Annotation of parser3/src/classes/op.C, revision 1.161

1.1       paf         1: /** @file
1.9       paf         2:        Parser: parser @b operators.
1.1       paf         3: 
1.155     paf         4:        Copyright (c) 2001-2005 ArtLebedev Group (http://www.artlebedev.com)
1.71      paf         5:        Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
1.98      paf         6: */
1.1       paf         7: 
1.161   ! paf         8: static const char * const IDENT_OP_C="$Date: 2005/11/22 15:38:17 $";
1.1       paf         9: 
1.13      paf        10: #include "classes.h"
1.129     paf        11: #include "pa_vmethod_frame.h"
                     12: 
1.1       paf        13: #include "pa_common.h"
1.134     paf        14: #include "pa_os.h"
1.1       paf        15: #include "pa_request.h"
                     16: #include "pa_vint.h"
                     17: #include "pa_sql_connection.h"
1.79      paf        18: #include "pa_vdate.h"
1.105     paf        19: #include "pa_vmethod_frame.h"
1.129     paf        20: #include "pa_vclass.h"
1.144     paf        21: #include "pa_charset.h"
1.1       paf        22: 
1.18      parser     23: // limits
                     24: 
                     25: #define MAX_LOOPS 10000
                     26: 
1.10      paf        27: // defines
                     28: 
1.82      paf        29: #define CASE_DEFAULT_VALUE "DEFAULT"
1.146     paf        30: #define PROCESS_MAIN_OPTION_NAME "main"
                     31: #define PROCESS_FILE_OPTION_NAME "file"
                     32: #define PROCESS_LINENO_OPTION_NAME "lineno"
1.11      paf        33: 
1.10      paf        34: // class
                     35: 
1.113     paf        36: class VClassMAIN: public VClass {
1.10      paf        37: public:
1.129     paf        38:        VClassMAIN();
1.10      paf        39: };
                     40: 
1.129     paf        41: // defines for statics
                     42: 
                     43: #define SWITCH_DATA_NAME "SWITCH-DATA"
                     44: #define CACHE_DATA_NAME "CACHE-DATA"
                     45: #define EXCEPTION_VAR_NAME "exception"
                     46: 
                     47: // statics
                     48: 
                     49: //^switch ^case
                     50: static const String switch_data_name(SWITCH_DATA_NAME);
                     51: //^cache
                     52: static const String cache_data_name(CACHE_DATA_NAME);
                     53: 
                     54: static const String exception_var_name(EXCEPTION_VAR_NAME);
                     55: 
1.136     paf        56: // local defines
                     57: 
                     58: #define CACHE_EXCEPTION_HANDLED_CACHE_NAME "cache"
                     59: 
1.129     paf        60: // helpers
                     61: 
1.130     paf        62: class Untaint_lang_name2enum: public Hash<const String::Body, String::Language> {
1.129     paf        63: public:
                     64:        Untaint_lang_name2enum() {
                     65:                #define ULN(name, LANG) \
1.130     paf        66:                        put(String::Body(name), (value_type)(String::L_##LANG));
1.129     paf        67:                ULN("as-is", AS_IS);
                     68:                ULN("optimized-as-is", AS_IS|String::L_OPTIMIZE_BIT);
                     69:                ULN("file-spec", FILE_SPEC);
                     70:                ULN("http-header", HTTP_HEADER);
                     71:                ULN("mail-header", MAIL_HEADER);
                     72:                ULN("uri", URI);
                     73:                ULN("sql", SQL);
                     74:                ULN("js", JS);
                     75:                ULN("xml", XML);
                     76:                ULN("optimized-xml", XML|String::L_OPTIMIZE_BIT);
                     77:                ULN("html", HTML);
                     78:                ULN("optimized-html", HTML|String::L_OPTIMIZE_BIT);
1.159     paf        79:                ULN("regex", REGEX);
1.129     paf        80:                #undef ULN
                     81:        }
                     82: } untaint_lang_name2enum;
                     83: 
1.10      paf        84: // methods
                     85: 
1.129     paf        86: static void _if(Request& r, MethodParams& params) {
1.156     paf        87:        bool condition=params.as_bool(0, "condition must be expression", r);
1.6       paf        88:        if(condition)
1.156     paf        89:                r.write_pass_lang(r.process(*params.get(1)));
1.129     paf        90:        else if(params.count()>2)
1.156     paf        91:                r.write_pass_lang(r.process(*params.get(2)));
1.1       paf        92: }
                     93: 
1.129     paf        94: static void _untaint(Request& r, MethodParams& params) {
1.1       paf        95: 
1.129     paf        96:        String::Language lang;
                     97:        if(params.count()==1)
                     98:                lang=String::L_AS_IS; // mark as simply 'tainted'. useful in html from sql 
1.59      paf        99:        else {
1.129     paf       100:                const String& lang_name=params.as_string(0, "lang must be string");
                    101:                lang=untaint_lang_name2enum.get(lang_name);
1.59      paf       102:                if(!lang)
1.78      paf       103:                        throw Exception(0,
1.59      paf       104:                                &lang_name,
                    105:                                "invalid taint language");
                    106:        }
1.1       paf       107: 
                    108:        {
1.129     paf       109:                Value& vbody=params.as_junction(params.count()-1, "body must be code");
1.1       paf       110:                
                    111:                Temp_lang temp_lang(r, lang); // set temporarily specified ^untaint[language;
1.86      paf       112:                r.write_pass_lang(r.process(vbody)); // process marking tainted with that lang
1.1       paf       113:        }
                    114: }
                    115: 
1.129     paf       116: static void _taint(Request& r, MethodParams& params) {
                    117:        String::Language lang;
                    118:        if(params.count()==1)
                    119:                lang=String::L_TAINTED; // mark as simply 'tainted'. useful in table:set
1.1       paf       120:        else {
1.129     paf       121:                const String& lang_name=params.as_string(0, "lang must be string");
                    122:                lang=untaint_lang_name2enum.get(lang_name);
1.1       paf       123:                if(!lang)
1.78      paf       124:                        throw Exception(0,
1.3       paf       125:                                &lang_name,
                    126:                                "invalid taint language");
1.1       paf       127:        }
                    128: 
                    129:        {
1.129     paf       130:                Value& vbody=params.as_no_junction(params.count()-1, "body must not be code");
1.1       paf       131:                
1.129     paf       132:                String result;
1.1       paf       133:                result.append(
                    134:                        vbody.as_string(),  // process marking tainted with that lang
                    135:                        lang, true);  // force result language to specified
                    136:                r.write_pass_lang(result);
                    137:        }
                    138: }
                    139: 
1.129     paf       140: static void _process(Request& r, MethodParams& params) {
                    141:        Method* main_method;
                    142: 
                    143:        size_t index=0;
                    144:        Value* target_self;
                    145:        Value& maybe_target_self=params[index];
                    146:        if(maybe_target_self.get_string() || maybe_target_self.get_junction())
                    147:                target_self=&r.get_method_frame()->caller()->self();
                    148:        else {
                    149:                target_self=&maybe_target_self;  index++;
                    150:        }
                    151: 
1.1       paf       152:        {
1.129     paf       153:                VStateless_class *target_class=target_self->get_last_derived_class();
1.116     paf       154:                if(!target_class)
                    155:                        throw Exception("parser.runtime",
1.129     paf       156:                                0,
1.116     paf       157:                                "no target class");
1.114     paf       158: 
1.73      paf       159:                // temporary remove language change
1.129     paf       160:                Temp_lang temp_lang(r, String::L_PASS_APPENDED);
1.1       paf       161:                // temporary zero @main so to maybe-replace it in processed code
1.129     paf       162:                Temp_method temp_method_main(*target_class, main_method_name, 0);
1.1       paf       163:                // temporary zero @auto so it wouldn't be auto-called in Request::use_buf
1.129     paf       164:                Temp_method temp_method_auto(*target_class, auto_method_name, 0);
                    165: 
1.146     paf       166:                size_t options_index=index+1;
                    167:                HashStringValue* options=0;
                    168:                if(options_index<params.count()) {
                    169:                        Value& voptions=params.as_no_junction(options_index, "options must not be code");
                    170:                        options=voptions.get_hash();
                    171:                        if(!options)
                    172:                                throw Exception("parser.runtime",
                    173:                                        0,
                    174:                                        "options must be hash");
                    175:                }
                    176: 
1.129     paf       177:                const String* main_alias=0;
1.146     paf       178:                const String* file_alias=0;
                    179:                int line_no_alias_offset=0;
                    180:                if(options) {
                    181:                        int valid_options=0;
                    182:                        if(Value* vmain_alias=options->get(PROCESS_MAIN_OPTION_NAME)) {
                    183:                                valid_options++;
                    184:                                main_alias=&vmain_alias->as_string();
                    185:                        }
                    186:                        if(Value* vfile_alias=options->get(PROCESS_FILE_OPTION_NAME)) {
                    187:                                valid_options++;
                    188:                                file_alias=&vfile_alias->as_string();
                    189:                        }
                    190:                        if(Value* vline_no_alias_offset=options->get(PROCESS_LINENO_OPTION_NAME)) {
                    191:                                valid_options++;
                    192:                                line_no_alias_offset=vline_no_alias_offset->as_int();
                    193:                        }
                    194:        
                    195:                        if(valid_options!=options->count())
                    196:                                throw Exception("parser.runtime",
                    197:                                        0,
                    198:                                        "called with invalid option");
                    199:                }
1.129     paf       200: 
1.146     paf       201:                uint processe_file_no=file_alias?
                    202:                        r.register_file(r.absolute(*file_alias))
                    203:                        : pseudo_file_no__process;
                    204:                // process...{string}
                    205:                Value& vjunction=params.as_junction(index, "body must be code");
                    206:                // evaluate source to process
                    207:                const String& source=r.process_to_string(vjunction);
                    208:                r.use_buf(*target_class,
                    209:                        source.cstr(String::L_UNSPECIFIED, r.connection(false)),
                    210:                        main_alias,
                    211:                        processe_file_no,
                    212:                        line_no_alias_offset);
1.1       paf       213: 
1.73      paf       214:                // main_method
1.129     paf       215:                main_method=target_class->get_method(main_method_name);
1.73      paf       216:        }
                    217:        // after restoring current-request-lang
                    218:        // maybe-execute @main[]
                    219:        if(main_method) {
1.119     paf       220:                // temporarily set method_frame's self to target_self
1.129     paf       221:                Temp_method_frame_self tmfs(*r.get_method_frame(), *target_self);
1.73      paf       222:                // execute!     
                    223:                r.execute(*main_method->parser_code);
1.1       paf       224:        }
                    225: }
                    226:        
1.138     paf       227: static void _rem(Request&, MethodParams& params) {
1.129     paf       228:        params.as_junction(0, "body must be code");
1.1       paf       229: }
                    230: 
1.129     paf       231: static void _while(Request& r, MethodParams& params) {
                    232:        Value& vcondition=params.as_junction(0, "condition must be expression");
                    233:        Value& body=params.as_junction(1, "body must be code");
1.1       paf       234: 
                    235:        // while...
                    236:        int endless_loop_count=0;
                    237:        while(true) {
1.18      parser    238:                if(++endless_loop_count>=MAX_LOOPS) // endless loop?
1.78      paf       239:                        throw Exception("parser.runtime",
1.129     paf       240:                                0,
1.1       paf       241:                                "endless loop detected");
                    242: 
1.86      paf       243:                bool condition=r.process_to_value(vcondition, 
1.1       paf       244:                                false/*don't intercept string*/).as_bool();
                    245:                if(!condition) // ...condition is true
                    246:                        break;
                    247: 
                    248:                // write processed body
1.86      paf       249:                r.write_pass_lang(r.process(body));
1.1       paf       250:        }
                    251: }
                    252: 
1.129     paf       253: static void _use(Request& r, MethodParams& params) {
                    254:        Value& vfile=params.as_no_junction(0, "file name must not be code");
1.113     paf       255:        r.use_file(r.main_class, vfile.as_string());
1.1       paf       256: }
                    257: 
1.129     paf       258: static void _for(Request& r, MethodParams& params) {
                    259:        const String& var_name=params.as_string(0, "var name must be string");
                    260:        int from=params.as_int(1, "from must be int", r);
                    261:        int to=params.as_int(2, "to must be int", r);
                    262:        Value&  body_code=params.as_junction(3, "body must be code");
                    263:        Value* delim_maybe_code=params.count()>4?&params[4]:0;
1.1       paf       264: 
1.57      paf       265:        if(to-from>=MAX_LOOPS) // too long loop?
1.78      paf       266:                throw Exception("parser.runtime",
1.129     paf       267:                        0,
1.57      paf       268:                        "endless loop detected");
                    269: 
1.1       paf       270:        bool need_delim=false;
1.129     paf       271:        VInt* vint=new VInt(0);
1.154     paf       272: 
                    273:        VMethodFrame& caller=*r.get_method_frame()->caller();
                    274:        caller.put_element(caller, var_name, vint, false);
1.1       paf       275:        for(int i=from; i<=to; i++) {
                    276:                vint->set_int(i);
                    277: 
1.108     paf       278:                StringOrValue sv_processed=r.process(body_code);
1.129     paf       279:                const String* s_processed=sv_processed.get_string();
                    280:                if(delim_maybe_code && s_processed && s_processed->length()) { // delimiter set and we have body
1.108     paf       281:                        if(need_delim) // need delim & iteration produced string?
1.86      paf       282:                                r.write_pass_lang(r.process(*delim_maybe_code));
1.1       paf       283:                        need_delim=true;
                    284:                }
1.108     paf       285:                r.write_pass_lang(sv_processed);
1.1       paf       286:        }
                    287: }
                    288: 
1.129     paf       289: static void _eval(Request& r, MethodParams& params) {
                    290:        Value& expr=params.as_junction(0, "need expression");
1.1       paf       291:        // evaluate expresion
1.129     paf       292:        Value& value_result=r.process_to_value(expr, 
1.1       paf       293:                true/*don't intercept string*/).as_expr_result();
1.129     paf       294:        if(params.count()>1) {
                    295:                Value& fmt=params.as_no_junction(1, "fmt must not be code");
                    296:                r.write_no_lang(String(format(value_result.as_double(), fmt.as_string().cstrm())));
1.91      paf       297:        } else
1.129     paf       298:                r.write_no_lang(value_result);
1.1       paf       299: }
                    300: 
1.129     paf       301: static void _connect(Request& r, MethodParams& params) {
1.63      paf       302: #ifdef RESOURCES_DEBUG
                    303: struct timeval mt[2];
                    304: #endif
1.129     paf       305:        Value& url=params.as_no_junction(0, "url must not be code");
                    306:        Value& body_code=params.as_junction(1, "body must be code");
1.1       paf       307: 
1.129     paf       308:        Table* protocol2driver_and_client=0;
                    309:        if(Value* sql=r.main_class.get_element(String(MAIN_SQL_NAME), r.main_class, false)) {
                    310:                if(Value* element=sql->get_element(String(MAIN_SQL_DRIVERS_NAME), *sql, false)) {
1.113     paf       311:                        protocol2driver_and_client=element->get_table();
                    312:                }
                    313:        }
1.11      paf       314: 
1.63      paf       315: #ifdef RESOURCES_DEBUG
                    316: //measure:before
                    317: gettimeofday(&mt[0],NULL);
                    318: #endif
1.1       paf       319:        // connect
1.142     paf       320:        SQL_Connection* connection=SQL_driver_manager->get_connection(url.as_string(), 
1.144     paf       321:                protocol2driver_and_client,
                    322:                r.charsets.source().NAME().cstr());
1.1       paf       323: 
1.63      paf       324: #ifdef RESOURCES_DEBUG
                    325: //measure:after connect
                    326: gettimeofday(&mt[1],NULL);
                    327: 
                    328: double t[2];
                    329: for(int i=0;i<2;i++)
                    330:     t[i]=mt[i].tv_sec+mt[i].tv_usec/1000000.0;
                    331: 
                    332: r.sql_connect_time+=t[1]-t[0];
                    333: #endif
1.129     paf       334:        Temp_connection temp_connection(r, connection);
1.1       paf       335:        // execute body
1.53      parser    336:        try {
1.86      paf       337:                r.write_assign_lang(r.process(body_code));
1.129     paf       338:                connection->commit();
                    339:                connection->close();
1.75      paf       340:        } catch(...) { // process problem
1.129     paf       341:                connection->rollback();
                    342:                connection->close();
                    343:                rethrow;
1.1       paf       344:        }
                    345: }
                    346: 
1.41      parser    347: #ifndef DOXYGEN
1.129     paf       348: class Switch_data: public PA_Object {
                    349: public:
                    350:        Request& r;
                    351:        Value& searching;
                    352:        Value* found;
                    353:        Value* _default;
                    354: public:
                    355:        Switch_data(Request& ar, Value& asearching): 
                    356:          r(ar), searching(asearching) {}
1.28      parser    357: };
1.41      parser    358: #endif
1.129     paf       359: static void _switch(Request& r, MethodParams& params) {
                    360:        Switch_data* data=new Switch_data(r, r.process_to_value(params[0]));
1.135     paf       361:        Temp_hash_value<const String::Body, void*> 
1.129     paf       362:                switch_data_setter(r.classes_conf, switch_data_name, data);
1.28      parser    363: 
1.129     paf       364:        Value& cases_code=params.as_junction(1, "switch cases must be code");
1.82      paf       365:        // execution of found ^case[...]{code} must be in context of ^switch[...]{code}
                    366:        // because of stacked WWrapper used there as wcontext
1.84      paf       367:        r.process(cases_code, true/*intercept_string*/);
1.147     paf       368:        if(Value* selected_code=data->found? data->found: data->_default)
1.107     paf       369:                r.write_pass_lang(r.process(*selected_code));
1.28      parser    370: }
                    371: 
1.129     paf       372: static void _case(Request& r, MethodParams& params) {
                    373:        Switch_data* data=static_cast<Switch_data*>(r.classes_conf.get(switch_data_name));
1.38      parser    374:        if(!data)
1.78      paf       375:                throw Exception("parser.runtime",
1.129     paf       376:                        0,
1.38      parser    377:                        "without switch");
1.28      parser    378: 
1.129     paf       379:        int count=params.count();
                    380:        Value& code=params.as_junction(--count, "case result must be code");
1.83      paf       381:        
1.28      parser    382:        for(int i=0; i<count; i++) {
1.129     paf       383:                Value& value=r.process_to_value(params[i]);
1.28      parser    384: 
1.157     paf       385:                if(value.is_string() && value.as_string() == CASE_DEFAULT_VALUE) {
1.129     paf       386:                        data->_default=&code;
1.28      parser    387:                        break;
                    388:                }
                    389: 
                    390:                bool matches;
1.129     paf       391:                if(data->searching.is_string())
                    392:                        matches=data->searching.as_string() == value.as_string();
1.28      parser    393:                else
1.129     paf       394:                        matches=data->searching.as_double() == value.as_double();
1.28      parser    395: 
                    396:                if(matches) {
1.82      paf       397:                        if(data->found)
                    398:                                throw Exception("parser.runtime",
1.129     paf       399:                                        0,
1.82      paf       400:                                        "duplicate found");
                    401: 
1.129     paf       402:                        data->found=&code;
1.28      parser    403:                        break;
                    404:                }
                    405:        }
                    406: }
1.136     paf       407: #ifndef DOXYGEN
                    408: struct Try_catch_result {
                    409:        StringOrValue processed_code;
                    410:        const String* exception_should_be_handled;
                    411: 
                    412:        Try_catch_result(): exception_should_be_handled(0) {}
                    413: };
                    414: #endif
                    415: 
                    416: /// used by ^try and ^cache, @returns $exception.handled[string] if any
                    417: template<class I>
                    418: static Try_catch_result try_catch(Request& r, 
                    419:                  StringOrValue body_code(Request&, I), I info, 
1.160     paf       420:                  Value* catch_code, bool could_be_handled_by_caller=false) 
1.136     paf       421: {
                    422:        Try_catch_result result;
                    423:        if(!catch_code) {
                    424:                result.processed_code=body_code(r, info);
                    425:                return result;
                    426:        }
                    427: 
                    428:        // taking snapshot of try-context
                    429:        Request_context_saver try_context(r);
                    430:        try {
                    431:                result.processed_code=body_code(r, info);
                    432:        } catch(const Exception& e) {
                    433:                Request_context_saver throw_context(r); // taking snapshot of throw-context [stack trace contains error]
                    434:                Request::Exception_details details=r.get_details(e);
                    435:                try_context.restore(); // restoring try-context to perform catch-code
                    436: 
                    437:                Junction* junction=catch_code->get_junction();
                    438:                Value* method_frame=junction->method_frame;
                    439:                Value* saved_exception_var_value=method_frame->get_element(exception_var_name, *method_frame, false);
1.154     paf       440:                VMethodFrame& frame=*junction->method_frame;
                    441:                frame.put_element(frame, exception_var_name, &details.vhash, false);
1.136     paf       442:                result.processed_code=r.process(*catch_code);
                    443:                
                    444:                // retriving $exception.handled, restoring $exception var
                    445:                Value* vhandled=details.vhash.hash().get(exception_handled_part_name);
1.154     paf       446:                frame.put_element(frame, exception_var_name, saved_exception_var_value, false);
1.136     paf       447: 
                    448:                bool bhandled=false;
                    449:                if(vhandled) {
                    450:                        if(vhandled->is_string()) { // not simple $exception.handled(1/0)?
1.160     paf       451:                                if(could_be_handled_by_caller) { // and we can possibly handle it
                    452:                                        result.exception_should_be_handled=vhandled->get_string(); // considering 'recovered' and let the caller recover
                    453:                                        return result;
                    454:                                }
                    455:                                
                    456:                                bhandled=false;
                    457:                        } else
                    458:                                bhandled=vhandled->as_bool();           
1.136     paf       459:                }
                    460: 
                    461:                if(!bhandled) {
                    462:                        throw_context.restore(); // restoring throw-context [exception were not handled]
                    463:                        rethrow;
                    464:                }
                    465:        }
                    466:        return result;
                    467: }
1.28      parser    468: 
1.63      paf       469: // cache--
                    470: 
                    471: // consts
                    472: 
1.152     paf       473: const int DATA_STRING_SERIALIZED_VERSION=0x0006;
1.63      paf       474: 
                    475: // helper types
                    476: 
                    477: #ifndef DOXYGEN
                    478: struct Data_string_serialized_prolog {
                    479:        int version;
1.79      paf       480:        time_t expires;
1.63      paf       481: };
                    482: #endif
                    483: 
1.68      paf       484: void cache_delete(const String& file_spec) {
                    485:        file_delete(file_spec, false/*fail_on_read_problem*/);
1.63      paf       486: }
1.69      paf       487: 
                    488: #ifndef DOXYGEN
1.135     paf       489: struct Cache_scope {
1.129     paf       490: public:
1.79      paf       491:        time_t expires;
1.135     paf       492:        const String* body_from_disk;
1.79      paf       493: };
1.69      paf       494: struct Locked_process_and_cache_put_action_info {
                    495:        Request *r;
1.136     paf       496:        Cache_scope *scope;
                    497:        Value* body_code; Value* catch_code; 
                    498:        const String* processed_code;
1.69      paf       499: };
                    500: #endif
1.136     paf       501: 
                    502: 
                    503: 
                    504: static StringOrValue process_cache_body_code(Request& r, Value* body_code) {
1.153     paf       505:        return StringOrValue(r.process_to_string(*body_code));
1.136     paf       506: }
                    507: 
1.129     paf       508: /* @todo maybe network order worth spending some effort?
                    509:        don't bothering myself with network byte order,
                    510:        am not planning to be able to move resulting file across platforms
                    511: */
1.69      paf       512: static void locked_process_and_cache_put_action(int f, void *context) {
                    513:        Locked_process_and_cache_put_action_info& info=
                    514:                *static_cast<Locked_process_and_cache_put_action_info *>(context);
1.129     paf       515: 
1.160     paf       516: 
                    517:        const String* body_from_disk=info.scope->body_from_disk;
1.69      paf       518:        // body->process 
1.136     paf       519:        Try_catch_result result=try_catch(*info.r, 
                    520:                process_cache_body_code, info.body_code,
1.160     paf       521:                info.catch_code, body_from_disk!=0 /*we have something old=we can handle=recover later*/);
1.136     paf       522: 
                    523:        if(result.exception_should_be_handled) {
                    524:                if(*result.exception_should_be_handled==CACHE_EXCEPTION_HANDLED_CACHE_NAME) {
1.160     paf       525:                        assert(body_from_disk);
                    526:                        info.processed_code=body_from_disk;
1.136     paf       527:                } else
                    528:                        throw Exception("parser.runtime",
                    529:                                result.exception_should_be_handled,
                    530:                                "$"EXCEPTION_VAR_NAME"."EXCEPTION_HANDLED_PART_NAME" value must be "
                    531:                                "either boolean or string '"CACHE_EXCEPTION_HANDLED_CACHE_NAME"'");
                    532:        } else
                    533:                info.processed_code=&result.processed_code.as_string();
1.69      paf       534: 
1.79      paf       535:        // expiration time not spoiled by ^cache(0) or something?
1.136     paf       536:        if(info.scope->expires > time(0)) {
1.79      paf       537:                // string -serialize> buffer
1.136     paf       538:                String::Cm serialized=info.processed_code->serialize(
1.129     paf       539:                        sizeof(Data_string_serialized_prolog));
1.79      paf       540:                Data_string_serialized_prolog& prolog=
1.129     paf       541:                        *reinterpret_cast<Data_string_serialized_prolog *>(serialized.str);
1.79      paf       542:                prolog.version=DATA_STRING_SERIALIZED_VERSION;
1.136     paf       543:                prolog.expires=info.scope->expires;
1.79      paf       544:                
                    545:                // buffer -write> file
1.129     paf       546:                write(f, serialized.str, serialized.length);
1.79      paf       547:        } else // expired!
1.136     paf       548:                info.scope->expires=0; // flag it so that could be easily checked by caller
1.69      paf       549: }
1.129     paf       550: const String* locked_process_and_cache_put(Request& r, 
1.128     paf       551:                                           Value& body_code,
1.136     paf       552:                                           Value* catch_code,
                    553:                                           Cache_scope& scope,
                    554:                                           const String& file_spec) 
                    555: {
1.140     paf       556:        Locked_process_and_cache_put_action_info info={&r, &scope, &body_code, catch_code, 0};
1.69      paf       557: 
1.129     paf       558:        const String* result=file_write_action_under_lock(
1.69      paf       559:                file_spec, 
                    560:                "cache_put", locked_process_and_cache_put_action, &info,
                    561:                false/*as_text*/,
                    562:                false/*do_append*/,
1.96      paf       563:                false/*block*/,
1.136     paf       564:                false/*fail on lock problem*/) ? info.processed_code: 0;
1.100     paf       565:        time_t now=time(0);
1.136     paf       566:        if(scope.expires<=now)
1.79      paf       567:                cache_delete(file_spec);
                    568:        return result;
1.63      paf       569: }
1.137     paf       570: #ifndef DOXYGEN
1.135     paf       571: struct Cache_get_result {
                    572:        const String* body;
                    573:        bool expired;
1.137     paf       574: };
                    575: #endif
                    576: static Cache_get_result cache_get(Request_charsets& charsets, const String& file_spec, time_t now) {
1.140     paf       577:        Cache_get_result result={0, false};
1.135     paf       578: 
1.129     paf       579:        File_read_result file=file_read(charsets, file_spec, 
1.63      paf       580:                           false/*as_text*/, 
1.129     paf       581:                           0, //no params
                    582:                           false/*fail_on_read_problem*/);
                    583:        if(file.success && file.length/* ignore reads which are empty due to 
1.72      paf       584:                        non-unary open+lockEX conflict with lockSH */) {
1.129     paf       585:                        
1.72      paf       586:                Data_string_serialized_prolog& prolog=
1.129     paf       587:                        *reinterpret_cast<Data_string_serialized_prolog *>(file.str);
1.63      paf       588: 
1.135     paf       589:                String* body=new String;
1.72      paf       590:                if(
1.129     paf       591:                        file.length>=sizeof(Data_string_serialized_prolog)
1.135     paf       592:                        && prolog.version==DATA_STRING_SERIALIZED_VERSION) {
                    593:                        if(body->deserialize(sizeof(Data_string_serialized_prolog),  file.str, file.length)) {
                    594:                                result.body=body;
                    595:                                result.expired=prolog.expires <= now;
                    596:                        }
                    597:                }
1.72      paf       598:        }
1.63      paf       599: 
1.135     paf       600:        return result;
1.63      paf       601: }
1.129     paf       602: static time_t as_expires(Request& r, MethodParams& params, 
1.79      paf       603:                                                int index, time_t now) {
                    604:        time_t result;
1.129     paf       605:        if(Value* vdate=params[index].as(VDATE_TYPE, false))
                    606:                result=static_cast<VDate*>(vdate)->get_time();
1.79      paf       607:        else
1.129     paf       608:                result=now+(time_t)params.as_double(index, "lifespan must be date or number", r);
1.79      paf       609:        
                    610:        return result;
                    611: }
1.129     paf       612: static const String& as_file_spec(Request& r, MethodParams& params, int index) {
                    613:        return r.absolute(params.as_string(index, "filespec must be string"));
1.79      paf       614: }
1.129     paf       615: static void _cache(Request& r, MethodParams& params) {
1.158     paf       616:        if(params.count()==0)
                    617:        {
                    618:                // return current expiration time
                    619:                Cache_scope* scope=static_cast<Cache_scope*>(r.classes_conf.get(cache_data_name));
                    620:                if(!scope)
                    621:                        throw Exception("parser.runtime",
                    622:                                0,
                    623:                                "expire-time get without cache");
                    624:                r.write_no_lang(*new VDate(scope->expires));
                    625:                return;
                    626:        }
                    627: 
1.79      paf       628:        time_t now=time(0);
                    629: 
                    630:        // ^cache[filename] ^cache(seconds) ^cache[expires date]
1.129     paf       631:        if(params.count()==1) {
                    632:                if(params[0].is_string()) { // filename?
1.79      paf       633:                        cache_delete(as_file_spec(r, params, 0));
                    634:                        return;
                    635:                }
                    636: 
                    637:                // secods|expires date
1.135     paf       638:                Cache_scope* scope=static_cast<Cache_scope*>(r.classes_conf.get(cache_data_name));
                    639:                if(!scope)
1.79      paf       640:                        throw Exception("parser.runtime",
1.129     paf       641:                                0,
1.79      paf       642:                                "expire-time reducing instruction without cache");
                    643:                
1.129     paf       644:                time_t expires=as_expires(r, params, 0, now);
1.135     paf       645:                if(expires < scope->expires)
                    646:                        scope->expires=expires;
1.79      paf       647: 
                    648:                return;
1.149     paf       649:        } else if(params.count()<3)
                    650:                throw Exception("parser.runtime",
                    651:                        0,
                    652:                        "invalid number of parameters"); 
1.63      paf       653:        
                    654:        // file_spec, expires, body code
1.129     paf       655:        const String& file_spec=r.absolute(params.as_string(0, "filespec must be string"));
1.65      paf       656: 
1.141     paf       657:        Cache_scope scope={as_expires(r, params, 1, now), 0};
1.135     paf       658: 
                    659:        Temp_hash_value<const String::Body, void*> 
                    660:                cache_scope_setter(r.classes_conf, cache_data_name, &scope);
1.136     paf       661:        Value& body_code=params.as_junction(2, "body_code must be code");
                    662:        Value* catch_code=0;
                    663:        if(params.count()>3)
                    664:                catch_code=&params.as_junction(3, "catch_code must be code");
1.63      paf       665: 
1.135     paf       666:        if(scope.expires>now) { // valid 'expires' specified? try cached copy...
1.69      paf       667:                // hence we don't hope to have unary create/lockEX
                    668:                // we need some plan to live in a life like that, so... 
                    669:                // worst races plan:
                    670:                // A        B
                    671:                // open
                    672:                //          |open
                    673:                // lockSH
                    674:                //          |nonblocking-lockEX fails
                    675:                // unlockSH
                    676:                // close, cache_get returns 0
                    677:                // open
                    678:                // nonblocking-lockEX succeeds; process, write, close
                    679:                //          |retry1: open
                    680:                // ...
                    681:                //          |lockSH succeeds; ...
                    682: 
                    683:                for(int retry=0; retry<2; retry++) {
1.135     paf       684:                        Cache_get_result cached=cache_get(r.charsets, file_spec, now);
1.136     paf       685:                        if(cached.body) { // have cached copy
1.135     paf       686:                                if(cached.expired) 
                    687:                                        scope.body_from_disk=cached.body; // storing for user to retrive it with ^cache[]
1.136     paf       688:                                else // and it's not expired yet
                    689:                                {
1.135     paf       690:                                // write it out 
                    691:                                r.write_assign_lang(*cached.body);
                    692:                                // happy with it
                    693:                                return;
                    694:                        }
1.79      paf       695:                        }
1.69      paf       696: 
1.135     paf       697:                // non-blocked lock; process; cache it
                    698:                if(const String* processed_body=
1.136     paf       699:                        locked_process_and_cache_put(r, body_code, catch_code, scope, file_spec)) {
1.135     paf       700:                        // write it out 
                    701:                        r.write_assign_lang(*processed_body);
                    702:                        // happy with it
                    703:                        return;
                    704:                } else { // somebody writing result right now
                    705:                        pa_sleep(0, 500000); // waiting half a second
                    706:                        retry=0; // prolonging our wait, than could cache_get it, without processing body_code
                    707:                }
1.69      paf       708:                }
1.78      paf       709:                throw Exception(0,
1.69      paf       710:                        &file_spec,
                    711:                        "locking problem");
                    712:        } else { 
1.79      paf       713:                // instructed not to cache; forget cached copy
1.68      paf       714:                cache_delete(file_spec);
1.69      paf       715:                // process
1.81      paf       716:                const String& processed_body=r.process_to_string(body_code);
1.69      paf       717:                // write it out 
                    718:                r.write_assign_lang(processed_body);
                    719:                // happy with it
                    720:                return;
                    721:        }
                    722:        // never reached
1.63      paf       723: }
                    724: 
1.136     paf       725: static StringOrValue process_try_body_code(Request& r, Value* body_code) {
                    726:        return r.process(*body_code);
                    727: }
1.129     paf       728: static void _try_operator(Request& r, MethodParams& params) {
                    729:        Value& body_code=params.as_junction(0, "body_code must be code");
                    730:        Value& catch_code=params.as_junction(1, "catch_code must be code");
1.74      paf       731: 
1.136     paf       732:        Try_catch_result result=try_catch(r, 
                    733:                process_try_body_code, &body_code,
                    734:                &catch_code);
                    735:        
                    736:        if(result.exception_should_be_handled)
                    737:                throw Exception("parser.runtime",
                    738:                        result.exception_should_be_handled,
                    739:                        "catch block must set $exception.handled to some boolean value, not string");
1.123     paf       740: 
1.136     paf       741:        // write out processed body_code or catch_code
                    742:        r.write_pass_lang(result.processed_code);
1.74      paf       743: }
                    744: 
1.138     paf       745: static void _throw_operator(Request&, MethodParams& params) {
1.129     paf       746:        if(params.count()==1) {
                    747:                if(HashStringValue *hash=params[0].get_hash()) {
                    748:                        const char* type=0;
                    749:                        if(Value* value=hash->get(exception_type_part_name))
1.78      paf       750:                                type=value->as_string().cstr();
1.129     paf       751:                        const String* source=0;
                    752:                        if(Value* value=hash->get(exception_source_part_name))
1.74      paf       753:                                source=&value->as_string();
1.138     paf       754:                        const char* comment=0;
1.129     paf       755:                        if(Value* value=hash->get(exception_comment_part_name))
1.74      paf       756:                                comment=value->as_string().cstr();
                    757: 
1.78      paf       758:                        throw Exception(type,
1.129     paf       759:                                source?source:0,
                    760:                                "%s", comment?comment:"");
1.74      paf       761:                } else
1.78      paf       762:                        throw Exception("parser.runtime",
1.129     paf       763:                                0,
1.74      paf       764:                                "one-param version has hash param");
                    765:        } else {
1.129     paf       766:                const char* type=params.as_string(0, "type must be string").cstr();
                    767:                const String& source=params.as_string(1, "source must be string");
                    768:                const char* comment=params.count()>2? params.as_string(2, "comment must be string").cstr()
                    769:                        :0;
1.97      paf       770:                throw Exception(type, &source, "%s", comment?comment:"");
1.74      paf       771:        }
1.132     paf       772:  }
1.129     paf       773: 
1.150     paf       774: static void _sleep_operator(Request& r, MethodParams& params) {
                    775:        double seconds=params.as_double(0, "seconds must be double", r);
1.151     paf       776:        pa_sleep((int)trunc(seconds), (int)trunc(seconds*1000));
1.150     paf       777:  }
                    778: 
1.129     paf       779: #if defined(WIN32) && defined(_DEBUG)
                    780: #      define PA_BPT
1.138     paf       781: static void _bpt(Request&, MethodParams&) {
1.129     paf       782:        _asm int 3;
                    783: }
                    784: #endif
                    785: 
1.10      paf       786: // constructor
                    787: 
1.129     paf       788: VClassMAIN::VClassMAIN(): VClass() {
                    789:        set_name(*new String(MAIN_CLASS_NAME));
                    790: 
                    791: #ifdef PA_BPT
                    792:        // ^bpt[]
                    793:        add_native_method("bpt", Method::CT_ANY, _bpt, 0, 0);
                    794: #endif
1.121     paf       795: 
1.1       paf       796:        // ^if(condition){code-when-true}
                    797:        // ^if(condition){code-when-true}{code-when-false}
1.10      paf       798:        add_native_method("if", Method::CT_ANY, _if, 2, 3);
1.1       paf       799: 
                    800:        // ^untaint[as-is|uri|sql|js|html|html-typo]{code}
1.59      paf       801:        add_native_method("untaint", Method::CT_ANY, _untaint, 1, 2);
1.1       paf       802: 
                    803:        // ^taint[as-is|uri|sql|js|html|html-typo]{code}
1.10      paf       804:        add_native_method("taint", Method::CT_ANY, _taint, 1, 2);
1.1       paf       805: 
                    806:        // ^process[code]
1.146     paf       807:        add_native_method("process", Method::CT_ANY, _process, 1, 3);
1.1       paf       808: 
                    809:        // ^rem{code}
1.51      parser    810:        add_native_method("rem", Method::CT_ANY, _rem, 1, 10000);
1.1       paf       811: 
                    812:        // ^while(condition){code}
1.10      paf       813:        add_native_method("while", Method::CT_ANY, _while, 2, 2);
1.1       paf       814: 
                    815:        // ^use[file]
1.10      paf       816:        add_native_method("use", Method::CT_ANY, _use, 1, 1);
1.1       paf       817: 
1.54      paf       818:        // ^for[i](from-number;to-number-inclusive){code}[delim]
1.10      paf       819:        add_native_method("for", Method::CT_ANY, _for, 3+1, 3+1+1);
1.1       paf       820: 
                    821:        // ^eval(expr)
                    822:        // ^eval(expr)[format]
1.10      paf       823:        add_native_method("eval", Method::CT_ANY, _eval, 1, 2);
1.52      parser    824: 
1.1       paf       825:        // ^connect[protocol://user:pass@host[:port]/database]{code with ^sql-s}
1.10      paf       826:        add_native_method("connect", Method::CT_ANY, _connect, 2, 2);
                    827: 
1.63      paf       828: 
1.136     paf       829:        // ^cache[file_spec](time){code}[{catch code}] time=0 no cache
1.65      paf       830:        // ^cache[file_spec] delete cache
1.161   ! paf       831:        // ^cache[] get current expiration time
        !           832:        add_native_method("cache", Method::CT_ANY, _cache, 0, 4);
1.63      paf       833:        
1.28      parser    834:        // switch
                    835: 
                    836:        // ^switch[value]{cases}
                    837:        add_native_method("switch", Method::CT_ANY, _switch, 2, 2);
                    838: 
                    839:        // ^case[value]{code}
1.51      parser    840:        add_native_method("case", Method::CT_ANY, _case, 2, 10000);
1.74      paf       841: 
                    842:        // try-catch
                    843: 
                    844:        // ^try{code}{catch code}
                    845:        add_native_method("try", Method::CT_ANY, _try_operator, 2, 2);
                    846:        // ^throw[$exception hash]
                    847:        // ^throw[type;source;comment]
                    848:        add_native_method("throw", Method::CT_ANY, _throw_operator, 1, 3);
                    849: 
1.150     paf       850:        add_native_method("sleep", Method::CT_ANY, _sleep_operator, 1, 1);
1.10      paf       851: }
1.11      paf       852: 
                    853: // constructor & configurator
1.1       paf       854: 
1.129     paf       855: VStateless_class& VClassMAIN_create() {
                    856:        return *new VClassMAIN;
1.1       paf       857: }

E-mail: