--- parser3/src/include/pa_request.h 2001/03/12 18:13:49 1.44 +++ parser3/src/include/pa_request.h 2001/03/19 19:17:43 1.63 @@ -1,129 +1,177 @@ -/* - Parser +/** @file + Parser: request class decl. + Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com) + Author: Alexander Petrosyan (http://design.ru/paf) - $Id: pa_request.h,v 1.44 2001/03/12 18:13:49 paf Exp $ + $Id: pa_request.h,v 1.63 2001/03/19 19:17:43 paf Exp $ */ #ifndef PA_REQUEST_H #define PA_REQUEST_H #include "pa_pool.h" -#include "pa_exception.h" #include "pa_hash.h" #include "pa_wcontext.h" #include "pa_value.h" #include "pa_stack.h" #include "pa_vclass.h" - -#define UNNAMED_NAME "unnamed" - -#define MAIN_METHOD_NAME "main" -#define AUTO_METHOD_NAME "auto" -#define MAIN_CLASS_NAME "MAIN" - -#define ROOT_CLASS_NAME "ROOT" -#define ENV_CLASS_NAME "ENV" -#define TABLE_CLASS_NAME "table" +#include "pa_vobject.h" +#include "pa_venv.h" +#include "pa_vform.h" +#include "pa_vrequest.h" +#include "pa_vresponse.h" +#include "pa_vcookie.h" #ifndef NO_STRING_ORIGIN # define COMPILE_PARAMS \ const char *source, \ - VClass *aclass, const String *name, \ - VClass *base_class, \ + VStateless_class *aclass, const String *name, \ + VStateless_class *base_class, \ const char *file # define COMPILE(source, aclass, name, base_class, file) \ real_compile(source, aclass, name, base_class, file) #else # define COMPILE_PARAMS \ const char *source, \ - VClass *aclass, const String *name, \ - VClass *base_class + VStateless_class *aclass, const String *name, \ + VStateless_class *base_class # define COMPILE(source, aclass, name, base_class, file) \ real_compile(source, aclass, name, base_class) #endif class Temp_lang; +/// Main workhorse. class Request : public Pooled { friend Temp_lang; public: + + /// some information from web server + struct Info { + const char *document_root; + const char *path_translated; + const char *method; + const char *query_string; + const char *uri; + const char *content_type; + size_t content_length; + const char *cookie; + }; - Request(Pool& apool); + Request(Pool& apool, + Info& ainfo, + String::Untaint_lang adefault_lang ///< all tainted data default untainting lang + ); ~Request() {} - // global classes + /// global classes Hash& classes() { return fclasses; } - Array& classes_array() { return fclasses_array; } - // core request processing - void core(); + /// core request processing + void core(Exception& system_exception, + const char *sys_auto_path1, + const char *sys_auto_path2); + /// executes ops void execute(const Array& ops); - VClass *use_file( + /// compiles the file, maybe forcing it's class \a name and \a base_class. + VStateless_class *use_file( const char *file, bool fail_on_read_problem=true, - VClass *aclass=0, const String *name=0, - VClass *base_class=0); // core.C - VClass *use_buf( + const String *name=0, + VStateless_class *base_class=0); // core.C + /// compiles a \a source buffer + VStateless_class *use_buf( const char *source, const char *file, - VClass *aclass=0, const String *name=0, - VClass *base_class=0); // core.C + VStateless_class *aclass=0, const String *name=0, + 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 + /// write(const) = clean void write(const String& astring) { - wcontext->write(astring, String::Untaint_lang::NO); // write(const) = clean + wcontext->write(astring, String::Untaint_lang::NO); } - + /// appending, sure of clean string inside + void write_no_lang(String& astring) { + wcontext->write(astring, String::Untaint_lang::NO); + } + /// appending string, passing language built into string being written + void write_pass_lang(String& astring) { + wcontext->write(astring, String::Untaint_lang::PASS_APPENDED); + } + /// appending possible string, assigning untaint language void write_assign_lang(Value& avalue) { - // appending possible string, assigning untaint language wcontext->write(avalue, flang); } + /// appending possible string, passing language built into string being written void write_pass_lang(Value& avalue) { - // appending possible string, passing language built into string being written wcontext->write(avalue, String::Untaint_lang::PASS_APPENDED); } + /// appending sure value, that would be converted to clean string + void write_no_lang(Value& avalue) { + wcontext->write(avalue, String::Untaint_lang::NO); + } + /// appending sure value, not VString + void write_expr_result(Value& avalue) { + wcontext->write(avalue); + } + /// handy is-value-a-junction ensurer void fail_if_junction_(bool is, Value& value, const String& method_name, char *msg); + /// returns relative to \a path path to \a file char *relative(const char *path, const char *file); + + /// returns an absolute \a path to relative \a name char *absolute(const char *name); public: - // default base - VClass root_class; - // $ENV:fields here - VClass env_class; + /// info from web server + Info& info; - // contexts + /// default base + VClass ROOT; + /// $env:fields here + VEnv env; + /// $form:elements here + VForm form; + /// $request:elements here + VRequest request; + /// $response: + VResponse response; + /// $cookie: + VCookie cookie; + + /// contexts Value *self, *root, *rcontext; + /// contexts WContext *wcontext; private: // core data // classes Hash fclasses; - Array fclasses_array; // execution stack Stack stack; -private: // core.C - - char *execute_MAIN(); - private: // compile.C - VClass& real_compile(COMPILE_PARAMS); + VStateless_class& real_compile(COMPILE_PARAMS); private: // execute.C - char *execute_static_method(VClass& vclass, String& method_name, bool return_cstr); + const String *execute_method(Value& aself, const Method& method, + bool return_cstr=true); + const String *execute_method(Value& aself, const String& method_name, + bool return_cstr=true); Value *get_element(); @@ -131,6 +179,11 @@ private: // lang&raw String::Untaint_lang flang; +private: // defaults + + const String::Untaint_lang fdefault_lang; + Value *fdefault_content_type; + private: // lang manipulation String::Untaint_lang set_lang(String::Untaint_lang alang) { @@ -142,13 +195,12 @@ private: // lang manipulation flang=alang; } -private: // web - - const char *document_root; - const char *page_filespec; +private: + void output_result(const String& body_string); }; +/// Auto-object used for temporary changing Request::flang. class Temp_lang { Request& frequest; String::Untaint_lang saved_lang;