duke@435: /* jrose@1100: * Copyright 1997-2009 Sun Microsystems, Inc. All Rights Reserved. duke@435: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. duke@435: * duke@435: * This code is free software; you can redistribute it and/or modify it duke@435: * under the terms of the GNU General Public License version 2 only, as duke@435: * published by the Free Software Foundation. duke@435: * duke@435: * This code is distributed in the hope that it will be useful, but WITHOUT duke@435: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or duke@435: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License duke@435: * version 2 for more details (a copy is included in the LICENSE file that duke@435: * accompanied this code). duke@435: * duke@435: * You should have received a copy of the GNU General Public License version duke@435: * 2 along with this work; if not, write to the Free Software Foundation, duke@435: * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. duke@435: * duke@435: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, duke@435: * CA 95054 USA or visit www.sun.com if you need additional information or duke@435: * have any questions. duke@435: * duke@435: */ duke@435: duke@435: // Class Reflection contains utility methods needed for implementing the duke@435: // reflection api. duke@435: // duke@435: // Used by functions in the JVM interface. duke@435: // duke@435: // NOTE that in JDK 1.4 most of reflection is now implemented in Java duke@435: // using dynamic bytecode generation. The Array class has not yet been duke@435: // rewritten using bytecodes; if it were, most of the rest of this duke@435: // class could go away, as well as a few more entry points in jvm.cpp. duke@435: duke@435: class FieldStream; duke@435: duke@435: class Reflection: public AllStatic { duke@435: private: duke@435: // Access checking duke@435: static bool reflect_check_access(klassOop field_class, AccessFlags acc, klassOop target_class, bool is_method_invoke, TRAPS); duke@435: duke@435: // Conversion duke@435: static klassOop basic_type_mirror_to_arrayklass(oop basic_type_mirror, TRAPS); duke@435: static oop basic_type_arrayklass_to_mirror(klassOop basic_type_arrayklass, TRAPS); duke@435: duke@435: static objArrayHandle get_parameter_types(methodHandle method, int parameter_count, oop* return_type, TRAPS); duke@435: static objArrayHandle get_exception_types(methodHandle method, TRAPS); duke@435: // Creating new java.lang.reflect.xxx wrappers duke@435: static Handle new_type(symbolHandle signature, KlassHandle k, TRAPS); duke@435: duke@435: public: duke@435: // Constants defined by java reflection api classes duke@435: enum SomeConstants { duke@435: PUBLIC = 0, duke@435: DECLARED = 1, duke@435: MEMBER_PUBLIC = 0, duke@435: MEMBER_DECLARED = 1, duke@435: MAX_DIM = 255 duke@435: }; duke@435: duke@435: // Boxing. Returns boxed value of appropriate type. Throws IllegalArgumentException. duke@435: static oop box(jvalue* v, BasicType type, TRAPS); duke@435: // Unboxing. Returns type code and sets value. duke@435: static BasicType unbox_for_primitive(oop boxed_value, jvalue* value, TRAPS); duke@435: static BasicType unbox_for_regular_object(oop boxed_value, jvalue* value); duke@435: duke@435: // Widening of basic types. Throws IllegalArgumentException. duke@435: static void widen(jvalue* value, BasicType current_type, BasicType wide_type, TRAPS); duke@435: duke@435: // Reflective array access. Returns type code. Throws ArrayIndexOutOfBoundsException. duke@435: static BasicType array_get(jvalue* value, arrayOop a, int index, TRAPS); duke@435: static void array_set(jvalue* value, arrayOop a, int index, BasicType value_type, TRAPS); duke@435: // Returns mirror on array element type (NULL for basic type arrays and non-arrays). duke@435: static oop array_component_type(oop mirror, TRAPS); duke@435: duke@435: // Object creation duke@435: static arrayOop reflect_new_array(oop element_mirror, jint length, TRAPS); duke@435: static arrayOop reflect_new_multi_array(oop element_mirror, typeArrayOop dimensions, TRAPS); duke@435: duke@435: // Verification duke@435: static bool verify_class_access(klassOop current_class, klassOop new_class, bool classloader_only); duke@435: duke@435: static bool verify_field_access(klassOop current_class, duke@435: klassOop resolved_class, duke@435: klassOop field_class, duke@435: AccessFlags access, duke@435: bool classloader_only, duke@435: bool protected_restriction = false); duke@435: static bool is_same_class_package(klassOop class1, klassOop class2); jrose@1100: static bool is_same_package_member(klassOop class1, klassOop class2, TRAPS); duke@435: duke@435: static bool can_relax_access_check_for( duke@435: klassOop accessor, klassOop accesee, bool classloader_only); duke@435: duke@435: // inner class reflection jrose@1100: // raise an ICCE unless the required relationship can be proven to hold jrose@1100: // If inner_is_member, require the inner to be a member of the outer. jrose@1100: // If !inner_is_member, require the inner to be anonymous (a non-member). jrose@1100: // Caller is responsible for figuring out in advance which case must be true. jrose@1100: static void check_for_inner_class(instanceKlassHandle outer, instanceKlassHandle inner, jrose@1100: bool inner_is_member, TRAPS); duke@435: duke@435: // duke@435: // Support for reflection based on dynamic bytecode generation (JDK 1.4) duke@435: // duke@435: duke@435: // Create a java.lang.reflect.Method object based on a method duke@435: static oop new_method(methodHandle method, bool intern_name, bool for_constant_pool_access, TRAPS); duke@435: // Create a java.lang.reflect.Constructor object based on a method duke@435: static oop new_constructor(methodHandle method, TRAPS); duke@435: // Create a java.lang.reflect.Field object based on a field descriptor duke@435: static oop new_field(fieldDescriptor* fd, bool intern_name, TRAPS); duke@435: duke@435: //--------------------------------------------------------------------------- duke@435: // duke@435: // Support for old native code-based reflection (pre-JDK 1.4) duke@435: // duke@435: // NOTE: the method and constructor invocation code is still used duke@435: // for startup time reasons; see reflectionCompat.hpp. duke@435: // duke@435: //--------------------------------------------------------------------------- duke@435: duke@435: #ifdef SUPPORT_OLD_REFLECTION duke@435: private: duke@435: // method resolution for invoke duke@435: static methodHandle resolve_interface_call(instanceKlassHandle klass, methodHandle method, KlassHandle recv_klass, Handle receiver, TRAPS); duke@435: // Method call (shared by invoke_method and invoke_constructor) duke@435: static oop invoke(instanceKlassHandle klass, methodHandle method, Handle receiver, bool override, objArrayHandle ptypes, BasicType rtype, objArrayHandle args, bool is_method_invoke, TRAPS); duke@435: duke@435: // Narrowing of basic types. Used to create correct jvalues for duke@435: // boolean, byte, char and short return return values from interpreter duke@435: // which are returned as ints. Throws IllegalArgumentException. duke@435: static void narrow(jvalue* value, BasicType narrow_type, TRAPS); duke@435: duke@435: // Conversion duke@435: static BasicType basic_type_mirror_to_basic_type(oop basic_type_mirror, TRAPS); duke@435: duke@435: static bool match_parameter_types(methodHandle method, objArrayHandle types, int parameter_count, TRAPS); duke@435: // Creating new java.lang.reflect.xxx wrappers duke@435: static oop new_field(FieldStream* st, TRAPS); duke@435: duke@435: public: duke@435: // Field lookup and verification. duke@435: static bool resolve_field(Handle field_mirror, Handle& receiver, fieldDescriptor* fd, bool check_final, TRAPS); duke@435: duke@435: // Reflective field access. Returns type code. Throws IllegalArgumentException. duke@435: static BasicType field_get(jvalue* value, fieldDescriptor* fd, Handle receiver); duke@435: static void field_set(jvalue* value, fieldDescriptor* fd, Handle receiver, BasicType value_type, TRAPS); duke@435: duke@435: // Reflective lookup of fields. Returns java.lang.reflect.Field instances. duke@435: static oop reflect_field(oop mirror, symbolOop field_name, jint which, TRAPS); duke@435: static objArrayOop reflect_fields(oop mirror, jint which, TRAPS); duke@435: duke@435: // Reflective lookup of methods. Returns java.lang.reflect.Method instances. duke@435: static oop reflect_method(oop mirror, symbolHandle method_name, objArrayHandle types, jint which, TRAPS); duke@435: static objArrayOop reflect_methods(oop mirror, jint which, TRAPS); duke@435: duke@435: // Reflective lookup of constructors. Returns java.lang.reflect.Constructor instances. duke@435: static oop reflect_constructor(oop mirror, objArrayHandle types, jint which, TRAPS); duke@435: static objArrayOop reflect_constructors(oop mirror, jint which, TRAPS); duke@435: duke@435: // Method invokation through java.lang.reflect.Method duke@435: static oop invoke_method(oop method_mirror, Handle receiver, objArrayHandle args, TRAPS); duke@435: // Method invokation through java.lang.reflect.Constructor duke@435: static oop invoke_constructor(oop method_mirror, objArrayHandle args, TRAPS); duke@435: #endif /* SUPPORT_OLD_REFLECTION */ duke@435: duke@435: };