< prev index next >

src/java.base/share/classes/jdk/internal/access/JavaLangReflectAccess.java

Print this page

 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 

50     // Method, and Constructor objects from templates
51 
52     /** Makes a "child" copy of a Method */
53     public Method      copyMethod(Method arg);
54 
55     /** Makes a "child" copy of a Field */
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 }

 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 

53     // Method, and Constructor objects from templates
54 
55     /** Makes a "child" copy of a Method */
56     public Method      copyMethod(Method arg);
57 
58     /** Makes a "child" copy of a Field */
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     /** Cache code model on the reflective method instance (if none is set already). */
75     Optional<?> setCodeModelIfNeeded(Method method, Function<Method, Optional<?>> modelFactory);
76 }
< prev index next >