|
|
| version 1.61, 2001/03/19 15:29:38 | version 1.67, 2001/03/24 10:54:45 |
|---|---|
| Line 1 | Line 1 |
| /** @file | /** @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> (http://design.ru/paf) | Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf) |
| $Id$ | $Id$ |
| Line 47 class Request : public Pooled { | Line 49 class Request : public Pooled { |
| public: | public: |
| /// some information from web server | /// some information from web server |
| struct Info { | class Info { |
| public: | |
| const char *document_root; | const char *document_root; |
| const char *path_translated; | const char *path_translated; |
| const char *method; | const char *method; |
| Line 60 public: | Line 63 public: |
| Request(Pool& apool, | Request(Pool& apool, |
| Info& ainfo, | Info& ainfo, |
| String::Untaint_lang adefault_lang ///< all tainted data default untainted | 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; } |
| /// core request processing | /** |
| void core(Exception& system_exception, | core request processing |
| const char *sys_auto_path1, | |
| const char *sys_auto_path2); | BEWARE: may throw exception to you: catch it! |
| */ | |
| 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 | /// executes ops |
| void execute(const Array& ops); | void execute(const Array& ops); |
| /// 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 char *file, bool fail_on_read_problem=true, | const char *file, 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 |
| VStateless_class *use_buf( | VStateless_class *use_buf( |
| 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 | /// processes any code-junction there may be inside of @a value |
| Value& process( | Value& process( |
| Value& value, | Value& value, |
| const String *name=0, | const String *name=0, |
| bool intercept_string=true); // execute.C | bool intercept_string=true); // execute.C |
| /// write(const) = clean | |
| void write(const String& astring) { | |
| wcontext->write(astring, String::Untaint_lang::NO); | |
| } | |
| /// appending, sure of clean string inside | /// appending, sure of clean string inside |
| void write_no_lang(String& astring) { | void write_no_lang(const String& astring) { |
| wcontext->write(astring, String::Untaint_lang::NO); | wcontext->write(astring, String::UL_NO); |
| } | } |
| /// appending string, passing language built into string being written | /// appending string, passing language built into string being written |
| void write_pass_lang(String& astring) { | void write_pass_lang(const String& astring) { |
| wcontext->write(astring, String::Untaint_lang::PASS_APPENDED); | wcontext->write(astring, String::UL_PASS_APPENDED); |
| } | } |
| /// appending possible string, assigning untaint language | /// appending possible string, assigning untaint language |
| void write_assign_lang(Value& avalue) { | void write_assign_lang(Value& avalue) { |
| Line 109 public: | Line 115 public: |
| } | } |
| /// 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::Untaint_lang::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::Untaint_lang::NO); | wcontext->write(avalue, String::UL_NO); |
| } | } |
| /// appending sure value, not VString | /// appending sure value, not VString |
| void write_expr_result(Value& avalue) { | void write_expr_result(Value& avalue) { |
| Line 121 public: | Line 127 public: |
| } | } |
| /// handy is-value-a-junction ensurer | /// handy is-value-a-junction ensurer |
| void fail_if_junction_(bool is, Value& value, const String& method_name, char *msg); | void fail_if_junction_(bool is, Value& value, |
| const String& method_name, const char *msg); | |
| /// returns relative to \a path path to \a file | /// returns relative to @a path path to @a file |
| char *relative(const char *path, const char *file); | char *relative(const char *path, const char *file); |
| /// returns an absolute \a path to relative \a name | /// returns an absolute @a path to relative @a name |
| char *absolute(const char *name); | char *absolute(const char *name); |
| public: | public: |
| Line 157 private: // core data | Line 164 private: // core data |
| // classes | // classes |
| Hash fclasses; | Hash fclasses; |
| // already used files to avoid cyclic uses | |
| Hash used_files; | |
| // execution stack | // execution stack |
| Stack stack; | Stack stack; |
| Line 195 private: // lang manipulation | Line 205 private: // lang manipulation |
| private: | private: |
| void output_result(const String& body_string); | void output_result(const String& body_string, bool header_only); |
| }; | }; |
| /// Auto-object used for temporary changing Request::flang. | /// Auto-object used for temporary changing Request::flang. |