1 /* 2 * Copyright (c) 1997, 2017, 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 43 class FieldStream; 44 45 class Reflection: public AllStatic { 46 public: 47 // Constants defined by java reflection api classes 48 enum SomeConstants { 49 PUBLIC = 0, 50 DECLARED = 1, 51 MEMBER_PUBLIC = 0, 52 MEMBER_DECLARED = 1, 53 MAX_DIM = 255 54 }; 55 56 // Results returned by verify_class_access() 57 enum VerifyClassAccessResults { 58 ACCESS_OK = 0, 59 MODULE_NOT_READABLE = 1, 60 TYPE_NOT_EXPORTED = 2, 61 OTHER_PROBLEM = 3 62 }; 63 64 // Boxing. Returns boxed value of appropriate type. Throws IllegalArgumentException. 65 static oop box(jvalue* v, BasicType type, TRAPS); 66 // Unboxing. Returns type code and sets value. 67 static BasicType unbox_for_primitive(oop boxed_value, jvalue* value, TRAPS); 68 static BasicType unbox_for_regular_object(oop boxed_value, jvalue* value); 69 70 // Widening of basic types. Throws IllegalArgumentException. 71 static void widen(jvalue* value, BasicType current_type, BasicType wide_type, TRAPS); 72 73 // Reflective array access. Returns type code. Throws ArrayIndexOutOfBoundsException. 74 static BasicType array_get(jvalue* value, arrayOop a, int index, TRAPS); 75 static void array_set(jvalue* value, arrayOop a, int index, BasicType value_type, TRAPS); 76 // Returns mirror on array element type (NULL for basic type arrays and non-arrays). 77 static oop array_component_type(oop mirror, TRAPS); 78 79 // Object creation 80 static arrayOop reflect_new_array(oop element_mirror, jint length, TRAPS); 81 static arrayOop reflect_new_multi_array(oop element_mirror, typeArrayOop dimensions, TRAPS); 82 83 // Verification 84 static VerifyClassAccessResults verify_class_access(const Klass* current_class, 85 const InstanceKlass* new_class, 86 bool classloader_only); 87 // Return an error message specific to the specified Klass*'s and result. 88 // This function must be called from within a block containing a ResourceMark. 89 static char* verify_class_access_msg(const Klass* current_class, 90 const InstanceKlass* new_class, 91 const VerifyClassAccessResults result); 92 93 static bool verify_member_access(const Klass* current_class, 94 const Klass* resolved_class, 95 const Klass* member_class, 96 AccessFlags access, 97 bool classloader_only, 98 bool protected_restriction, 99 TRAPS); 100 static bool is_same_class_package(const Klass* class1, const Klass* class2); 101 102 // inner class reflection 103 // raise an ICCE unless the required relationship can be proven to hold 104 // If inner_is_member, require the inner to be a member of the outer. 105 // If !inner_is_member, require the inner to be anonymous (a non-member). 106 // Caller is responsible for figuring out in advance which case must be true. 107 static void check_for_inner_class(const InstanceKlass* outer, 108 const InstanceKlass* inner, 109 bool inner_is_member, 110 TRAPS); 111 112 // 113 // Support for reflection based on dynamic bytecode generation (JDK 1.4) 114 // 115 116 // Create a java.lang.reflect.Method object based on a method 117 static oop new_method(const methodHandle& method, bool for_constant_pool_access, TRAPS); 118 // Create a java.lang.reflect.Constructor object based on a method 119 static oop new_constructor(const methodHandle& method, TRAPS); 120 // Create a java.lang.reflect.Field object based on a field descriptor 121 static oop new_field(fieldDescriptor* fd, TRAPS); 122 // Create a java.lang.reflect.Parameter object based on a 123 // MethodParameterElement 124 static oop new_parameter(Handle method, int index, Symbol* sym, 125 int flags, TRAPS); 126 // Method invocation through java.lang.reflect.Method 127 static oop invoke_method(oop method_mirror, 128 Handle receiver, 129 objArrayHandle args, 130 TRAPS); 131 // Method invocation through java.lang.reflect.Constructor 132 static oop invoke_constructor(oop method_mirror, objArrayHandle args, TRAPS); 133 134 }; 135 136 #endif // SHARE_VM_RUNTIME_REFLECTION_HPP