parser3/src/include/pa_request.h - diff

Return to pa_request.h CVS log

Up to [parser3project] / parser3 / src / include

Diff for /parser3/src/include/pa_request.h between versions 1.86 and 1.129

version 1.86, 2001/04/28 12:58:41	version 1.129, 2002/04/15 10:35:22
Line 1	Line 1
/** @file	/** @file
Parser: request class decl.	Parser: request class decl.

Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)	Copyright (c) 2001, 2002 ArtLebedev Group (http://www.artlebedev.com)
	Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)

$Id$	$Id$
*/	*/
Line 19	Line 18
#include "pa_vclass.h"	#include "pa_vclass.h"
#include "pa_vobject.h"	#include "pa_vobject.h"
#include "pa_venv.h"	#include "pa_venv.h"
	#include "pa_vstatus.h"
#include "pa_vform.h"	#include "pa_vform.h"
	#include "pa_vmath.h"
#include "pa_vrequest.h"	#include "pa_vrequest.h"
#include "pa_vresponse.h"	#include "pa_vresponse.h"
#include "pa_vcookie.h"	#include "pa_vcookie.h"
#include "pa_sql_driver_manager.h"	#include "pa_sql_driver_manager.h"

	#ifdef RESOURCES_DEBUG
	#include <sys/resource.h>
	#endif

	// consts

	const uint ANTI_ENDLESS_EXECUTE_RECOURSION=500;

	// defines

#ifndef NO_STRING_ORIGIN	#ifndef NO_STRING_ORIGIN
# define COMPILE_PARAMS \	# define COMPILE_PARAMS \
const char *source, \	const char *source, \
Line 44	Line 55

class Temp_lang;	class Temp_lang;
class Methoded;	class Methoded;
	class VMethodFrame;

/// Main workhorse.	/// Main workhorse.
class Request : public Pooled {	class Request : public Pooled {
friend Temp_lang;	friend class Temp_lang;
	friend class Temp_connection;
public:	public:

	#ifdef RESOURCES_DEBUG
	/// measures
	double sql_connect_time;
	double sql_request_time;
	#endif

/// some information from web server	/// some information from web server
class Info {	class Info {
public:	public:
Line 66 public:	Line 85 public:

Request(Pool& apool,	Request(Pool& apool,
Info& ainfo,	Info& ainfo,
String::Untaint_lang adefault_lang ///< all tainted data default untainting lang	uchar adefault_lang, ///< all tainted data default untainting lang
	bool status_allowed ///< status class allowed
);	);
~Request() {}	~Request();

/// global classes	/// global classes
Hash& classes() { return fclasses; }	Hash& classes() { return fclasses; }
Line 79 public:	Line 99 public:
BEWARE: may throw exception to you: catch it!	BEWARE: may throw exception to you: catch it!
*/	*/
void core(	void core(
const char *root_auto_path, ///< path to system auto.p file	const char *root_config_filespec, ///< system config filespec
bool root_auto_fail, ///< fail if system auto.p file not found	bool root_config_fail_on_read_problem, ///< fail if system config file not found
const char *site_auto_path, ///< path to site auto.p file	const char *site_config_filespec, ///< site config filespec
bool site_auto_fail, ///< fail if site auto.p file not found	bool site_config_fail_on_read_problem, ///< fail if site config file not found
bool header_only);	bool header_only);

/// executes ops	/// executes ops
void execute(const Array& ops);	void execute(const Array& ops); // execute.C
	/// execute ops with anti-recoursion check
	void recoursion_checked_execute(const String *name, const Array& ops) {
	// anti_endless_execute_recoursion
	if(++anti_endless_execute_recoursion==ANTI_ENDLESS_EXECUTE_RECOURSION) {
	anti_endless_execute_recoursion=0; // give @exception a chance
	throw Exception("parser.runtime",
	name,
	"call canceled - endless recursion detected");
	}
	execute(ops); // execute it
	anti_endless_execute_recoursion--;
	}

/// compiles the file, maybe forcing it's class @a name and @a base_class.	/// compiles the file, maybe forcing it's class @a name and @a base_class.
VStateless_class *use_file(	VStateless_class *use_file(
const String& file_spec, bool fail_on_read_problem=true,	const String& file_name,
	bool ignore_class_path=false, bool fail_on_read_problem=true,
const String *name=0,	const String *name=0,
VStateless_class *base_class=0); // core.C	VStateless_class *base_class=0); // core.C
/// compiles a @a source buffer	/// compiles a @a source buffer
Line 98 public:	Line 131 public:
const char source, const char file,	const char source, const char file,
VStateless_class aclass=0, const String name=0,	VStateless_class aclass=0, const String name=0,
VStateless_class *base_class=0); // core.C	VStateless_class *base_class=0); // core.C
/// processes any code-junction there may be inside of @a value
Value& process(
Value& value,
const String *name=0,
bool intercept_string=true); // execute.C

	/// processes any code-junction there may be inside of @a value
	StringOrValue process(Value& input_value,
	bool intercept_string,
	void (postexecute)(void info)=0, void *postexecute_info=0); // execute.C
	//@{ convinient helpers
	const String& process_to_string(Value& input_value) {
	return process(input_value, true/intercept_string/).as_string();
	}
	Value& process_to_value(Value& input_value, bool intercept_string=true) {
	return process(input_value, intercept_string).as_value();
	}
	//@}

/// appending, sure of clean string inside	/// appending, sure of clean string inside
void write_no_lang(const String& astring) {	void write_no_lang(const String& astring) {
wcontext->write(astring, String::UL_CLEAN);	wcontext->write(astring,
	String::UL_CLEAN \| flang&String::UL_OPTIMIZE_BIT);
}	}
/// appending string, passing language built into string being written	/// appending string, passing language built into string being written
void write_pass_lang(const String& astring) {	void write_pass_lang(const String& astring) {
Line 116 public:	Line 158 public:
void write_assign_lang(Value& avalue) {	void write_assign_lang(Value& avalue) {
wcontext->write(avalue, flang);	wcontext->write(avalue, flang);
}	}
	/// appending string, assigning untaint language
	void write_assign_lang(const String& astring) {
	wcontext->write(astring, flang);
	}
/// appending possible string, passing language built into string being written	/// appending possible string, passing language built into string being written
void write_pass_lang(Value& avalue) {	void write_pass_lang(Value& avalue) {
wcontext->write(avalue, String::UL_PASS_APPENDED);	wcontext->write(avalue, String::UL_PASS_APPENDED);
}	}
/// appending sure value, that would be converted to clean string	/// appending sure value, that would be converted to clean string
void write_no_lang(Value& avalue) {	void write_no_lang(Value& avalue) {
wcontext->write(avalue, String::UL_CLEAN);	if(wcontext->get_in_expression())
	wcontext->write(avalue);
	else
	wcontext->write(avalue,
	String::UL_CLEAN \| flang&String::UL_OPTIMIZE_BIT);
}	}
/// appending sure value, not VString	/// appending sure value, not VString
void write_expr_result(Value& avalue) {	void write_expr_result(Value& avalue) {
Line 138 public:	Line 188 public:
/// returns the mime type of 'user_file_name_cstr'	/// returns the mime type of 'user_file_name_cstr'
const String& mime_type_of(const char *user_file_name_cstr);	const String& mime_type_of(const char *user_file_name_cstr);

	/// returns current SQL connection if any
	SQL_Connection connection(const String source) {
	if(!fconnection && source)
	throw Exception("parser.runtime",
	source,
	"outside of 'connect' operator");

	return fconnection;
	}

public:	public:

/// info from web server	/// info from web server
Line 149 public:	Line 209 public:
Methoded& OP;	Methoded& OP;
/// $env:fields	/// $env:fields
VEnv env;	VEnv env;
	/// $status:fields
	VStatus status;
/// $form:elements	/// $form:elements
VForm form;	VForm form;
	/// $math:constants
	VMath math;
/// $request:elements	/// $request:elements
VRequest request;	VRequest request;
/// $response:elements	/// $response:elements
Line 158 public:	Line 222 public:
/// $cookie:elements	/// $cookie:elements
VCookie cookie;	VCookie cookie;

	//@{ request processing status
	/// execution stack
	Stack stack;
/// contexts	/// contexts
Value self, root, *rcontext;	Value self, root, *rcontext;
/// contexts	/// contexts
WContext *wcontext;	WContext *wcontext;
	/// exception stack trace
	Stack exception_trace;
	//@}

/// 'MAIN' class conglomerat	/// 'MAIN' class conglomerat
VStateless_class *main_class;	VStateless_class *main_class;

/// connection	/// classes configured data
SQL_Connection *connection;	Hash classes_conf;
/// table of protocol's libraries. read from $SQL:drivers
Table *protocol2library;
/// mail options
Hash *mail;
/// PCRE character tables
unsigned char *pcre_tables;

private: // core data	private: // core data

// classes	/// classes
Hash fclasses;	Hash fclasses;

// already used files to avoid cyclic uses	/// already used files to avoid cyclic uses
Hash used_files;	Hash used_files;

// execution stack	/** endless execute(execute(... preventing counter
Stack stack;	@see ANTI_ENDLESS_EXECUTE_RECOURSION
	*/
	uint anti_endless_execute_recoursion;

private: // compile.C	private: // compile.C

Line 192 private: // compile.C	Line 258 private: // compile.C

private: // execute.C	private: // execute.C

const String *execute_method(Value& aself, const Method& method,	const String *execute_method(Value& aself, const Method& method,
bool return_cstr=true);	bool return_cstr);
const String *execute_method(Value& aself, const String& method_name,	const String& execute_method(VMethodFrame& amethodFrame, const Method& method);
bool return_cstr=true);	const String *execute_virtual_method(Value& aself, const String& method_name);
	const String *execute_nonvirtual_method(VStateless_class& aclass,
	const String& method_name,
	bool return_cstr);

Value *get_element();	Value *get_element(bool can_call_operator);

private: // lang&raw

String::Untaint_lang flang;

private: // defaults	private: // defaults

const String::Untaint_lang fdefault_lang;	const uchar fdefault_lang;
Value *default_content_type;	Value *default_content_type;

private: // mime types	private: // mime types
Line 215 private: // mime types	Line 280 private: // mime types

private: // lang manipulation	private: // lang manipulation

String::Untaint_lang set_lang(String::Untaint_lang alang) {	uchar set_lang(uchar alang) {
String::Untaint_lang result=flang;	uchar result=flang;
flang=alang;	flang=alang;
return result;	return result;
}	}
void restore_lang(String::Untaint_lang alang) {	void restore_lang(uchar alang) {
flang=alang;	flang=alang;
}	}

	private: // lang&raw

	uchar flang;


	private: // connection manipulation

	SQL_Connection set_connection(SQL_Connection aconnection) {
	SQL_Connection *result=fconnection;
	fconnection=aconnection;
	return result;
	}
	void restore_connection(SQL_Connection *aconnection) {
	fconnection=aconnection;
	}

private:	private:

	/// connection
	SQL_Connection *fconnection;

void output_result(const VFile& body_file, bool header_only);	void output_result(const VFile& body_file, bool header_only);
};	};

/// Auto-object used for temporary changing Request::flang.	/// Auto-object used for temporary changing Request::flang.
class Temp_lang {	class Temp_lang {
Request& frequest;	Request& frequest;
String::Untaint_lang saved_lang;	uchar saved_lang;
public:	public:
Temp_lang(Request& arequest, String::Untaint_lang alang) :	Temp_lang(Request& arequest, uchar alang) :
frequest(arequest),	frequest(arequest),
saved_lang(arequest.set_lang(alang)) {	saved_lang(arequest.set_lang(alang)) {
}	}
Line 243 public:	Line 327 public:
}	}
};	};

	/// Auto-object used for temporary changing Request::fconnection.
	class Temp_connection {
	Request& frequest;
	SQL_Connection *saved_connection;
	public:
	Temp_connection(Request& arequest, SQL_Connection *aconnection) :
	frequest(arequest),
	saved_connection(arequest.set_connection(aconnection)) {
	}
	~Temp_connection() {
	frequest.restore_connection(saved_connection);
	}
	};

	/**
	@b method parameters passed in this array.
	contains handy typecast ad junction/not junction ensurers

	*/
	class MethodParams : public Array {
	public:
	MethodParams(Pool& pool, const String& amethod_name) : Array(pool),
	fmethod_name(amethod_name) {
	}

	/// handy typecast. I long for templates
	Value& get(int index) {
	return static_cast<Value >(Array::get(index));
	}
	/// handy is-value-a-junction ensurer
	Value& as_junction(int index, const char *msg) {
	return get_as(index, true, msg);
	}
	/// handy value-is-not-a-junction ensurer
	Value& as_no_junction(int index, const char *msg) {
	return get_as(index, false, msg);
	}
	/// handy expression auto-processing to double
	double as_double(int index, const char *msg, Request& r) {
	return get_processed(index, msg, r).as_double();
	}
	/// handy expression auto-processing to int
	int as_int(int index, const char *msg, Request& r) {
	return get_processed(index, msg, r).as_int();
	}
	/// handy expression auto-processing to bool
	bool as_bool(int index, const char *msg, Request& r) {
	return get_processed(index, msg, r).as_bool();
	}
	/// handy string ensurer
	const String& as_string(int index, const char *msg) {
	return as_no_junction(index, msg).as_string();
	}

	private:

	/// handy value-is/not-a-junction ensurer
	Value& get_as(int index, bool as_junction, const char *msg) {
	Value& result=get(index);
	if((result.get_junction()!=0) ^ as_junction)
	throw Exception("parser.runtime",
	&fmethod_name,
	"%s (parameter #%d)", msg, 1+index);

	return result;
	}

	Value& get_processed(int index, const char *msg, Request& r) {
	return r.process_to_value(as_junction(index, msg), 0/no name/);
	}

	private:

	const String& fmethod_name;

	};

#endif	#endif

E-mail:

Removed from v.1.86
changed lines
	Added in v.1.129