Annotation of parser3/src/classes/reflection.C, revision 1.47

1.1       misha       1: /** @file
                      2:        Parser: @b reflection parser class.
                      3: 
1.38      moko        4:        Copyright (c) 2001-2015 Art. Lebedev Studio (http://www.artlebedev.com)
1.1       misha       5:        Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
                      6: */
                      7: 
                      8: #include "pa_vmethod_frame.h"
                      9: #include "pa_request.h"
                     10: #include "pa_vbool.h"
                     11: 
1.47    ! moko       12: volatile const char * IDENT_REFLECTION_C="$Id: reflection.C,v 1.46 2016/07/20 14:53:55 moko Exp $";
1.24      moko       13: 
1.3       misha      14: static const String class_type_methoded("methoded");
1.2       misha      15: 
1.3       misha      16: static const String method_type_native("native");
                     17: static const String method_type_parser("parser");
1.2       misha      18: 
1.5       misha      19: static const String method_call_type("call_type");
1.8       misha      20: static const String method_inherited("inherited");
1.23      misha      21: static const String method_overridden("overridden");
1.2       misha      22: 
1.3       misha      23: static const String method_min_params("min_params");
                     24: static const String method_max_params("max_params");
1.29      misha      25: static const String method_extra_param("extra_param");
1.2       misha      26: 
1.30      misha      27: static const String def_class("class");
                     28: 
1.1       misha      29: // class
                     30: 
                     31: class MReflection: public Methoded {
                     32: public:
                     33:        MReflection();
                     34: };
                     35: 
                     36: // global variable
                     37: 
1.40      moko       38: DECLARE_CLASS_VAR(reflection, new MReflection);
1.1       misha      39: 
                     40: // methods
                     41: 
1.2       misha      42: 
                     43: static void _create(Request& r, MethodParams& params) {
1.1       misha      44:        const String& class_name=params.as_string(0, "class_name must be string");
1.11      misha      45:        Value* class_value=r.get_class(class_name);
1.1       misha      46: 
                     47:        if(!class_value)
                     48:                throw Exception(PARSER_RUNTIME,
                     49:                        &class_name,
                     50:                        "class is undefined");
                     51: 
                     52:        const String& constructor_name=params.as_string(1, "constructor_name must be string");
1.6       misha      53:        Value* constructor_value=class_value->get_element(constructor_name);
1.1       misha      54: 
1.10      misha      55:        if(!constructor_value || !constructor_value->get_junction())
1.1       misha      56:                throw Exception(PARSER_RUNTIME,
                     57:                        &constructor_name,
                     58:                        "constructor must be declared in class '%s'",
1.41      moko       59:                        class_value->type());
1.1       misha      60: 
                     61:        Junction* junction=constructor_value->get_junction();
1.2       misha      62:        const Method* method=junction->method;
                     63: 
                     64:        int nparams=params.count()-2;
                     65:        int max_params_count;
                     66: 
                     67:        if(method->native_code){
                     68:                if(method->call_type==Method::CT_STATIC)
                     69:                        throw Exception(PARSER_RUNTIME,
                     70:                                &constructor_name,
1.41      moko       71:                                "native method of class '%s' is not allowed to be called dynamically",
1.2       misha      72:                                class_value->type());
                     73: 
                     74:                if(nparams<method->min_numbered_params_count)
                     75:                        throw Exception(PARSER_RUNTIME,
                     76:                                &constructor_name,
1.41      moko       77:                                "native method of class '%s' accepts minimum %d parameter(s) (%d passed)",
1.2       misha      78:                                class_value->type(),
                     79:                                method->min_numbered_params_count,
                     80:                                nparams);
                     81: 
                     82:                max_params_count=method->max_numbered_params_count;
                     83:        } else {
1.12      misha      84:                max_params_count=method->params_names?method->params_names->count():0;
1.2       misha      85:        }
                     86: 
                     87:        if(nparams>max_params_count)
                     88:                throw Exception(PARSER_RUNTIME,
                     89:                        &constructor_name,
1.41      moko       90:                        "method of class '%s' accepts maximum %d parameter(s) (%d passed)",
1.2       misha      91:                        class_value->type(),
                     92:                        max_params_count,
                     93:                        nparams);
1.1       misha      94: 
1.17      moko       95:        Value &object = r.construct(*class_value, *method);
                     96:        VConstructorFrame frame(*method, r.get_method_frame(), object);
1.1       misha      97: 
1.3       misha      98:        Value* v[100];
1.1       misha      99:        if(nparams>0){
1.2       misha     100:                for(int i=0; i<nparams; i++)
1.1       misha     101:                        v[i]=&r.process_to_value(params[i+2]);
                    102:                frame.store_params((Value**)&v, nparams);
                    103:        } else {
                    104:                frame.empty_params();
                    105:        }
1.17      moko      106:        r.op_call(frame);
1.18      moko      107:        object.enable_default_setter();
1.21      moko      108:        r.write_pass_lang(frame.result());
1.1       misha     109: }
                    110: 
1.2       misha     111: 
1.3       misha     112: static void _classes(Request& r, MethodParams&) {
                    113:        VHash& result=*new VHash;
1.47    ! moko      114:        for(HashString<VStateless_class*>::Iterator i(r.classes()); i; i.next()){
        !           115:                result.hash().put(i.key(), i.value()->get_methods().count()>0 ? new VString(class_type_methoded) : VVoid::get() );
        !           116:        }
1.3       misha     117:        r.write_no_lang(result);
                    118: }
                    119: 
                    120: 
                    121: static Value* get_class(Value* value){
                    122:        if(VStateless_class* result=value->get_class())
                    123:                return result;
                    124:        else
                    125:                // classes with fields only, like env & console
                    126:                return value;
                    127: }
                    128: 
                    129: static const String* get_class_name(Value* value){
                    130:        if(VStateless_class* lclass=value->get_class())
1.41      moko      131:                return new String(lclass->type());
1.3       misha     132:        else
                    133:                // classes with fields only, like env & console
                    134:                return new String(value->type());
                    135: }
                    136: 
                    137: 
1.1       misha     138: static void _class(Request& r, MethodParams& params) {
1.3       misha     139:        r.write_no_lang(*get_class(&params[0]));
1.1       misha     140: }
                    141: 
1.2       misha     142: 
1.1       misha     143: static void _class_name(Request& r, MethodParams& params) {
1.3       misha     144:        r.write_no_lang(*get_class_name(&params[0]));
1.1       misha     145: }
                    146: 
1.34      moko      147: static void _class_by_name(Request& r, MethodParams& params) {
                    148:        const String& class_name=params.as_string(0, "class_name must be string");
                    149:        Value* class_value=r.get_class(class_name);
                    150:        if(!class_value)
                    151:                throw Exception(PARSER_RUNTIME, &class_name, "class is undefined");
                    152:        r.write_no_lang(*class_value);
                    153: }
1.1       misha     154: 
1.2       misha     155: static void _base(Request& r, MethodParams& params) {
1.3       misha     156:        if(VStateless_class* lclass=params[0].get_class())
                    157:                if(Value* base=lclass->base()){
                    158:                        r.write_no_lang(*get_class(base));
                    159:                        return;
                    160:                }
                    161: 
                    162:        // classes with fields only, like env & console or without base
                    163:        r.write_no_lang(*VVoid::get());
1.2       misha     164: }
1.1       misha     165: 
                    166: 
1.2       misha     167: static void _base_name(Request& r, MethodParams& params) {
1.3       misha     168:        if(VStateless_class* lclass=params[0].get_class())
1.2       misha     169:                if(Value* base=lclass->base())
1.3       misha     170:                        r.write_no_lang(*get_class_name(base));
1.2       misha     171: }
1.1       misha     172: 
1.2       misha     173: static void store_method_info(
1.7       misha     174:                HashStringMethod::key_type key, 
                    175:                HashStringMethod::value_type method,
1.8       misha     176:                HashStringValue* result
1.2       misha     177: ) {
1.8       misha     178:        result->put(key, new VString(method->native_code?method_type_native:method_type_parser));
1.1       misha     179: }
                    180: 
1.30      misha     181: static void _def(Request& r, MethodParams& params) {
                    182:        const String& type=params.as_string(0, "type must be string");
                    183:        if(type == def_class) {
                    184:                const String& name=params.as_string(1, "name must be string");
1.47    ! moko      185:                // can't use get_class because it will call @autouse[] if the class wasn't loaded
1.43      moko      186:                r.write_no_lang(VBool::get(r.classes().get(name)!=0));
1.30      misha     187:        } else {
1.31      misha     188:                throw Exception(PARSER_RUNTIME, &type, "is invalid type, must be '%s'", def_class.cstr());
1.30      misha     189:        }
                    190: }
                    191: 
1.1       misha     192: static void _methods(Request& r, MethodParams& params) {
                    193:        const String& class_name=params.as_string(0, "class_name must be string");
1.11      misha     194:        Value* class_value=r.get_class(class_name);
1.1       misha     195:        if(!class_value)
                    196:                throw Exception(PARSER_RUNTIME,
                    197:                        &class_name,
                    198:                        "class is undefined");
                    199: 
                    200:        VHash& result=*new VHash;
1.28      misha     201:        if(VStateless_class* lclass=class_value->get_class()) {
1.7       misha     202:                HashStringMethod methods=lclass->get_methods();
1.8       misha     203:                methods.for_each(store_method_info, result.get_hash());
1.1       misha     204:        } else {
1.3       misha     205:                // class which does not have methods (env, console, etc)
1.1       misha     206:        }
                    207:        r.write_no_lang(result);
                    208: }
                    209: 
1.28      misha     210: static void _method(Request& r, MethodParams& params) {
                    211:        Value& o=params.as_no_junction(0, "first param must be object or class, not junction");
                    212:        const String& name=params.as_string(1, "method name must be string");
                    213: 
                    214:        if(VStateless_class* lclass=o.get_class()) {
                    215:                if(Method* method=lclass->get_method(name))
                    216:                        r.write_no_lang(*method->get_vjunction(o));
                    217:        } else {
                    218:                // class which does not have methods (env, console, etc)
                    219:        }
                    220: }
                    221: 
1.13      misha     222: static void _fields(Request& r, MethodParams& params) {
1.28      misha     223:        Value& o=params.as_no_junction(0, "param must be object or class, not junction");
                    224: 
1.44      moko      225:        if(HashStringValue* fields=o.get_fields())
                    226:                r.write_no_lang(*new VHash(*fields));
                    227:        else
1.13      misha     228:                r.write_no_lang(*new VHash());
                    229: }
1.2       misha     230: 
1.44      moko      231: static void _fields_reference(Request& r, MethodParams& params) {
1.46      moko      232:        Value& o=params.as_no_junction(0, "param must be object or hash, not junction");
1.44      moko      233: 
1.45      moko      234:        if(HashStringValue* fields=o.get_fields_reference())
1.44      moko      235:                r.write_no_lang(*new VHashReference(*fields));
                    236:        else
1.46      moko      237:                throw Exception(PARSER_RUNTIME, 0, "param must be object or hash");
1.44      moko      238: }
                    239: 
1.28      misha     240: static void _field(Request& r, MethodParams& params) {
                    241:        Value& o=params.as_no_junction(0, "first param must be object or class, not junction");
                    242:        const String& name=params.as_string(1, "field name must be string");
                    243: 
                    244:        if(HashStringValue* fields=o.get_fields())
                    245:                if(Value* value=fields->get(name))
                    246:                        r.write_no_lang(*value);
                    247: }
                    248: 
1.8       misha     249: static void _method_info(Request& r, MethodParams& params) {
1.2       misha     250:        const String& class_name=params.as_string(0, "class_name must be string");
1.11      misha     251:        Value* class_value=r.get_class(class_name);
1.2       misha     252:        if(!class_value)
1.44      moko      253:                throw Exception(PARSER_RUNTIME, &class_name, "class is undefined");
1.2       misha     254: 
                    255:        VStateless_class* lclass=class_value->get_class();
                    256:        if(!lclass)
1.44      moko      257:                throw Exception(PARSER_RUNTIME, &class_name, "class does not have methods");
1.2       misha     258: 
                    259:        const String& method_name=params.as_string(1, "method_name must be string");
                    260:        Method* method=lclass->get_method(method_name);
                    261:        if(!method)
1.44      moko      262:                throw Exception(PARSER_RUNTIME, &method_name, "method not found in class %s", class_name.cstr());
1.2       misha     263: 
                    264:        VHash& result=*new VHash;
                    265:        HashStringValue* hash=result.get_hash();
1.8       misha     266: 
                    267:        VStateless_class* c=lclass;
1.23      misha     268:        Method* base_method;
                    269:        if(c->base() && (base_method=c->base()->get_method(method_name))){
1.8       misha     270:                c=c->base()->get_class();
1.23      misha     271:                while(c->base() && base_method==c->base()->get_method(method_name))
                    272:                        c=c->base()->get_class();
1.41      moko      273:                hash->put((base_method==method) ? method_inherited : method_overridden, new VString(*new String(c->type())));
1.23      misha     274:        }
1.8       misha     275: 
1.29      misha     276:        Value* call_type=0;
                    277:        switch(method->call_type){
                    278:                case Method::CT_DYNAMIC:
1.42      moko      279:                        call_type=new VString(Symbols::DYNAMIC_SYMBOL);
1.29      misha     280:                        break;
                    281:                case Method::CT_STATIC:
1.42      moko      282:                        call_type=new VString(Symbols::STATIC_SYMBOL);
1.29      misha     283:                        break;
1.32      moko      284:                case Method::CT_ANY:
                    285:                        break;
1.29      misha     286:        }
                    287:        if(call_type)
                    288:                hash->put(method_call_type, call_type);
                    289: 
1.2       misha     290:        if(method->native_code){
                    291:                // native code
                    292:                hash->put(method_min_params, new VInt(method->min_numbered_params_count));
                    293:                hash->put(method_max_params, new VInt(method->max_numbered_params_count));
                    294:        } else {
                    295:                // parser code
1.16      misha     296:                const String* filespec = r.get_method_filename(method);
                    297:                if( filespec )
                    298:                        hash->put("file", new VString(*filespec));
1.29      misha     299: 
                    300:                hash->put(method_max_params, new VInt(method->params_names ? method->params_names->count() : 0));
                    301: 
1.2       misha     302:                if(method->params_names)
                    303:                        for(size_t i=0; i<method->params_names->count(); i++)
                    304:                                hash->put(String::Body::Format(i), new VString(*method->params_names->get(i)));
1.29      misha     305: 
                    306:                if(method->extra_params)
                    307:                        hash->put(method_extra_param, new VString(*method->extra_params));
1.2       misha     308:        }
                    309: 
                    310:        r.write_no_lang(result);
                    311: }
                    312: 
1.9       misha     313: static void _dynamical(Request& r, MethodParams& params) {
                    314:        if(params.count()){
                    315:                r.write_no_lang(VBool::get(params[0].get_class() != &params[0]));
                    316:        } else {
                    317:                VMethodFrame* caller=r.get_method_frame()->caller();
                    318:                r.write_no_lang(VBool::get(caller && caller->get_class() != &caller->self()));
                    319:        }
                    320: }
                    321: 
1.35      moko      322: static void _is(Request& r, MethodParams& params) {
1.39      moko      323:        const String& name=params.as_string(0, "element name must be string");
                    324:        const String& type=params.as_string(1, "class name must be string");
                    325:        Value *context=params.count()==3 ? &(params.as_no_junction(2, "context must not be code")) : r.get_method_frame()->caller();
1.37      moko      326:        Value *value=context ? context->get_element(name) : 0;
1.35      moko      327: 
                    328:        if(value) {
                    329:                if(type == "code" || type == "method") {
                    330:                        Junction *junction=value->get_junction();
                    331:                        r.write_no_lang(VBool::get(junction && ((junction->code==0) ^ (type == "code"))) );
                    332:                } else {
                    333:                        r.write_no_lang(VBool::get( value->is(type.cstr()) ));
                    334:                }
                    335:        } else
1.36      moko      336:                r.write_no_lang(VBool::get(type == "void"));
1.35      moko      337: }
                    338: 
1.19      moko      339: static void _copy(Request& r, MethodParams& params) {
                    340:        HashStringValue* src=params.as_no_junction(0, "source must not be code").get_hash();
                    341: 
1.44      moko      342:        if(src==NULL)
1.19      moko      343:                throw Exception(PARSER_RUNTIME, 0, "source must have hash representation");
                    344: 
                    345:        Value& dst=params.as_no_junction(1, "destination must not be code");
                    346: 
                    347:        for(HashStringValue::Iterator i(*src); i; i.next())
1.20      moko      348:                r.put_element(dst, *new String(i.key(), String::L_TAINTED), i.value());
1.19      moko      349: }
                    350: 
1.25      moko      351: static void _uid(Request& r, MethodParams& params) {
                    352:        Value& obj=params.as_no_junction(0, "object must not be code");
                    353: 
                    354:        char local_buf[MAX_NUMBER];
                    355:        int size=snprintf(local_buf, sizeof(local_buf), "%p", &obj);
                    356: 
1.33      moko      357:        r.write_pass_lang(*new String(String::C(pa_strdup(local_buf, (size_t)size), size)));
1.25      moko      358: }
                    359: 
1.27      moko      360: static void _delete(Request&, MethodParams& params) {
1.26      misha     361:        const String& key=params.as_string(1, "field name must be string");
                    362:        if(HashStringValue* fields=params[0].get_fields()){
                    363:                fields->remove(key);
                    364:        }
                    365: }
                    366: 
                    367: 
1.1       misha     368: // constructor
                    369: MReflection::MReflection(): Methoded("reflection") {
1.2       misha     370:        // ^reflection:create[class_name;constructor_name[;param1[;param2[;...]]]]
                    371:        add_native_method("create", Method::CT_STATIC, _create, 2, 102);
1.1       misha     372: 
1.3       misha     373:        // ^reflection:classes[]
                    374:        add_native_method("classes", Method::CT_STATIC, _classes, 0, 0);
                    375: 
1.1       misha     376:        // ^reflection:class[object]
                    377:        add_native_method("class", Method::CT_STATIC, _class, 1, 1);
                    378: 
                    379:        // ^reflection:class_name[object]
                    380:        add_native_method("class_name", Method::CT_STATIC, _class_name, 1, 1);
                    381: 
1.34      moko      382:        // ^reflection:class_by_name[class_name]
                    383:        add_native_method("class_by_name", Method::CT_STATIC, _class_by_name, 1, 1);
                    384: 
1.2       misha     385:        // ^reflection:base_class[object]
                    386:        add_native_method("base", Method::CT_STATIC, _base, 1, 1);
                    387: 
                    388:        // ^reflection:base_class_name[object]
                    389:        add_native_method("base_name", Method::CT_STATIC, _base_name, 1, 1);
                    390: 
1.30      misha     391:        // ^reflection:def[class|...;name]
                    392:        add_native_method("def", Method::CT_STATIC, _def, 2, 2);
                    393: 
1.2       misha     394:        // ^reflection:methods[class_name]
1.1       misha     395:        add_native_method("methods", Method::CT_STATIC, _methods, 1, 1);
1.2       misha     396: 
1.28      misha     397:        // ^reflection:method[object or class;method_name]
                    398:        add_native_method("method", Method::CT_STATIC, _method, 2, 2);
                    399: 
                    400:        // ^reflection:method_info[class_name;method_name]
                    401:        add_native_method("method_info", Method::CT_STATIC, _method_info, 2, 2);
                    402: 
1.13      misha     403:        // ^reflection:fields[object or class]
                    404:        add_native_method("fields", Method::CT_STATIC, _fields, 1, 1);
                    405: 
1.44      moko      406:        // ^reflection:fields_reference[object]
                    407:        add_native_method("fields_reference", Method::CT_STATIC, _fields_reference, 1, 1);
                    408: 
1.28      misha     409:        // ^reflection:field[object or class;field_name]
                    410:        add_native_method("field", Method::CT_STATIC, _field, 2, 2);
1.9       misha     411: 
                    412:        // ^reflection:dynamical[[object or class, caller if absent]]
                    413:        add_native_method("dynamical", Method::CT_STATIC, _dynamical, 0, 1);
1.19      moko      414: 
1.39      moko      415:        // ^reflection:is[element_name;class_name|code|method[;context]]
1.35      moko      416:        add_native_method("is", Method::CT_STATIC, _is, 2, 3);
                    417: 
1.19      moko      418:        // ^reflection:copy[src;dst]
                    419:        add_native_method("copy", Method::CT_STATIC, _copy, 2, 2);
1.25      moko      420: 
                    421:        // ^reflection:uid[object or class]
                    422:        add_native_method("uid", Method::CT_STATIC, _uid, 1, 1);
1.26      misha     423: 
                    424:        // ^reflection:delete[object or class;field_name]
                    425:        add_native_method("delete", Method::CT_STATIC, _delete, 2, 2);
1.1       misha     426: }

E-mail: