|
|
| version 1.24, 2001/03/10 11:44:31 | version 1.89, 2001/05/17 15:20:15 |
|---|---|
| Line 1 | Line 1 |
| /* | /** @file |
| $Id$ | Parser: request class decl. |
| Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com) | |
| Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf) | |
| $Id$ | |
| */ | */ |
| #ifndef PA_REQUEST_H | #ifndef PA_REQUEST_H |
| #define PA_REQUEST_H | #define PA_REQUEST_H |
| #include "pa_config_includes.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 RUN_NAME "RUN" | #include "pa_vform.h" |
| #include "pa_vrequest.h" | |
| #define ROOT_NAME "ROOT" | #include "pa_vresponse.h" |
| #define ENV_NAME "ENV" | #include "pa_vcookie.h" |
| #include "pa_sql_driver_manager.h" | |
| #ifndef NO_STRING_ORIGIN | #ifndef NO_STRING_ORIGIN |
| # define COMPILE_PARAMS char *source, String *name, char *file | # define COMPILE_PARAMS \ |
| # define COMPILE(source, name, file) real_compile(source, name, 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 | # define COMPILE_PARAMS \ |
| # define COMPILE(source, name, file) real_compile(source, name) | 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(); | |
| void use(char *file, String *alias); // core.C | /** |
| Value& autocalc(Value& value, bool make_string=true); // execute.C | core request processing |
| void write(String& astring) { | BEWARE: may throw exception to you: catch it! |
| wcontext->write(astring, lang); // append string, assigning untaint language | */ |
| void core( | |
| const char *root_auto_path, ///< path to system auto.p file | |
| bool root_auto_fail, ///< fail if system auto.p file not found | |
| 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); // execute.C | |
| /// 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, | |
| 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 | |
| /// appending, sure of clean string inside | |
| void write_no_lang(const String& astring) { | |
| wcontext->write(astring, String::UL_CLEAN); | |
| } | |
| /// appending string, passing language built into string being written | |
| void write_pass_lang(const String& astring) { | |
| wcontext->write(astring, String::UL_PASS_APPENDED); | |
| } | |
| /// 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 | |
| VEnv env; | |
| /// $form:elements | |
| VForm form; | |
| /// $request:elements | |
| VRequest request; | |
| /// $response:elements | |
| VResponse response; | |
| /// $cookie:elements | |
| VCookie cookie; | |
| // contexts | /// contexts |
| Value *self, *root, *rcontext; | Value *self, *root, *rcontext; |
| /// contexts | |
| WContext *wcontext; | WContext *wcontext; |
| /// 'MAIN' class conglomerat | |
| VStateless_class *main_class; | |
| /// connection | |
| SQL_Connection *connection; | |
| /// PCRE character tables | |
| unsigned char *pcre_tables; | |
| /// classes configured data | |
| Hash classes_conf; | |
| private: // core data | private: // core data |
| // classes | /// classes |
| Hash fclasses; | Hash fclasses; |
| Array fclasses_array; | |
| // execution stack | /// already used files to avoid cyclic uses |
| Stack stack; | Hash used_files; |
| private: // core.C | /// execution stack |
| Stack stack; | |
| char *execute_MAIN(); | /** endless execute(execute(... preventing counter |
| @see ANTI_ENDLESS_EXECUTE_RECOURSION | |
| */ | |
| uint anti_endless_execute_recoursion; | |
| private: // compile.C | private: // compile.C |
| VClass& real_compile(COMPILE_PARAMS); | VStateless_class& real_compile(COMPILE_PARAMS); |
| private: // execute.C | private: // execute.C |
| void execute(const Array& ops); | 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(); | Value *get_element(); |
| private: // lang&raw | private: // lang&raw |
| String::Untaint_lang lang; | String::Untaint_lang flang; |
| private: // defaults | |
| private: // lang&raw manipulation | const String::Untaint_lang fdefault_lang; |
| Value *default_content_type; | |
| // TODO | private: // mime types |
| /// $MAIN:MIME-TYPES | |
| Table *mime_types; | |
| private: // lang manipulation | |
| 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 |