[BACK]Return to op.C CVS log [TXT] [DIR] Up to [parser3project] / parser3 / src / classes

Diff for /parser3/src/classes/op.C between versions 1.8 and 1.153

version 1.8, 2001/04/17 19:00:27 version 1.153, 2005/07/15 06:16:41
Line 1 Line 1
 /** @file  /** @file
         Parser: @b ROOT parser class.          Parser: parser @b operators.
   
         Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)          Copyright (c) 2001-2004 ArtLebedev Group (http://www.artlebedev.com)
           Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
   */
   
         Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)  static const char * const IDENT_OP_C="$Date$";
   
         $Id$  #include "classes.h"
 */  #include "pa_vmethod_frame.h"
   
 #include "pa_config_includes.h"  
 #include "pa_common.h"  #include "pa_common.h"
   #include "pa_os.h"
 #include "pa_request.h"  #include "pa_request.h"
 #include "_op.h"  
 #include "pa_vint.h"  #include "pa_vint.h"
 #include "pa_sql_connection.h"  #include "pa_sql_connection.h"
   #include "pa_vdate.h"
   #include "pa_vmethod_frame.h"
   #include "pa_vclass.h"
   #include "pa_charset.h"
   
   // limits
   
   #define MAX_LOOPS 10000
   
   // defines
   
   #define CASE_DEFAULT_VALUE "DEFAULT"
   #define PROCESS_MAIN_OPTION_NAME "main"
   #define PROCESS_FILE_OPTION_NAME "file"
   #define PROCESS_LINENO_OPTION_NAME "lineno"
   
   // class
   
   class VClassMAIN: public VClass {
   public:
           VClassMAIN();
   };
   
   // defines for statics
   
   #define SWITCH_DATA_NAME "SWITCH-DATA"
   #define CACHE_DATA_NAME "CACHE-DATA"
   #define EXCEPTION_VAR_NAME "exception"
   
   // statics
   
   //^switch ^case
   static const String switch_data_name(SWITCH_DATA_NAME);
   //^cache
   static const String cache_data_name(CACHE_DATA_NAME);
   
   static const String exception_var_name(EXCEPTION_VAR_NAME);
   
   // local defines
   
   #define CACHE_EXCEPTION_HANDLED_CACHE_NAME "cache"
   
   // helpers
   
   class Untaint_lang_name2enum: public Hash<const String::Body, String::Language> {
   public:
           Untaint_lang_name2enum() {
                   #define ULN(name, LANG) \
                           put(String::Body(name), (value_type)(String::L_##LANG));
                   ULN("as-is", AS_IS);
                   ULN("optimized-as-is", AS_IS|String::L_OPTIMIZE_BIT);
                   ULN("file-spec", FILE_SPEC);
                   ULN("http-header", HTTP_HEADER);
                   ULN("mail-header", MAIL_HEADER);
                   ULN("uri", URI);
                   ULN("sql", SQL);
                   ULN("js", JS);
                   ULN("xml", XML);
                   ULN("optimized-xml", XML|String::L_OPTIMIZE_BIT);
                   ULN("html", HTML);
                   ULN("optimized-html", HTML|String::L_OPTIMIZE_BIT);
                   #undef ULN
           }
   } untaint_lang_name2enum;
   
 static void _if(Request& r, const String&, MethodParams *params) {  // methods
         Value& condition_code=params->get(0);  
   
         bool condition=r.process(condition_code,   static void _if(Request& r, MethodParams& params) {
                 0/*no name*/,          Value& condition_code=params.as_junction(0, "condition must be expression");
   
           bool condition=r.process_to_value(condition_code, 
                 false/*don't intercept string*/).as_bool();                  false/*don't intercept string*/).as_bool();
         if(condition)          if(condition)
                 r.write_pass_lang(r.process(params->get(1)));                  r.write_pass_lang(r.process(params.as_junction(1, "'then' parameter must be code")));
         else if(params->size()==3)          else if(params.count()>2)
                 r.write_pass_lang(r.process(params->get(2)));                  r.write_pass_lang(r.process(params.as_junction(2, "'else' parameter must be code")));
 }  }
   
 static void _untaint(Request& r, const String& method_name, MethodParams *params) {  static void _untaint(Request& r, MethodParams& params) {
         Pool& pool=r.pool();  
           String::Language lang;
         const String& lang_name=r.process(params->get(0)).as_string();          if(params.count()==1)
         String::Untaint_lang lang=static_cast<String::Untaint_lang>(                  lang=String::L_AS_IS; // mark as simply 'tainted'. useful in html from sql 
                 untaint_lang_name2enum->get_int(lang_name));          else {
         if(!lang)                  const String& lang_name=params.as_string(0, "lang must be string");
                 PTHROW(0, 0,                  lang=untaint_lang_name2enum.get(lang_name);
                         &lang_name,                  if(!lang)
                         "invalid untaint language");                          throw Exception(0,
                                   &lang_name,
                                   "invalid taint language");
           }
   
         {          {
                 Value& vbody=params->get_junction(1, "body must be code");                  Value& vbody=params.as_junction(params.count()-1, "body must be code");
                                   
                 Temp_lang temp_lang(r, lang); // set temporarily specified ^untaint[language;                  Temp_lang temp_lang(r, lang); // set temporarily specified ^untaint[language;
                 r.write_pass_lang(r.process(vbody)); // process marking tainted with that lang                  r.write_pass_lang(r.process(vbody)); // process marking tainted with that lang
         }          }
 }  }
   
 static void _taint(Request& r, const String&, MethodParams *params) {  static void _taint(Request& r, MethodParams& params) {
         Pool& pool=r.pool();          String::Language lang;
           if(params.count()==1)
         String::Untaint_lang lang;                  lang=String::L_TAINTED; // mark as simply 'tainted'. useful in table:set
         if(params->size()==1)  
                 lang=String::UL_TAINTED; // mark as simply 'tainted'. useful in table:set  
         else {          else {
                 const String& lang_name=                  const String& lang_name=params.as_string(0, "lang must be string");
                         r.process(params->get(0)).as_string();                  lang=untaint_lang_name2enum.get(lang_name);
                 lang=static_cast<String::Untaint_lang>(  
                         untaint_lang_name2enum->get_int(lang_name));  
                 if(!lang)                  if(!lang)
                         PTHROW(0, 0,                          throw Exception(0,
                                 &lang_name,                                  &lang_name,
                                 "invalid taint language");                                  "invalid taint language");
         }          }
   
         {          {
                 Value& vbody=params->get_no_junction(params->size()-1, "body must not be code");                  Value& vbody=params.as_no_junction(params.count()-1, "body must not be code");
                                   
                 String result(r.pool());                  String result;
                 result.append(                  result.append(
                         vbody.as_string(),  // process marking tainted with that lang                          vbody.as_string(),  // process marking tainted with that lang
                         lang, true);  // force result language to specified                          lang, true);  // force result language to specified
Line 74  static void _taint(Request& r, const Str Line 139  static void _taint(Request& r, const Str
         }          }
 }  }
   
 static void _process(Request& r, const String& method_name, MethodParams *params) {  static void _process(Request& r, MethodParams& params) {
         // calculate pseudo file name of processed chars          Method* main_method;
         // would be something like "/some/file(4) process"  
         char place[MAX_STRING];          size_t index=0;
 #ifndef NO_STRING_ORIGIN          Value* target_self;
         const Origin& origin=method_name.origin();          Value& maybe_target_self=params[index];
         snprintf(place, MAX_STRING, "%s(%d) %s",           if(maybe_target_self.get_string() || maybe_target_self.get_junction())
                 origin.file, 1+origin.line,                  target_self=&r.get_method_frame()->caller()->self();
                 method_name.cstr());          else {
 #else                  target_self=&maybe_target_self;  index++;
         strncpy(place, MAX_STRING, method_name.cstr());          }
 #endif    
   
         VStateless_class& self_class=*r.self->get_class();  
         {          {
                   VStateless_class *target_class=target_self->get_last_derived_class();
                   if(!target_class)
                           throw Exception("parser.runtime",
                                   0,
                                   "no target class");
   
                   // temporary remove language change
                   Temp_lang temp_lang(r, String::L_PASS_APPENDED);
                 // temporary zero @main so to maybe-replace it in processed code                  // temporary zero @main so to maybe-replace it in processed code
                 Temp_method temp_method_main(self_class, *main_method_name, 0);                  Temp_method temp_method_main(*target_class, main_method_name, 0);
                 // temporary zero @auto so it wouldn't be auto-called in Request::use_buf                  // temporary zero @auto so it wouldn't be auto-called in Request::use_buf
                 Temp_method temp_method_auto(self_class, *auto_method_name, 0);                  Temp_method temp_method_auto(*target_class, auto_method_name, 0);
                   
                 // evaluate source to process  
                 const String& source=  
                         r.process(params->get(0)).as_string();  
   
                 // process source code, append processed methods to 'self' class                  size_t options_index=index+1;
                 // maybe-define new @main                  HashStringValue* options=0;
                 r.use_buf(source.cstr(), place, &self_class);                  if(options_index<params.count()) {
                                           Value& voptions=params.as_no_junction(options_index, "options must not be code");
                 // maybe-execute @main[]                          options=voptions.get_hash();
                 if(const Method *method=self_class.get_method(*main_method_name)) {                          if(!options)
                         // execute!                                       throw Exception("parser.runtime",
                         r.execute(*method->parser_code);                                          0,
                                           "options must be hash");
                 }                  }
   
                   const String* main_alias=0;
                   const String* file_alias=0;
                   int line_no_alias_offset=0;
                   if(options) {
                           int valid_options=0;
                           if(Value* vmain_alias=options->get(PROCESS_MAIN_OPTION_NAME)) {
                                   valid_options++;
                                   main_alias=&vmain_alias->as_string();
                           }
                           if(Value* vfile_alias=options->get(PROCESS_FILE_OPTION_NAME)) {
                                   valid_options++;
                                   file_alias=&vfile_alias->as_string();
                           }
                           if(Value* vline_no_alias_offset=options->get(PROCESS_LINENO_OPTION_NAME)) {
                                   valid_options++;
                                   line_no_alias_offset=vline_no_alias_offset->as_int();
                           }
           
                           if(valid_options!=options->count())
                                   throw Exception("parser.runtime",
                                           0,
                                           "called with invalid option");
                   }
   
                   uint processe_file_no=file_alias?
                           r.register_file(r.absolute(*file_alias))
                           : pseudo_file_no__process;
                   // process...{string}
                   Value& vjunction=params.as_junction(index, "body must be code");
                   // evaluate source to process
                   const String& source=r.process_to_string(vjunction);
                   r.use_buf(*target_class,
                           source.cstr(String::L_UNSPECIFIED, r.connection(false)),
                           main_alias,
                           processe_file_no,
                           line_no_alias_offset);
   
                   // main_method
                   main_method=target_class->get_method(main_method_name);
           }
           // after restoring current-request-lang
           // maybe-execute @main[]
           if(main_method) {
                   // temporarily set method_frame's self to target_self
                   Temp_method_frame_self tmfs(*r.get_method_frame(), *target_self);
                   // execute!     
                   r.execute(*main_method->parser_code);
         }          }
 }  }
                   
 static void _rem(Request& r, const String&, MethodParams *params) {  static void _rem(Request&, MethodParams& params) {
         params->get_junction(0, "body must be code");          params.as_junction(0, "body must be code");
 }  }
   
 static void _while(Request& r, const String& method_name, MethodParams *params) {  static void _while(Request& r, MethodParams& params) {
         Pool& pool=r.pool();          Value& vcondition=params.as_junction(0, "condition must be expression");
           Value& body=params.as_junction(1, "body must be code");
         Value& vcondition=params->get_junction(0, "condition must be expression");  
         Value& body=params->get_junction(1, "body must be code");  
   
         // while...          // while...
         int endless_loop_count=0;          int endless_loop_count=0;
         while(true) {          while(true) {
                 if(++endless_loop_count>=1973) // endless loop?                  if(++endless_loop_count>=MAX_LOOPS) // endless loop?
                         PTHROW(0, 0,                          throw Exception("parser.runtime",
                                 &method_name,                                  0,
                                 "endless loop detected");                                  "endless loop detected");
   
                 bool condition=                  bool condition=r.process_to_value(vcondition, 
                         r.process(  
                                 vcondition,   
                                 0/*no name*/,  
                                 false/*don't intercept string*/).as_bool();                                  false/*don't intercept string*/).as_bool();
                 if(!condition) // ...condition is true                  if(!condition) // ...condition is true
                         break;                          break;
Line 141  static void _while(Request& r, const Str Line 252  static void _while(Request& r, const Str
         }          }
 }  }
   
 static void _use(Request& r, const String& method_name, MethodParams *params) {  static void _use(Request& r, MethodParams& params) {
         Value& vfile=params->get_no_junction(0, "file name must not be code");          Value& vfile=params.as_no_junction(0, "file name must not be code");
         r.use_file(r.absolute(vfile.as_string()));          r.use_file(r.main_class, vfile.as_string());
 }  }
   
 /// ^for[i;from-number;to-number-inclusive]{code}[delim]  static void _for(Request& r, MethodParams& params) {
 static void _for(Request& r, const String& method_name, MethodParams *params) {          const String& var_name=params.as_string(0, "var name must be string");
         Pool& pool=r.pool();          int from=params.as_int(1, "from must be int", r);
         const String& var_name=r.process(params->get(0)).as_string();          int to=params.as_int(2, "to must be int", r);
         int from=(int)r.process(params->get(1)).as_double();          Value&  body_code=params.as_junction(3, "body must be code");
         int to=(int)r.process(params->get(2)).as_double();          Value* delim_maybe_code=params.count()>4?&params[4]:0;
         Value& body_code=params->get_junction(3, "body must be code");  
         Value *delim_code=params->size()==3+1+1?&params->get(3+1):0;          if(to-from>=MAX_LOOPS) // too long loop?
                   throw Exception("parser.runtime",
                           0,
                           "endless loop detected");
   
         bool need_delim=false;          bool need_delim=false;
         VInt *vint=new(pool) VInt(pool, 0);          VInt* vint=new VInt(0);
         int endless_loop_count=0;          r.get_method_frame()->caller()->put_element(var_name, vint, false);
         for(int i=from; i<=to; i++) {          for(int i=from; i<=to; i++) {
                 if(++endless_loop_count>=2001) // endless loop?  
                         PTHROW(0, 0,  
                                 &method_name,  
                                 "endless loop detected");  
                 vint->set_int(i);                  vint->set_int(i);
                 r.root->put_element(var_name, vint);  
   
                 Value& processed_body=r.process(body_code);                  StringOrValue sv_processed=r.process(body_code);
                 if(delim_code) { // delimiter set?                  const String* s_processed=sv_processed.get_string();
                         const String *string=processed_body.get_string();                  if(delim_maybe_code && s_processed && s_processed->length()) { // delimiter set and we have body
                         if(need_delim && string && string->size()) // need delim & iteration produced string?                          if(need_delim) // need delim & iteration produced string?
                                 r.write_pass_lang(r.process(*delim_code));                                  r.write_pass_lang(r.process(*delim_maybe_code));
                         need_delim=true;                          need_delim=true;
                 }                  }
                 r.write_pass_lang(processed_body);                  r.write_pass_lang(sv_processed);
         }          }
 }  }
   
 static void _eval(Request& r, const String&, MethodParams *params) {  static void _eval(Request& r, MethodParams& params) {
         Value& expr=params->get_junction(0, "need expression");          Value& expr=params.as_junction(0, "need expression");
         // evaluate expresion          // evaluate expresion
         Value *result=r.process(expr,           Value& value_result=r.process_to_value(expr, 
                 0/*no name*/,  
                 true/*don't intercept string*/).as_expr_result();                  true/*don't intercept string*/).as_expr_result();
         if(params->size()==2) {          if(params.count()>1) {
                 Value& fmt=params->get_no_junction(1, "fmt must not be code");                  Value& fmt=params.as_no_junction(1, "fmt must not be code");
                   r.write_no_lang(String(format(value_result.as_double(), fmt.as_string().cstrm())));
           } else
                   r.write_no_lang(value_result);
   }
   
   static void _connect(Request& r, MethodParams& params) {
   #ifdef RESOURCES_DEBUG
   struct timeval mt[2];
   #endif
           Value& url=params.as_no_junction(0, "url must not be code");
           Value& body_code=params.as_junction(1, "body must be code");
   
           Table* protocol2driver_and_client=0;
           if(Value* sql=r.main_class.get_element(String(MAIN_SQL_NAME), r.main_class, false)) {
                   if(Value* element=sql->get_element(String(MAIN_SQL_DRIVERS_NAME), *sql, false)) {
                           protocol2driver_and_client=element->get_table();
                   }
           }
   
                 Pool& pool=r.pool();  #ifdef RESOURCES_DEBUG
                 String& string=*new(pool) String(pool);  //measure:before
                 string.APPEND_CONST(format(pool, result->as_double(), fmt.as_string().cstr()));  gettimeofday(&mt[0],NULL);
                 result=new(pool) VString(string);  #endif
           // connect
           SQL_Connection* connection=SQL_driver_manager->get_connection(url.as_string(), 
                   protocol2driver_and_client,
                   r.charsets.source().NAME().cstr());
   
   #ifdef RESOURCES_DEBUG
   //measure:after connect
   gettimeofday(&mt[1],NULL);
   
   double t[2];
   for(int i=0;i<2;i++)
       t[i]=mt[i].tv_sec+mt[i].tv_usec/1000000.0;
   
   r.sql_connect_time+=t[1]-t[0];
   #endif
           Temp_connection temp_connection(r, connection);
           // execute body
           try {
                   r.write_assign_lang(r.process(body_code));
                   connection->commit();
                   connection->close();
           } catch(...) { // process problem
                   connection->rollback();
                   connection->close();
                   rethrow;
         }          }
         r.write_no_lang(*result);  
 }  }
   
   #ifndef DOXYGEN
   class Switch_data: public PA_Object {
   public:
           Request& r;
           Value& searching;
           Value* found;
           Value* _default;
   public:
           Switch_data(Request& ar, Value& asearching): 
             r(ar), searching(asearching) {}
   };
   #endif
   static void _switch(Request& r, MethodParams& params) {
           Switch_data* data=new Switch_data(r, r.process_to_value(params[0]));
           Temp_hash_value<const String::Body, void*> 
                   switch_data_setter(r.classes_conf, switch_data_name, data);
   
           Value& cases_code=params.as_junction(1, "switch cases must be code");
           // execution of found ^case[...]{code} must be in context of ^switch[...]{code}
           // because of stacked WWrapper used there as wcontext
           r.process(cases_code, true/*intercept_string*/);
           if(Value* selected_code=data->found? data->found: data->_default)
                   r.write_pass_lang(r.process(*selected_code));
   }
   
   static void _case(Request& r, MethodParams& params) {
           Switch_data* data=static_cast<Switch_data*>(r.classes_conf.get(switch_data_name));
           if(!data)
                   throw Exception("parser.runtime",
                           0,
                           "without switch");
   
 typedef double (*math_one_double_op_func_ptr)(double);          int count=params.count();
 static double round(double op) { return floor(op+0.5); }          Value& code=params.as_junction(--count, "case result must be code");
 static double sign(double op) { return op > 0 ? 1 : ( op < 0 ? -1 : 0 ); }          
           for(int i=0; i<count; i++) {
                   Value& value=r.process_to_value(params[i]);
   
 static void double_one_op(                  if(value.as_string() == CASE_DEFAULT_VALUE) {
                                                                 Request& r,                           data->_default=&code;
                                                                 const String& method_name, MethodParams *params,                          break;
                                                                 math_one_double_op_func_ptr func) {                  }
         Pool& pool=r.pool();  
         Value& param=params->get_junction(0, "parameter must be expression");  
   
         Value& result=*new(pool) VDouble(pool, (*func)(r.process(param).as_double()));                  bool matches;
         r.write_no_lang(result);                  if(data->searching.is_string())
 }                          matches=data->searching.as_string() == value.as_string();
                   else
                           matches=data->searching.as_double() == value.as_double();
   
                   if(matches) {
                           if(data->found)
                                   throw Exception("parser.runtime",
                                           0,
                                           "duplicate found");
   
 static void _round(Request& r, const String& method_name, MethodParams *params) {                          data->found=&code;
         double_one_op(r, method_name, params,   &round);                          break;
                   }
           }
 }  }
   #ifndef DOXYGEN
   struct Try_catch_result {
           StringOrValue processed_code;
           const String* exception_should_be_handled;
   
           Try_catch_result(): exception_should_be_handled(0) {}
   };
   #endif
   
   /// used by ^try and ^cache, @returns $exception.handled[string] if any
   template<class I>
   static Try_catch_result try_catch(Request& r, 
                     StringOrValue body_code(Request&, I), I info, 
                     Value* catch_code) 
   {
           Try_catch_result result;
           if(!catch_code) {
                   result.processed_code=body_code(r, info);
                   return result;
           }
   
           // taking snapshot of try-context
           Request_context_saver try_context(r);
           try {
                   result.processed_code=body_code(r, info);
           } catch(const Exception& e) {
                   Request_context_saver throw_context(r); // taking snapshot of throw-context [stack trace contains error]
                   Request::Exception_details details=r.get_details(e);
                   try_context.restore(); // restoring try-context to perform catch-code
   
                   Junction* junction=catch_code->get_junction();
                   Value* method_frame=junction->method_frame;
                   Value* saved_exception_var_value=method_frame->get_element(exception_var_name, *method_frame, false);
                   junction->method_frame->put_element(exception_var_name, &details.vhash, false);
                   result.processed_code=r.process(*catch_code);
                   
                   // retriving $exception.handled, restoring $exception var
                   Value* vhandled=details.vhash.hash().get(exception_handled_part_name);
                   junction->method_frame->put_element(exception_var_name, saved_exception_var_value, false);
   
                   bool bhandled=false;
                   if(vhandled) {
                           if(vhandled->is_string()) { // not simple $exception.handled(1/0)?
                                   result.exception_should_be_handled=vhandled->get_string(); // considering 'recovered' and let the caller recover
                                   return result;
                           }
   
 static void _floor(Request& r, const String& method_name, MethodParams *params) {                          bhandled=vhandled->as_bool();           
         double_one_op(r, method_name, params,   &floor);                  }
   
                   if(!bhandled) {
                           throw_context.restore(); // restoring throw-context [exception were not handled]
                           rethrow;
                   }
           }
           return result;
 }  }
   
 static void _ceiling(Request& r, const String& method_name, MethodParams *params) {  // cache--
         double_one_op(r, method_name, params,   &ceil);  
   // consts
   
   const int DATA_STRING_SERIALIZED_VERSION=0x0006;
   
   // helper types
   
   #ifndef DOXYGEN
   struct Data_string_serialized_prolog {
           int version;
           time_t expires;
   };
   #endif
   
   void cache_delete(const String& file_spec) {
           file_delete(file_spec, false/*fail_on_read_problem*/);
 }  }
   
 static void _abs(Request& r, const String& method_name, MethodParams *params) {  #ifndef DOXYGEN
         double_one_op(r, method_name, params,   &fabs);  struct Cache_scope {
   public:
           time_t expires;
           const String* body_from_disk;
   };
   struct Locked_process_and_cache_put_action_info {
           Request *r;
           Cache_scope *scope;
           Value* body_code; Value* catch_code; 
           const String* processed_code;
   };
   #endif
   
   
   
   static StringOrValue process_cache_body_code(Request& r, Value* body_code) {
           return StringOrValue(r.process_to_string(*body_code));
 }  }
   
 static void _sign(Request& r, const String& method_name, MethodParams *params) {  /* @todo maybe network order worth spending some effort?
         double_one_op(r, method_name, params,   &sign);          don't bothering myself with network byte order,
           am not planning to be able to move resulting file across platforms
   */
   static void locked_process_and_cache_put_action(int f, void *context) {
           Locked_process_and_cache_put_action_info& info=
                   *static_cast<Locked_process_and_cache_put_action_info *>(context);
   
           // body->process 
           Try_catch_result result=try_catch(*info.r, 
                   process_cache_body_code, info.body_code,
                   info.catch_code);
   
           if(result.exception_should_be_handled) {
                   if(*result.exception_should_be_handled==CACHE_EXCEPTION_HANDLED_CACHE_NAME) {
                           if(const String* body_from_disk=info.scope->body_from_disk) // we have something old?
                                   info.processed_code=body_from_disk;
                           else
                                   throw Exception(0,
                                           new String("$"EXCEPTION_VAR_NAME"."EXCEPTION_HANDLED_PART_NAME"["CACHE_EXCEPTION_HANDLED_CACHE_NAME"]"),
                                           "fallback failed - there is no old cached body");
                   } else
                           throw Exception("parser.runtime",
                                   result.exception_should_be_handled,
                                   "$"EXCEPTION_VAR_NAME"."EXCEPTION_HANDLED_PART_NAME" value must be "
                                   "either boolean or string '"CACHE_EXCEPTION_HANDLED_CACHE_NAME"'");
           } else
                   info.processed_code=&result.processed_code.as_string();
   
           // expiration time not spoiled by ^cache(0) or something?
           if(info.scope->expires > time(0)) {
                   // string -serialize> buffer
                   String::Cm serialized=info.processed_code->serialize(
                           sizeof(Data_string_serialized_prolog));
                   Data_string_serialized_prolog& prolog=
                           *reinterpret_cast<Data_string_serialized_prolog *>(serialized.str);
                   prolog.version=DATA_STRING_SERIALIZED_VERSION;
                   prolog.expires=info.scope->expires;
                   
                   // buffer -write> file
                   write(f, serialized.str, serialized.length);
           } else // expired!
                   info.scope->expires=0; // flag it so that could be easily checked by caller
   }
   const String* locked_process_and_cache_put(Request& r, 
                                              Value& body_code,
                                              Value* catch_code,
                                              Cache_scope& scope,
                                              const String& file_spec) 
   {
           Locked_process_and_cache_put_action_info info={&r, &scope, &body_code, catch_code, 0};
   
           const String* result=file_write_action_under_lock(
                   file_spec, 
                   "cache_put", locked_process_and_cache_put_action, &info,
                   false/*as_text*/,
                   false/*do_append*/,
                   false/*block*/,
                   false/*fail on lock problem*/) ? info.processed_code: 0;
           time_t now=time(0);
           if(scope.expires<=now)
                   cache_delete(file_spec);
           return result;
   }
   #ifndef DOXYGEN
   struct Cache_get_result {
           const String* body;
           bool expired;
   };
   #endif
   static Cache_get_result cache_get(Request_charsets& charsets, const String& file_spec, time_t now) {
           Cache_get_result result={0, false};
   
           File_read_result file=file_read(charsets, file_spec, 
                              false/*as_text*/, 
                              0, //no params
                              false/*fail_on_read_problem*/);
           if(file.success && file.length/* ignore reads which are empty due to 
                           non-unary open+lockEX conflict with lockSH */) {
                           
                   Data_string_serialized_prolog& prolog=
                           *reinterpret_cast<Data_string_serialized_prolog *>(file.str);
   
                   String* body=new String;
                   if(
                           file.length>=sizeof(Data_string_serialized_prolog)
                           && prolog.version==DATA_STRING_SERIALIZED_VERSION) {
                           if(body->deserialize(sizeof(Data_string_serialized_prolog),  file.str, file.length)) {
                                   result.body=body;
                                   result.expired=prolog.expires <= now;
                           }
                   }
           }
   
           return result;
   }
   static time_t as_expires(Request& r, MethodParams& params, 
                                                   int index, time_t now) {
           time_t result;
           if(Value* vdate=params[index].as(VDATE_TYPE, false))
                   result=static_cast<VDate*>(vdate)->get_time();
           else
                   result=now+(time_t)params.as_double(index, "lifespan must be date or number", r);
           
           return result;
 }  }
   static const String& as_file_spec(Request& r, MethodParams& params, int index) {
           return r.absolute(params.as_string(index, "filespec must be string"));
   }
   static void _cache(Request& r, MethodParams& params) {
           time_t now=time(0);
   
 /// ^connect[protocol://user:pass@host[:port]/database]{code with ^sql-s}          // ^cache[filename] ^cache(seconds) ^cache[expires date]
 static void _connect(Request& r, const String&, MethodParams *params) {          if(params.count()==1) {
         Pool& pool=r.pool();                  if(params[0].is_string()) { // filename?
                           cache_delete(as_file_spec(r, params, 0));
                           return;
                   }
   
         Value& url=params->get_no_junction(0, "url must not be code");                  // secods|expires date
         Value& body_code=params->get_junction(1, "body must be code");                  Cache_scope* scope=static_cast<Cache_scope*>(r.classes_conf.get(cache_data_name));
                   if(!scope)
                           throw Exception("parser.runtime",
                                   0,
                                   "expire-time reducing instruction without cache");
                   
                   time_t expires=as_expires(r, params, 0, now);
                   if(expires < scope->expires)
                           scope->expires=expires;
   
                   return;
           } else if(params.count()<3)
                   throw Exception("parser.runtime",
                           0,
                           "invalid number of parameters"); 
           
           // file_spec, expires, body code
           const String& file_spec=r.absolute(params.as_string(0, "filespec must be string"));
   
         // connect          Cache_scope scope={as_expires(r, params, 1, now), 0};
         SQL_Connection& connection=SQL_driver_manager->get_connection(  
                 url.as_string(), r.protocol2library);  
   
         Exception rethrow_me;          Temp_hash_value<const String::Body, void*> 
         // remember/set current connection                  cache_scope_setter(r.classes_conf, cache_data_name, &scope);
         SQL_Connection *saved_connection=r.connection;          Value& body_code=params.as_junction(2, "body_code must be code");
         r.connection=&connection;          Value* catch_code=0;
         // execute body          if(params.count()>3)
         bool body_failed=false;                    catch_code=&params.as_junction(3, "catch_code must be code");
         PTRY  
                 r.write_assign_lang(r.process(body_code));          if(scope.expires>now) { // valid 'expires' specified? try cached copy...
         PCATCH(e) { // connect/process problem                  // hence we don't hope to have unary create/lockEX
                 rethrow_me=e;  body_failed=true;                   // we need some plan to live in a life like that, so... 
                   // worst races plan:
                   // A        B
                   // open
                   //          |open
                   // lockSH
                   //          |nonblocking-lockEX fails
                   // unlockSH
                   // close, cache_get returns 0
                   // open
                   // nonblocking-lockEX succeeds; process, write, close
                   //          |retry1: open
                   // ...
                   //          |lockSH succeeds; ...
   
                   for(int retry=0; retry<2; retry++) {
                           Cache_get_result cached=cache_get(r.charsets, file_spec, now);
                           if(cached.body) { // have cached copy
                                   if(cached.expired) 
                                           scope.body_from_disk=cached.body; // storing for user to retrive it with ^cache[]
                                   else // and it's not expired yet
                                   {
                                   // write it out 
                                   r.write_assign_lang(*cached.body);
                                   // happy with it
                                   return;
                           }
                           }
   
                   // non-blocked lock; process; cache it
                   if(const String* processed_body=
                           locked_process_and_cache_put(r, body_code, catch_code, scope, file_spec)) {
                           // write it out 
                           r.write_assign_lang(*processed_body);
                           // happy with it
                           return;
                   } else { // somebody writing result right now
                           pa_sleep(0, 500000); // waiting half a second
                           retry=0; // prolonging our wait, than could cache_get it, without processing body_code
                   }
                   }
                   throw Exception(0,
                           &file_spec,
                           "locking problem");
           } else { 
                   // instructed not to cache; forget cached copy
                   cache_delete(file_spec);
                   // process
                   const String& processed_body=r.process_to_string(body_code);
                   // write it out 
                   r.write_assign_lang(processed_body);
                   // happy with it
                   return;
         }          }
         PEND_CATCH          // never reached
   }
   
         bool finalizer_failed=false;  static StringOrValue process_try_body_code(Request& r, Value* body_code) {
         PTRY          return r.process(*body_code);
                 // FINALLY  }
                 if(body_failed)  static void _try_operator(Request& r, MethodParams& params) {
                         connection.rollback();          Value& body_code=params.as_junction(0, "body_code must be code");
                 else          Value& catch_code=params.as_junction(1, "catch_code must be code");
                         connection.commit();  
         PCATCH(e) { // commit/rollback problem          Try_catch_result result=try_catch(r, 
                 rethrow_me=e;  finalizer_failed=true;                   process_try_body_code, &body_code,
                   &catch_code);
           
           if(result.exception_should_be_handled)
                   throw Exception("parser.runtime",
                           result.exception_should_be_handled,
                           "catch block must set $exception.handled to some boolean value, not string");
   
           // write out processed body_code or catch_code
           r.write_pass_lang(result.processed_code);
   }
   
   static void _throw_operator(Request&, MethodParams& params) {
           if(params.count()==1) {
                   if(HashStringValue *hash=params[0].get_hash()) {
                           const char* type=0;
                           if(Value* value=hash->get(exception_type_part_name))
                                   type=value->as_string().cstr();
                           const String* source=0;
                           if(Value* value=hash->get(exception_source_part_name))
                                   source=&value->as_string();
                           const char* comment=0;
                           if(Value* value=hash->get(exception_comment_part_name))
                                   comment=value->as_string().cstr();
   
                           throw Exception(type,
                                   source?source:0,
                                   "%s", comment?comment:"");
                   } else
                           throw Exception("parser.runtime",
                                   0,
                                   "one-param version has hash param");
           } else {
                   const char* type=params.as_string(0, "type must be string").cstr();
                   const String& source=params.as_string(1, "source must be string");
                   const char* comment=params.count()>2? params.as_string(2, "comment must be string").cstr()
                           :0;
                   throw Exception(type, &source, "%s", comment?comment:"");
         }          }
         PEND_CATCH   }
   
         // close connection [cache it]  static void _sleep_operator(Request& r, MethodParams& params) {
         connection.close();          double seconds=params.as_double(0, "seconds must be double", r);
         // recall current connection from remembered          pa_sleep((int)trunc(seconds), (int)trunc(seconds*1000));
         r.connection=saved_connection;   }
   
         if(body_failed || finalizer_failed) // were there an exception for us to rethrow?  #if defined(WIN32) && defined(_DEBUG)
                 PTHROW(rethrow_me.type(), rethrow_me.code(),  #       define PA_BPT
                         rethrow_me.problem_source(),  static void _bpt(Request&, MethodParams&) {
                         rethrow_me.comment());          _asm int 3;
 }  }
   #endif
   
   // constructor
   
 // initialize  VClassMAIN::VClassMAIN(): VClass() {
           set_name(*new String(MAIN_CLASS_NAME));
   
   #ifdef PA_BPT
           // ^bpt[]
           add_native_method("bpt", Method::CT_ANY, _bpt, 0, 0);
   #endif
   
 void initialize_op_class(Pool& pool, VStateless_class& vclass) {  
         // ^if(condition){code-when-true}          // ^if(condition){code-when-true}
         // ^if(condition){code-when-true}{code-when-false}          // ^if(condition){code-when-true}{code-when-false}
         vclass.add_native_method("if", Method::CT_ANY, _if, 2, 3);          add_native_method("if", Method::CT_ANY, _if, 2, 3);
   
         // ^untaint[as-is|uri|sql|js|html|html-typo]{code}          // ^untaint[as-is|uri|sql|js|html|html-typo]{code}
         vclass.add_native_method("untaint", Method::CT_ANY, _untaint, 2, 2);          add_native_method("untaint", Method::CT_ANY, _untaint, 1, 2);
   
         // ^taint[as-is|uri|sql|js|html|html-typo]{code}          // ^taint[as-is|uri|sql|js|html|html-typo]{code}
         vclass.add_native_method("taint", Method::CT_ANY, _taint, 1, 2);          add_native_method("taint", Method::CT_ANY, _taint, 1, 2);
   
         // ^process[code]          // ^process[code]
         vclass.add_native_method("process", Method::CT_ANY, _process, 1, 1);          add_native_method("process", Method::CT_ANY, _process, 1, 3);
   
         // ^rem{code}          // ^rem{code}
         vclass.add_native_method("rem", Method::CT_ANY, _rem, 1, 1);          add_native_method("rem", Method::CT_ANY, _rem, 1, 10000);
   
         // ^while(condition){code}          // ^while(condition){code}
         vclass.add_native_method("while", Method::CT_ANY, _while, 2, 2);          add_native_method("while", Method::CT_ANY, _while, 2, 2);
   
         // ^use[file]          // ^use[file]
         vclass.add_native_method("use", Method::CT_ANY, _use, 1, 1);          add_native_method("use", Method::CT_ANY, _use, 1, 1);
   
         // ^for[i;from-number;to-number-inclusive]{code}[delim]          // ^for[i](from-number;to-number-inclusive){code}[delim]
         vclass.add_native_method("for", Method::CT_ANY, _for, 3+1, 3+1+1);          add_native_method("for", Method::CT_ANY, _for, 3+1, 3+1+1);
   
         // ^eval(expr)          // ^eval(expr)
         // ^eval(expr)[format]          // ^eval(expr)[format]
         vclass.add_native_method("eval", Method::CT_ANY, _eval, 1, 2);          add_native_method("eval", Method::CT_ANY, _eval, 1, 2);
   
           // ^connect[protocol://user:pass@host[:port]/database]{code with ^sql-s}
           add_native_method("connect", Method::CT_ANY, _connect, 2, 2);
   
         // math functions  
   
         // ^round(expr)           // ^cache[file_spec](time){code}[{catch code}] time=0 no cache
         vclass.add_native_method("round", Method::CT_ANY, _round, 1, 1);          // ^cache[file_spec] delete cache
           add_native_method("cache", Method::CT_ANY, _cache, 1, 4);
           
           // switch
   
         // ^floor(expr)           // ^switch[value]{cases}
         vclass.add_native_method("floor", Method::CT_ANY, _floor, 1, 1);          add_native_method("switch", Method::CT_ANY, _switch, 2, 2);
   
         // ^ceiling(expr)                 // ^case[value]{code}
         vclass.add_native_method("ceiling", Method::CT_ANY, _ceiling, 1, 1);          add_native_method("case", Method::CT_ANY, _case, 2, 10000);
   
         // ^abs(expr)             // try-catch
         vclass.add_native_method("abs", Method::CT_ANY, _abs, 1, 1);  
   
         // ^sign(expr)          // ^try{code}{catch code}
         vclass.add_native_method("sign", Method::CT_ANY, _sign, 1, 1);          add_native_method("try", Method::CT_ANY, _try_operator, 2, 2);
           // ^throw[$exception hash]
           // ^throw[type;source;comment]
           add_native_method("throw", Method::CT_ANY, _throw_operator, 1, 3);
   
                   add_native_method("sleep", Method::CT_ANY, _sleep_operator, 1, 1);
         // connect  }
   
         // ^connect[protocol://user:pass@host[:port]/database]{code with ^sql-s}  // constructor & configurator
         vclass.add_native_method("connect", Method::CT_ANY, _connect, 2, 2);  
   
   VStateless_class& VClassMAIN_create() {
           return *new VClassMAIN;
 }  }
Removed from v.1.8  
changed lines
  Added in v.1.153

E-mail: