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

1.54      paf         1: /** @file
1.55      paf         2:        Parser: request class main part. @see compile.C and execute.C.
                      3: 
1.329     moko        4:        Copyright (c) 2001-2012 Art. Lebedev Studio (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.69      paf         8: #include "pa_sapi.h"
1.53      paf         9: #include "pa_common.h"
1.1       paf        10: #include "pa_request.h"
1.3       paf        11: #include "pa_wwrapper.h"
                     12: #include "pa_vclass.h"
1.31      paf        13: #include "pa_globals.h"
1.30      paf        14: #include "pa_vint.h"
1.297     misha      15: #include "pa_vmethod_frame.h"
1.32      paf        16: #include "pa_types.h"
1.248     paf        17: #include "pa_venv.h"
                     18: #include "pa_vmath.h"
                     19: #include "pa_vstatus.h"
                     20: #include "pa_vrequest.h"
1.78      paf        21: #include "pa_vtable.h"
1.90      paf        22: #include "pa_vfile.h"
1.147     parser     23: #include "pa_dictionary.h"
1.208     paf        24: #include "pa_charset.h"
1.186     paf        25: #include "pa_charsets.h"
1.248     paf        26: #include "pa_cache_managers.h"
                     27: #include "pa_vmail.h"
                     28: #include "pa_vform.h"
                     29: #include "pa_vcookie.h"
                     30: #include "pa_vresponse.h"
                     31: #include "pa_vmemory.h"
1.253     paf        32: #include "pa_vconsole.h"
1.267     paf        33: #include "pa_vdate.h"
1.159     parser     34: 
1.347   ! moko       35: volatile const char * IDENT_PA_REQUEST_C="$Id: pa_request.C,v 1.346 2015/09/22 23:38:59 moko Exp $" IDENT_PA_REQUEST_H IDENT_PA_REQUEST_CHARSETS_H IDENT_PA_REQUEST_INFO_H IDENT_PA_VCONSOLE_H;
1.329     moko       36: 
1.248     paf        37: // consts
                     38: 
1.269     paf        39: #define UNHANDLED_EXCEPTION_METHOD_NAME "unhandled_exception"
1.207     paf        40: 
1.82      paf        41: /// content type of exception response, when no @MAIN:exception handler defined
1.248     paf        42: const char* UNHANDLED_EXCEPTION_CONTENT_TYPE="text/plain";
1.82      paf        43: 
                     44: /// content type of response when no $MAIN:defaults.content-type defined
1.248     paf        45: const char* DEFAULT_CONTENT_TYPE="text/html";
                     46: const char* ORIGINS_CONTENT_TYPE="text/plain";
                     47: 
                     48: // defines for globals
                     49: 
                     50: #define MAIN_METHOD_NAME "main"
                     51: #define AUTO_METHOD_NAME "auto"
1.309     misha      52: #define AUTOUSE_METHOD_NAME "autouse"
1.248     paf        53: #define EXCEPTION_TYPE_PART_NAME "type"
                     54: #define EXCEPTION_SOURCE_PART_NAME "source"
                     55: #define EXCEPTION_COMMENT_PART_NAME "comment"
                     56: 
                     57: // globals
                     58: 
                     59: const String main_method_name(MAIN_METHOD_NAME);
                     60: const String auto_method_name(AUTO_METHOD_NAME);
1.309     misha      61: const String autouse_method_name(AUTOUSE_METHOD_NAME);
1.311     misha      62: 
1.248     paf        63: const String exception_type_part_name(EXCEPTION_TYPE_PART_NAME);
                     64: const String exception_source_part_name(EXCEPTION_SOURCE_PART_NAME);
                     65: const String exception_comment_part_name(EXCEPTION_COMMENT_PART_NAME);
                     66: const String exception_handled_part_name(EXCEPTION_HANDLED_PART_NAME);
                     67: 
                     68: // defines for statics
                     69: 
                     70: #define CHARSETS_NAME "CHARSETS"
                     71: #define MIME_TYPES_NAME "MIME-TYPES"
1.330     moko       72: #define STRICT_VARS_NAME "STRICT-VARS"
1.248     paf        73: #define ORIGINS_MODE_NAME "ORIGINS"
                     74: #define CONF_METHOD_NAME "conf"
                     75: #define POST_PROCESS_METHOD_NAME "postprocess"
                     76: #define CLASS_PATH_NAME "CLASS_PATH"
1.277     paf        77: #define RESPONSE_BODY_FILE_NAME "file"
1.248     paf        78: 
1.344     moko       79: #define DOWNLOAD_NAME_UPPER "DOWNLOAD"
                     80: #define BODY_NAME_UPPER "BODY"
                     81: 
1.248     paf        82: // statics
                     83: 
                     84: static const String charsets_name(CHARSETS_NAME);
                     85: static const String main_class_name(MAIN_CLASS_NAME);
                     86: static const String mime_types_name(MIME_TYPES_NAME);
1.330     moko       87: static const String strict_vars_name(STRICT_VARS_NAME);
1.248     paf        88: static const String origins_mode_name(ORIGINS_MODE_NAME);
                     89: static const String conf_method_name(CONF_METHOD_NAME);
                     90: static const String post_process_method_name(POST_PROCESS_METHOD_NAME);
                     91: static const String class_path_name(CLASS_PATH_NAME);
1.277     paf        92: static const String response_body_file_name(RESPONSE_BODY_FILE_NAME);
1.248     paf        93: 
1.344     moko       94: static const String download_name_upper(DOWNLOAD_NAME_UPPER);
                     95: static const String body_name_upper(BODY_NAME_UPPER);
                     96: 
                     97: // more static
                     98: 
                     99: static const String content_type_name_upper(HTTP_CONTENT_TYPE_UPPER);
                    100: static const String content_disposition_name_upper(CONTENT_DISPOSITION_UPPER);
                    101: static const String content_disposition_inline(CONTENT_DISPOSITION_INLINE);
                    102: static const String content_disposition_attachment(CONTENT_DISPOSITION_ATTACHMENT);
                    103: 
1.248     paf       104: // defines
1.82      paf       105: 
1.344     moko      106: #define CHARSET_NAME_UPPER "CHARSET"
                    107: #define LAST_MODIFIED_NAME_UPPER "LAST-MODIFIED"
                    108: 
1.233     paf       109: // op.C
1.248     paf       110: VStateless_class& VClassMAIN_create();
1.123     paf       111: 
1.157     parser    112: //
1.248     paf       113: Request::Request(SAPI_Info& asapi_info, Request_info& arequest_info, 
1.325     moko      114:                                 String::Language adefault_lang):
1.248     paf       115:        // private
                    116:        anti_endless_execute_recoursion(0),
                    117: 
                    118:        // public
1.335     moko      119:        allow_class_replace(false),
1.248     paf       120:        method_frame(0),
                    121:        rcontext(0),
                    122:        wcontext(0),
                    123:        flang(adefault_lang),
1.191     paf       124:        fconnection(0),
1.307     misha     125:        finterrupted(false),
                    126:        fskip(SKIP_NOTHING),
                    127:        fin_cycle(0),
1.248     paf       128: 
                    129:        // public
1.257     paf       130:        request_info(arequest_info),
1.248     paf       131:        sapi_info(asapi_info),
                    132:        charsets(UTF8_charset, UTF8_charset, UTF8_charset), // default charsets
                    133: 
                    134:        main_class(VClassMAIN_create()),
1.260     paf       135:        form(*new VForm(charsets, arequest_info)),
1.248     paf       136:        mail(*new VMail),
                    137:        response(*new VResponse(arequest_info, charsets)),
1.298     misha     138:        cookie(*new VCookie(charsets, arequest_info)),
1.285     misha     139:        console(*new VConsole),
1.248     paf       140: 
                    141:        // private
                    142:        configure_admin_done(false),
                    143: 
                    144:        // private defaults
                    145:        fdefault_lang(adefault_lang), 
                    146:        // private mime types
                    147:        mime_types(0)
1.157     parser    148: {
1.261     paf       149:        pa_register_thread_request(*this);
                    150: 
1.248     paf       151:        // file_no=0 => unknown
1.347   ! moko      152:        file_list+="UNKNOWN";
        !           153:        file_list+="-body of process-"; // pseudo_file_no__process
1.186     paf       154: 
1.178     paf       155:        // maybe expire old caches
1.264     paf       156:        cache_managers->maybe_expire();
1.178     paf       157:        
1.157     parser    158:        /// directly used
1.233     paf       159:        // MAIN class, operators
1.235     paf       160:        classes().put(main_class.name(), &main_class);
1.157     parser    161:        // classes:
                    162:        // table, file, random, mail, image, ...
1.248     paf       163:        methoded_array().register_directly_used(*this);
1.157     parser    164: 
                    165:        /// methodless
                    166:        // env class
1.347   ! moko      167:        classes().put(ENV_CLASS_NAME, new VEnv(asapi_info));
1.175     paf       168:        // status class
1.347   ! moko      169:        classes().put(STATUS_CLASS_NAME, new VStatus());
1.157     parser    170:        // request class
1.347   ! moko      171:        classes().put(REQUEST_CLASS_NAME, new VRequest(arequest_info, charsets, form, asapi_info));
1.157     parser    172:        // cookie class
1.347   ! moko      173:        classes().put(COOKIE_CLASS_NAME, &cookie);
1.253     paf       174:        // console class
1.347   ! moko      175:        classes().put(CONSOLE_CLASS_NAME, &console);
1.157     parser    176:        /// methoded
                    177:        // response class
1.248     paf       178:        classes().put(response.get_class()->name(), &response);
1.157     parser    179: 
                    180:        /// bases used
                    181:        // form class
1.248     paf       182:        classes().put(form.get_class()->base_class()->name(), &form);
1.213     paf       183:        // mail class
1.248     paf       184:        classes().put(mail.get_class()->base_class()->name(), &mail);
1.157     parser    185:        // math class
1.248     paf       186:        {
                    187:                Value& math=*new VMath;
                    188:                classes().put(math.get_class()->base_class()->name(), &math);
                    189:        }
                    190:        // memory class
                    191:        {
                    192:                Value& memory=*new VMemory;
                    193:                classes().put(memory.get_class()->base_class()->name(), &memory);
                    194:        }
1.117     paf       195: }
1.192     paf       196: 
                    197: Request::~Request() {
                    198: #ifdef XML
                    199:        // if for some strange reason xml generic errors failed to be reported, free them up
1.248     paf       200:        if(const char* xml_generic_errors=xmlGenericErrors()) {
                    201:                SAPI::log(sapi_info, "warning: unreported xmlGenericErrors: %s", xml_generic_errors);
1.341     moko      202:                pa_free((void *)xml_generic_errors);
1.192     paf       203:        }
                    204: #endif
                    205: }
1.236     paf       206: 
1.248     paf       207: Value& Request::get_self() { return method_frame/*always have!*/->self(); }
1.192     paf       208: 
1.309     misha     209: Value* Request::get_class(const String& name){
                    210:        Value* result=classes().get(name);
1.313     misha     211:        if(!result)
1.309     misha     212:                if(Value* value=main_class.get_element(autouse_method_name))
                    213:                        if(Junction* junction=value->get_junction())
                    214:                                if(const Method *method=junction->method) {
                    215:                                        Value *vname=new VString(name);
1.322     moko      216:                                        VMethodFrame frame(*method, 0 /*no parent*/, main_class);
1.309     misha     217: 
                    218:                                        frame.store_params(&vname, 1);
                    219:                                        // we don't need the result
1.323     moko      220:                                        execute_method(frame);
1.309     misha     221: 
                    222:                                        result=classes().get(name);
                    223:                                }
1.313     misha     224: 
1.309     misha     225:        return result;
                    226: }
                    227: 
1.248     paf       228: static void load_charset(HashStringValue::key_type akey, 
                    229:                         HashStringValue::value_type avalue, 
                    230:                         Request_charsets* charsets) {
1.249     paf       231:        const String::Body NAME=String(akey, String::L_CLEAN).change_case(charsets->source(), String::CC_UPPER);
1.248     paf       232:        ::charsets.load_charset(*charsets, NAME, avalue->as_string());
1.208     paf       233: }
1.248     paf       234: void Request::configure_admin(VStateless_class& conf_class) {
1.208     paf       235:        if(configure_admin_done)
1.286     misha     236:                throw Exception(PARSER_RUNTIME,
1.248     paf       237:                0,
1.208     paf       238:                "parser already configured");
                    239:        configure_admin_done=true;
                    240:        
1.227     paf       241:        // charsets must only be specified in method_frame config
1.208     paf       242:        // so that users would not interfere
                    243: 
                    244:        /* $MAIN:CHARSETS[
                    245:                        $.charsetname1[/full/path/to/charset/file.cfg]
                    246:                        ...
                    247:                ]
                    248:        */
1.308     misha     249:        if(Value* vcharsets=conf_class.get_element(charsets_name)) {
1.342     moko      250:                if(!vcharsets->is_string()) {
1.248     paf       251:                        if(HashStringValue* charsets=vcharsets->get_hash())
1.281     paf       252:                                charsets->for_each<Request_charsets*>(load_charset, &this->charsets);
1.240     paf       253:                        else
1.286     misha     254:                                throw Exception(PARSER_RUNTIME,
1.240     paf       255:                                        0,
                    256:                                        "$" MAIN_CLASS_NAME ":" CHARSETS_NAME " must be hash");
1.342     moko      257:                }
1.208     paf       258:        }
                    259: 
1.330     moko      260: #ifdef STRICT_VARS
1.332     moko      261:        VVoid::strict_vars=false;
1.330     moko      262:        if(Value* strict_vars=conf_class.get_element(strict_vars_name)) {
                    263:                if(strict_vars->is_bool())
                    264:                        VVoid::strict_vars=strict_vars->as_bool();
                    265:                        else
                    266:                                throw Exception(PARSER_RUNTIME,
                    267:                                        0,
                    268:                                        "$" MAIN_CLASS_NAME ":" STRICT_VARS_NAME " must be bool");
                    269:        }
                    270: #endif
                    271: 
1.227     paf       272:        // configure method_frame options
1.208     paf       273:        //      until someone with less privileges have overriden them
1.248     paf       274:        methoded_array().configure_admin(*this);
1.208     paf       275: }
1.150     parser    276: 
1.269     paf       277: const char* Request::get_exception_cstr(
                    278:                                                                                const Exception& e,
                    279:                                                                                Request::Exception_details& details) {
                    280: #define PA_URI_FORMAT "%s: "
                    281: #define PA_ORIGIN_FILE_POS_FORMAT "%s(%d:%d): "
                    282: #define PA_SOURCE_FORMAT "'%s' "
                    283: #define PA_COMMENT_TYPE_FORMAT "%s [%s]"
                    284:        char* result=new(PointerFreeGC) char[MAX_STRING];
                    285: 
                    286:        if(details.problem_source) { // do we know the guy?
                    287:                if(details.trace) { // do whe know where he came from?
                    288:                        Operation::Origin origin=details.trace.origin();
                    289:                        snprintf(result, MAX_STRING, 
                    290:                                PA_URI_FORMAT 
                    291:                                PA_ORIGIN_FILE_POS_FORMAT 
                    292:                                PA_SOURCE_FORMAT PA_COMMENT_TYPE_FORMAT,
                    293:                                request_info.uri,
                    294:                                file_list[origin.file_no].cstr(), 1+origin.line, 1+origin.col,
                    295:                                details.problem_source->cstr(),
                    296:                                e.comment(), e.type()
                    297:                        );
                    298:                } else
                    299:                        snprintf(result, MAX_STRING, 
                    300:                                PA_URI_FORMAT 
                    301:                                PA_SOURCE_FORMAT PA_COMMENT_TYPE_FORMAT,
                    302:                                request_info.uri,
                    303:                                details.problem_source->cstr(),
                    304:                                e.comment(), e.type()
                    305:                        );
                    306:        } else
                    307:                snprintf(result, MAX_STRING, 
                    308:                        PA_URI_FORMAT 
                    309:                        PA_COMMENT_TYPE_FORMAT,
                    310:                        request_info.uri,
                    311:                        e.comment(), e.type()
                    312:                );
                    313: 
                    314:        return result;
                    315: }
1.272     paf       316: 
                    317: void Request::configure() {
                    318:        // configure admin options if not configured yet
                    319:        if(!configure_admin_done)
                    320:                configure_admin(main_class);
                    321: 
                    322:        // configure not-admin=user options
                    323:        methoded_array().configure_user(*this);
                    324: 
                    325:        // $MAIN:MIME-TYPES
1.308     misha     326:        if(Value* element=main_class.get_element(mime_types_name))
1.272     paf       327:                if(Table *table=element->get_table())
                    328:                        mime_types=table;                       
                    329: }
1.64      paf       330: /**
                    331:        load MAIN class, execute @main.
                    332:        MAIN class consists of all the auto.p files we'd manage to find
                    333:        plus
                    334:        the file user requested us to process
                    335:        all located classes become children of one another,
                    336:        composing class we name 'MAIN'
1.180     paf       337: 
                    338:        @test log stack trace
                    339: 
1.64      paf       340: */
1.248     paf       341: void Request::core(const char* config_filespec, bool config_fail_on_read_problem, bool header_only) {
1.169     parser    342:        try {
1.211     paf       343:                // loading config
                    344:                if(config_filespec) {
1.248     paf       345:                        const String& filespec=*new String(config_filespec);
1.318     misha     346:                        use_file_directly(main_class,
                    347:                                filespec,
1.248     paf       348:                                config_fail_on_read_problem, 
                    349:                                true /*file must exist if 'fail on read problem' not set*/);
1.29      paf       350:                }
1.8       paf       351: 
1.338     moko      352:                // filling mail received
                    353:                mail.fill_received(*this);
                    354: 
1.72      paf       355:                // loading auto.p files from document_root/.. 
                    356:                // to the one beside requested file.
                    357:                // all assigned bases from upper dir
                    358:                {
1.248     paf       359:                        const char* after=request_info.path_translated;
                    360:                        size_t drlen=strlen(request_info.document_root);
                    361:                        if(memcmp(after, request_info.document_root, drlen)==0) {
1.115     paf       362:                                after+=drlen;
                    363:                                if(after[-1]=='/') 
                    364:                                        --after;
                    365:                        }
                    366:                        
1.248     paf       367:                        while(const char* before=strchr(after, '/')) {
                    368:                                String& sfile_spec=*new String;
                    369:                                if(after!=request_info.path_translated) {
                    370:                                        sfile_spec.append_strdup(
                    371:                                                request_info.path_translated, before-request_info.path_translated,
                    372:                                                String::L_CLEAN);
1.152     parser    373:                                        sfile_spec << "/" AUTO_FILE_NAME;
                    374: 
1.318     misha     375:                                        use_file_directly(main_class,
1.248     paf       376:                                                sfile_spec, 
                    377:                                                true /*fail on read problem*/, 
                    378:                                                false /*but ignore absence, sole user*/);
1.115     paf       379:                                }
1.317     misha     380:                                for(after=before+1;*after=='/';after++);
1.72      paf       381:                        }
                    382:                }
1.34      paf       383: 
1.272     paf       384:                try {
                    385:                        // compile requested file
                    386:                        String& spath_translated=*new String;
                    387:                        spath_translated.append_help_length(request_info.path_translated, 0, String::L_TAINTED);
1.318     misha     388:                        use_file_directly(main_class, spath_translated);
1.272     paf       389: 
                    390:                        configure();
                    391:                } catch(...) {
                    392:                        configure(); // configure anyway, useful in @unhandled_exception [say, if they would want to mail by SMTP something]
                    393:                        rethrow;
                    394:                }
1.25      paf       395: 
                    396:                // execute @main[]
1.248     paf       397:                const String* body_string=execute_virtual_method(main_class, main_method_name);
1.41      paf       398:                if(!body_string)
1.286     misha     399:                        throw Exception(PARSER_RUNTIME,
1.248     paf       400:                                0,
1.340     moko      401:                                "'" MAIN_METHOD_NAME "' method not found");
1.79      paf       402: 
1.250     paf       403:                // extract response body
1.344     moko      404:                Value* body_value=response.fields().get(download_name_upper); // $response:download?
1.250     paf       405:                bool as_attachment=body_value!=0;
                    406:                if(!body_value)
1.344     moko      407:                        body_value=response.fields().get(body_name_upper); // $response:body
1.250     paf       408:                if(!body_value)
                    409:                        body_value=new VString(*body_string); // just result of ^main[]
                    410: 
1.119     paf       411:                // @postprocess
1.308     misha     412:                if(Value* value=main_class.get_element(post_process_method_name))
1.248     paf       413:                        if(Junction* junction=value->get_junction())
1.91      paf       414:                                if(const Method *method=junction->method) {
                    415:                                        // preparing to pass parameters to 
1.119     paf       416:                                        //      @postprocess[data]
1.322     moko      417:                                        VMethodFrame frame(*method, 0 /*no parent*/, main_class);
1.91      paf       418: 
1.300     misha     419:                                        frame.store_params(&body_value, 1);
1.323     moko      420:                                        execute_method(frame);
                    421: 
                    422:                                        body_value=&frame.result().as_value();
1.91      paf       423:                                }
1.90      paf       424: 
1.303     misha     425:                VFile* body_file=body_value->as_vfile(flang, &charsets);
1.41      paf       426: 
1.45      paf       427:                // OK. write out the result
1.248     paf       428:                output_result(body_file, header_only, as_attachment);
1.183     paf       429: 
1.171     parser    430:        } catch(const Exception& e) { // request handling problem
1.268     paf       431:                try {
1.76      paf       432:                // we're returning not result, but error explanation
1.269     paf       433: 
                    434:                Request::Exception_details details=get_details(e);
                    435:                const char* exception_cstr=get_exception_cstr(e, details);
1.258     paf       436: 
                    437:                // reset language to default
                    438:                flang=fdefault_lang;
                    439:                
                    440:                // reset response
                    441:                response.fields().clear();
                    442: 
                    443:                // this is what we'd return in $response:body
                    444:                const String* body_string=0;
                    445: 
                    446:                // maybe we'd be lucky enough as to report an error
                    447:                // in a gracefull way...
1.308     misha     448:                if(Value* value=main_class.get_element(*new String(UNHANDLED_EXCEPTION_METHOD_NAME))) {
1.258     paf       449:                        if(Junction* junction=value->get_junction()) {
                    450:                                if(const Method *method=junction->method) {
1.287     misha     451:                                        // preparing to pass parameters to 
                    452:                                        //      @unhandled_exception[exception;stack]
                    453: 
                    454:                                        // $stack[^table::create{name   file    lineno  colno}]
                    455:                                        Table::columns_type stack_trace_columns(new ArrayString);
                    456:                                        *stack_trace_columns+=new String("name");
                    457:                                        *stack_trace_columns+=new String("file");
                    458:                                        *stack_trace_columns+=new String("lineno");
                    459:                                        *stack_trace_columns+=new String("colno");
                    460:                                        Table& stack_trace=*new Table(stack_trace_columns);
                    461:                                        if(!exception_trace.is_empty()/*signed!*/) 
                    462:                                                for(size_t i=exception_trace.bottom_index(); i<exception_trace.top_index(); i++) {
                    463:                                                        Trace trace=exception_trace.get(i);
                    464:                                                        Table::element_type row(new ArrayString);
                    465: 
                    466:                                                        *row+=trace.name(); // name column
                    467:                                                        Operation::Origin origin=trace.origin();
                    468:                                                        if(origin.file_no) {
                    469:                                                                *row+=new String(file_list[origin.file_no], String::L_TAINTED); // 'file' column
                    470:                                                                *row+=new String(String::Body::Format(1+origin.line), String::L_CLEAN); // 'lineno' column
                    471:                                                                *row+=new String(String::Body::Format(1+origin.col), String::L_CLEAN); // 'colno' column
                    472:                                                        }
                    473:                                                        stack_trace+=row;
                    474:                                                }
                    475: 
1.323     moko      476:                                        // future $response:body=
                    477:                                        //   execute ^unhandled_exception[exception;stack]
                    478:                                        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)
                    479: 
                    480:                                        VMethodFrame frame(*method, 0 /*no caller*/, main_class);
1.300     misha     481:                                        Value *params[]={&details.vhash, new VTable(&stack_trace)};
1.323     moko      482: 
1.300     misha     483:                                        frame.store_params(params, 2);
1.323     moko      484:                                        execute_method(frame);
1.287     misha     485: 
1.323     moko      486:                                        body_string=&frame.result().as_string();
1.233     paf       487:                                }
1.30      paf       488:                        }
1.258     paf       489:                }
                    490:                
                    491:                if(!body_string) {  // couldn't report an error beautifully?
                    492:                        // doing that ugly
                    493: 
                    494:                        // future $response:content-type
1.344     moko      495:                        response.fields().put(content_type_name_upper, new VString(*new String(UNHANDLED_EXCEPTION_CONTENT_TYPE)));
1.258     paf       496:                        // future $response:body
1.269     paf       497:                        body_string=new String(exception_cstr);
1.258     paf       498:                }
1.41      paf       499: 
1.258     paf       500:                VString body_vstring(*body_string);
1.303     misha     501:                VFile* body_file=body_vstring.as_vfile(flang, &charsets);
1.90      paf       502: 
1.273     paf       503:                // conditionally log it
                    504:                Value* vhandled=details.vhash.hash().get(exception_handled_part_name);
                    505:                if(!vhandled || !vhandled->as_bool()) {
                    506:                        SAPI::log(sapi_info, "%s", exception_cstr);
                    507:                }
                    508: 
1.258     paf       509:                // ERROR. write it out
                    510:                output_result(body_file, header_only, false);
1.287     misha     511: 
1.273     paf       512:                } catch(const Exception& e) { // exception in unhandled exception
1.269     paf       513:                        Request::Exception_details details=get_details(e);
                    514:                        const char* exception_cstr=get_exception_cstr(e, details);
1.273     paf       515:                        // unconditionally log the beast
                    516:                        SAPI::log(sapi_info, "%s", exception_cstr);
1.269     paf       517: 
                    518:                        throw Exception(0,
                    519:                                0,
                    520:                                "in %s", 
                    521:                                        exception_cstr);
1.268     paf       522:                }
1.1       paf       523:        }
                    524: }
                    525: 
1.266     paf       526: uint Request::register_file(String::Body file_spec) {
1.248     paf       527:        file_list+=file_spec;
                    528:        return file_list.count()-1;
                    529: }
                    530: 
1.318     misha     531: void Request::use_file_directly(VStateless_class& aclass,
                    532:                                const String& file_spec,
                    533:                                bool fail_on_read_problem, 
                    534:                                bool fail_on_file_absence) {
                    535: 
1.73      paf       536:        // cyclic dependence check
1.318     misha     537:        if(used_files.get(file_spec))
1.248     paf       538:                return;
1.318     misha     539:        used_files.put(file_spec, true);
                    540: 
                    541:        if(fail_on_read_problem && !fail_on_file_absence) // ignore file absence if asked for
                    542:                if(!entry_exists(file_spec))
                    543:                        return;
                    544: 
                    545:        if(const char* source=file_read_text(charsets, file_spec, fail_on_read_problem))
                    546:                use_buf(aclass, source, 0, register_file(file_spec));
                    547: }
                    548: 
                    549: 
                    550: void Request::use_file(VStateless_class& aclass,
                    551:                                const String& file_name,
                    552:                                const String* use_filespec/*absolute*/) {
1.73      paf       553: 
1.326     misha     554:        if(file_name.is_empty())
                    555:                throw Exception(PARSER_RUNTIME,
                    556:                        0,
                    557:                        "usage failed - no filename was specified");
                    558: 
1.318     misha     559:        const String* filespec=0;
                    560: 
                    561:        if(file_name.first_char()=='/') //absolute path? [no need to scan MAIN:CLASS_PATH]
                    562:                filespec=&absolute(file_name);
                    563:        else if(use_filespec){ // search in current dir first
1.331     misha     564:                size_t last_slash_pos=use_filespec->strrpbrk("/");
                    565:                if(last_slash_pos!=STRING_NOT_FOUND)
                    566:                        filespec=file_exist(use_filespec->mid(0, last_slash_pos), file_name); // found in current dir?
1.318     misha     567:        }
                    568: 
                    569:        if(!filespec){
                    570:                // prevent multiple scan CLASS_PATH for searching one file
                    571:                if(searched_along_class_path.get(file_name))
                    572:                        return;
                    573:                searched_along_class_path.put(file_name, true);
1.308     misha     574:                if(Value* element=main_class.get_element(class_path_name)) {
1.233     paf       575:                        if(element->is_string()) {
1.318     misha     576:                                filespec=file_exist(absolute(element->as_string()), file_name); // found at class_path?
1.233     paf       577:                        } else if(Table *table=element->get_table()) {
1.318     misha     578:                                for(size_t i=table->count(); i--; ) {
1.248     paf       579:                                        const String& path=*(*table->get(i))[0];
1.318     misha     580:                                        if(filespec=file_exist(absolute(path), file_name))
1.233     paf       581:                                                break; // found along class_path
                    582:                                }
                    583:                        } else
1.286     misha     584:                                throw Exception(PARSER_RUNTIME,
1.233     paf       585:                                        0,
                    586:                                        "$" CLASS_PATH_NAME " must be string or table");
1.318     misha     587:                        if(!filespec)
1.286     misha     588:                                throw Exception(PARSER_RUNTIME,
1.233     paf       589:                                        &file_name,
                    590:                                        "not found along " MAIN_CLASS_NAME ":" CLASS_PATH_NAME);
1.318     misha     591:                } else 
1.286     misha     592:                        throw Exception(PARSER_RUNTIME,
1.153     parser    593:                                &file_name,
1.203     paf       594:                                "usage failed - no $" MAIN_CLASS_NAME  ":" CLASS_PATH_NAME " were specified");
1.148     parser    595:        }
1.230     paf       596: 
1.318     misha     597:        use_file_directly(aclass, *filespec);
1.16      paf       598: }
                    599: 
1.208     paf       600: 
1.248     paf       601: void Request::use_buf(VStateless_class& aclass,
1.318     misha     602:                                const char* source, const String* main_alias, 
                    603:                                uint file_no,
                    604:                                int line_no_offset) {
1.233     paf       605:        // temporary zero @conf so to maybe-replace it in compiled code
1.248     paf       606:        Temp_method temp_method_conf(aclass, conf_method_name, 0);
1.233     paf       607:        // temporary zero @auto so to maybe-replace it in compiled code
1.248     paf       608:        Temp_method temp_method_auto(aclass, auto_method_name, 0);
1.233     paf       609: 
1.295     misha     610:        // compile loaded classes
                    611:        ArrayClass& cclasses=compile(&aclass, source, main_alias, file_no, line_no_offset);
1.212     paf       612: 
1.248     paf       613:        VString* vfilespec=
                    614:                new VString(*new String(file_list[file_no], String::L_TAINTED));
1.295     misha     615: 
                    616:        for(size_t i=0; i<cclasses.count(); i++){
                    617:                VStateless_class& cclass=*cclasses.get(i);
1.296     misha     618: 
                    619:                // locate and execute possible @conf[] static
1.295     misha     620:                Execute_nonvirtual_method_result executed=execute_nonvirtual_method(cclass, 
                    621:                        conf_method_name, vfilespec,
                    622:                        false/*no string result needed*/);
                    623:                if(executed.method)
                    624:                        configure_admin(cclass/*, executed.method->name*/);
                    625: 
                    626:                // locate and execute possible @auto[] static
                    627:                execute_nonvirtual_method(cclass, 
                    628:                        auto_method_name, vfilespec,
                    629:                        false/*no result needed*/);
1.336     moko      630: 
                    631:                cclass.enable_default_setter();
1.295     misha     632:        }
1.19      paf       633: }
                    634: 
1.248     paf       635: const String& Request::relative(const char* apath, const String& relative_name) {
1.341     moko      636:        char *hpath=pa_strdup(apath);
1.248     paf       637:        String& result=*new String;
                    638:        if(rsplit(hpath, '/')) // if something/splitted
1.217     paf       639:                result << hpath << "/";
1.248     paf       640:        result << relative_name;
                    641:        return result;
1.19      paf       642: }
                    643: 
1.77      paf       644: const String& Request::absolute(const String& relative_name) {
1.217     paf       645:        if(relative_name.first_char()=='/') {
1.341     moko      646:                String& result=*new String(pa_strdup(request_info.document_root));
1.104     paf       647:                result << relative_name;
1.19      paf       648:                return result;
                    649:        } else 
1.248     paf       650:                if(relative_name.pos("://")!=STRING_NOT_FOUND // something like "http://xxx"
1.247     paf       651: #ifdef WIN32
                    652:                        || relative_name.pos(":")==1  // DRIVE:
                    653:                        || relative_name.starts_with("\\\\") // UNC1
                    654:                        || relative_name.starts_with("//") // UNC2
                    655: #endif
                    656:                        )
                    657:                        return relative_name;
                    658:                else
1.248     paf       659:                        return relative(request_info.path_translated, relative_name);
1.1       paf       660: }
1.45      paf       661: 
1.267     paf       662: #ifndef DOXYGEN
                    663: class Add_header_attribute_info
                    664: {
                    665: public:
                    666:        Add_header_attribute_info(Request& ar) : r(ar), add_last_modified(true) {}
                    667:        Request& r;
                    668:        bool add_last_modified;
                    669: };
                    670: #endif
1.344     moko      671: static void add_header_attribute(HashStringValue::key_type name, HashStringValue::value_type value, Add_header_attribute_info* info) {
                    672:        if(name==BODY_NAME_UPPER || name==DOWNLOAD_NAME_UPPER || name==CHARSET_NAME_UPPER)
1.101     paf       673:                return;
1.290     misha     674:        
1.345     moko      675:        if(name==LAST_MODIFIED_NAME_UPPER)
                    676:                info->add_last_modified=false;
                    677: 
1.316     misha     678:        const char* aname=String(name, String::L_URI).untaint_and_transcode_cstr(String::L_URI, &info->r.charsets);
1.101     paf       679: 
1.267     paf       680:        SAPI::add_header_attribute(info->r.sapi_info,
1.345     moko      681:                        aname,
1.316     misha     682:                        attributed_meaning_to_string(*value, String::L_URI, false).untaint_and_transcode_cstr(String::L_URI, &info->r.charsets)
1.303     misha     683:                );
1.267     paf       684: }
                    685: 
                    686: static void output_sole_piece(Request& r,
                    687:                                                          bool header_only, 
                    688:                                                          VFile& body_file,
                    689:                                                          Value* body_file_content_type) {
                    690:        // transcode text body when "text/*" or simple result
                    691:        String::C output(body_file.value_ptr(), body_file.value_size());
                    692:        if(!body_file_content_type/*vstring.as_vfile*/ || body_file_content_type->as_string().pos("text/")==0)
                    693:                output=Charset::transcode(output, 
                    694:                        r.charsets.source(), 
                    695:                        r.charsets.client());
                    696: 
1.311     misha     697:        // prepare header: Content-Length
                    698:        SAPI::add_header_attribute(r.sapi_info, HTTP_CONTENT_LENGTH, format(output.length, "%u"));
1.267     paf       699: 
                    700:        // send header
                    701:        SAPI::send_header(r.sapi_info);
                    702:        
                    703:        // send body
                    704:        if(!header_only)
                    705:                SAPI::send_body(r.sapi_info, output.str, output.length);
                    706: }
                    707: 
                    708: #ifndef DOXYGEN
                    709: struct Range
                    710: {
                    711:        size_t start;
                    712:        size_t end;
                    713: };
                    714: #endif
1.313     misha     715: static void parse_range(const String* s, Array<Range> &ar) {
1.267     paf       716:        const char *p = s->cstr();
                    717:        if(s->starts_with("bytes="))
                    718:                p += 6;
                    719:        Range r;
                    720:        while(*p){
                    721:                r.start = (size_t)-1;
                    722:                r.end = (size_t)-1;
                    723:                if(*p >= '0' && *p <= '9'){
                    724:                        r.start = atol(p);
                    725:                        while(*p>='0' && *p<='9') ++p;
                    726:                }
                    727:                if(*p++ != '-') break;
                    728:                if(*p >= '0' && *p <= '9'){
                    729:                        r.end = atol(p);
                    730:                        while(*p>='0' && *p<='9') ++p;
                    731:                }
                    732:                if(*p == ',') ++p;
                    733:                ar += r;
                    734:        }
1.101     paf       735: }
1.267     paf       736: 
                    737: static void output_pieces(Request& r,
                    738:                                                  bool header_only, 
                    739:                                                  const String& filename,
                    740:                                                  size_t content_length,
                    741:                                                  Value& date,
                    742:                                                  bool add_last_modified) 
                    743: {
1.315     misha     744:        SAPI::add_header_attribute(r.sapi_info, "accept-ranges", "bytes");
1.270     paf       745: 
1.267     paf       746:        const size_t BUFSIZE = 10*0x400;
                    747:        char buf[BUFSIZE];
1.339     moko      748:        const char *range = SAPI::Env::get(r.sapi_info, "HTTP_RANGE");
1.267     paf       749:        size_t offset=0;
                    750:        size_t part_length=content_length;
                    751:        if(range){
                    752:                Array<Range> ar;
                    753:                parse_range(new String(range), ar);
                    754:                size_t count = ar.count();
                    755:                if(count == 1){
                    756:                        Range &rg = ar.get_ref(0);
                    757:                        if(rg.start == (size_t)-1 && rg.end == (size_t)-1){
1.311     misha     758:                                SAPI::add_header_attribute(r.sapi_info, HTTP_STATUS, "416 Requested Range Not Satisfiable");
1.267     paf       759:                                return;
                    760:                        }
                    761:                        if(rg.start == (size_t)-1 && rg.end != (size_t)-1){
                    762:                                rg.start = content_length - rg.end;
                    763:                                rg.end = content_length;
                    764:                                offset += rg.start;
                    765:                                part_length = rg.end-rg.start;
                    766:                        }else if(rg.start != (size_t)-1 && rg.end == (size_t)-1){
                    767:                                rg.end = content_length-1;
                    768:                                offset += rg.start;
                    769:                                part_length -= rg.start;
                    770:                        }
                    771:                        if(part_length == 0){
1.311     misha     772:                                SAPI::add_header_attribute(r.sapi_info, HTTP_STATUS, "204 No Content");
1.267     paf       773:                                return;
                    774:                        }
1.311     misha     775:                        SAPI::add_header_attribute(r.sapi_info, HTTP_STATUS, "206 Partial Content");
1.267     paf       776:                        snprintf(buf, BUFSIZE, "bytes %u-%u/%u", rg.start, rg.end, content_length);
1.315     misha     777:                        SAPI::add_header_attribute(r.sapi_info, "content-range", buf);
1.267     paf       778:                }else if(count != 0){
1.311     misha     779:                        SAPI::add_header_attribute(r.sapi_info, HTTP_STATUS, "501 Not Implemented");
1.267     paf       780:                        return;
                    781:                }
                    782:        }
                    783: 
                    784: 
1.311     misha     785:        SAPI::add_header_attribute(r.sapi_info, HTTP_CONTENT_LENGTH, format(part_length, "%u"));
1.267     paf       786: 
1.314     misha     787:        if(add_last_modified)
1.315     misha     788:                SAPI::add_header_attribute(r.sapi_info, "last-modified", attributed_meaning_to_string(date, String::L_AS_IS, true).cstr());
1.314     misha     789: 
1.267     paf       790:        SAPI::send_header(r.sapi_info);
                    791: 
                    792:        const String& filespec=r.absolute(filename);
                    793: 
                    794:        size_t sent = 0;
                    795:        if(!header_only){
                    796:                size_t to_read = 0;
                    797:                size_t size = 0;
                    798:                do{
                    799:                        to_read = part_length<BUFSIZE?part_length:BUFSIZE;
                    800:                        File_read_result read_result=file_read(r.charsets, filespec, 
                    801:                                false /*as text*/,  0/*params*/, true/*fail on problem*/,
                    802:                                buf, offset, to_read);
                    803:                        to_read=read_result.length;
                    804:                        if(to_read == 0)
                    805:                                break;
                    806:                        offset += to_read;
                    807: 
                    808:                        size = SAPI::send_body(r.sapi_info, read_result.str, to_read);
                    809:                        sent += size;
                    810:                        if(size != to_read)
                    811:                                break;
                    812:                        part_length -= to_read;
                    813:                }while(part_length);
                    814:        }
                    815: }
                    816: 
1.248     paf       817: void Request::output_result(VFile* body_file, bool header_only, bool as_attachment) {
1.51      paf       818:        // header: cookies
1.248     paf       819:        cookie.output_result(sapi_info);
1.51      paf       820:        
1.314     misha     821:        // _file_ content-type might be specified
1.267     paf       822:        Value* body_file_content_type=body_file->fields().get(content_type_name);
1.92      paf       823: 
1.314     misha     824:        // Content-Disposition
1.267     paf       825:        Value* vfile_name=body_file->fields().get(name_name);
                    826:        if(!vfile_name) {
                    827:                vfile_name=body_file->fields().get(response_body_file_name);
1.313     misha     828:                if(vfile_name) {
                    829:                        char* name_cstr=vfile_name->as_string().cstrm();
1.274     paf       830:                        if(char *after_slash=rsplit(name_cstr, '\\'))
                    831:                                name_cstr=after_slash;
                    832:                        if(char *after_slash=rsplit(name_cstr, '/'))
                    833:                                name_cstr=after_slash;
1.327     misha     834:                        vfile_name=new VString(*new String(name_cstr));
1.274     paf       835:                }
1.267     paf       836:        }
                    837:        if(vfile_name) {
                    838:                const String& sfile_name=vfile_name->as_string();
                    839:                if(sfile_name!=NONAME_DAT) {
1.283     misha     840:                        VHash& hash=*new VHash();
                    841:                        HashStringValue &h=hash.hash();
1.288     misha     842:                        h.put(value_name, new VString( as_attachment ? content_disposition_attachment : content_disposition_inline ));
1.343     moko      843:                        h.put(content_disposition_filename_name, new VString(*new String(sfile_name, String::L_HTTP_HEADER)));
1.283     misha     844: 
1.344     moko      845:                        response.fields().put(content_disposition_name_upper, &hash);
1.267     paf       846: 
                    847:                        if(!body_file_content_type)
                    848:                                body_file_content_type=new VString(mime_type_of(sfile_name.cstr()));
1.111     paf       849:                }
1.267     paf       850:        }
                    851: 
1.312     misha     852:        // set Content-Type
1.314     misha     853:        if(body_file_content_type) {
                    854:                // body file content type
1.344     moko      855:                response.fields().put(content_type_name_upper, body_file_content_type);
1.314     misha     856:        } else {
                    857:                // default content type
1.344     moko      858:                response.fields().put_dont_replace(content_type_name_upper, new VString(*new String(DEFAULT_CONTENT_TYPE)));
1.314     misha     859:        }
1.312     misha     860: 
1.314     misha     861:        // prepare header: $response:fields without :body, :download and :charset
1.267     paf       862:        Add_header_attribute_info info(*this);
1.281     paf       863:        response.fields().for_each<Add_header_attribute_info*>(add_header_attribute, &info);
1.50      paf       864: 
1.267     paf       865:        if(Value* vresponse_body_file=body_file->fields().get(response_body_file_name)) {
1.314     misha     866:                // $response:[download|body][$.file[filespec]] -- optput specified file
1.267     paf       867:                const String& sresponse_body_file=vresponse_body_file->as_string();
                    868:                size_t content_length=0;
                    869:                time_t atime=0, mtime=0, ctime=0;
                    870:                file_stat(absolute(sresponse_body_file),
                    871:                        content_length,
                    872:                        atime, mtime, ctime);
                    873: 
                    874:                VDate* vdate=0;
                    875:                if(Value* v=body_file->fields().get("mdate")) {
1.308     misha     876:                        if(Value* vdatep=v->as(VDATE_TYPE))
1.267     paf       877:                                vdate=static_cast<VDate*>(vdatep);
                    878:                        else 
1.286     misha     879:                                throw Exception(PARSER_RUNTIME, 0, "mdate must be a date");
1.267     paf       880:                }
                    881:                if(!vdate)
1.346     moko      882:                        vdate=new VDate((pa_time_t)mtime);
1.62      paf       883: 
1.267     paf       884:                output_pieces(*this, header_only, 
                    885:                        sresponse_body_file,
                    886:                        content_length,
                    887:                        *vdate,
                    888:                        info.add_last_modified);
                    889:        } else {
1.314     misha     890:                if(body_file_content_type)
                    891:                        if(HashStringValue *hash=body_file_content_type->get_hash())
                    892:                                body_file_content_type=hash->get(value_name);
                    893: 
1.267     paf       894:                output_sole_piece(*this, header_only, 
                    895:                        *body_file, body_file_content_type);
                    896:        }
1.50      paf       897: }
1.104     paf       898: 
1.328     misha     899: const String& Request::mime_type_of(const String* file_name) {
                    900:        return mime_type_of(file_name?file_name->taint_cstr(String::L_FILE_SPEC):0);
                    901: }
                    902: 
1.248     paf       903: const String& Request::mime_type_of(const char* user_file_name_cstr) {
1.104     paf       904:        if(mime_types)
1.248     paf       905:                if(const char* cext=strrchr(user_file_name_cstr, '.')) {
                    906:                        String sext(++cext);
1.246     paf       907:                        Table::Action_options options;
1.342     moko      908:                        if(mime_types->locate(0, sext.change_case(charsets.source(), String::CC_LOWER), options)) {
1.313     misha     909:                                if(const String* result=mime_types->item(1))
                    910:                                        return *result;
1.104     paf       911:                                else
1.286     misha     912:                                        throw Exception(PARSER_RUNTIME,
1.248     paf       913:                                                0,
1.212     paf       914:                                                MIME_TYPES_NAME  " table column elements must not be empty");
1.342     moko      915:                        }
1.104     paf       916:                }
1.248     paf       917: 
                    918:        return *new String("application/octet-stream");
                    919: }
                    920: 
1.318     misha     921: const String* Request::get_used_filename(uint file_no){
                    922:        if(file_no < file_list.count())
                    923:                return new String(file_list[file_no], String::L_TAINTED);
                    924:        return 0;
                    925: }
                    926: 
1.248     paf       927: #ifdef XML
1.280     paf       928: xmlChar* Request::transcode(const String& s) {
1.248     paf       929:        return charsets.source().transcode(s);
                    930: }
                    931: 
1.280     paf       932: xmlChar* Request::transcode(const String::Body s) {
1.248     paf       933:        return charsets.source().transcode(s);
                    934: }
                    935: 
1.280     paf       936: const String& Request::transcode(const xmlChar* s) {
1.248     paf       937:        return charsets.source().transcode(s);
1.233     paf       938: }
1.248     paf       939: #endif
                    940: 
                    941: 
                    942: const Request::Trace Request::Exception_trace::extract_origin(const String*& problem_source) {
                    943:        Trace result;
                    944:        if(!is_empty()) {
                    945:                result=bottom_value();
                    946:                if(!problem_source) { // we don't know who trigged the bug?
1.279     paf       947:                        problem_source=result.name(); // consider the stack-top-guy (we usually know source of next-from-throw-point exception) did that
1.248     paf       948:                        fbottom++;
                    949:                } else if(result.name()==problem_source) // it is that same guy?
                    950:                        fbottom++; // throw away that trace
1.279     paf       951:                else {
                    952:                        // stack top contains not us, 
                    953:                        //      leaving result intact
                    954:                        //      it would help ^throw
                    955:                }
1.248     paf       956:        }
                    957: 
                    958:        return result;
                    959: }
                    960: 
                    961: Request::Exception_details Request::get_details(const Exception& e) {
                    962:        const String* problem_source=e.problem_source();
                    963:        Trace trace=exception_trace.extract_origin(problem_source);
                    964:        
                    965:        VHash& vhash=*new VHash;  HashStringValue& hash=vhash.hash();
                    966: 
                    967:        // $.type
                    968:        if(const char* type=e.type(true))
                    969:                hash.put(exception_type_part_name, new VString(*new String(type)));
                    970: 
                    971:        // $.source
                    972:        if(problem_source) {
1.306     misha     973:                String& source=*new String(*problem_source, String::L_TAINTED);
1.248     paf       974:                hash.put(exception_source_part_name, new VString(source));
                    975:        }
                    976: 
                    977:        // $.file lineno colno
                    978:        if(trace) {
                    979:                const Operation::Origin origin=trace.origin();
1.347   ! moko      980:                hash.put("file", new VString(*new String(file_list[origin.file_no], String::L_TAINTED)));
        !           981:                hash.put("lineno", new VInt(1+origin.line));
        !           982:                hash.put("colno", new VInt(1+origin.col));
1.248     paf       983:        }
                    984: 
                    985:        // $.comment
                    986:        if(const char* comment=e.comment(true))
                    987:                hash.put(exception_comment_part_name, 
1.302     misha     988:                        new VString(*new String(comment, String::L_TAINTED)));
1.248     paf       989: 
                    990:        // $.handled(0)
1.299     misha     991:        hash.put(exception_handled_part_name, &VBool::get(false));
1.233     paf       992: 
1.248     paf       993:        return Request::Exception_details(trace, problem_source, vhash);
1.133     parser    994: }
1.337     moko      995: 
                    996: Temp_value_element::Temp_value_element(Request& arequest, Value& awhere, const String& aname, Value* awhat) :
                    997:        frequest(arequest),
                    998:        fwhere(awhere),
                    999:        fname(aname),
                   1000:        saved(awhere.get_element(aname))
                   1001: {
                   1002:        Junction* junction;
                   1003:        if(saved && (junction=saved->get_junction()) && junction->is_getter)
                   1004:                saved=0;
                   1005:        frequest.put_element(fwhere, aname, awhat);
                   1006: }
                   1007: 
                   1008: Temp_value_element::~Temp_value_element() {
                   1009:        frequest.put_element(fwhere, fname, saved ? saved : VVoid::get());
                   1010: }

E-mail: