9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26 package jdk.internal.access;
27
28 import java.lang.reflect.*;
29 import jdk.internal.reflect.*;
30
31 /** An interface which gives privileged packages Java-level access to
32 internals of java.lang.reflect. Use as a last resort! */
33 public interface JavaLangReflectAccess {
34 /**
35 * Creates a new root constructor from the original one, with
36 * a custom accessor. Used by serialization hooks.
37 */
38 <T> Constructor<T> newConstructorWithAccessor(Constructor<T> original, ConstructorAccessor accessor);
39
40 /** Gets the byte[] that encodes TypeAnnotations on an Executable. */
41 public byte[] getExecutableTypeAnnotationBytes(Executable ex);
42
43 /** Gets the shared array of parameter types of an Executable. */
44 public Class<?>[] getExecutableSharedParameterTypes(Executable ex);
45
46 /** Gets the shared array of exception types of an Executable. */
47 public Class<?>[] getExecutableSharedExceptionTypes(Executable ex);
48
56 public Field copyField(Field arg);
57
58 /** Makes a "child" copy of a Constructor */
59 public <T> Constructor<T> copyConstructor(Constructor<T> arg);
60
61 /** Gets the root of the given AccessibleObject object; null if arg is the root */
62 public <T extends AccessibleObject> T getRoot(T obj);
63
64 /** Tests if this is a trusted final field */
65 public boolean isTrustedFinalField(Field f);
66
67 /** Returns a new instance created by the given constructor with access check */
68 public <T> T newInstance(Constructor<T> ctor, Object[] args, Class<?> caller)
69 throws IllegalAccessException, InstantiationException, InvocationTargetException;
70
71 /**
72 * Check that the caller is allowed to unreflect for mutation a final instance field
73 * in a class that is not a record or hidden class.
74 */
75 void checkAllowedToUnreflectFinalSetter(Class<?> caller, Field f) throws IllegalAccessException;
76 }
|
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26 package jdk.internal.access;
27
28 import java.lang.reflect.*;
29 import java.util.Optional;
30 import java.util.function.Function;
31
32 import jdk.internal.reflect.*;
33
34 /** An interface which gives privileged packages Java-level access to
35 internals of java.lang.reflect. Use as a last resort! */
36 public interface JavaLangReflectAccess {
37 /**
38 * Creates a new root constructor from the original one, with
39 * a custom accessor. Used by serialization hooks.
40 */
41 <T> Constructor<T> newConstructorWithAccessor(Constructor<T> original, ConstructorAccessor accessor);
42
43 /** Gets the byte[] that encodes TypeAnnotations on an Executable. */
44 public byte[] getExecutableTypeAnnotationBytes(Executable ex);
45
46 /** Gets the shared array of parameter types of an Executable. */
47 public Class<?>[] getExecutableSharedParameterTypes(Executable ex);
48
49 /** Gets the shared array of exception types of an Executable. */
50 public Class<?>[] getExecutableSharedExceptionTypes(Executable ex);
51
59 public Field copyField(Field arg);
60
61 /** Makes a "child" copy of a Constructor */
62 public <T> Constructor<T> copyConstructor(Constructor<T> arg);
63
64 /** Gets the root of the given AccessibleObject object; null if arg is the root */
65 public <T extends AccessibleObject> T getRoot(T obj);
66
67 /** Tests if this is a trusted final field */
68 public boolean isTrustedFinalField(Field f);
69
70 /** Returns a new instance created by the given constructor with access check */
71 public <T> T newInstance(Constructor<T> ctor, Object[] args, Class<?> caller)
72 throws IllegalAccessException, InstantiationException, InvocationTargetException;
73
74 /**
75 * Check that the caller is allowed to unreflect for mutation a final instance field
76 * in a class that is not a record or hidden class.
77 */
78 void checkAllowedToUnreflectFinalSetter(Class<?> caller, Field f) throws IllegalAccessException;
79
80 /** Cache code model on the reflective method instance (if none is set already). */
81 Optional<?> setCodeModelIfNeeded(Method method, Function<Method, Optional<?>> modelFactory);
82 }
|