Class Lookup
java.lang.Object
jdk.dynalink.linker.support.Lookup
A wrapper around
MethodHandles.Lookup that masks
checked exceptions. It is useful in those cases when you're looking up
methods within your own codebase (therefore it is an error if they are not
present).- Since:
- 9
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final LookupA canonical Lookup object that wrapsMethodHandles.publicLookup(). -
Constructor Summary
ConstructorsConstructorDescriptionLookup(MethodHandles.Lookup lookup) Creates a new instance, bound to an instance ofMethodHandles.Lookup. -
Method Summary
Modifier and TypeMethodDescriptionfindGetter(Class<?> refc, String name, Class<?> type) Performs aMethodHandles.Lookup.findGetter(Class, String, Class), converting any encounteredIllegalAccessExceptioninto anIllegalAccessErrorandNoSuchFieldExceptioninto aNoSuchFieldError.static MethodHandlefindOwnSpecial(MethodHandles.Lookup lookup, String name, Class<?> rtype, Class<?>... ptypes) Given a lookup, finds usingfindSpecial(Class, String, MethodType)a method on that lookup's class.findOwnSpecial(String name, Class<?> rtype, Class<?>... ptypes) Finds usingfindSpecial(Class, String, MethodType)a method on that lookup's class.static MethodHandlefindOwnStatic(MethodHandles.Lookup lookup, String name, Class<?> rtype, Class<?>... ptypes) Given a lookup, finds usingfindStatic(Class, String, MethodType)a method on that lookup's class.findOwnStatic(String name, Class<?> rtype, Class<?>... ptypes) Finds usingfindStatic(Class, String, MethodType)a method on that lookup's class.findSpecial(Class<?> declaringClass, String name, MethodType type) Performs aMethodHandles.Lookup.findSpecial(Class, String, MethodType, Class)on the underlying lookup.findStatic(Class<?> declaringClass, String name, MethodType type) Performs aMethodHandles.Lookup.findStatic(Class, String, MethodType)on the underlying lookup.findVirtual(Class<?> declaringClass, String name, MethodType type) Performs aMethodHandles.Lookup.findVirtual(Class, String, MethodType)on the underlying lookup.static MethodHandleunreflect(MethodHandles.Lookup lookup, Method m) Performs aMethodHandles.Lookup.unreflect(Method), converting any encounteredIllegalAccessExceptioninto anIllegalAccessError.Performs aMethodHandles.Lookup.unreflect(Method), converting any encounteredIllegalAccessExceptioninto anIllegalAccessError.static MethodHandleunreflectConstructor(MethodHandles.Lookup lookup, Constructor<?> c) Performs aMethodHandles.Lookup.unreflectConstructor(Constructor), converting any encounteredIllegalAccessExceptioninto anIllegalAccessError.Performs aMethodHandles.Lookup.unreflectConstructor(Constructor), converting any encounteredIllegalAccessExceptioninto anIllegalAccessError.Performs aMethodHandles.Lookup.unreflectGetter(Field), converting any encounteredIllegalAccessExceptioninto anIllegalAccessError.Performs aMethodHandles.Lookup.unreflectSetter(Field), converting any encounteredIllegalAccessExceptioninto anIllegalAccessError.
-
Field Details
-
PUBLIC
A canonical Lookup object that wrapsMethodHandles.publicLookup().
-
-
Constructor Details
-
Lookup
Creates a new instance, bound to an instance ofMethodHandles.Lookup.- Parameters:
lookup- theMethodHandles.Lookupit delegates to.
-
-
Method Details
-
unreflect
Performs aMethodHandles.Lookup.unreflect(Method), converting any encounteredIllegalAccessExceptioninto anIllegalAccessError.- Parameters:
m- the method to unreflect- Returns:
- the unreflected method handle.
- Throws:
IllegalAccessError- if the method is inaccessible.
-
unreflect
Performs aMethodHandles.Lookup.unreflect(Method), converting any encounteredIllegalAccessExceptioninto anIllegalAccessError.- Parameters:
lookup- the lookup used to unreflectm- the method to unreflect- Returns:
- the unreflected method handle.
- Throws:
IllegalAccessError- if the method is inaccessible.
-
unreflectGetter
Performs aMethodHandles.Lookup.unreflectGetter(Field), converting any encounteredIllegalAccessExceptioninto anIllegalAccessError.- Parameters:
f- the field for which a getter is unreflected- Returns:
- the unreflected field getter handle.
- Throws:
IllegalAccessError- if the getter is inaccessible.
-
findGetter
Performs aMethodHandles.Lookup.findGetter(Class, String, Class), converting any encounteredIllegalAccessExceptioninto anIllegalAccessErrorandNoSuchFieldExceptioninto aNoSuchFieldError.- Parameters:
refc- the class declaring the fieldname- the name of the fieldtype- the type of the field- Returns:
- the unreflected field getter handle.
- Throws:
IllegalAccessError- if the field is inaccessible.NoSuchFieldError- if the field does not exist.
-
unreflectSetter
Performs aMethodHandles.Lookup.unreflectSetter(Field), converting any encounteredIllegalAccessExceptioninto anIllegalAccessError.- Parameters:
f- the field for which a setter is unreflected- Returns:
- the unreflected field setter handle.
- Throws:
IllegalAccessError- if the field is inaccessible.NoSuchFieldError- if the field does not exist.
-
unreflectConstructor
Performs aMethodHandles.Lookup.unreflectConstructor(Constructor), converting any encounteredIllegalAccessExceptioninto anIllegalAccessError.- Parameters:
c- the constructor to unreflect- Returns:
- the unreflected constructor handle.
- Throws:
IllegalAccessError- if the constructor is inaccessible.
-
unreflectConstructor
Performs aMethodHandles.Lookup.unreflectConstructor(Constructor), converting any encounteredIllegalAccessExceptioninto anIllegalAccessError.- Parameters:
lookup- the lookup used to unreflectc- the constructor to unreflect- Returns:
- the unreflected constructor handle.
- Throws:
IllegalAccessError- if the constructor is inaccessible.
-
findSpecial
Performs aMethodHandles.Lookup.findSpecial(Class, String, MethodType, Class)on the underlying lookup. Converts any encounteredIllegalAccessExceptioninto anIllegalAccessErrorandNoSuchMethodExceptioninto aNoSuchMethodError.- Parameters:
declaringClass- class declaring the methodname- the name of the methodtype- the type of the method- Returns:
- a method handle for the method
- Throws:
IllegalAccessError- if the method is inaccessible.NoSuchMethodError- if the method does not exist.
-
findStatic
Performs aMethodHandles.Lookup.findStatic(Class, String, MethodType)on the underlying lookup. Converts any encounteredIllegalAccessExceptioninto anIllegalAccessErrorandNoSuchMethodExceptioninto aNoSuchMethodError.- Parameters:
declaringClass- class declaring the methodname- the name of the methodtype- the type of the method- Returns:
- a method handle for the method
- Throws:
IllegalAccessError- if the method is inaccessible.NoSuchMethodError- if the method does not exist.
-
findVirtual
Performs aMethodHandles.Lookup.findVirtual(Class, String, MethodType)on the underlying lookup. Converts any encounteredIllegalAccessExceptioninto anIllegalAccessErrorandNoSuchMethodExceptioninto aNoSuchMethodError.- Parameters:
declaringClass- class declaring the methodname- the name of the methodtype- the type of the method- Returns:
- a method handle for the method
- Throws:
IllegalAccessError- if the method is inaccessible.NoSuchMethodError- if the method does not exist.
-
findOwnSpecial
public static MethodHandle findOwnSpecial(MethodHandles.Lookup lookup, String name, Class<?> rtype, Class<?>... ptypes) Given a lookup, finds usingfindSpecial(Class, String, MethodType)a method on that lookup's class. Useful in classes' code for convenient linking to their own privates.- Parameters:
lookup- the lookup for the classname- the name of the methodrtype- the return type of the methodptypes- the parameter types of the method- Returns:
- the method handle for the method
-
findOwnSpecial
Finds usingfindSpecial(Class, String, MethodType)a method on that lookup's class. Useful in classes' code for convenient linking to their own privates. It's also more convenient thanfindSpecialin that you can just list the parameter types, and don't have to specify lookup class.- Parameters:
name- the name of the methodrtype- the return type of the methodptypes- the parameter types of the method- Returns:
- the method handle for the method
-
findOwnStatic
public static MethodHandle findOwnStatic(MethodHandles.Lookup lookup, String name, Class<?> rtype, Class<?>... ptypes) Given a lookup, finds usingfindStatic(Class, String, MethodType)a method on that lookup's class. Useful in classes' code for convenient linking to their own privates. It's easier to use thanfindStaticin that you can just list the parameter types, and don't have to specify lookup class.- Parameters:
lookup- the lookup for the classname- the name of the methodrtype- the return type of the methodptypes- the parameter types of the method- Returns:
- the method handle for the method
-
findOwnStatic
Finds usingfindStatic(Class, String, MethodType)a method on that lookup's class. Useful in classes' code for convenient linking to their own privates. It's easier to use thanfindStaticin that you can just list the parameter types, and don't have to specify lookup class.- Parameters:
name- the name of the methodrtype- the return type of the methodptypes- the parameter types of the method- Returns:
- the method handle for the method
-