Annotation of parser3/src/types/pa_vmethod_frame.h, revision 1.43.4.2

1.3       paf         1: /** @file
1.5       paf         2:        Parser: @b method_frame write context
1.3       paf         3: 
1.21      paf         4:        Copyright (c) 2001, 2002 ArtLebedev Group (http://www.artlebedev.com)
1.22      paf         5:        Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
1.1       paf         6: */
                      7: 
                      8: #ifndef PA_VMETHOD_FRAME_H
                      9: #define PA_VMETHOD_FRAME_H
1.28      paf        10: 
1.43.4.2! paf        11: static const char* IDENT_VMETHOD_FRAME_H="$Date: 2002/10/31 12:22:14 $";
1.1       paf        12: 
                     13: #include "pa_wcontext.h"
1.12      parser     14: #include "pa_vvoid.h"
1.1       paf        15: #include "pa_vjunction.h"
1.35      paf        16: #include "pa_request.h"
1.1       paf        17: 
1.40      paf        18: // defines
                     19: 
1.42      paf        20: #define CALLER_ELEMENT_NAME "caller"
                     21: #define SELF_ELEMENT_NAME "self"
1.40      paf        22: 
1.4       paf        23: /**    Method frame write context
                     24:        accepts values written by method code
                     25:        also handles method parameters and local variables
1.3       paf        26: */
1.1       paf        27: class VMethodFrame : public WContext {
                     28: public: // Value
                     29: 
                     30:        const char *type() const { return "method_frame"; }
1.20      paf        31: 
                     32:        /// VMethodFrame: $result | parent get_string(=accumulated fstring)
                     33:        const String *get_string() { 
                     34:                // check the $result value
                     35:                Value *result=get_result_variable();
                     36:                // if we have one, return it's string value, else return as usual: accumulated fstring or fvalue
                     37:                return result ? result->get_string() : WContext::get_string();
                     38:        }
                     39:        
1.40      paf        40:        /// VMethodFrame: my or self_transparent or $caller
1.43.4.1  paf        41:        Value *get_element(const String& aname, Value& aself, bool looking_up) { 
1.25      paf        42:                if(junction.method->max_numbered_params_count==0) {
1.32      paf        43:                        if(Value *result=static_cast<Value *>(my.get(aname)))
1.1       paf        44:                                return result;
                     45:                }
1.41      paf        46:                if(Value *result=self().get_element(aname, aself, looking_up))
1.40      paf        47:                        return result;
                     48: 
1.42      paf        49:                if(aname==CALLER_ELEMENT_NAME)
1.40      paf        50:                        return caller();
1.42      paf        51: 
                     52:                if(aname==SELF_ELEMENT_NAME)
                     53:                        return &self();
1.40      paf        54: 
                     55:                return 0;
1.1       paf        56:        }
1.4       paf        57:        /// VMethodFrame: my or self_transparent
1.32      paf        58:        /*override*/ bool put_element(const String& aname, Value *avalue, bool replace) { 
                     59:                if(junction.method->max_numbered_params_count==0 && my.put_replace(aname, avalue))
                     60:                        return true;
                     61: 
1.41      paf        62:                return self().put_element(aname, avalue, replace);
1.1       paf        63:        }
                     64: 
1.4       paf        65:        /// VMethodFrame: self_transparent
1.43.4.1  paf        66:        /*override*/ VStateless_class* get_class() { return self().get_class(); }
                     67: 
                     68:        /// VMethodFrame: self_transparent
                     69:        /*override*/ Value *base() { return self().base(); }
1.1       paf        70: 
1.30      paf        71: public: // WContext
1.1       paf        72: 
1.35      paf        73:        /* override */ StringOrValue result() {
1.1       paf        74:                // check the $result value
1.24      paf        75:                Value *result_value=get_result_variable();
1.1       paf        76:                // if we have one, return it, else return as usual: accumulated fstring or fvalue
1.24      paf        77:                return result_value ? StringOrValue(0, result_value) : WContext::result();
1.1       paf        78:        }
                     79: 
                     80: public: // usage
                     81: 
                     82:        VMethodFrame(Pool& apool, 
1.25      paf        83:                const String& aname,
1.40      paf        84:                const Junction& ajunction/*info: always method-junction*/,
                     85:                VMethodFrame *acaller) : 
1.36      paf        86:                WContext(apool, 0 /* empty */, 0 /* no parent, junctions can be reattached only up to VMethodFrame */ ),
1.1       paf        87: 
1.25      paf        88:                fname(aname),
1.1       paf        89:                junction(ajunction),
1.40      paf        90:                fcaller(acaller),
1.1       paf        91:                store_param_index(0),
1.25      paf        92: 
                     93:                my(apool),
                     94:                fnumbered_params(apool, aname),
                     95: 
1.15      parser     96:                fself(0),
1.36      paf        97:                fresult_initial_void(0) {
1.1       paf        98: 
1.25      paf        99:                if(has_my()) { // this method uses named params?
                    100:                        const Method &method=*junction.method;
1.1       paf       101:                        if(method.locals_names) { // are there any local var names?
                    102:                                // remember them
1.25      paf       103:                                // those are flags that fname is local == to be looked up in 'my'
1.1       paf       104:                                for(int i=0; i<method.locals_names->size(); i++) {
1.25      paf       105:                                        // speedup: not checking for clash with "result" fname
1.12      parser    106:                                        Value *value=NEW VVoid(pool());
1.25      paf       107:                                        const String& fname=*method.locals_names->get_string(i);
                    108:                                        set_my_variable(fname, value);
1.1       paf       109:                                }
                    110:                        }
                    111:                        { // always there is one local: $result
1.15      parser    112:                                fresult_initial_void=NEW VVoid(pool());
1.18      paf       113:                                set_my_variable(*result_var_name, fresult_initial_void);
1.1       paf       114:                        }
                    115:                }
                    116:        }
                    117: 
1.25      paf       118:        const String& name() { return fname; }
1.40      paf       119:        VMethodFrame *caller() { return fcaller; }
1.25      paf       120: 
1.38      paf       121:        void set_self(Value& aself) { fself=&aself; }
1.41      paf       122:        /// we sure that someone already set our self with VMethodFrame::set_self(Value&)
                    123:        Value& self() { return *fself; }
1.1       paf       124: 
1.27      paf       125:        bool can_store_param() {
                    126:                const Method& method=*junction.method;
                    127:                return method.params_names && store_param_index<method.params_names->size();
                    128:        }
1.26      paf       129:        void store_param(Value *value) {
1.1       paf       130:                const Method& method=*junction.method;
                    131:                int max_params=
                    132:                        method.max_numbered_params_count?method.max_numbered_params_count:
                    133:                        method.params_names?method.params_names->size():
                    134:                        0;
                    135:                if(store_param_index==max_params)
1.23      paf       136:                        throw Exception("parser.runtime",
1.26      paf       137:                                &name(),
1.7       paf       138:                                "method of %s (%s) accepts maximum %d parameter(s)", 
1.38      paf       139:                                        junction.self.get_class()->name_cstr(),
                    140:                                        junction.self.type(),
1.1       paf       141:                                        max_params);
                    142:                
                    143:                if(method.max_numbered_params_count) { // are this method params numbered?
1.25      paf       144:                        fnumbered_params+=value;
1.1       paf       145:                } else { // named param
1.25      paf       146:                        // speedup: not checking for clash with "result" fname
                    147:                        const String& fname=*method.params_names->get_string(store_param_index);
                    148:                        set_my_variable(fname, value);
1.1       paf       149:                }
                    150:                store_param_index++;
                    151:        }
                    152:        void fill_unspecified_params() {
                    153:                const Method &method=*junction.method;
                    154:                if(method.params_names) // there are any named parameters might need filling?
                    155:                        for(; store_param_index<method.params_names->size(); store_param_index++) {
1.25      paf       156:                                const String& fname=*method.params_names->get_string(store_param_index);
                    157:                                my.put(fname, NEW VVoid(pool()));
1.1       paf       158:                        }
                    159:        }
                    160: 
1.25      paf       161:        MethodParams *numbered_params() { return &fnumbered_params; }
1.18      paf       162: 
                    163: private:
                    164: 
1.25      paf       165:        bool has_my() {
                    166:                return junction.method->max_numbered_params_count==0;
                    167:        }
                    168: 
                    169:        void set_my_variable(const String& fname, Value *value) {
                    170:                my.put(fname, value); // remember param
1.20      paf       171:        }
                    172: 
                    173:        Value *get_result_variable() {
1.25      paf       174:                Value *result=has_my()?static_cast<Value*>(my.get(*result_var_name)):0;
1.20      paf       175:                return result && result!=fresult_initial_void ? result : 0;
1.18      paf       176:        }
1.1       paf       177: 
                    178: public:
                    179:        
                    180:        const Junction& junction;
                    181: 
                    182: private:
1.35      paf       183: 
1.25      paf       184:        const String& fname;
1.40      paf       185:        VMethodFrame *fcaller;
1.25      paf       186: 
1.1       paf       187:        int store_param_index;
1.25      paf       188:        Hash my;/*OR*/MethodParams fnumbered_params;
1.1       paf       189:        Value *fself;
1.15      parser    190: 
                    191: private:
1.35      paf       192: 
1.15      parser    193:        Value *fresult_initial_void;
1.1       paf       194: 
1.41      paf       195: };
                    196: 
                    197: ///    Auto-object used for temporary changing VMethod_frame::fself.
                    198: class Temp_method_frame_self {
                    199:        VMethodFrame& fmethod_frame;
                    200:        Value& saved_self;
                    201: public:
                    202:        Temp_method_frame_self(VMethodFrame& amethod_frame, Value& aself) :
                    203:                fmethod_frame(amethod_frame),
                    204:                saved_self(amethod_frame.self()) {
                    205:                fmethod_frame.set_self(aself);
                    206:        }
                    207:        ~Temp_method_frame_self() {
                    208:                fmethod_frame.set_self(saved_self);
                    209:        }
1.1       paf       210: };
                    211: 
                    212: #endif

E-mail: