reflection.hpp revision 5776:de6a9e811145
1/* 2 * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. 8 * 9 * This code is distributed in the hope that it will be useful, but WITHOUT 10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 12 * version 2 for more details (a copy is included in the LICENSE file that 13 * accompanied this code). 14 * 15 * You should have received a copy of the GNU General Public License version 16 * 2 along with this work; if not, write to the Free Software Foundation, 17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 18 * 19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 20 * or visit www.oracle.com if you need additional information or have any 21 * questions. 22 * 23 */ 24 25#ifndef SHARE_VM_RUNTIME_REFLECTION_HPP 26#define SHARE_VM_RUNTIME_REFLECTION_HPP 27 28#include "oops/oop.hpp" 29#include "runtime/fieldDescriptor.hpp" 30#include "utilities/accessFlags.hpp" 31#include "utilities/growableArray.hpp" 32 33// Class Reflection contains utility methods needed for implementing the 34// reflection api. 35// 36// Used by functions in the JVM interface. 37// 38// NOTE that in JDK 1.4 most of reflection is now implemented in Java 39// using dynamic bytecode generation. The Array class has not yet been 40// rewritten using bytecodes; if it were, most of the rest of this 41// class could go away, as well as a few more entry points in jvm.cpp. 42 43class FieldStream; 44 45class Reflection: public AllStatic { 46 private: 47 // Access checking 48 static bool reflect_check_access(Klass* field_class, AccessFlags acc, Klass* target_class, bool is_method_invoke, TRAPS); 49 50 // Conversion 51 static Klass* basic_type_mirror_to_arrayklass(oop basic_type_mirror, TRAPS); 52 static oop basic_type_arrayklass_to_mirror(Klass* basic_type_arrayklass, TRAPS); 53 54 static objArrayHandle get_parameter_types(methodHandle method, int parameter_count, oop* return_type, TRAPS); 55 static objArrayHandle get_exception_types(methodHandle method, TRAPS); 56 // Creating new java.lang.reflect.xxx wrappers 57 static Handle new_type(Symbol* signature, KlassHandle k, TRAPS); 58 59 public: 60 // Constants defined by java reflection api classes 61 enum SomeConstants { 62 PUBLIC = 0, 63 DECLARED = 1, 64 MEMBER_PUBLIC = 0, 65 MEMBER_DECLARED = 1, 66 MAX_DIM = 255 67 }; 68 69 // Boxing. Returns boxed value of appropriate type. Throws IllegalArgumentException. 70 static oop box(jvalue* v, BasicType type, TRAPS); 71 // Unboxing. Returns type code and sets value. 72 static BasicType unbox_for_primitive(oop boxed_value, jvalue* value, TRAPS); 73 static BasicType unbox_for_regular_object(oop boxed_value, jvalue* value); 74 75 // Widening of basic types. Throws IllegalArgumentException. 76 static void widen(jvalue* value, BasicType current_type, BasicType wide_type, TRAPS); 77 78 // Reflective array access. Returns type code. Throws ArrayIndexOutOfBoundsException. 79 static BasicType array_get(jvalue* value, arrayOop a, int index, TRAPS); 80 static void array_set(jvalue* value, arrayOop a, int index, BasicType value_type, TRAPS); 81 // Returns mirror on array element type (NULL for basic type arrays and non-arrays). 82 static oop array_component_type(oop mirror, TRAPS); 83 84 // Object creation 85 static arrayOop reflect_new_array(oop element_mirror, jint length, TRAPS); 86 static arrayOop reflect_new_multi_array(oop element_mirror, typeArrayOop dimensions, TRAPS); 87 88 // Verification 89 static bool verify_class_access(Klass* current_class, Klass* new_class, bool classloader_only); 90 91 static bool verify_field_access(Klass* current_class, 92 Klass* resolved_class, 93 Klass* field_class, 94 AccessFlags access, 95 bool classloader_only, 96 bool protected_restriction = false); 97 static bool is_same_class_package(Klass* class1, Klass* class2); 98 static bool is_same_package_member(Klass* class1, Klass* class2, TRAPS); 99 100 static bool can_relax_access_check_for( 101 Klass* accessor, Klass* accesee, bool classloader_only); 102 103 // inner class reflection 104 // raise an ICCE unless the required relationship can be proven to hold 105 // If inner_is_member, require the inner to be a member of the outer. 106 // If !inner_is_member, require the inner to be anonymous (a non-member). 107 // Caller is responsible for figuring out in advance which case must be true. 108 static void check_for_inner_class(instanceKlassHandle outer, instanceKlassHandle inner, 109 bool inner_is_member, TRAPS); 110 111 // 112 // Support for reflection based on dynamic bytecode generation (JDK 1.4) 113 // 114 115 // Create a java.lang.reflect.Method object based on a method 116 static oop new_method(methodHandle method, bool intern_name, bool for_constant_pool_access, TRAPS); 117 // Create a java.lang.reflect.Constructor object based on a method 118 static oop new_constructor(methodHandle method, TRAPS); 119 // Create a java.lang.reflect.Field object based on a field descriptor 120 static oop new_field(fieldDescriptor* fd, bool intern_name, TRAPS); 121 // Create a java.lang.reflect.Parameter object based on a 122 // MethodParameterElement 123 static oop new_parameter(Handle method, int index, Symbol* sym, 124 int flags, TRAPS); 125 126private: 127 // method resolution for invoke 128 static methodHandle resolve_interface_call(instanceKlassHandle klass, methodHandle method, KlassHandle recv_klass, Handle receiver, TRAPS); 129 // Method call (shared by invoke_method and invoke_constructor) 130 static oop invoke(instanceKlassHandle klass, methodHandle method, Handle receiver, bool override, objArrayHandle ptypes, BasicType rtype, objArrayHandle args, bool is_method_invoke, TRAPS); 131 132 // Narrowing of basic types. Used to create correct jvalues for 133 // boolean, byte, char and short return return values from interpreter 134 // which are returned as ints. Throws IllegalArgumentException. 135 static void narrow(jvalue* value, BasicType narrow_type, TRAPS); 136 137 // Conversion 138 static BasicType basic_type_mirror_to_basic_type(oop basic_type_mirror, TRAPS); 139 140public: 141 // Method invokation through java.lang.reflect.Method 142 static oop invoke_method(oop method_mirror, Handle receiver, objArrayHandle args, TRAPS); 143 // Method invokation through java.lang.reflect.Constructor 144 static oop invoke_constructor(oop method_mirror, objArrayHandle args, TRAPS); 145 146}; 147 148#endif // SHARE_VM_RUNTIME_REFLECTION_HPP 149