Annotation of parser3/src/main/pa_request.C, revision 1.245.2.37.2.24

1.54      paf         1: /** @file
1.55      paf         2:        Parser: request class main part. @see compile.C and execute.C.
                      3: 
1.245.2.5  paf         4:        Copyright (c) 2001-2003 ArtLebedev Group (http://www.artlebedev.com)
1.194     paf         5:        Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
1.218     paf         6: */
1.55      paf         7: 
1.245.2.37.2.  4(paf       8:3): static const char* IDENT_REQUEST_C="$Date: 2003/04/03 09:18:46 $";
1.1       paf         9: 
1.69      paf        10: #include "pa_sapi.h"
1.53      paf        11: #include "pa_common.h"
1.1       paf        12: #include "pa_request.h"
1.3       paf        13: #include "pa_wwrapper.h"
                     14: #include "pa_vclass.h"
1.31      paf        15: #include "pa_globals.h"
1.30      paf        16: #include "pa_vint.h"
1.112     paf        17: #include "pa_vmethod_frame.h"
1.32      paf        18: #include "pa_types.h"
1.245.2.27  paf        19: #include "pa_venv.h"
1.245.2.29  paf        20: #include "pa_vmath.h"
1.245.2.27  paf        21: #include "pa_vstatus.h"
                     22: #include "pa_vrequest.h"
1.78      paf        23: #include "pa_vtable.h"
1.90      paf        24: #include "pa_vfile.h"
1.147     parser     25: #include "pa_dictionary.h"
1.208     paf        26: #include "pa_charset.h"
1.186     paf        27: #include "pa_charsets.h"
1.245.2.4  paf        28: #include "pa_cache_managers.h"
1.245.2.34  paf        29: #include "pa_vmail.h"
1.245.2.36  paf        30: #include "pa_vform.h"
                     31: #include "pa_vcookie.h"
                     32: #include "pa_vresponse.h"
1.245.2.37.2.  5(paf      33:3): #include "pa_vmemory.h"
1.159     parser     34: 
1.245.2.3  paf        35: // consts
                     36: 
1.245.2.5  paf        37: const char* UNHANDLED_EXCEPTION_METHOD_NAME="unhandled_exception";
1.207     paf        38: 
1.82      paf        39: /// content type of exception response, when no @MAIN:exception handler defined
1.245.2.5  paf        40: const char* UNHANDLED_EXCEPTION_CONTENT_TYPE="text/plain";
1.82      paf        41: 
                     42: /// content type of response when no $MAIN:defaults.content-type defined
1.245.2.5  paf        43: const char* DEFAULT_CONTENT_TYPE="text/html";
                     44: const char* ORIGINS_CONTENT_TYPE="text/plain";
1.82      paf        45: 
1.245.2.6  paf        46: // defines for globals
                     47: 
1.245.2.12  paf        48: #define MAIN_METHOD_NAME "main"
1.245.2.16  paf        49: #define AUTO_METHOD_NAME "auto"
1.245.2.14  paf        50: #define BODY_NAME "body"
1.245.2.37.2.  3(paf      51:3): #define EXCEPTION_TYPE_PART_NAME "type"
                     52:3): #define EXCEPTION_SOURCE_PART_NAME "source"
                     53:3): #define EXCEPTION_COMMENT_PART_NAME "comment"
                     54:3): #define EXCEPTION_HANDLED_PART_NAME "handled"
1.245.2.12  paf        55: 
1.245.2.3  paf        56: // globals
                     57: 
1.245.2.37.2.  (paf       58:): const String main_method_name(MAIN_METHOD_NAME);
                     59:): const String auto_method_name(AUTO_METHOD_NAME);
                     60:): const String content_disposition_name(CONTENT_DISPOSITION_NAME);
                     61:): const String content_disposition_value(CONTENT_DISPOSITION_VALUE);
                     62:): const String content_disposition_filename_name(CONTENT_DISPOSITION_FILENAME_NAME);
                     63:): const String body_name(BODY_NAME);
          3(paf      64:3): const String exception_type_part_name(EXCEPTION_TYPE_PART_NAME);
                     65:3): const String exception_source_part_name(EXCEPTION_SOURCE_PART_NAME);
                     66:3): const String exception_comment_part_name(EXCEPTION_COMMENT_PART_NAME);
                     67:3): const String exception_handled_part_name(EXCEPTION_HANDLED_PART_NAME);
1.245.2.3  paf        68: 
1.245.2.6  paf        69: // defines for statics
                     70: 
                     71: #define CHARSETS_NAME "CHARSETS"
                     72: #define MIME_TYPES_NAME "MIME-TYPES"
                     73: #define ORIGINS_MODE_NAME "ORIGINS"
                     74: #define CONF_METHOD_NAME "conf"
                     75: #define POST_PROCESS_METHOD_NAME "postprocess"
                     76: #define DOWNLOAD_NAME "download"
                     77: #define CLASS_PATH_NAME "CLASS_PATH"
                     78: 
                     79: // statics
                     80: 
1.245.2.37.2.  (paf       81:): static const String charsets_name(CHARSETS_NAME);
                     82:): static const String main_class_name(MAIN_CLASS_NAME);
                     83:): static const String mime_types_name(MIME_TYPES_NAME);
                     84:): static const String origins_mode_name(ORIGINS_MODE_NAME);
                     85:): static const String conf_method_name(CONF_METHOD_NAME);
                     86:): static const String post_process_method_name(POST_PROCESS_METHOD_NAME);
                     87:): static const String download_name(DOWNLOAD_NAME);
                     88:): static const String class_path_name(CLASS_PATH_NAME);
1.245.2.6  paf        89: 
1.245.2.7  paf        90: // defines
1.245.2.6  paf        91: 
1.233     paf        92: // op.C
1.245.2.37.2.  (paf       93:): VStateless_class& VClassMAIN_create();
1.123     paf        94: 
1.157     parser     95: //
1.245.2.37.2.  (paf       96:): Request::Request(SAPI_Info& asapi_info, Request_info& arequest_info, 
                     97:):               String::Language adefault_lang, bool status_allowed):
1.245.2.20  paf        98:        // private
                     99:        anti_endless_execute_recoursion(0),
                    100: 
                    101:        // public
                    102:        method_frame(0),
                    103:        rcontext(0),
                    104:        wcontext(0),
                    105:        flang(adefault_lang),
1.245.2.37.2.  7(paf     106:3):     fconnection(0),
1.245.2.20  paf       107:        finterrupted(false),
                    108: 
                    109:        // public
                    110: #ifdef RESOURCES_DEBUG
                    111:        sql_connect_time(0),
                    112:        sql_request_time(0),
                    113: #endif 
                    114: 
                    115:        // public
1.245.2.4  paf       116:        sapi_info(asapi_info),
                    117:        request_info(arequest_info),
1.245.2.37.2.  (paf      118:):      charsets(UTF8_charset, UTF8_charset, UTF8_charset), // default charsets
1.245.2.6  paf       119: 
1.245.2.37.2.  (paf      120:):      main_class(VClassMAIN_create()),
                    121:):      form(*new VForm),
                    122:):      mail(*new VMail),
                    123:):      response(*new VResponse(arequest_info, charsets)),
                    124:):      cookie(*new VCookie),
1.245.2.20  paf       125: 
1.245.2.24  paf       126:        // private
                    127:        configure_admin_done(false),
                    128: 
1.245.2.20  paf       129:        // private defaults
                    130:        fdefault_lang(adefault_lang), 
                    131:        // private mime types
                    132:        mime_types(0)
1.245.2.4  paf       133: {
1.245.2.37.2.  0(paf     134:3):     // file_no=0 => unknown
                    135:3):     file_list+=StringBody("UNKNOWN");
          4(paf     136:3):     file_list+=StringBody("-body of process-"); // pseudo_file_no__process
          0(paf     137:3): 
1.178     paf       138:        // maybe expire old caches
1.245.2.4  paf       139:        cache_managers.maybe_expire();
1.178     paf       140:        
1.157     parser    141:        /// directly used
1.233     paf       142:        // MAIN class, operators
1.245.2.37.2.  (paf      143:):      classes().put(main_class.name(), &main_class);
1.157     parser    144:        // classes:
                    145:        // table, file, random, mail, image, ...
1.245.2.24  paf       146:        methoded_array().register_directly_used(*this);
1.157     parser    147: 
                    148:        /// methodless
                    149:        // env class
1.245.2.37.2.  1(paf     150:3):     classes().put(StringBody(ENV_CLASS_NAME), new VEnv(asapi_info));
1.175     paf       151:        // status class
1.179     paf       152:        if(status_allowed)
1.245.2.37.2.  1(paf     153:3):             classes().put(StringBody(STATUS_CLASS_NAME), new VStatus());
1.157     parser    154:        // request class
1.245.2.37.2.  1(paf     155:3):     classes().put(StringBody(REQUEST_CLASS_NAME), new VRequest(arequest_info, charsets));   
1.157     parser    156:        // cookie class
1.245.2.37.2.  1(paf     157:3):     classes().put(StringBody(COOKIE_CLASS_NAME), &cookie);
1.157     parser    158: 
                    159:        /// methoded
                    160:        // response class
1.245.2.37.2.  (paf      161:):      classes().put(response.get_class()->name(), &response);
1.157     parser    162: 
                    163:        /// bases used
                    164:        // form class
1.245.2.37.2.  (paf      165:):      classes().put(form.get_class()->base_class()->name(), &form);
1.213     paf       166:        // mail class
1.245.2.37.2.  (paf      167:):      classes().put(mail.get_class()->base_class()->name(), &mail);
1.157     parser    168:        // math class
1.245.2.4  paf       169:        {
1.245.2.37.2.  (paf      170:):              Value& math=*new VMath;
                    171:):              classes().put(math.get_class()->base_class()->name(), &math);
          5(paf     172:3):     }
                    173:3):     // memory class
                    174:3):     {
                    175:3):             Value& memory=*new VMemory;
                    176:3):             classes().put(memory.get_class()->base_class()->name(), &memory);
1.245.2.4  paf       177:        }
1.117     paf       178: }
1.192     paf       179: 
                    180: Request::~Request() {
                    181: #ifdef XML
                    182:        // if for some strange reason xml generic errors failed to be reported, free them up
1.245.2.5  paf       183:        if(const char* xml_generic_errors=xmlGenericErrors()) {
1.245.2.30  paf       184:                SAPI::log(sapi_info, "warning: unreported xmlGenericErrors: %s", xml_generic_errors);
1.192     paf       185:                free((void *)xml_generic_errors);
                    186:        }
                    187: #endif
                    188: }
1.236     paf       189: 
1.245.2.37.2.  (paf      190:): Value& Request::get_self() { return method_frame/*always have!*/->self(); }
1.192     paf       191: 
1.245.2.6  paf       192: static void load_charset(HashStringValue::key_type akey, HashStringValue::value_type avalue, int) {
1.245.2.37.2.  (paf      193:):      ::charsets.load_charset(*new String(akey, String::L_CLEAN), avalue->as_string());
1.208     paf       194: }
1.245.2.37.2.  (paf      195:): void Request::configure_admin(VStateless_class& conf_class) {
1.208     paf       196:        if(configure_admin_done)
                    197:                throw Exception("parser.runtime",
1.245.2.37.2.  (paf      198:):              0,
1.208     paf       199:                "parser already configured");
                    200:        configure_admin_done=true;
                    201:        
1.227     paf       202:        // charsets must only be specified in method_frame config
1.208     paf       203:        // so that users would not interfere
                    204: 
                    205:        /* $MAIN:CHARSETS[
                    206:                        $.charsetname1[/full/path/to/charset/file.cfg]
                    207:                        ...
                    208:                ]
                    209:        */
1.245.2.37.2.  (paf      210:):      if(Value* vcharsets=conf_class.get_element(charsets_name, conf_class, false)) {
1.240     paf       211:                if(!vcharsets->is_string())
1.245.2.37.2.  (paf      212:):                      if(HashStringValue* charsets=vcharsets->get_hash())
1.245.2.6  paf       213:                                charsets->for_each(load_charset, 0);
1.240     paf       214:                        else
                    215:                                throw Exception("parser.runtime",
1.245.2.37.2.  (paf      216:):                                      0,
1.240     paf       217:                                        "$" MAIN_CLASS_NAME ":" CHARSETS_NAME " must be hash");
1.208     paf       218:        }
                    219: 
1.227     paf       220:        // configure method_frame options
1.208     paf       221:        //      until someone with less privileges have overriden them
1.245.2.24  paf       222:        methoded_array().configure_admin(*this);
1.208     paf       223: }
1.150     parser    224: 
1.64      paf       225: /**
                    226:        load MAIN class, execute @main.
                    227:        MAIN class consists of all the auto.p files we'd manage to find
                    228:        plus
                    229:        the file user requested us to process
                    230:        all located classes become children of one another,
                    231:        composing class we name 'MAIN'
1.180     paf       232: 
                    233:        @test log stack trace
                    234: 
1.64      paf       235: */
1.245.2.37.2.  (paf      236:): void Request::core(const char* config_filespec, bool config_fail_on_read_problem, bool header_only) {
1.183     paf       237: 
                    238: #ifdef RESOURCES_DEBUG
                    239: //measures
                    240: struct timeval mt[10];
                    241: //measure:before all
                    242: gettimeofday(&mt[0],NULL);
                    243: #endif
1.169     parser    244:        try {
1.211     paf       245:                // loading config
                    246:                if(config_filespec) {
1.245.2.37.2.  (paf      247:):                      const String& filespec=*new String(config_filespec);
                    248:):                      use_file(main_class,
1.233     paf       249:                                filespec, true/* ignore class_path */, 
                    250:                                config_fail_on_read_problem, true/* file must exist if 'fail on read problem' not set */);
1.29      paf       251:                }
1.8       paf       252: 
1.72      paf       253:                // loading auto.p files from document_root/.. 
                    254:                // to the one beside requested file.
                    255:                // all assigned bases from upper dir
                    256:                {
1.245.2.6  paf       257:                        const char* after=request_info.path_translated;
                    258:                        size_t drlen=strlen(request_info.document_root);
                    259:                        if(memcmp(after, request_info.document_root, drlen)==0) {
1.115     paf       260:                                after+=drlen;
                    261:                                if(after[-1]=='/') 
                    262:                                        --after;
                    263:                        }
                    264:                        
1.152     parser    265:                        int step=0;
1.245.2.5  paf       266:                        while(const char* before=strchr(after, '/')) {
1.245.2.37.2.  (paf      267:):                              String& sfile_spec=*new String;
1.245.2.6  paf       268:                                if(after!=request_info.path_translated) {
1.245.2.37.2.  8(paf     269:3):                                     sfile_spec.append_strdup(
1.245.2.6  paf       270:                                                request_info.path_translated, before-request_info.path_translated,
1.245.2.37.2.  (paf      271:):                                              String::L_CLEAN);
                    272:):                                      sfile_spec << "/" AUTO_FILE_NAME;
1.152     parser    273: 
1.245.2.37.2.  (paf      274:):                                      use_file(main_class,
1.233     paf       275:                                                sfile_spec, true/* ignore class_path */, 
                    276:                                                true/* fail on read problem */, false/* but ignore absence, sole user */);
1.115     paf       277:                                }
                    278:                                after=before+1;
1.72      paf       279:                        }
                    280:                }
1.34      paf       281: 
1.125     paf       282:                // compile requested file
1.245.2.37.2.  (paf      283:):              String& spath_translated=*new String;
          8(paf     284:3):             spath_translated.append_help_length(request_info.path_translated, 0, String::L_TAINTED);
          (paf      285:):              use_file(main_class,
1.233     paf       286:                        spath_translated, true/* ignore class_path */, 
                    287:                        true/* fail on read problem*/, true/* fail on abscence */);
1.214     paf       288: 
1.227     paf       289:                // configure method_frame options if not configured yet
1.214     paf       290:                if(!configure_admin_done)
1.245.2.37.2.  (paf      291:):                      configure_admin(main_class);
1.7       paf       292: 
1.227     paf       293:                // configure not-method_frame=user options
1.245.2.24  paf       294:                methoded_array().configure_user(*this);
1.124     paf       295: 
1.85      paf       296:                // $MAIN:MIME-TYPES
1.245.2.37.2.  (paf      297:):              if(Value* element=main_class.get_element(mime_types_name, main_class, false))
1.85      paf       298:                        if(Table *table=element->get_table())
                    299:                                mime_types=table;                       
1.102     paf       300: 
1.124     paf       301:                // filling form fields
1.245.2.37.2.  (paf      302:):              form.fill_fields_and_tables(charsets, request_info);
1.102     paf       303: 
1.124     paf       304:                // filling cookies
1.245.2.37.2.  (paf      305:):              cookie.fill_fields(request_info);
1.213     paf       306: 
                    307:                // filling mail received
1.245.2.37.2.  (paf      308:):              mail.fill_received(*this);
1.25      paf       309: 
1.183     paf       310: #ifdef RESOURCES_DEBUG
                    311: //measure:after compile
                    312: gettimeofday(&mt[1],NULL);
                    313: #endif
1.25      paf       314:                // execute @main[]
1.245.2.37.2.  (paf      315:):              const String* body_string=execute_virtual_method(main_class, main_method_name);
1.41      paf       316:                if(!body_string)
1.197     paf       317:                        throw Exception("parser.runtime",
1.245.2.37.2.  (paf      318:):                              0,
1.145     parser    319:                                "'"MAIN_METHOD_NAME"' method not found");
1.79      paf       320: 
1.183     paf       321: #ifdef RESOURCES_DEBUG
                    322:                //measure:after main
                    323: gettimeofday(&mt[2],NULL);
                    324: #endif
                    325: 
1.245.2.37.2.  (paf      326:):              VString& body_vstring_before_post_process=*new VString(*body_string);
                    327:):              VString* body_vstring_after_post_process=&body_vstring_before_post_process;
1.119     paf       328:                // @postprocess
1.245.2.37.2.  (paf      329:):              if(Value* value=main_class.get_element(post_process_method_name, main_class, false))
                    330:):                      if(Junction* junction=value->get_junction())
1.91      paf       331:                                if(const Method *method=junction->method) {
                    332:                                        // preparing to pass parameters to 
1.119     paf       333:                                        //      @postprocess[data]
1.245.2.37.2.  (paf      334:):                                      VMethodFrame frame(/*method->name, */ *junction, 0/*no parent*/);
1.245.2.8  paf       335:                                        frame.set_self(main_class);
1.91      paf       336: 
1.245.2.6  paf       337:                                        frame.store_param(body_vstring_before_post_process);
1.91      paf       338:                                        body_vstring_after_post_process=
1.245.2.37.2.  (paf      339:):                                              new VString(execute_method(frame, *method));
1.91      paf       340:                                }
1.90      paf       341: 
1.245.2.37.2.  (paf      342:):              VFile* body_file=body_vstring_after_post_process->as_vfile(
          6(paf     343:3):                     String::L_UNSPECIFIED, &charsets);
1.41      paf       344: 
1.45      paf       345:                // extract response body
1.245.2.37.2.  (paf      346:):              Value* body_value=response.fields().get(download_name);
1.244     paf       347:                bool as_attachment=body_value!=0;
                    348:                if(!body_value)
1.245.2.37.2.  (paf      349:):                      body_value=response.fields().get(body_name);
1.244     paf       350: 
1.216     paf       351:                if(body_value) // there is some $response:body
1.245.2.37.2.  6(paf     352:3):                     body_file=body_value->as_vfile(String::L_UNSPECIFIED, &charsets);
1.45      paf       353: 
1.183     paf       354: #ifdef RESOURCES_DEBUG
                    355: //measure:after postprocess
                    356: gettimeofday(&mt[3],NULL);             
                    357: #endif
                    358: 
1.45      paf       359:                // OK. write out the result
1.245.2.7  paf       360:                output_result(body_file, header_only, as_attachment);
1.183     paf       361: 
                    362: #ifdef RESOURCES_DEBUG
                    363:                //measure:after output_result
                    364: gettimeofday(&mt[9],NULL);             
                    365: t[9]=mt[9].tv_sec+mt[9].tv_usec/1000000.0;
                    366: 
                    367: double t[10];
                    368: for(int i=0;i<10;i++)
                    369:     t[i]=mt[i].tv_sec+mt[i].tv_usec/1000000.0;
                    370: //measure:log2 compile,main,postprocess,output
1.245.2.37.2.  (paf      371:): SAPI::log("rmeasure: %s,%.2f,%.2f,%.2f %.2f,%.2f %.2f", 
1.245.2.6  paf       372: request_info.uri,
1.183     paf       373: t[1]-t[0],
                    374: t[2]-t[1],
                    375: t[3]-t[2],
                    376: sql_connect_time,sql_request_time,
                    377: t[9]-t[3]
                    378: );
                    379: #endif
1.171     parser    380:        } catch(const Exception& e) { // request handling problem
1.76      paf       381:                // we're returning not result, but error explanation
1.245.2.37.2.  3(paf     382:3): //          try {
                    383:3): #define PA_URI_FORMAT "%s: "
                    384:3): #define PA_ORIGIN_FILE_POS_FORMAT "%s(%d:%d): "
                    385:3): #define PA_SOURCE_FORMAT "'%s' "
                    386:3): #define PA_COMMENT_TYPE_FORMAT "%s [%s]"
1.76      paf       387:                        // log the beast
1.245.2.37.2.  3(paf     388:3):                     Request::Exception_details details=get_details(e);
                    389:3): 
                    390:3):                     if(details.problem_source) { // do we know the guy?
                    391:3):                             if(details.trace) { // do whe know where he came from?
                    392:3):                                     Operation::Info origin=details.trace.origin();
                    393:3):                                     SAPI::log(sapi_info,
                    394:3):                                             PA_URI_FORMAT 
                    395:3):                                             PA_ORIGIN_FILE_POS_FORMAT 
                    396:3):                                             PA_SOURCE_FORMAT PA_COMMENT_TYPE_FORMAT,
                    397:3):                                             request_info.uri,
                    398:3):                                             file_list[origin.file_no], 1+origin.line, 1+origin.col,
                    399:3):                                             details.problem_source->cstr(),
                    400:3):                                             e.comment(), e.type()
                    401:3):                                     );
                    402:3):                             } else
                    403:3):                                     SAPI::log(sapi_info,
                    404:3):                                             PA_URI_FORMAT 
                    405:3):                                             PA_SOURCE_FORMAT PA_COMMENT_TYPE_FORMAT,
                    406:3):                                             request_info.uri,
                    407:3):                                             details.problem_source->cstr(),
                    408:3):                                             e.comment(), e.type()
                    409:3):                                     );
                    410:3):                     } else
1.245.2.6  paf       411:                                SAPI::log(sapi_info,
1.245.2.37.2.  3(paf     412:3):                                     PA_URI_FORMAT 
                    413:3):                                     PA_COMMENT_TYPE_FORMAT,
1.245.2.6  paf       414:                                        request_info.uri,
1.206     paf       415:                                        e.comment(), e.type()
1.180     paf       416:                                );
1.171     parser    417: 
1.43      paf       418:                        // reset language to default
                    419:                        flang=fdefault_lang;
                    420:                        
                    421:                        // reset response
1.245.2.37.2.  (paf      422:):                      response.fields().clear();
1.43      paf       423: 
                    424:                        // this is what we'd return in $response:body
1.245.2.37.2.  (paf      425:):                      const String* body_string=0;
1.43      paf       426: 
1.233     paf       427:                        // maybe we'd be lucky enough as to report an error
                    428:                        // in a gracefull way...
1.245.2.37.2.  (paf      429:):                      if(Value* value=main_class.get_element(
                    430:):                                      *new String(UNHANDLED_EXCEPTION_METHOD_NAME), 
                    431:):                                      main_class,
1.233     paf       432:                                        false)) {
1.245.2.37.2.  (paf      433:):                              if(Junction* junction=value->get_junction()) {
1.233     paf       434:                                        if(const Method *method=junction->method) {
1.245.2.37.2.  3(paf     435:3): // preparing to pass parameters to 
                    436:3): //  @unhandled_exception[exception;stack]
                    437:3): VMethodFrame frame(/*method->name, */ *junction, 0/*no caller*/);
                    438:3): frame.set_self(main_class);
                    439:3): 
                    440:3): // $exception
                    441:3): frame.store_param(details.vhash);
                    442:3): // $stack[^table::set{name  origin}]
                    443:3): Table::columns_type stack_trace_columns(new ArrayString);
                    444:3): *stack_trace_columns+=new String("name");
                    445:3): *stack_trace_columns+=new String("file");
                    446:3): *stack_trace_columns+=new String("lineno");
                    447:3): *stack_trace_columns+=new String("colno");
                    448:3): Table& stack_trace=*new Table(stack_trace_columns);
                    449:3): if(!exception_trace.is_empty()/*signed!*/) 
                    450:3):     for(size_t i=exception_trace.bottom_index(); i<=exception_trace.top_index(); i++) {
                    451:3):             Trace trace=exception_trace.get(i);
                    452:3):             Table::element_type row(new ArrayString);
                    453:3): 
                    454:3):             *row+=trace.name(); // name column
                    455:3):             Operation::Info origin=trace.origin();
                    456:3):             if(origin.file_no) {
                    457:3):                     *row+=new String(file_list[origin.file_no], String::L_TAINTED); // 'file' column
                    458:3):                     *row+=new String(StringBody::Format(1+origin.line), String::L_CLEAN); // 'lineno' column
                    459:3):                     *row+=new String(StringBody::Format(1+origin.col), String::L_CLEAN); // 'colno' column
                    460:3):             }
                    461:3):             stack_trace+=row;
                    462:3):     }
                    463:3): frame.store_param(*new VTable(&stack_trace));
                    464:3): 
                    465:3): // future $response:body=
                    466:3): //   execute ^unhandled_exception[exception;stack]
                    467:3): body_string=&execute_method(frame, *method);
1.233     paf       468:                                        }
                    469:                                }
1.30      paf       470:                        }
                    471:                        
1.41      paf       472:                        if(!body_string) {  // couldn't report an error beautifully?
                    473:                                // doing that ugly
                    474: 
                    475:                                // make up result: $origin $source $comment $type $code
1.245.2.37.2.  1(paf     476:3):                             char *buf=new(PointerFreeGC) char[MAX_STRING];
1.30      paf       477:                                size_t printed=0;
1.245.2.37.2.  (paf      478:):                              if(const String* problem_source=e.problem_source()) {
                    479:):                                      /*const String_fragment::Origin& origin=problem_source->origin();
1.30      paf       480:                                        if(origin.file)
1.180     paf       481:                                                printed+=snprintf(buf+printed, MAX_STRING-printed, 
1.245.2.37.2.  3(paf     482:3):                                                     PA_ORIGIN_FILE_POS_FORMAT, 
1.180     paf       483:                                                        origin.file, 1+origin.line
                    484:                                                );
1.41      paf       485:                                        printed+=snprintf(buf+printed, MAX_STRING-printed, "'%s' ", 
1.245.2.14  paf       486:                                                problem_source->cstr().get());
1.245.2.37.2.  (paf      487:):                                              */
1.30      paf       488:                                }
1.245.2.5  paf       489:                                if(const char* comment=e.comment(true))
1.206     paf       490:                                        printed+=snprintf(buf+printed, MAX_STRING-printed, "%s", comment);
1.245.2.5  paf       491:                                if(const char* type=e.type(true)) 
1.197     paf       492:                                        printed+=snprintf(buf+printed, MAX_STRING-printed, "  type: %s",  type);
1.43      paf       493: 
                    494:                                // future $response:content-type
1.245.2.37.2.  (paf      495:):                              response.fields().put(content_type_name, 
                    496:):                                      new VString(*new String(UNHANDLED_EXCEPTION_CONTENT_TYPE)));
1.43      paf       497:                                // future $response:body
1.245.2.37.2.  (paf      498:):                              body_string=new String(buf);
1.30      paf       499:                        }
1.41      paf       500: 
1.245.2.37.2.  (paf      501:):                      VString body_vstring(*body_string);
          6(paf     502:3):                     VFile* body_file=body_vstring.as_vfile(String::L_UNSPECIFIED, &charsets);
1.90      paf       503: 
1.45      paf       504:                        // ERROR. write it out
1.245.2.7  paf       505:                        output_result(body_file, header_only, false);
1.245.2.37.2.  3(paf     506:3): //          } catch(const Exception& ) {
                    507:3): //                  rethrow;
                    508:3): //          }
1.1       paf       509:        }
                    510: }
                    511: 
1.245.2.37.2.  4(paf     512:3): size_t Request::register_file(StringBody file_spec) {
                    513:3):     file_list+=file_spec;
                    514:3):     return file_list.count()-1;
                    515:3): }
                    516:3): 
1.245.2.37  paf       517: void Request::use_file(VStateless_class& aclass,
1.245.2.37.2.  0(paf     518:3):                    const String& file_name, bool ignore_class_path, 
                    519:3):                    bool fail_on_read_problem, bool fail_on_file_absence) {
1.73      paf       520:        // cyclic dependence check
1.148     parser    521:        if(used_files.get(file_name))
1.245.2.37  paf       522:                return;
1.245.2.2  paf       523:        used_files.put(file_name, true);
1.73      paf       524: 
1.245.2.37.2.  (paf      525:):      const String* file_spec;
1.153     parser    526:        if(ignore_class_path) // ignore_class_path?
1.245.2.37.2.  (paf      527:):              file_spec=&file_name;
          4(paf     528:3):     else if(file_name.first_char()=='/') //absolute path? [no need to scan MAIN:CLASS_PATH]
          (paf      529:):              file_spec=&absolute(file_name);
1.153     parser    530:        else {
1.245.2.37.2.  (paf      531:):              file_spec=0;
                    532:):              if(Value* element=main_class.get_element(class_path_name, main_class, false)) {
1.233     paf       533:                        if(element->is_string()) {
1.245.2.37.2.  (paf      534:):                              file_spec=file_readable(absolute(element->as_string()), file_name); // found at class_path?
1.233     paf       535:                        } else if(Table *table=element->get_table()) {
1.245.2.6  paf       536:                                int size=table->count();
1.233     paf       537:                                for(int i=size; i--; ) {
1.245.2.37.2.  (paf      538:):                                      const String& path=*(*table->get(i))[0];
                    539:):                                      if(file_spec=file_readable(absolute(path), file_name))
1.233     paf       540:                                                break; // found along class_path
                    541:                                }
                    542:                        } else
                    543:                                throw Exception("parser.runtime",
1.245.2.37.2.  (paf      544:):                                      0,
1.233     paf       545:                                        "$" CLASS_PATH_NAME " must be string or table");
                    546:                        if(!file_spec)
                    547:                                throw Exception("parser.runtime",
1.245.2.37.2.  (paf      548:):                                      &file_name,
1.233     paf       549:                                        "not found along " MAIN_CLASS_NAME ":" CLASS_PATH_NAME);
                    550:                }
1.153     parser    551:                if(!file_spec)
1.197     paf       552:                        throw Exception("parser.runtime",
1.245.2.37.2.  (paf      553:):                              &file_name,
1.203     paf       554:                                "usage failed - no $" MAIN_CLASS_NAME  ":" CLASS_PATH_NAME " were specified");
1.148     parser    555:        }
1.230     paf       556: 
                    557:        if(fail_on_read_problem && !fail_on_file_absence) // ignore file absence if asked for
1.245.2.37.2.  (paf      558:):              if(!entry_exists(*file_spec))
1.245.2.37  paf       559:                        return;
1.73      paf       560: 
1.245.2.37.2.  (paf      561:):      if(const char* source=file_read_text(charsets.source(), *file_spec, fail_on_read_problem))
          4(paf     562:3):             use_buf(aclass, source, register_file(*file_spec));
1.16      paf       563: }
                    564: 
1.208     paf       565: 
1.245.2.37  paf       566: void Request::use_buf(VStateless_class& aclass,
1.245.2.37.2.  0(paf     567:3):                   const char* source, 
                    568:3):                   uint file_no) {
1.233     paf       569:        // temporary zero @conf so to maybe-replace it in compiled code
1.245.2.37.2.  (paf      570:):      Temp_method temp_method_conf(aclass, conf_method_name, 0);
1.233     paf       571:        // temporary zero @auto so to maybe-replace it in compiled code
1.245.2.37.2.  (paf      572:):      Temp_method temp_method_auto(aclass, auto_method_name, 0);
1.233     paf       573: 
1.5       paf       574:        // compile loaded class
1.245.2.37.2.  0(paf     575:3):     VStateless_class& cclass=compile(&aclass, source, file_no);
1.212     paf       576: 
1.233     paf       577:        // locate and execute possible @conf[] static
1.245.2.37.2.  0(paf     578:3):     VString* vfilespec=
                    579:3):             new VString(*new String(file_list[file_no], String::L_TAINTED));
1.245.2.26  paf       580:        Execute_nonvirtual_method_result executed=execute_nonvirtual_method(cclass, 
1.245.2.6  paf       581:                conf_method_name, vfilespec,
1.245.2.26  paf       582:                false/*no string result needed*/);
                    583:        if(executed.method)
1.245.2.37.2.  (paf      584:):              configure_admin(cclass/*, executed.method->name*/);
1.208     paf       585: 
                    586:        // locate and execute possible @auto[] static
1.233     paf       587:        execute_nonvirtual_method(cclass, 
1.245.2.6  paf       588:                auto_method_name, vfilespec,
1.245.2.21  paf       589:                false/*no result needed*/);
1.19      paf       590: }
                    591: 
1.245.2.37.2.  (paf      592:): const String& Request::relative(const char* apath, const String& relative_name) {
                    593:):      char *hpath=strdup(apath);
                    594:):      String& result=*new String;
                    595:):      if(rsplit(hpath, '/')) // if something/splitted
                    596:):              result << hpath << "/";
                    597:):      result << relative_name;
                    598:):      return result;
1.19      paf       599: }
                    600: 
1.245.2.37.2.  (paf      601:): const String& Request::absolute(const String& relative_name) {
                    602:):      if(relative_name.first_char()=='/') {
                    603:):              String& result=*new String(strdup(request_info.document_root));
                    604:):              result << relative_name;
1.19      paf       605:                return result;
                    606:        } else 
1.245.2.37.2.  2(paf     607:3):             return relative_name.pos("://")==STRING_NOT_FOUND?
                    608:3):                     relative(request_info.path_translated, relative_name)
1.239     paf       609:                        :relative_name; // something like "http://xxx"
1.1       paf       610: }
1.45      paf       611: 
1.245.2.7  paf       612: static void add_header_attribute(
1.245.2.37.2.  (paf      613:):                               HashStringValue::key_type aattribute, 
                    614:):                               HashStringValue::value_type ameaning, 
                    615:):                               Request *r) {
                    616:):      if(aattribute==BODY_NAME
                    617:):              || aattribute==DOWNLOAD_NAME
                    618:):              || aattribute==CHARSET_NAME)
1.101     paf       619:                return;
                    620: 
1.245.2.7  paf       621:        SAPI::add_header_attribute(r->sapi_info,
1.245.2.37.2.  (paf      622:):              aattribute.cstr(), 
          0(paf     623:3):             attributed_meaning_to_string(*ameaning, String::L_HTTP_HEADER, false).
          (paf      624:):                      cstr(String::L_UNSPECIFIED));
1.101     paf       625: }
1.245.2.37.2.  (paf      626:): void Request::output_result(VFile* body_file, bool header_only, bool as_attachment) {
1.51      paf       627:        // header: cookies
1.245.2.37.2.  (paf      628:):      cookie.output_result(sapi_info);
1.51      paf       629:        
1.245.2.37.2.  (paf      630:):      Value* body_file_content_type;
1.90      paf       631:        // set content-type
1.245.2.7  paf       632:        if(body_file_content_type=body_file->fields().get(content_type_name)) {
1.90      paf       633:                // body file content type
1.245.2.37.2.  (paf      634:):              response.fields().put(content_type_name, body_file_content_type);
1.90      paf       635:        } else {
                    636:                // default content type
1.245.2.37.2.  (paf      637:):              response.fields().put_dont_replace(content_type_name, 
                    638:):                      new VString(*new String(DEFAULT_CONTENT_TYPE)));
1.92      paf       639:        }
                    640: 
                    641:        // content-disposition
1.245.2.37.2.  (paf      642:):      if(Value* vfile_name=body_file->fields().get(name_name))
                    643:):              if(*vfile_name->get_string()!=NONAME_DAT) {
                    644:):                      VHash& hash=*new VHash();
                    645:):                      HashStringValue &h=hash.hash();
1.244     paf       646:                        if(as_attachment)
1.245.2.37.2.  (paf      647:):                              h.put(value_name, new VString(content_disposition_value));
1.245.2.7  paf       648:                        h.put(content_disposition_filename_name, vfile_name);
1.245.2.37.2.  (paf      649:):                      response.fields().put(content_disposition_name, &hash);
1.111     paf       650:                }
1.49      paf       651: 
1.62      paf       652:        // prepare header: $response:fields without :body
1.245.2.37.2.  (paf      653:):      response.fields().for_each(add_header_attribute, this);
1.50      paf       654: 
1.184     paf       655:        const void *client_body;
                    656:        size_t client_content_length;
1.220     paf       657:        // transcode text body when "text/*" or simple result
1.223     paf       658:        if(body_file_content_type)
1.245.2.37.2.  (paf      659:):              if(HashStringValue *hash=body_file_content_type->get_hash())
1.245.2.7  paf       660:                        body_file_content_type=hash->get(value_name);
1.245.2.37.2.  (paf      661:):      if(!body_file_content_type/*vstring.as_vfile*/ || body_file_content_type->as_string().pos("text/")==0) {
                    662:):              Charset::transcode(
1.245.2.7  paf       663:                        charsets.source(), body_file->value_ptr(), body_file->value_size(),
                    664:                        charsets.client(), client_body, client_content_length
1.220     paf       665:                );
                    666:        } else {
1.245.2.7  paf       667:                client_body=body_file->value_ptr();
                    668:                client_content_length=body_file->value_size();
1.220     paf       669:        }
1.50      paf       670: 
1.62      paf       671:        // prepare header: content-length
1.200     paf       672:        char content_length_cstr[MAX_NUMBER];
                    673:        snprintf(content_length_cstr, MAX_NUMBER, "%u", client_content_length);
1.245.2.7  paf       674:        SAPI::add_header_attribute(sapi_info, "content-length", content_length_cstr);
1.62      paf       675: 
                    676:        // send header
1.245.2.7  paf       677:        SAPI::send_header(sapi_info);
1.71      paf       678:        
1.62      paf       679:        // send body
                    680:        if(!header_only)
1.245.2.7  paf       681:                SAPI::send_body(sapi_info, client_body, client_content_length);
1.50      paf       682: }
1.104     paf       683: 
1.245.2.37.2.  (paf      684:): const String& Request::mime_type_of(const char* user_file_name_cstr) {
1.104     paf       685:        if(mime_types)
1.245.2.5  paf       686:                if(const char* cext=strrchr(user_file_name_cstr, '.')) {
1.245.2.7  paf       687:                        String sext(++cext);
1.245.2.37.2.  (paf      688:):                      if(mime_types->locate(0, sext.change_case(charsets.source(), String::CC_LOWER)))
                    689:):                                      if(const String* result=mime_types->item(1))
                    690:):                                              return *result;
1.104     paf       691:                                else
1.197     paf       692:                                        throw Exception("parser.runtime",
1.245.2.37.2.  (paf      693:):                                              0,
1.212     paf       694:                                                MIME_TYPES_NAME  " table column elements must not be empty");
1.104     paf       695:                }
1.245.2.7  paf       696: 
1.245.2.37.2.  (paf      697:):      return *new String("application/octet-stream");
1.233     paf       698: }
                    699: 
1.245.2.33  paf       700: #ifdef XML
1.245.2.37.2.  (paf      701:): GdomeDOMString_auto_ptr Request::transcode(const String& s) {
          4(paf     702:3):     return charsets.source().transcode(s);
                    703:3): }
                    704:3): 
                    705:3): GdomeDOMString_auto_ptr Request::transcode(const StringBody s) {
1.245.2.30  paf       706:        return charsets.source().transcode(s);
                    707: }
                    708: 
1.245.2.37.2.  3(paf     709:3): const String& Request::transcode(GdomeDOMString* s) {
                    710:3):     return charsets.source().transcode(s);
1.245.2.30  paf       711: }
                    712: 
1.245.2.37.2.  3(paf     713:3): const String& Request::transcode(xmlChar* s) {
                    714:3):     return charsets.source().transcode(s);
1.245.2.31  paf       715: }
1.245.2.34  paf       716: #endif
1.245.2.37.2.  3(paf     717:3): 
                    718:3): 
                    719:3): const Request::Trace Request::Exception_trace::extract_origin(const String*& problem_source) {
                    720:3):     Trace result;
                    721:3):     if(!is_empty()) {
                    722:3):             result=bottom_value();
                    723:3):             if(!problem_source) { // we don't know who trigged the bug?
                    724:3):                     problem_source=result.name(); // consider the stack-top-guy did that
                    725:3):                     fbottom++;
                    726:3):             } else if(result.name()==problem_source) // it is that same guy?
                    727:3):                     fbottom++; // throw away that trace
                    728:3):             else // stack top contains not us
                    729:3):                     result.clear();
                    730:3):     }
                    731:3): 
                    732:3):     return result;
                    733:3): }
                    734:3): 
                    735:3): Request::Exception_details Request::get_details(const Exception& e) {
                    736:3):     const String* problem_source=e.problem_source();
                    737:3):     Trace trace=exception_trace.extract_origin(problem_source);
                    738:3):     
                    739:3):     VHash& vhash=*new VHash;  HashStringValue& hash=vhash.hash();
                    740:3): 
                    741:3):     // $.type
                    742:3):     if(const char* type=e.type(true))
                    743:3):             hash.put(exception_type_part_name, new VString(*new String(type)));
                    744:3): 
                    745:3):     // $.source
                    746:3):     if(problem_source) {
                    747:3):             String& source=*new String; 
                    748:3):             source.append(*problem_source, String::L_TAINTED, true/*forced*/);
                    749:3): 
                    750:3):             hash.put(exception_source_part_name, new VString(source));
                    751:3):     }
                    752:3): 
                    753:3):     // $.file lineno colno
                    754:3):     if(trace) {
                    755:3):             const Operation::Info origin=trace.origin();
                    756:3):             hash.put(StringBody("file"),
                    757:3):                     new VString(*new String(file_list[origin.file_no], String::L_TAINTED)));
                    758:3):             hash.put(StringBody("lineno"), new VInt(1+origin.line));
                    759:3):             hash.put(StringBody("colno"), new VInt(1+origin.col));
                    760:3):     }
                    761:3): 
                    762:3):     // $.comment
                    763:3):     if(const char* comment=e.comment(true))
                    764:3):             hash.put(exception_comment_part_name, 
                    765:3):                     new VString(*new String(comment, 0, true/*tainted*/)));
                    766:3): 
                    767:3):     // $.handled(0)
                    768:3):     hash.put(exception_handled_part_name, new VBool(false));
                    769:3): 
                    770:3):     return Request::Exception_details(trace, problem_source, vhash);
                    771:3): }
                    772:3): 
                    773:3): //

E-mail: