Diff for /parser3/src/main/pa_request.C between versions 1.105 and 1.404

version 1.105, 2001/04/09 09:48:20 version 1.404, 2020/12/15 16:52:36
Line 1 Line 1
 /** @file  /** @file
         Parser: request class main part. @see compile.C and execute.C.          Parser: request class main part. @see compile.C and execute.C.
   
         Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)          Copyright (c) 2001-2017 Art. Lebedev Studio (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$  
 */  */
   
 #include "pa_config_includes.h"  
   
 #include <locale.h>  
   
 #include "pa_sapi.h"  #include "pa_sapi.h"
 #include "pa_common.h"  #include "pa_common.h"
   #include "pa_os.h"
 #include "pa_request.h"  #include "pa_request.h"
 #include "pa_wwrapper.h"  #include "pa_wwrapper.h"
 #include "pa_vclass.h"  #include "pa_vclass.h"
 #include "_op.h"  
 #include "_table.h"  
 #include "_file.h"  
 #include "pa_globals.h"  #include "pa_globals.h"
 #include "pa_vint.h"  #include "pa_vint.h"
 #include "pa_vmframe.h"  #include "pa_vmethod_frame.h"
 #include "pa_types.h"  #include "pa_types.h"
   #include "pa_venv.h"
   #include "pa_vmath.h"
   #include "pa_vstatus.h"
   #include "pa_vrequest.h"
 #include "pa_vtable.h"  #include "pa_vtable.h"
 #include "_random.h"  
 #include "pa_vfile.h"  #include "pa_vfile.h"
 #include "_mail.h"  #include "pa_dictionary.h"
   #include "pa_charset.h"
   #include "pa_charsets.h"
   #include "pa_cache_managers.h"
   #include "pa_http.h"
   #include "pa_vmail.h"
   #include "pa_vform.h"
   #include "pa_vcookie.h"
   #include "pa_vresponse.h"
   #include "pa_vmemory.h"
   #include "pa_vconsole.h"
   #include "pa_vdate.h"
   
 /// $limits.post_max_size default 10M  volatile const char * IDENT_PA_REQUEST_C="$Id$" IDENT_PA_REQUEST_H IDENT_PA_REQUEST_CHARSETS_H IDENT_PA_REQUEST_INFO_H IDENT_PA_VCONSOLE_H;
 const size_t MAX_POST_SIZE_DEFAULT=10*0x400*400;  
   
 /// content type of exception response, when no @MAIN:exception handler defined  // consts
 const char *UNHANDLED_EXCEPTION_CONTENT_TYPE="text/plain";  
   #define UNHANDLED_EXCEPTION_METHOD_NAME "unhandled_exception"
   
 /// content type of response when no $MAIN:defaults.content-type defined  /// content type of response when no $MAIN:defaults.content-type defined
 const char *DEFAULT_CONTENT_TYPE="text/html";  const char* DEFAULT_CONTENT_TYPE="text/html";
   
   const uint LOOP_LIMIT=20000;
   const uint EXECUTE_RECOURSION_LIMIT=1000;
   const uint HTTPD_TIMEOUT=4;
   const size_t FILE_SIZE_LIMIT=512*1024*1024;
   
   // defines for globals
   
   #define MAIN_METHOD_NAME "main"
   #define AUTO_METHOD_NAME "auto"
   #define USE_METHOD_NAME "use"
   #define AUTOUSE_METHOD_NAME "autouse"
   
   #define EXCEPTION_TYPE_PART_NAME "type"
   #define EXCEPTION_SOURCE_PART_NAME "source"
   #define EXCEPTION_COMMENT_PART_NAME "comment"
   
   #define ORIGIN_KEY "origin"
   
   // globals
   
   const String main_method_name(MAIN_METHOD_NAME);
   const String auto_method_name(AUTO_METHOD_NAME);
   static const String use_method_name(USE_METHOD_NAME);
   static const String autouse_method_name(AUTOUSE_METHOD_NAME);
   
   const String exception_type_part_name(EXCEPTION_TYPE_PART_NAME);
   const String exception_source_part_name(EXCEPTION_SOURCE_PART_NAME);
   const String exception_comment_part_name(EXCEPTION_COMMENT_PART_NAME);
   const String exception_handled_part_name(EXCEPTION_HANDLED_PART_NAME);
   
   static const String origin_key(ORIGIN_KEY);
   
   int pa_loop_limit=LOOP_LIMIT;
   int pa_execute_recoursion_limit=EXECUTE_RECOURSION_LIMIT;
   int pa_httpd_timeout=HTTPD_TIMEOUT;
   size_t pa_file_size_limit=FILE_SIZE_LIMIT;
   
   // defines for statics
   
   #define MIME_TYPES_NAME "MIME-TYPES"
   #define CLASS_PATH_NAME "CLASS_PATH"
   
   #define DOWNLOAD_NAME_UPPER "DOWNLOAD"
   #define BODY_NAME_UPPER "BODY"
   
   // statics
   
   static const String main_class_name(MAIN_CLASS_NAME);
   static const String mime_types_name(MIME_TYPES_NAME);
   static const String class_path_name(CLASS_PATH_NAME);
   
   static const String charsets_name("CHARSETS");
   static const String strict_vars_name("STRICT-VARS");
   static const String prototype_name("OBJECT-PROTOTYPE");
   static const String limits_name("LIMITS");
   static const String loop_limit_name("max_loop");
   static const String recoursion_limit_name("max_recoursion");
   static const String file_size_limit_name("max_file_size");
   static const String lock_wait_timeout_name("lock_wait_timeout");
   static const String httpd_name("HTTPD");
   static const String httpd_timeout_name("timeout");
   static const String httpd_mode_name("mode");
   
   static const String conf_method_name("conf");
   static const String post_process_method_name("postprocess");
   static const String response_body_file_name("file");
   
   static const String download_name_upper(DOWNLOAD_NAME_UPPER);
   static const String body_name_upper(BODY_NAME_UPPER);
   
   // more static
   
   static const String content_type_name_upper(HTTP_CONTENT_TYPE_UPPER);
   static const String content_disposition_name_upper(CONTENT_DISPOSITION_UPPER);
   static const String content_disposition_inline(CONTENT_DISPOSITION_INLINE);
   static const String content_disposition_attachment(CONTENT_DISPOSITION_ATTACHMENT);
   
   // defines
   
   #define CHARSET_NAME_UPPER "CHARSET"
   #define LAST_MODIFIED_NAME_UPPER "LAST-MODIFIED"
   
   // op.C
   VStateless_class& VClassMAIN_create();
   
 //  //
 Request::Request(Pool& apool,  Request::Request(SAPI_Info& asapi_info, Request_info& arequest_info, 
                                  Info& ainfo,                                   String::Language adefault_lang):
                                  String::Untaint_lang adefault_lang) : Pooled(apool),          // private
         stack(apool),          anti_endless_execute_recoursion(0),
         OP(apool),  
         env(apool),          // public
         form(apool),          allow_class_replace(false),
         request(apool, *this),          method_frame(0),
         response(apool),          rcontext(0),
         cookie(apool),          wcontext(0),
         fclasses(apool),          flang(adefault_lang),
         fdefault_lang(adefault_lang), flang(adefault_lang),          fconnection(0),
         info(ainfo),          fin_cycle(0),
         post_data(0), post_size(0),          fskip(SKIP_NOTHING),
         used_files(apool),  
         default_content_type(0),          // public
         mime_types(0),          request_info(arequest_info),
         connection(0), protocol2library(0),          sapi_info(asapi_info),
         mail(0)          charsets(pa_UTF8_charset, pa_UTF8_charset, pa_UTF8_charset), // default charsets
   
           main_class(VClassMAIN_create()),
           form(*new VForm(charsets, arequest_info)),
           mail(*new VMail),
           response(*new VResponse(arequest_info, charsets)),
           cookie(*new VCookie(charsets, arequest_info)),
           console(*new VConsole),
   
           // private
           configure_admin_done(false),
   
           // private defaults
           fdefault_lang(adefault_lang), 
           // private mime types
           mime_types(0)
 {  {
         // root superclass,           pa_register_thread_request(*this);
         //   parent of all classes,   
         //   operators holder          // file_no=0 => unknown
         initialize_op_class(pool(), OP);          file_list+="UNKNOWN";
         classes().put(*op_class_name, &OP);          file_list+="-body of process-"; // pseudo_file_no__process
         // table class  
         classes().put(*table_class_name, table_class);            // maybe expire old caches
         // file class          cache_managers->maybe_expire();
         classes().put(*file_class_name, file_class);              
         // random class          /// directly used
         classes().put(*random_class_name, random_class);                  // MAIN class, operators
           put_class(&main_class);
           // classes:
           // table, file, random, mail, image, ...
           methoded_array().register_directly_used(*this);
   
           /// methodless
   
         // env class          // env class
         classes().put(*env_class_name, &env);          put_class(new VEnv(asapi_info));
         // form class          // status class
         classes().put(*form_class_name, &form);           put_class(new VStatus());
         // request class          // request class
         classes().put(*request_class_name, &request);             put_class(new VRequest(arequest_info, charsets, form, asapi_info));
         // response class  
         classes().put(*response_class_name, &response);   
         // cookie class          // cookie class
         classes().put(*cookie_class_name, &cookie);          put_class(&cookie);
           // console class
           put_class(&console);
   
           /// methoded
   
           // response class
           put_class(&response);
           // form class
           put_class(&form);
         // mail class          // mail class
         classes().put(*mail_class_name, mail_class);              put_class(&mail);
           // math class
           put_class(new VMath);
           // memory class
           put_class(new VMemory);
   }
   
   Request::~Request() {
   #ifdef XML
           // if for some strange reason xml generic errors failed to be reported, free them up
           if(const char* xml_generic_errors=xmlGenericErrors()) {
                   SAPI::log(sapi_info, "warning: unreported xmlGenericErrors: %s", xml_generic_errors);
                   pa_free((void *)xml_generic_errors);
           }
   #endif
   }
   
   Value& Request::get_self() { return method_frame/*always have!*/->self(); }
   
   VStateless_class* Request::get_class(const String& name){
           VStateless_class* result=classes().get(name);
           if(!result)
                   if(const Method *method=main_class.get_element_method(autouse_method_name)){
                           Value *vname=new VString(name);
                           CONSTRUCTOR_FRAME_ACTION(*method, 0 /*no parent*/, main_class, {
                                   frame.store_params(&vname, 1);
                                   // we don't need the result
                                   call(frame);
                           });
                           result=classes().get(name);
                   }
           return result;
   }
   
   static void load_charset(HashStringValue::key_type akey, HashStringValue::value_type avalue, Request_charsets* charsets) {
           pa_charsets.load_charset(*charsets, akey, avalue->as_string());
   }
   
   
   #define CONF_OPTION(config, name, code, exception_name)         \
           if(config)                                              \
                   if(Value* option=config->get_element(name)) {   \
                           if(option->is_evaluated_expr()) {       \
                                   code;                           \
                           } else                                  \
                                   throw Exception(PARSER_RUNTIME, 0, "$main:" exception_name, name.cstr()); \
                   }
   
   void Request::configure_admin(VStateless_class& conf_class) {
           if(configure_admin_done)
                   throw Exception(PARSER_RUNTIME, 0, "parser already configured");
           configure_admin_done=true;
           
           // charsets must only be specified in method_frame config
           // so that users would not interfere
   
           /* $MAIN:CHARSETS[
                           $.charsetname1[/full/path/to/charset/file.cfg]
                           ...
                   ]
           */
           if(Value* vcharsets=conf_class.get_element(charsets_name)) {
                   if(!vcharsets->is_string()) {
                           if(HashStringValue* charsets=vcharsets->get_hash())
                                   charsets->for_each<Request_charsets*>(load_charset, &this->charsets);
                           else
                                   throw Exception(PARSER_RUNTIME, 0, "$main:%s must be hash", charsets_name.cstr());
                   }
           }
   
   #ifdef STRICT_VARS
           VVoid::strict_vars=false;
           if(Value* strict_vars=conf_class.get_element(strict_vars_name)) {
                   if(strict_vars->is_bool())
                           VVoid::strict_vars=strict_vars->as_bool();
                   else
                           throw Exception(PARSER_RUNTIME, 0, "$main:%s must be bool", strict_vars_name.cstr());
           }
   #endif
   
   #ifdef OBJECT_PROTOTYPE
           VClass::prototype=true;
           if(Value* prototype=conf_class.get_element(prototype_name)) {
                   if(prototype->is_bool())
                           VClass::prototype=prototype->as_bool();
                   else
                           throw Exception(PARSER_RUNTIME, 0, "$main:%s must be bool", prototype_name.cstr());
           }
   #endif
   
           Value* limits=conf_class.get_element(limits_name);
   
           pa_loop_limit=LOOP_LIMIT;
           CONF_OPTION(limits, loop_limit_name, {
                   pa_loop_limit=option->as_int();
                   if(pa_loop_limit==0) pa_loop_limit=INT_MAX;
           }, "LIMITS.%s must be int");
   
           pa_execute_recoursion_limit=EXECUTE_RECOURSION_LIMIT;
           CONF_OPTION(limits, recoursion_limit_name, {
                   pa_execute_recoursion_limit=option->as_int();
                   if(pa_execute_recoursion_limit==0) pa_execute_recoursion_limit=INT_MAX;
           }, "LIMITS.%s must be int");
   
           pa_file_size_limit=FILE_SIZE_LIMIT;
           CONF_OPTION(limits, file_size_limit_name, {
                   double limit=option->as_double();
                   if(limit >= (double)SSIZE_MAX)
                           throw Exception(PARSER_RUNTIME, 0, "$main:LIMITS.%s must be less then %.15g", file_size_limit_name.cstr(), (double)SSIZE_MAX);
                   pa_file_size_limit=(size_t)limit;
                   if(pa_file_size_limit==0)
                           pa_file_size_limit=SSIZE_MAX;
           }, "LIMITS.%s must be number");
   
           pa_lock_attempts=PA_LOCK_ATTEMPTS;
           CONF_OPTION(limits, lock_wait_timeout_name, {
                   double limit=option->as_double();
                   if(limit >= 3600*24)
                           throw Exception(PARSER_RUNTIME, 0, "$main:LIMITS.%s must be less then %d", lock_wait_timeout_name.cstr(), 3600*24);
                   pa_lock_attempts=(unsigned int)(limit*2)+1;
           }, "LIMITS.%s must be number");
   
           Value* httpd=conf_class.get_element(httpd_name);
   
           pa_httpd_timeout=HTTPD_TIMEOUT;
           CONF_OPTION(httpd, httpd_timeout_name, {
                   pa_httpd_timeout=option->as_int();
                   if(pa_httpd_timeout==0) pa_httpd_timeout=INT_MAX;
           }, "HTTPD.%s must be int");
   
           if(httpd)
                   if(Value* option=httpd->get_element( httpd_mode_name)) {
                           if(option->get_junction())
                                   throw Exception(PARSER_RUNTIME, 0, "$main:HTTPD:mode must be string");
                           HTTPD_Server::set_mode(option->as_string());
                   }
   
           // configure method_frame options
           //      until someone with less privileges have overriden them
           methoded_array().configure_admin(*this);
 }  }
   
   const char* Request::get_exception_cstr(const Exception& e, Request::Exception_details& details) {
   
   #define PA_URI_FORMAT "%s: "
   #define PA_COMMENT_TYPE_FORMAT "%s [%s]"
   
   #define PA_ORIGIN_FILE_POS_FORMAT "%s(%d:%d): "
   #define PA_SOURCE_FORMAT "'%s' "
   
   #define PA_ORIGIN_FILE_POS_VALUE file_list[details.origin.file_no].cstr(), 1+details.origin.line, 1+details.origin.col,
   #define PA_SOURCE_VALUE details.problem_source->cstr(),
   
   #define EXCEPTION_CSTR(f1,v1,f2,v2) \
                           snprintf(result, MAX_STRING, \
                                   PA_URI_FORMAT \
                                   f1 f2 \
                                   PA_COMMENT_TYPE_FORMAT, \
                                   request_info.uri, \
                                   v1 v2 \
                                   e.comment(), e.type() \
                           );
   
           char* result=new(PointerFreeGC) char[MAX_STRING];
   
           if(details.problem_source) { // do we know the guy?
                   if(details.origin.file_no) // do whe know where he came from?
                           EXCEPTION_CSTR(PA_ORIGIN_FILE_POS_FORMAT, PA_ORIGIN_FILE_POS_VALUE, PA_SOURCE_FORMAT, PA_SOURCE_VALUE)
                   else
                           EXCEPTION_CSTR(PA_SOURCE_FORMAT, PA_SOURCE_VALUE,,)
           } else {
                   if(details.origin.file_no) // do whe know where he came from?
                           EXCEPTION_CSTR(PA_ORIGIN_FILE_POS_FORMAT, PA_ORIGIN_FILE_POS_VALUE,,)
                   else
                           EXCEPTION_CSTR(,,,)
           }
   
           return result;
   }
   
   void Request::configure() {
           // configure admin options if not configured yet
           if(!configure_admin_done)
                   configure_admin(main_class);
   
           // configure not-admin=user options
           methoded_array().configure_user(*this);
   
           // $MAIN:MIME-TYPES
           if(Value* element=main_class.get_element(mime_types_name))
                   if(Table *table=element->get_table())
                           mime_types=table;
   }
 /**  /**
         load MAIN class, execute @main.          load MAIN class, execute @main.
         MAIN class consists of all the auto.p files we'd manage to find          MAIN class consists of all the auto.p files we'd manage to find
Line 92  Request::Request(Pool& apool, Line 401  Request::Request(Pool& apool,
         all located classes become children of one another,          all located classes become children of one another,
         composing class we name 'MAIN'          composing class we name 'MAIN'
   
         @test get read of setlocale          @test log stack trace
   
 */  */
 void Request::core(const char *root_auto_path, bool root_auto_fail,  void Request::core(const char* config_filespec, bool header_only, const String &amain_method_name) {
                                    const char *site_auto_path, bool site_auto_fail,          try {
                                    bool header_only) {                  // loading config
         VStateless_class *main_class=0;                  if(config_filespec)
         bool need_rethrow=false;  Exception rethrow_me;                          use_file_directly(*new String(config_filespec));
         TRY {  
                 char *auto_filespec=(char *)malloc(MAX_STRING);                  // filling mail received
                   mail.fill_received(*this);
   
                   try {
                           // compile requested file
                           if(request_info.path_translated)
                                   use_file_directly(*new String(request_info.path_translated, String::L_TAINTED), true, true /* load auto.p files */);
                           configure();
                   } catch(...) {
                           configure(); // configure anyway, useful in @unhandled_exception [say, if they would want to mail by SMTP something]
                           rethrow;
                   }
   
                   // execute @main[]
                   const String* body_string=amain_method_name.is_empty() ? &String::Empty : execute_method(main_class, amain_method_name);
                   if(!body_string)
                           throw Exception(PARSER_RUNTIME, 0, "'%s' method not found", amain_method_name.cstr());
   
                   // extract response body
                   Value* body_value=response.fields().get(download_name_upper); // $response:download?
                   bool as_attachment=body_value!=0;
                   if(!body_value)
                           body_value=response.fields().get(body_name_upper); // $response:body
                   if(!body_value)
                           body_value=new VString(*body_string); // just result of ^main[]
   
                   // @postprocess
                   if(const Method *method=main_class.get_method(post_process_method_name)) {
                           // preparing to pass parameters to
                           //      @postprocess[data]
                           METHOD_FRAME_ACTION(*method, 0 /*no parent*/, main_class, {
                                   frame.store_params(&body_value, 1);
                                   call(frame);
                                   body_value=&frame.result();
                           });
                   }
   
                   VFile* body_file=body_value->as_vfile(flang, &charsets);
   
                   // OK. write out the result
                   output_result(body_file, header_only, as_attachment);
   
           } catch(const Exception& e) { // request handling problem
                   try {
                   // we're returning not result, but error explanation
   
                   Request::Exception_details details=get_details(e);
                   const char* exception_cstr=get_exception_cstr(e, details);
   
                   // reset language to default
                   flang=fdefault_lang;
                                   
                 // loading root auto.p                   // reset response
                 if(root_auto_path) {                  response.fields().clear();
                         String& filespec=*NEW String(pool());  
                         filespec.APPEND_CLEAN(root_auto_path, 0, "root_auto", 0);                  // this is what we'd return in $response:body
                         filespec.APPEND_CONST("/" AUTO_FILE_NAME);                  const String* body_string=0;
                         main_class=use_file(  
                                 filespec, root_auto_fail,                  // maybe we'd be lucky enough as to report an error
                                 main_class_name, main_class);                  // in a gracefull way...
                 }                  if(const Method *method=main_class.get_method(*new String(UNHANDLED_EXCEPTION_METHOD_NAME))) {
                           // preparing to pass parameters to 
                 // $MAIN:LIMITS hash used here,                          //      @unhandled_exception[exception;stack]
                 //      until someone with less privileges have overriden them  
                 {                          // $stack[^table::create{name   file    lineno  colno}]
                         Value *limits=main_class?main_class->get_element(*limits_name):0;                          Table::columns_type stack_trace_columns(new ArrayString);
                         if(StrEqNc(info.method, "post", true)) {                          *stack_trace_columns+=new String("name");
                                 // $limits.post_max_size default 10M                          *stack_trace_columns+=new String("file");
                                 Value *element=limits?limits->get_element(*post_max_size_name):0;                          *stack_trace_columns+=new String("lineno");
                                 size_t value=element?(size_t)element->as_double():0;                          *stack_trace_columns+=new String("colno");
                                 size_t post_max_size=value?value:MAX_POST_SIZE_DEFAULT;                          Table& stack_trace=*new Table(stack_trace_columns);
                                                           if(!exception_trace.is_empty()/*signed!*/) 
                                 size_t post_size=max(0, min(info.content_length, post_max_size));                                  for(size_t i=exception_trace.bottom_index(); i<exception_trace.top_index(); i++) {
                                 if(post_size) {                                          Trace trace=exception_trace.get(i);
                                         post_data=(char *)malloc(post_size);                                          Table::element_type row(new ArrayString);
                                         size_t read_size=SAPI::read_post(pool(), post_data, post_size);  
                                         if(read_size!=post_size)                                          *row+=trace.name(); // name column
                                                 THROW(0, 0,                                           Operation::Origin origin=trace.origin();
                                                         0,                                           if(origin.file_no) {
                                                         "post_size(%d)!=read_size(%d)",                                                   *row+=new String(file_list[origin.file_no], String::L_TAINTED); // 'file' column
                                                                 post_size, read_size);                                                  *row+=new String(String::Body::Format(1+origin.line), String::L_CLEAN); // 'lineno' column
                                                   *row+=new String(String::Body::Format(1+origin.col), String::L_CLEAN); // 'colno' column
                                           }
                                           stack_trace+=row;
                                 }                                  }
                         }  
   
                         form.fill_fields(*this);                          // future $response:body=
                           //   execute ^unhandled_exception[exception;stack]
                           exception_trace.clear(); // forget all about previous life, in case there would be error inside of this method, error handled  would not be mislead by old stack contents (see extract_origin)
   
                           Value *params[]={&details.vhash, new VTable(&stack_trace)};
                           METHOD_FRAME_ACTION(*method, 0 /*no caller*/, main_class, {
                                   frame.store_params(params, 2);
                                   call(frame);
                                   body_string=&frame.result().as_string();
                           });
                   }
                   
                   // conditionally log it
                   Value* vhandled=details.vhash.hash().get(exception_handled_part_name);
                   if(!vhandled || !vhandled->as_bool()) {
                           SAPI::log(sapi_info, "%s", exception_cstr);
                 }                  }
   
                 // filling cookies                  if(body_string) {  // could report an error beautifully?
                 cookie.fill_fields(*this);                          VString body_vstring(*body_string);
                           VFile* body_file=body_vstring.as_vfile(flang, &charsets);
                           // write it out the error
                           output_result(body_file, header_only, false);
                   } else {
                           // doing that ugly
                           SAPI::send_error(sapi_info, exception_cstr, !strcmp(e.type(), "file.missing") ? "404" : "500");
                   }
   
                 // loading site auto.p                  } catch(const Exception& e) { // exception in unhandled exception
                 if(site_auto_path) {                          Request::Exception_details details=get_details(e);
                         String& filespec=*NEW String(pool());                          const char* exception_cstr=get_exception_cstr(e, details);
                         filespec.APPEND_CLEAN(site_auto_path, 0, "site_auto", 0);                          // unconditionally log the beast in exception handler
                         filespec.APPEND_CONST("/" AUTO_FILE_NAME);                          throw Exception(0, 0, "Unhandled exception in %s", exception_cstr);
                         main_class=use_file(  
                                 filespec, site_auto_fail,  
                                 main_class_name, main_class);  
                 }                  }
           }
   }
   
   uint Request::register_file(String::Body file_spec) {
           file_list+=file_spec;
           return file_list.count()-1;
   }
   
   void Request::use_file_directly(const String& file_spec, bool fail_on_file_absence, bool with_auto_p) {
           // cyclic dependence check
           if(used_files.get(file_spec))
                   return;
           used_files.put(file_spec, true);
   
           if(!fail_on_file_absence && !entry_exists(file_spec)) // ignore file absence if asked for
                   return;
   
           if(with_auto_p) {
                 // loading auto.p files from document_root/..                   // loading auto.p files from document_root/.. 
                 // to the one beside requested file.                  // to the one beside requested file.
                 // all assigned bases from upper dir                  // all assigned bases from upper dir
                 {                  const char* target=file_spec.cstr();
                         /* /document/root */  
                         char *file_spec=                  // all relative paths are calculated from main document
                                 (char *)malloc(strlen(info.path_translated)+strlen(AUTO_FILE_NAME)+1);                  request_info.path_translated=target;
                         size_t document_root_size=strlen(info.document_root);  
                         if(info.document_root[document_root_size-1]=='/')                  const char* after=target;
                                 document_root_size--;                  size_t drlen=strlen(request_info.document_root);
                         memcpy(file_spec, info.document_root, document_root_size);                  if(memcmp(after, request_info.document_root, drlen)==0) {
                           after+=drlen;
                         /* /requested/file.html */                          if(after[-1]=='/') 
                         char *branches=(char *)malloc(strlen(info.path_translated)+1);                                  --after;
                         strcpy(branches, info.path_translated+document_root_size);  
                         char *next=branches;  
                         char *append_here=file_spec+document_root_size;  
   
                         size_t slash_auto_p_size=strlen("/" AUTO_FILE_NAME);  
                         while(true) {  
                                 char *step=lsplit(&next, '/');  
                                 if(next) { // not 'file.html' part  
                                         size_t step_size=strlen(step);  
                                         memcpy(append_here, step, step_size);  
                                         append_here+=step_size;  
                                         memcpy(append_here, "/" AUTO_FILE_NAME, slash_auto_p_size+1);  
                                         append_here++/* / */;  
   
                                         String& sfile_spec=*NEW String(pool());  
                                         sfile_spec.APPEND_CLEAN(file_spec, 0, "scanned", 0);  
                                         main_class=use_file(sfile_spec, false/*ignore read problem*/,  
                                                 main_class_name, main_class);  
                                 } else  
                                         break;  
                         }  
                 }                  }
   
                 // compiling requested file                  while(const char* before=strchr(after, '/')) {
                 String& spath_translated=*NEW String(pool());                          String& sfile_spec=*new String;
                 spath_translated.APPEND_CLEAN(info.path_translated, 0, "user-request", 0);                          if(after!=target) {
                 main_class=use_file(spath_translated, true/*don't ignore read problem*/,                                  sfile_spec.append_strdup(target, before-target, String::L_CLEAN);
                         main_class_name, main_class);                                  sfile_spec << "/" AUTO_FILE_NAME;
   
                 // $MAIN:DEFAULTS                                  use_file_directly(sfile_spec, false /*ignore absence, sole user*/);
                 Value *defaults=main_class->get_element(*defaults_name);  
                 // value must be allocated on request's pool for that pool used on  
                 // meaning constructing @see attributed_meaning_to_string  
                 default_content_type=defaults?defaults->get_element(*content_type_name):0;  
                 if(Value *element=main_class->get_element(*html_typo_name))  
                         if(Table *table=element->get_table())  
                                 pool().set_tag(table);  
   
                 // $MAIN:SQL.drivers  
                 if(Value *sql=main_class->get_element(*main_sql_name))  
                         if(Value *element=sql->get_element(*main_sql_drivers_name))  
                                 protocol2library=element->get_table();            
   
                 // $MAIN:MIME-TYPES  
                 if(Value *element=main_class->get_element(*mime_types_name))  
                         if(Table *table=element->get_table())  
                                 mime_types=table;                         
   
                 // $MAIN:LOCALE.ctype[Russian_Russia.1251]  
 /*  
 #define LC_ALL      0  
 #define LC_COLLATE  1  
 #define LC_CTYPE    2  
 #define LC_MONETARY 3  
 #define LC_NUMERIC  4  
 #define LC_TIME     5  
 */  
                 if(Value *locale=main_class->get_element(*locale_name))  
                         if(Value *element=locale->get_element(*locale_ctype_name)) {  
                                 const String& name=element->as_string();  
                                 if(!setlocale(LC_CTYPE, name.cstr()))  
                                         THROW(0, 0,  
                                                 &name,  
                                                 "locale is invalid");  
                         }                          }
                           for(after=before+1;*after=='/';after++);
                   }
           }
   
                 // $MAIN:MAIL[$SMTP[mail.design.ru]]          if(const char* source=file_read_text(charsets, file_spec, true))
                 if(Value *mail_element=main_class->get_element(*mail_name))                  use_buf(main_class, source, 0, register_file(file_spec));
                         if(!(mail=mail_element->get_hash()))  }
                                 THROW(0, 0,  
                                         0,  
                                         "$MAIN:MAIL is not hash");  
   
   
                 // execute @main[]  void Request::use_file(const String& file_name, const String* use_filespec/*absolute*/, bool with_auto_p) {
                 const String *body_string=execute_method(*main_class, *main_method_name);          if(file_name.is_empty())
                 if(!body_string)                  throw Exception(PARSER_RUNTIME, 0, "usage failed - no filename was specified");
                         THROW(0,0,  
                         0,           const String* filespec=0;
                         "'"MAIN_METHOD_NAME"' method not found");  
           if(file_name.first_char()=='/') //absolute path? [no need to scan MAIN:CLASS_PATH]
                   filespec=&full_disk_path(file_name);
           else if(use_filespec){ // search in current dir first
                   size_t last_slash_pos=use_filespec->strrpbrk("/");
                   if(last_slash_pos!=STRING_NOT_FOUND)
                           filespec=file_exist(use_filespec->mid(0, last_slash_pos), file_name); // found in current dir?
           }
   
                 VString body_vstring_before_post_process(*body_string);          if(!filespec){
                 VString *body_vstring_after_post_process=&body_vstring_before_post_process;                  // prevent multiple scan CLASS_PATH for searching one file
                                   if(searched_along_class_path.get(file_name))
                 // post-process                          return;
                 if(Value *value=main_class->get_element(*post_process_method_name))                  searched_along_class_path.put(file_name, true);
                         if(Junction *junction=value->get_junction())                  if(Value* element=main_class.get_element(class_path_name)) {
                                 if(const Method *method=junction->method) {                          if(element->is_string()) {
                                         // preparing to pass parameters to                                   filespec=file_exist(full_disk_path(element->as_string()), file_name); // found at class_path?
                                         //      @post-process[data]                          } else if(Table *table=element->get_table()) {
                                         VMethodFrame frame(pool(), *junction, false);                                  for(size_t i=table->count(); i--; ) {
                                         frame.set_self(*main_class);                                          const String& path=*(*table->get(i))[0];
                                           if(filespec=file_exist(full_disk_path(path), file_name))
                                         frame.store_param(method->name,                                                   break; // found along class_path
                                                 &body_vstring_before_post_process);  
                                         body_vstring_after_post_process=  
                                                 NEW VString(*execute_method(frame, *method));  
                                 }                                  }
                           } else
                                   throw Exception(PARSER_RUNTIME, 0, "$" CLASS_PATH_NAME " must be string or table");
                           if(!filespec)
                                   throw Exception(PARSER_RUNTIME, &file_name, "not found along $main:" CLASS_PATH_NAME);
                   } else 
                           throw Exception(PARSER_RUNTIME, &file_name, "usage failed - no $main:" CLASS_PATH_NAME " were specified");
           }
   
                 const VFile *body_file=body_vstring_after_post_process->as_vfile();          use_file_directly(*filespec, true, with_auto_p);
   }
   
                 // extract response body  void Request::use_file(const String& file_name, const String* use_filespec/*absolute*/, Operation::Origin origin) {
                 Value *body_value=static_cast<Value *>(          static String use("USE");
                         response.fields().get(*body_name));          try {
                 if(body_value) // there is some $request.body                  static VHash* voptions=new VHash();
                         body_file=body_value->as_vfile();                  if(const Method *method=main_class.get_method(use_method_name)){
                           Value *params[]={new VString(file_name), voptions};
                           voptions->hash().put(origin_key, new VString(*use_filespec));
   
                           CONSTRUCTOR_FRAME_ACTION(*method, 0 /*no parent*/, main_class, {
                                   frame.store_params(params, 2);
                                   // we don't need the result
                                   call(frame);
                           });
                   }
           } catch (...) {
                   exception_trace.push(Trace(&use, origin));
                   rethrow;
           }
   }
   
                 // OK. write out the result  void Request::use_buf(VStateless_class& aclass, const char* source, const String* main_alias, uint file_no, int line_no_offset) {
                 output_result(*body_file, header_only);          // temporary zero @conf to avoid it second execution
         }           Temp_method temp_method_conf(aclass, conf_method_name, 0);
         CATCH(e) { // request handling problem          // temporary zero @auto to avoid it second execution
                 // we're returning not result, but error explanation          Temp_method temp_method_auto(aclass, auto_method_name, 0);
                 TRY {  
                         // log the beast  
                         const String *problem_source=e.problem_source();  
                         if(problem_source)  
                                 SAPI::log(pool(),  
 #ifndef NO_STRING_ORIGIN  
                                         "%s(%d): "  
 #endif  
                                         "'%s' %s [%s %s]",  
 #ifndef NO_STRING_ORIGIN  
                                         problem_source->origin().file?problem_source->origin().file:"global",  
                                         problem_source->origin().line,  
 #endif  
                                         problem_source->cstr(String::UL_AS_IS),  
                                         e.comment(),  
                                         e.type()?e.type()->cstr(String::UL_AS_IS):"-",  
                                         e.code()?e.code()->cstr(String::UL_AS_IS):"-"  
                                 );  
                         else  
                                 SAPI::log(pool(),  
                                         "%s [%s %s]",  
                                         e.comment(),  
                                         e.type()?e.type()->cstr(String::UL_AS_IS):"-",  
                                         e.code()?e.code()->cstr(String::UL_AS_IS):"-"  
                                         );  
   
                         // reset language to default  
                         flang=fdefault_lang;  
                           
                         // reset response  
                         response.fields().clear();  
   
                         // this is what we'd return in $response:body  
                         const String *body_string=0;  
   
                         if(main_class) { // we've managed to end up with some main_class  
                                 // maybe we'd be lucky enough as to report an error  
                                 // in a gracefull way...  
                                 if(Value *value=main_class->get_element(*exception_method_name))  
                                         if(Junction *junction=value->get_junction())  
                                                 if(const Method *method=junction->method) {  
                                                         // preparing to pass parameters to   
                                                         //      @exception[origin;source;comment;type;code]  
                                                         VMethodFrame frame(pool(), *junction, false);  
                                                         frame.set_self(*main_class);  
   
                                                         const String *problem_source=e.problem_source();  
                                                         // origin  
                                                         Value *origin_value=0;  
 #ifndef NO_STRING_ORIGIN  
                                                         if(problem_source) {  
                                                                 const Origin& origin=problem_source->origin();  
                                                                 if(origin.file) {  
                                                                         char *buf=(char *)malloc(MAX_STRING);  
                                                                         snprintf(buf, MAX_STRING, "%s(%d):",   
                                                                                 origin.file, 1+origin.line);  
                                                                         String *origin_file_line=NEW String(pool(),  
                                                                                 buf, true);  
                                                                         origin_value=NEW VString(*origin_file_line);  
                                                                 }  
                                                         }  
 #endif  
                                                         frame.store_param(method->name,   
                                                                 origin_value?origin_value:NEW VUnknown(pool()));  
   
                                                         // source          // compile loaded classes
                                                         Value *source_value=0;          ArrayClass& cclasses=compile(&aclass, source, main_alias, file_no, line_no_offset);
                                                         if(problem_source) {  
                                                                 String& problem_source_copy=*NEW String(pool());  
                                                                 problem_source_copy.append(*problem_source,   
                                                                         flang, true);  
                                                                 source_value=NEW VString(problem_source_copy);  
                                                         }  
                                                         frame.store_param(method->name,   
                                                                 source_value?source_value:NEW VUnknown(pool()));  
   
                                                         // comment  
                                                         String *comment_value=NEW String(pool(),  
                                                                 e.comment(), true);  
                                                         frame.store_param(method->name,   
                                                                 NEW VString(*comment_value));  
   
                                                         // type  
                                                         Value *type_value;  
                                                         if(e.type()) {  
                                                                 String& type_copy=*NEW String(pool());  
                                                                 type_value=NEW VString(type_copy.append(*e.type(),   
                                                                         flang, true));  
                                                         } else  
                                                                 type_value=NEW VUnknown(pool());  
                                                         frame.store_param(method->name, type_value);  
   
                                                         // code  
                                                         Value *code_value;  
                                                         if(e.code()) {  
                                                                 String& code_copy=*NEW String(pool());  
                                                                 code_value=NEW VString(code_copy.append(*e.code(),   
                                                                         flang, true));  
                                                         } else  
                                                                 code_value=NEW VUnknown(pool());  
                                                         frame.store_param(method->name, code_value);  
   
                                                         // future $response:body=  
                                                         //   execute ^exception[origin;source;comment;type;code]  
                                                         body_string=execute_method(frame, *method);  
                                                 }  
                         }  
                           
                         if(!body_string) {  // couldn't report an error beautifully?  
                                 // doing that ugly  
   
                                 // make up result: $origin $source $comment $type $code  
                                 char *buf=(char *)malloc(MAX_STRING);  
                                 size_t printed=0;  
                                 const String *problem_source=e.problem_source();  
                                 if(problem_source) {  
 #ifndef NO_STRING_ORIGIN  
                                         const Origin& origin=problem_source->origin();  
                                         if(origin.file)  
                                                 printed+=snprintf(buf+printed, MAX_STRING-printed, "%s(%d): ",   
                                                 origin.file, 1+origin.line);  
 #endif  
                                         printed+=snprintf(buf+printed, MAX_STRING-printed, "'%s' ",   
                                                 problem_source->cstr(String::UL_AS_IS));  
                                 }  
                                 printed+=snprintf(buf+printed, MAX_STRING-printed, "%s",   
                                         e.comment());  
                                 const String *type=e.type();  
                                 if(type) {  
                                         printed+=snprintf(buf+printed, MAX_STRING-printed, "  type: %s",   
                                                 type->cstr(String::UL_AS_IS));  
                                         const String *code=e.code();  
                                         if(code)  
                                                 printed+=snprintf(buf+printed, MAX_STRING-printed, ", code: %s",   
                                                 code->cstr(String::UL_AS_IS));  
                                 }  
   
                                 // future $response:content-type          VString* vfilespec=
                                 response.fields().put(*content_type_name,                   new VString(*new String(file_list[file_no], String::L_TAINTED));
                                         NEW VString(*NEW String(pool(), UNHANDLED_EXCEPTION_CONTENT_TYPE)));  
                                 // future $response:body  
                                 body_string=NEW String(pool(), buf);  
                         }  
   
                         const VString body_vstring(*body_string);          for(size_t i=0; i<cclasses.count(); i++){
                         const VFile *body_file=body_vstring.as_vfile();                  VStateless_class& cclass=*cclasses.get(i);
   
                         // ERROR. write it out                  // locate and execute possible @conf[] static
                         output_result(*body_file, header_only);                  if(execute_method_if_exists(cclass, conf_method_name, vfilespec))
                 }                          configure_admin(cclass/*, executed.method->name*/);
                 CATCH(e) {  
                         // exception in request exception handler                  // locate and execute possible @auto[] static
                         // remember to rethrow it                  execute_method_if_exists(cclass, auto_method_name, vfilespec);
                         rethrow_me=e;  need_rethrow=true;   
                 }                  cclass.enable_default_setter();
                 END_CATCH  
         }          }
         END_CATCH // do not use pool() after this point - no exception handler set  }
                   // any throw() would try to use zero exception() pointer   
   
         if(need_rethrow) // were there an exception for us to rethrow?  const String& Request::relative(const char* apath, const String& relative_name) {
                 THROW(rethrow_me.type(), rethrow_me.code(),          char *hpath=pa_strdup(apath);
                         rethrow_me.problem_source(),          String& result=*new String;
                         rethrow_me.comment());          if(rsplit(hpath, '/')) // if something/splitted
                   result << hpath << "/";
           result << relative_name;
           return result;
 }  }
   
 VStateless_class *Request::use_file(const String& file_spec, bool fail_on_read_problem,  const String& Request::full_disk_path(const String& relative_name) {
                                                                         const String *name,           if(relative_name.first_char()=='/') {
                                                                         VStateless_class *base_class) {                  String& result=*new String(pa_strdup(request_info.document_root));
         // cyclic dependence check                  result << relative_name;
         if(used_files.get(file_spec))                  return result;
                 return base_class;          }
         used_files.put(file_spec, (Hash::Val *)true);          if(relative_name.pos("://")!=STRING_NOT_FOUND // something like "http://xxx"
   #ifdef WIN32
                   || relative_name.pos(":")==1  // DRIVE:
                   || relative_name.starts_with("\\\\") // UNC1
                   || relative_name.starts_with("//") // UNC2
   #endif
                   )
                   return relative_name;
   
           return relative(request_info.path_translated ? request_info.path_translated : request_info.document_root, relative_name);
   }
   
         char *source=file_read_text(pool(), file_spec, fail_on_read_problem);  #ifndef DOXYGEN
         if(!source)  class Add_header_attribute_info
                 return base_class;  {
   public:
           Add_header_attribute_info(Request& ar) : r(ar), add_last_modified(true) {}
           Request& r;
           bool add_last_modified;
   };
   #endif
   static void add_header_attribute(HashStringValue::key_type name, HashStringValue::value_type value, Add_header_attribute_info* info) {
           if(name==BODY_NAME_UPPER || name==DOWNLOAD_NAME_UPPER || name==CHARSET_NAME_UPPER)
                   return;
           
           if(name==LAST_MODIFIED_NAME_UPPER)
                   info->add_last_modified=false;
   
           const char* aname=String(name, String::L_URI).untaint_and_transcode_cstr(String::L_URI, &info->r.charsets);
   
         return use_buf(source, file_spec.cstr(), 0/*new class*/, name, base_class);          SAPI::add_header_attribute(info->r.sapi_info,
                           aname,
                           attributed_meaning_to_string(*value, String::L_URI, false).untaint_and_transcode_cstr(String::L_URI, &info->r.charsets)
                   );
 }  }
   
 VStateless_class *Request::use_buf(const char *source, const char *file,  static void output_sole_piece(Request& r, bool header_only, VFile& body_file, Value* body_file_content_type) {
                                                                    VStateless_class *aclass, const String *name,           // transcode text body when "text/*" or simple result
                                                                    VStateless_class *base_class) {          String::C output(body_file.value_ptr(), body_file.value_size());
         // compile loaded class          if(!body_file_content_type/*vstring.as_vfile*/ || body_file_content_type->as_string().pos("text/")==0)
         VStateless_class& cclass=COMPILE(source, aclass, name, base_class, file);                  output=Charset::transcode(output, r.charsets.source(), r.charsets.client());
   
         // locate and execute possible @auto[] static method          // prepare header: Content-Length
         execute_method(cclass, *auto_method_name, false /*no result needed*/);          SAPI::add_header_attribute(r.sapi_info, HTTP_CONTENT_LENGTH, format(output.length, "%u"));
         return &cclass;  
           // send header
           SAPI::send_header(r.sapi_info);
           
           // send body
           if(!header_only)
                   SAPI::send_body(r.sapi_info, output.str, output.length);
 }  }
   
 /**  #ifndef DOXYGEN
         - fail_if_junction(true, junction = fail  struct Range
         - fail_if_junction(false, not junction = fail  {
 */          uint64_t start;
 void Request::fail_if_junction_(bool is, Value& value,           uint64_t end;
                                                                 const String& method_name, const char *msg) {  };
   #endif
   
         if((value.get_junction()!=0) ^ !is)  #define UNSET ((uint64_t)-1)
                 THROW(0, 0,  
                         &method_name,  static void parse_range(const String* s, Array<Range> &ar) {
                         msg);          const char *p = s->cstr();
 }          if(s->starts_with("bytes="))
                   p += 6;
 const String& Request::relative(const char *apath, const String& relative_name) {          Range r;
         int lpath_buf_size=strlen(apath)+1;          while(*p){
     char *lpath=(char *)malloc(lpath_buf_size);                  r.start = UNSET;
         memcpy(lpath, apath, lpath_buf_size);                  r.end = UNSET;
     rsplit(lpath, '/');  
         String& result=*NEW String(pool(), lpath);                  while(*p==' ' || *p=='\t') p++;
     result << "/" << relative_name;  
     return result;                  if(*p >= '0' && *p <= '9'){
 }                          const char *s=p;
                           while(*p>='0' && *p<='9') p++;
 const String& Request::absolute(const String& relative_name) {                          r.start = pa_atoul(pa_strdup(s,p-s));
         char *relative_name_cstr=relative_name.cstr();                  }
         if(relative_name_cstr[0]=='/') {  
                 String& result=*NEW String(pool(), info.document_root);                  while(*p==' ' || *p=='\t') p++;
                 result << relative_name;  
                 return result;                  if(*p++ != '-') break;
         } else   
                 return relative(info.path_translated, relative_name);                  while(*p==' ' || *p=='\t') p++;
   
                   if(*p >= '0' && *p <= '9'){
                           const char *s=p;
                           while(*p>='0' && *p<='9') p++;
                           r.end = pa_atoul(pa_strdup(s,p-s));
                   }
   
                   while(*p==' ' || *p=='\t') p++;
   
                   if(*p)
                           if(*p++ != ',') break;
   
                   ar += r;
           }
 }  }
   
 static void add_header_attribute(const Hash::Key& aattribute, Hash::Val *ameaning,   struct Send_range_action_info {
                                                                  void *info) {          Request *r;
         String *attribute_to_exclude=static_cast<String *>(info);          uint64_t offset;
         if(aattribute==*attribute_to_exclude)          uint64_t part_length;
                 return;  };
   
   static void send_range(struct stat& /*finfo*/, int f, const String& /*file_spec*/, void *context){
           Send_range_action_info &info = *(Send_range_action_info*)context;
   
           pa_lseek(f, info.offset, SEEK_SET);
   
           const size_t BUFSIZE = 128*0x400;
           char buf[BUFSIZE];
           do{
                   size_t to_read = info.part_length < BUFSIZE ? (size_t)info.part_length : BUFSIZE;
                   size_t to_write = file_block_read(f, buf, to_read);
   
                   if(to_write == 0)
                           break;
   
                   size_t size = SAPI::send_body(info.r->sapi_info, buf, to_write);
                   if(size != to_write)
                           break;
   
                   info.part_length -= to_write;
           } while (info.part_length);
   }
   
   static void output_pieces(Request& r, bool header_only, const String& filename, uint64_t content_length, Value& date, bool add_last_modified) {
           SAPI::add_header_attribute(r.sapi_info, "accept-ranges", "bytes");
   
           const char *range = SAPI::Env::get(r.sapi_info, "HTTP_RANGE");
           uint64_t offset=0;
           uint64_t part_length=content_length;
   
           if(range && content_length){
                   Array<Range> ar;
                   parse_range(new String(range), ar);
                   int count = ar.count();
                   if(count == 1){
                           Range &rg = ar.get_ref(0);
   
                           if(rg.start == UNSET && rg.end == UNSET)
                                   return SAPI::send_error(r.sapi_info, "", "416");
   
                           if(rg.start == UNSET && rg.end != UNSET){
                                   if(rg.end > content_length)
                                           rg.end = content_length;
                                   rg.start = content_length - rg.end;
                                   rg.end =  content_length-1;
                           } else if(rg.start != UNSET && rg.end == UNSET){
                                   if(rg.start >= content_length)
                                           return SAPI::send_error(r.sapi_info, "", "416");
                                   rg.end = content_length-1;
                           } else {
                                   if(rg.start >= content_length || rg.start > rg.end)
                                           return SAPI::send_error(r.sapi_info, "", "416");
                                   if(rg.end >= content_length)
                                           rg.end = content_length-1;
                           }
   
                           offset = rg.start;
                           part_length = rg.end-rg.start+1;
   
                           char buf[MAX_STRING];
                           snprintf(buf, MAX_STRING, "bytes %.15g-%.15g/%.15g", (double)rg.start, (double)rg.end, (double)content_length);
                           SAPI::add_header_attribute(r.sapi_info, HTTP_STATUS, "206");
                           SAPI::add_header_attribute(r.sapi_info, "content-range", buf);
                   } else {
                           return SAPI::send_error(r.sapi_info, count ? "Multiple ranges not supported" : "Invalid range", count ? "501" : "400");
                   }
           }
   
           SAPI::add_header_attribute(r.sapi_info, HTTP_CONTENT_LENGTH, format((double)part_length, "%.15g"));
   
           if(add_last_modified)
                   SAPI::add_header_attribute(r.sapi_info, "last-modified", attributed_meaning_to_string(date, String::L_AS_IS, true).cstr());
   
         Value& lmeaning=*static_cast<Value *>(ameaning);          SAPI::send_header(r.sapi_info);
         Pool& pool=lmeaning.pool();  
   
         String attribute(pool);          if(!header_only){
         SAPI::add_header_attribute(pool,                  Send_range_action_info info = { &r, offset, part_length};
                 attribute.append(aattribute, String::UL_HTTP_HEADER, true).cstr(),                   file_read_action_under_lock(r.full_disk_path(filename), "send", send_range, &info);
                 attributed_meaning_to_string(lmeaning, String::UL_HTTP_HEADER).cstr());          }
 }  }
 void Request::output_result(const VFile& body_file, bool header_only) {  
   void Request::output_result(VFile* body_file, bool header_only, bool as_attachment) {
         // header: cookies          // header: cookies
         cookie.output_result();          cookie.output_result(sapi_info);
                   
         // set content-type          // $.file and $.name (when body is real vfile)
         if(String *body_file_content_type=static_cast<String *>(          Value* vfile = body_file->fields().get(response_body_file_name);
                 body_file.fields().get(*vfile_mime_type_name))) {          Value* vname = body_file->fields().get(name_name);
   
           const String* sfile = vfile ? &vfile->as_string() : NULL;
           const String* sname = vname ? &vname->as_string() : NULL;
   
           if(sname && *sname == NONAME_DAT)
                   sname = NULL;
   
           // Content-Disposition
           const String* disposition_name = sname ? sname->is_empty() ? NULL : sname : sfile;
           if(disposition_name) {
                   VHash& hash=*new VHash();
                   hash.hash().put(value_name, new VString(as_attachment ? content_disposition_attachment : content_disposition_inline));
                   hash.hash().put(content_disposition_filename_name, new VString(*new String(*disposition_name, String::L_HTTP_HEADER)));
                   response.fields().put(content_disposition_name_upper, &hash);
           }
   
           // _file_ content-type might be specified
           Value* body_file_content_type = body_file->fields().get(content_type_name);
           if(!body_file_content_type){
                   const String* scontent_name = sname && !sname->is_empty() ? sname : sfile;
                   if(scontent_name)
                           body_file_content_type = new VString(mime_type_of(scontent_name->cstr()));
           }
   
           // set Content-Type
           if(body_file_content_type) {
                 // body file content type                  // body file content type
                 response.fields().put(*content_type_name, body_file_content_type);                  response.fields().put(content_type_name_upper, body_file_content_type);
         } else {          } else {
                 // default content type                  // default content type
                 response.fields().put_dont_replace(*content_type_name,                   response.fields().put_dont_replace(content_type_name_upper, new VString(*new String(DEFAULT_CONTENT_TYPE)));
                         default_content_type?default_content_type  
                         :NEW VString(*NEW String(pool(), DEFAULT_CONTENT_TYPE)));  
         }  
   
         // content-disposition  
         if(VString *vfile_name=static_cast<VString *>(body_file.fields().get(*name_name))) {  
                 VHash& vhash=*NEW VHash(pool());  
                 vhash.hash().put(*content_disposition_filename_name, vfile_name);  
                 response.fields().put(*content_disposition_name, &vhash);  
         }  
   
         // prepare header: $response:fields without :body  
         response.fields().for_each(add_header_attribute, /*excluding*/ body_name);  
   
         // prepare...  
         const void *body=body_file.value_ptr();  
         size_t content_length=body_file.value_size();  
   
         // prepare header: content-length  
         if(content_length) { // useful for redirecting [header "location: http://..."]  
                 char content_length_cstr[MAX_NUMBER];  
                 snprintf(content_length_cstr, MAX_NUMBER, "%lu", content_length);  
                 SAPI::add_header_attribute(pool(), "content-length", content_length_cstr);  
         }          }
   
         // send header          // prepare header: $response:fields without :body, :download and :charset
         SAPI::send_header(pool());          Add_header_attribute_info info(*this);
                   response.fields().for_each<Add_header_attribute_info*>(add_header_attribute, &info);
         // send body  
         if(!header_only)          if(sfile) {
                 SAPI::send_body(pool(), body, content_length);                  // $response:[download|body][$.file[filespec]] -- optput specified file
                   uint64_t content_length=0;
                   time_t atime=0, mtime=0, ctime=0;
                   file_stat(full_disk_path(*sfile), content_length, atime, mtime, ctime);
   
                   VDate* vdate=0;
                   if(Value* v=body_file->fields().get("mdate")) {
                           if(Value* vdatep=v->as(VDATE_TYPE))
                                   vdate=static_cast<VDate*>(vdatep);
                           else 
                                   throw Exception(PARSER_RUNTIME, 0, "mdate must be a date");
                   }
                   if(!vdate)
                           vdate=new VDate((pa_time_t)mtime);
   
                   output_pieces(*this, header_only, *sfile, content_length, *vdate, info.add_last_modified);
           } else {
                   if(body_file_content_type)
                           if(HashStringValue *hash=body_file_content_type->get_hash())
                                   body_file_content_type=hash->get(value_name);
   
                   output_sole_piece(*this, header_only, *body_file, body_file_content_type);
           }
   }
   
   const String& Request::mime_type_of(const String* file_name) {
           return mime_type_of(file_name?file_name->taint_cstr(String::L_FILE_SPEC):0);
 }  }
   
 const String& Request::mime_type_of(const char *user_file_name_cstr) {  const String& Request::mime_type_of(const char* user_file_name_cstr) {
         if(mime_types)          if(mime_types)
                 if(const char *cext=strrchr(user_file_name_cstr, '.')) {                  if(const char* cext=strrchr(user_file_name_cstr, '.')) {
                         String sext(pool(), ++cext);                          String sext(++cext);
                         if(mime_types->locate(0, sext))                          Table::Action_options options;
                                 if(const String *result=mime_types->item(1))                          if(mime_types->locate(0, sext.change_case(charsets.source(), String::CC_LOWER), options)) {
                                   if(const String* result=mime_types->item(1))
                                         return *result;                                          return *result;
                                 else                                  else
                                         THROW(0, 0,                                          throw Exception(PARSER_RUNTIME, 0, MIME_TYPES_NAME " table column elements must not be empty");
                                                 mime_types->origin_string(),                          }
                                                 "MIME-TYPE table column elements must not be empty");  
                 }                  }
         return *NEW String(pool(), "application/octet-stream");  
 }  
   
   
           return *new String("application/octet-stream");
   }
   
   const String* Request::get_used_filespec(uint file_no){
           if(file_no < file_list.count())
                   return new String(file_list[file_no], String::L_TAINTED);
           return 0;
   }
   
   #ifdef XML
   xmlChar* Request::transcode(const String& s) {
           return charsets.source().transcode(s);
   }
   
   xmlChar* Request::transcode(const String::Body s) {
           return charsets.source().transcode(s);
   }
   
   const String& Request::transcode(const xmlChar* s) {
           return charsets.source().transcode(s);
   }
   #endif
   
   Request::Exception_details Request::get_details(const Exception& e) {
           const String* problem_source=e.problem_source();
           VHash& vhash=*new VHash;  HashStringValue& hash=vhash.hash();
           Operation::Origin origin={0, 0, 0};
   
           if(!exception_trace.is_empty()) {
                   Trace bottom=exception_trace.bottom_value();
                   origin=bottom.origin();
                   if(!problem_source) { // we don't know who trigged the bug
                           problem_source=bottom.name(); // we usually know source of next-from-throw-point exception did that
                           exception_trace.set_bottom_index(exception_trace.bottom_index()+1);
                   } else if (bottom.name()==problem_source) { // it is that same guy?
                           exception_trace.set_bottom_index(exception_trace.bottom_index()+1); // throw away that trace
                   } else {
                           // stack top contains not us, leaving intact to help ^throw
                   }
           }
   
           // $.type
           if(const char* type=e.type(true))
                   hash.put(exception_type_part_name, new VString(*new String(type)));
   
           // $.source
           if(problem_source)
                   hash.put(exception_source_part_name, new VString(*new String(*problem_source, String::L_TAINTED)));
   
           // $.file $.lineno $.colno
           if(origin.file_no){
                   hash.put("file", new VString(*new String(file_list[origin.file_no], String::L_TAINTED)));
                   hash.put("lineno", new VInt(1+origin.line));
                   hash.put("colno", new VInt(1+origin.col));
           }
   
           // $.comment
           if(const char* comment=e.comment(true))
                   hash.put(exception_comment_part_name, new VString(*new String(comment, String::L_TAINTED)));
   
           // $.handled(0)
           hash.put(exception_handled_part_name, &VBool::get(false));
   
           return Request::Exception_details(origin, problem_source, vhash);
   }
   
   Temp_value_element::Temp_value_element(Request& arequest, Value& awhere, const String& aname, Value* awhat) :
           frequest(arequest),
           fwhere(awhere),
           fname(aname),
           saved(awhere.get_element(aname))
   {
           Junction* junction;
           if(saved && (junction=saved->get_junction()) && junction->is_getter)
                   saved=0;
           frequest.put_element(fwhere, aname, awhat);
   }
   
   Temp_value_element::~Temp_value_element() {
           frequest.put_element(fwhere, fname, saved ? saved : VVoid::get());
   }

Removed from v.1.105  
changed lines
  Added in v.1.404


E-mail: