--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/hotspot/share/runtime/reflection.hpp Tue Sep 12 19:03:39 2017 +0200
@@ -0,0 +1,135 @@
+/*
+ * Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ *
+ */
+
+#ifndef SHARE_VM_RUNTIME_REFLECTION_HPP
+#define SHARE_VM_RUNTIME_REFLECTION_HPP
+
+#include "oops/oop.hpp"
+#include "runtime/fieldDescriptor.hpp"
+#include "utilities/accessFlags.hpp"
+#include "utilities/growableArray.hpp"
+
+// Class Reflection contains utility methods needed for implementing the
+// reflection api.
+//
+// Used by functions in the JVM interface.
+//
+// NOTE that in JDK 1.4 most of reflection is now implemented in Java
+// using dynamic bytecode generation. The Array class has not yet been
+// rewritten using bytecodes; if it were, most of the rest of this
+// class could go away, as well as a few more entry points in jvm.cpp.
+
+class FieldStream;
+
+class Reflection: public AllStatic {
+ public:
+ // Constants defined by java reflection api classes
+ enum SomeConstants {
+ PUBLIC = 0,
+ DECLARED = 1,
+ MEMBER_PUBLIC = 0,
+ MEMBER_DECLARED = 1,
+ MAX_DIM = 255
+ };
+
+ // Results returned by verify_class_access()
+ enum VerifyClassAccessResults {
+ ACCESS_OK = 0,
+ MODULE_NOT_READABLE = 1,
+ TYPE_NOT_EXPORTED = 2,
+ OTHER_PROBLEM = 3
+ };
+
+ // Boxing. Returns boxed value of appropriate type. Throws IllegalArgumentException.
+ static oop box(jvalue* v, BasicType type, TRAPS);
+ // Unboxing. Returns type code and sets value.
+ static BasicType unbox_for_primitive(oop boxed_value, jvalue* value, TRAPS);
+ static BasicType unbox_for_regular_object(oop boxed_value, jvalue* value);
+
+ // Widening of basic types. Throws IllegalArgumentException.
+ static void widen(jvalue* value, BasicType current_type, BasicType wide_type, TRAPS);
+
+ // Reflective array access. Returns type code. Throws ArrayIndexOutOfBoundsException.
+ static BasicType array_get(jvalue* value, arrayOop a, int index, TRAPS);
+ static void array_set(jvalue* value, arrayOop a, int index, BasicType value_type, TRAPS);
+ // Returns mirror on array element type (NULL for basic type arrays and non-arrays).
+ static oop array_component_type(oop mirror, TRAPS);
+
+ // Object creation
+ static arrayOop reflect_new_array(oop element_mirror, jint length, TRAPS);
+ static arrayOop reflect_new_multi_array(oop element_mirror, typeArrayOop dimensions, TRAPS);
+
+ // Verification
+ static VerifyClassAccessResults verify_class_access(const Klass* current_class,
+ const InstanceKlass* new_class,
+ bool classloader_only);
+ // Return an error message specific to the specified Klass*'s and result.
+ // This function must be called from within a block containing a ResourceMark.
+ static char* verify_class_access_msg(const Klass* current_class,
+ const InstanceKlass* new_class,
+ const VerifyClassAccessResults result);
+
+ static bool verify_field_access(const Klass* current_class,
+ const Klass* resolved_class,
+ const Klass* field_class,
+ AccessFlags access,
+ bool classloader_only,
+ bool protected_restriction = false);
+ static bool is_same_class_package(const Klass* class1, const Klass* class2);
+
+ // inner class reflection
+ // raise an ICCE unless the required relationship can be proven to hold
+ // If inner_is_member, require the inner to be a member of the outer.
+ // If !inner_is_member, require the inner to be anonymous (a non-member).
+ // Caller is responsible for figuring out in advance which case must be true.
+ static void check_for_inner_class(const InstanceKlass* outer,
+ const InstanceKlass* inner,
+ bool inner_is_member,
+ TRAPS);
+
+ //
+ // Support for reflection based on dynamic bytecode generation (JDK 1.4)
+ //
+
+ // Create a java.lang.reflect.Method object based on a method
+ static oop new_method(const methodHandle& method, bool for_constant_pool_access, TRAPS);
+ // Create a java.lang.reflect.Constructor object based on a method
+ static oop new_constructor(const methodHandle& method, TRAPS);
+ // Create a java.lang.reflect.Field object based on a field descriptor
+ static oop new_field(fieldDescriptor* fd, TRAPS);
+ // Create a java.lang.reflect.Parameter object based on a
+ // MethodParameterElement
+ static oop new_parameter(Handle method, int index, Symbol* sym,
+ int flags, TRAPS);
+ // Method invocation through java.lang.reflect.Method
+ static oop invoke_method(oop method_mirror,
+ Handle receiver,
+ objArrayHandle args,
+ TRAPS);
+ // Method invocation through java.lang.reflect.Constructor
+ static oop invoke_constructor(oop method_mirror, objArrayHandle args, TRAPS);
+
+};
+
+#endif // SHARE_VM_RUNTIME_REFLECTION_HPP