1 /*
2 * Copyright (c) 1997, 2019, 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_RUNTIME_REFLECTION_HPP
26 #define SHARE_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 TRUSTED_FINAL = 0x10,
54 NULL_RESTRICTED = 0x20,
55 MAX_DIM = 255
56 };
57
58 // Results returned by verify_class_access()
59 enum VerifyClassAccessResults {
60 ACCESS_OK = 0,
61 MODULE_NOT_READABLE = 1,
62 TYPE_NOT_EXPORTED = 2,
63 OTHER_PROBLEM = 3
64 };
65
66 // Boxing. Returns boxed value of appropriate type. Throws IllegalArgumentException.
67 static oop box(jvalue* v, BasicType type, TRAPS);
68 // Unboxing. Returns type code and sets value.
69 static BasicType unbox_for_primitive(oop boxed_value, jvalue* value, TRAPS);
70 static BasicType unbox_for_regular_object(oop boxed_value, jvalue* value);
71
72 // Widening of basic types. Throws IllegalArgumentException.
73 static void widen(jvalue* value, BasicType current_type, BasicType wide_type, TRAPS);
74
75 // Reflective array access. Returns type code. Throws ArrayIndexOutOfBoundsException.
76 static BasicType array_get(jvalue* value, arrayOop a, int index, TRAPS);
77 static void array_set(jvalue* value, arrayOop a, int index, BasicType value_type, 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_RUNTIME_REFLECTION_HPP