|
|
| version 1.35, 2001/03/11 08:02:05 | version 1.84, 2001/04/28 08:43:53 |
|---|---|
| Line 1 | Line 1 |
| /* | /** @file |
| Parser | Parser: request class decl. |
| Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com) | Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com) |
| Author: Alexander Petrosyan <paf@design.ru> | |
| Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf) | |
| $Id$ | $Id$ |
| */ | */ |
| Line 10 | Line 12 |
| #define PA_REQUEST_H | #define PA_REQUEST_H |
| #include "pa_pool.h" | #include "pa_pool.h" |
| #include "pa_exception.h" | |
| #include "pa_hash.h" | #include "pa_hash.h" |
| #include "pa_wcontext.h" | #include "pa_wcontext.h" |
| #include "pa_value.h" | #include "pa_value.h" |
| #include "pa_stack.h" | #include "pa_stack.h" |
| #include "pa_vclass.h" | #include "pa_vclass.h" |
| #include "pa_vobject.h" | |
| #define MAIN_METHOD_NAME "main" | #include "pa_venv.h" |
| #define AUTO_METHOD_NAME "auto" | #include "pa_vform.h" |
| #define MAIN_CLASS_NAME "MAIN" | #include "pa_vrequest.h" |
| #include "pa_vresponse.h" | |
| #define ROOT_CLASS_NAME "ROOT" | #include "pa_vcookie.h" |
| #define ENV_CLASS_NAME "ENV" | #include "pa_sql_driver_manager.h" |
| #ifndef NO_STRING_ORIGIN | #ifndef NO_STRING_ORIGIN |
| # define COMPILE_PARAMS char *source, String *name, VClass *base_class, char *file | # define COMPILE_PARAMS \ |
| # define COMPILE(source, name, base_class, file) real_compile(source, name, base_class, file) | const char *source, \ |
| 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 | #else |
| # define COMPILE_PARAMS char *source, String *name, VClass *base_class | # define COMPILE_PARAMS \ |
| # define COMPILE(source, name, base_class, file) real_compile(source, name, base_class) | const char *source, \ |
| 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 | #endif |
| class Local_request_exception; | class Temp_lang; |
| class Methoded; | |
| /// Main workhorse. | |
| class Request : public Pooled { | class Request : public Pooled { |
| friend Temp_lang; | |
| public: | public: |
| /// some information from web server | |
| class Info { | |
| public: | |
| 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; | |
| const char *user_agent; | |
| }; | |
| Request(Pool& apool); | Request(Pool& apool, |
| Info& ainfo, | |
| String::Untaint_lang adefault_lang ///< all tainted data default untainting lang | |
| ); | |
| ~Request() {} | ~Request() {} |
| // global classes | /// global classes |
| Hash& classes() { return fclasses; } | Hash& classes() { return fclasses; } |
| Array& classes_array() { return fclasses_array; } | |
| // core request processing | /** |
| void core(); | core request processing |
| VClass *use(char *file, | BEWARE: may throw exception to you: catch it! |
| String *name=0, | */ |
| VClass *base_class=0, | void core( |
| bool fail_on_read_problem=true); // core.C | const char *root_auto_path, ///< path to system auto.p file |
| Value& autocalc( | bool root_auto_fail, ///< fail if system auto.p file not found |
| Value& value, | const char *site_auto_path, ///< path to site auto.p file |
| bool site_auto_fail, ///< fail if site auto.p file not found | |
| bool header_only); | |
| /// executes ops | |
| void execute(const Array& ops); | |
| /// compiles the file, maybe forcing it's class @a name and @a base_class. | |
| VStateless_class *use_file( | |
| const String& file_spec, bool fail_on_read_problem=true, | |
| const String *name=0, | const String *name=0, |
| bool make_string=true); // execute.C | VStateless_class *base_class=0); // core.C |
| /// compiles a @a source buffer | |
| VStateless_class *use_buf( | |
| const char *source, const char *file, | |
| 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 | |
| void write(const String& astring) { | /// appending, sure of clean string inside |
| wcontext->write(astring, String::Untaint_lang::NO); // write(const) = clean | void write_no_lang(const String& astring) { |
| wcontext->write(astring, String::UL_CLEAN); | |
| } | } |
| /// appending string, passing language built into string being written | |
| void write(Value& avalue) { | void write_pass_lang(const String& astring) { |
| // appending possible string, assigning untaint language | wcontext->write(astring, String::UL_PASS_APPENDED); |
| wcontext->write(avalue, lang); | } |
| /// appending possible string, assigning untaint language | |
| void write_assign_lang(Value& avalue) { | |
| wcontext->write(avalue, flang); | |
| } | |
| /// appending possible string, passing language built into string being written | |
| void write_pass_lang(Value& avalue) { | |
| wcontext->write(avalue, String::UL_PASS_APPENDED); | |
| } | |
| /// appending sure value, that would be converted to clean string | |
| void write_no_lang(Value& avalue) { | |
| wcontext->write(avalue, String::UL_CLEAN); | |
| } | } |
| /// appending sure value, not VString | |
| void write_expr_result(Value& avalue) { | |
| wcontext->write(avalue); | |
| } | |
| /// returns relative to @a path path to @a file | |
| const String& relative(const char *apath, const String& relative_name); | |
| /// returns an absolute @a path to relative @a name | |
| const String& absolute(const String& relative_name); | |
| /// returns the mime type of 'user_file_name_cstr' | |
| const String& mime_type_of(const char *user_file_name_cstr); | |
| public: | public: |
| // default base | /// info from web server |
| VClass root_class; | Info& info; |
| // $ENV:fields here | /// user's post data |
| VClass env_class; | char *post_data; size_t post_size; |
| /// operators are methods of this class | |
| Methoded& OP; | |
| /// $env:fields here | |
| VEnv env; | |
| /// $form:elements here | |
| VForm form; | |
| /// $request:elements here | |
| VRequest request; | |
| /// $response: | |
| VResponse response; | |
| /// $cookie: | |
| VCookie cookie; | |
| // contexts | /// contexts |
| Value *self, *root, *rcontext; | Value *self, *root, *rcontext; |
| /// contexts | |
| WContext *wcontext; | WContext *wcontext; |
| /// connection | |
| SQL_Connection *connection; | |
| /// 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; |
| Array fclasses_array; | |
| // already used files to avoid cyclic uses | |
| Hash used_files; | |
| // execution stack | // execution stack |
| Stack stack; | Stack stack; |
| private: // core.C | |
| char *execute_MAIN(); | |
| private: // compile.C | private: // compile.C |
| VClass& real_compile(COMPILE_PARAMS); | VStateless_class& real_compile(COMPILE_PARAMS); |
| private: // execute.C | private: // execute.C |
| char *execute_static_method(VClass& vclass, String& method_name, bool return_cstr); | const String *execute_method(Value& aself, const Method& method, |
| void execute(const Array& ops); | bool return_cstr=true); |
| const String *execute_method(Value& aself, const String& method_name, | |
| bool return_cstr=true); | |
| Value *get_element(); | Value *get_element(); |
| private: // lang&raw | private: // lang&raw |
| String::Untaint_lang lang; | String::Untaint_lang flang; |
| private: // defaults | |
| const String::Untaint_lang fdefault_lang; | |
| Value *default_content_type; | |
| private: // mime types | |
| /// $MAIN:MIME-TYPES | |
| Table *mime_types; | |
| private: // lang&raw manipulation | private: // lang manipulation |
| // TODO | String::Untaint_lang set_lang(String::Untaint_lang alang) { |
| String::Untaint_lang result=flang; | |
| flang=alang; | |
| return result; | |
| } | |
| void restore_lang(String::Untaint_lang alang) { | |
| flang=alang; | |
| } | |
| private: | |
| void output_result(const VFile& body_file, bool header_only); | |
| }; | |
| /// Auto-object used for temporary changing Request::flang. | |
| class Temp_lang { | |
| Request& frequest; | |
| String::Untaint_lang saved_lang; | |
| public: | |
| Temp_lang(Request& arequest, String::Untaint_lang alang) : | |
| frequest(arequest), | |
| saved_lang(arequest.set_lang(alang)) { | |
| } | |
| ~Temp_lang() { | |
| frequest.restore_lang(saved_lang); | |
| } | |
| }; | }; |
| #endif | #endif |