1 /*
2 * Copyright (c) 2001, 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. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
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. */
33
34 public interface JavaLangReflectAccess {
35 /** Creates a new java.lang.reflect.Field. Access checks as per
36 java.lang.reflect.AccessibleObject are not overridden. */
37 public Field newField(Class<?> declaringClass,
38 String name,
39 Class<?> type,
40 int modifiers,
41 int slot,
42 String signature,
43 byte[] annotations);
44
45 /** Creates a new java.lang.reflect.Method. Access checks as per
46 java.lang.reflect.AccessibleObject are not overridden. */
47 public Method newMethod(Class<?> declaringClass,
48 String name,
49 Class<?>[] parameterTypes,
50 Class<?> returnType,
51 Class<?>[] checkedExceptions,
52 int modifiers,
53 int slot,
54 String signature,
55 byte[] annotations,
56 byte[] parameterAnnotations,
57 byte[] annotationDefault);
58
59 /** Creates a new java.lang.reflect.Constructor. Access checks as
60 per java.lang.reflect.AccessibleObject are not overridden. */
61 public <T> Constructor<T> newConstructor(Class<T> declaringClass,
62 Class<?>[] parameterTypes,
63 Class<?>[] checkedExceptions,
64 int modifiers,
65 int slot,
66 String signature,
67 byte[] annotations,
68 byte[] parameterAnnotations);
69
70 /** Gets the MethodAccessor object for a java.lang.reflect.Method */
71 public MethodAccessor getMethodAccessor(Method m);
72
73 /** Sets the MethodAccessor object for a java.lang.reflect.Method */
74 public void setMethodAccessor(Method m, MethodAccessor accessor);
75
76 /** Gets the ConstructorAccessor object for a
77 java.lang.reflect.Constructor */
78 public ConstructorAccessor getConstructorAccessor(Constructor<?> c);
79
80 /** Sets the ConstructorAccessor object for a
81 java.lang.reflect.Constructor */
82 public void setConstructorAccessor(Constructor<?> c,
83 ConstructorAccessor accessor);
84
85 /** Gets the byte[] that encodes TypeAnnotations on an Executable. */
86 public byte[] getExecutableTypeAnnotationBytes(Executable ex);
87
88 /** Gets the "slot" field from a Constructor (used for serialization) */
89 public int getConstructorSlot(Constructor<?> c);
90
91 /** Gets the "signature" field from a Constructor (used for serialization) */
92 public String getConstructorSignature(Constructor<?> c);
93
94 /** Gets the "annotations" field from a Constructor (used for serialization) */
95 public byte[] getConstructorAnnotations(Constructor<?> c);
96
97 /** Gets the "parameterAnnotations" field from a Constructor (used for serialization) */
98 public byte[] getConstructorParameterAnnotations(Constructor<?> c);
99
100 /** Gets the shared array of parameter types of an Executable. */
101 public Class<?>[] getExecutableSharedParameterTypes(Executable ex);
102
103 //
104 // Copying routines, needed to quickly fabricate new Field,
105 // Method, and Constructor objects from templates
106 //
107
108 /** Makes a "child" copy of a Method */
109 public Method copyMethod(Method arg);
110
111 /** Makes a copy of this non-root a Method */
112 public Method leafCopyMethod(Method arg);
113
114 /** Makes a "child" copy of a Field */
115 public Field copyField(Field arg);
116
117 /** Makes a "child" copy of a Constructor */
118 public <T> Constructor<T> copyConstructor(Constructor<T> arg);
119
120 /** Gets the root of the given AccessibleObject object; null if arg is the root */
121 public <T extends AccessibleObject> T getRoot(T obj);
122
123 /** Returns a new instance created by the given constructor with access check */
124 public <T> T newInstance(Constructor<T> ctor, Object[] args, Class<?> caller)
125 throws IllegalAccessException, InstantiationException, InvocationTargetException;
126 }