OpenJDK 1.23 · jdk.dynalink.linker.support.Lookup · APIdia, the JavaDoc alternative

Modifier and Type	Field and Description
private final MethodHandles.Lookup	lookup
public static final Lookup	PUBLIC A canonical Lookup object that wraps `MethodHandles#publicLookup()`.

Access	Constructor and Description
public	Lookup(final MethodHandles.Lookup the `java.lang.invoke.MethodHandles.Lookup` it delegates to. lookup) Creates a new instance, bound to an instance of `java.lang.invoke.MethodHandles.Lookup`.

Method Summary

Modifier and Type	Method and Description
public MethodHandle	Returns: the unreflected field getter handle. findGetter(final Class<?> the class declaring the field refc, final String the name of the field name, final Class<?> the type of the field type) Performs a `java.lang.invoke.MethodHandles.Lookup#findGetter(Class, String, Class)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError` and `NoSuchFieldException` into a `NoSuchFieldError`.
public static MethodHandle	Returns: the method handle for the method findOwnSpecial(final MethodHandles.Lookup the lookup for the class lookup, final String the name of the method name, final Class<?> the return type of the method rtype, final Class<?>... the parameter types of the method ptypes) Given a lookup, finds using `findSpecial(Class, String, MethodType)` a method on that lookup's class.
public MethodHandle	Returns: the method handle for the method findOwnSpecial(final String the name of the method name, final Class<?> the return type of the method rtype, final Class<?>... the parameter types of the method ptypes) Finds using `findSpecial(Class, String, MethodType)` a method on that lookup's class.
public static MethodHandle	Returns: the method handle for the method findOwnStatic(final MethodHandles.Lookup the lookup for the class lookup, final String the name of the method name, final Class<?> the return type of the method rtype, final Class<?>... the parameter types of the method ptypes) Given a lookup, finds using `findStatic(Class, String, MethodType)` a method on that lookup's class.
public MethodHandle	Returns: the method handle for the method findOwnStatic(final String the name of the method name, final Class<?> the return type of the method rtype, final Class<?>... the parameter types of the method ptypes) Finds using `findStatic(Class, String, MethodType)` a method on that lookup's class.
public MethodHandle	Returns: a method handle for the method findSpecial(final Class<?> class declaring the method declaringClass, final String the name of the method name, final MethodType the type of the method type) Performs a `java.lang.invoke.MethodHandles.Lookup#findSpecial(Class, String, MethodType, Class)` on the underlying lookup.
public MethodHandle	Returns: a method handle for the method findStatic(final Class<?> class declaring the method declaringClass, final String the name of the method name, final MethodType the type of the method type) Performs a `java.lang.invoke.MethodHandles.Lookup#findStatic(Class, String, MethodType)` on the underlying lookup.
public MethodHandle	Returns: a method handle for the method findVirtual(final Class<?> class declaring the method declaringClass, final String the name of the method name, final MethodType the type of the method type) Performs a `java.lang.invoke.MethodHandles.Lookup#findVirtual(Class, String, MethodType)` on the underlying lookup.
private static String	methodDescription(final Class<?> declaringClass, final String name, final MethodType type)
public MethodHandle	Returns: the unreflected method handle. unreflect(final Method the method to unreflect m) Performs a `java.lang.invoke.MethodHandles.Lookup#unreflect(Method)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError`.
public static MethodHandle	Returns: the unreflected method handle. unreflect(final MethodHandles.Lookup the lookup used to unreflect lookup, final Method the method to unreflect m) Performs a `java.lang.invoke.MethodHandles.Lookup#unreflect(Method)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError`.
public MethodHandle	Returns: the unreflected constructor handle. unreflectConstructor(final Constructor<?> the constructor to unreflect c) Performs a `java.lang.invoke.MethodHandles.Lookup#unreflectConstructor(Constructor)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError`.
public static MethodHandle	Returns: the unreflected constructor handle. unreflectConstructor(final MethodHandles.Lookup the lookup used to unreflect lookup, final Constructor<?> the constructor to unreflect c) Performs a `java.lang.invoke.MethodHandles.Lookup#unreflectConstructor(Constructor)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError`.
public MethodHandle	Returns: the unreflected field getter handle. unreflectGetter(final Field the field for which a getter is unreflected f) Performs a `java.lang.invoke.MethodHandles.Lookup#unreflectGetter(Field)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError`.
public MethodHandle	Returns: the unreflected field setter handle. unreflectSetter(final Field the field for which a setter is unreflected f) Performs a `java.lang.invoke.MethodHandles.Lookup#unreflectSetter(Field)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

lookup	back to summary
private final MethodHandles.Lookup lookup

PUBLIC	back to summary
public static final Lookup PUBLIC A canonical Lookup object that wraps `MethodHandles#publicLookup()`.

Lookup	back to summary
public Lookup(final MethodHandles.Lookup lookup) Creates a new instance, bound to an instance of `java.lang.invoke.MethodHandles.Lookup`. Parameters lookup:MethodHandles.Lookup the `java.lang.invoke.MethodHandles.Lookup` it delegates to.

Method Detail

findGetter back to summary

findGetter	back to summary
public MethodHandle findGetter(final Class<?> refc, final String name, final Class<?> type) Performs a `java.lang.invoke.MethodHandles.Lookup#findGetter(Class, String, Class)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError` and `NoSuchFieldException` into a `NoSuchFieldError`. Parameters refc:Class<?> the class declaring the field name:String the name of the field type:Class<?> the type of the field Returns:MethodHandle the unreflected field getter handle. Exceptions IllegalAccessError: if the field is inaccessible. NoSuchFieldError: if the field does not exist.

public MethodHandle findGetter(final Class<?> refc, final String name, final Class<?> type)

Performs a java.lang.invoke.MethodHandles.Lookup#findGetter(Class, String, Class), converting any encountered IllegalAccessException into an IllegalAccessError and NoSuchFieldException into a NoSuchFieldError.

Parameters

refc:Class<?>: the class declaring the field
name:String: the name of the field
type:Class<?>: the type of the field

Returns:MethodHandle

the unreflected field getter handle.

Exceptions

IllegalAccessError:: if the field is inaccessible.
NoSuchFieldError:: if the field does not exist.

findOwnSpecial back to summary

findOwnSpecial	back to summary
public static MethodHandle findOwnSpecial(final MethodHandles.Lookup lookup, final String name, final Class<?> rtype, final Class<?>... ptypes) Given a lookup, finds using `findSpecial(Class, String, MethodType)` a method on that lookup's class. Useful in classes' code for convenient linking to their own privates. Parameters lookup:MethodHandles.Lookup the lookup for the class name:String the name of the method rtype:Class<?> the return type of the method ptypes:Class<?>[] the parameter types of the method Returns:MethodHandle the method handle for the method

public static MethodHandle findOwnSpecial(final MethodHandles.Lookup lookup, final String name, final Class<?> rtype, final Class<?>... ptypes)

Given a lookup, finds using findSpecial(Class, String, MethodType) a method on that lookup's class. Useful in classes' code for convenient linking to their own privates.

Parameters

lookup:MethodHandles.Lookup: the lookup for the class
name:String: the name of the method
rtype:Class<?>: the return type of the method
ptypes:Class<?>[]: the parameter types of the method

Returns:MethodHandle

the method handle for the method

findOwnSpecial back to summary

findOwnSpecial	back to summary
public MethodHandle findOwnSpecial(final String name, final Class<?> rtype, final Class<?>... ptypes) Finds using `findSpecial(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 than `findSpecial` in that you can just list the parameter types, and don't have to specify lookup class. Parameters name:String the name of the method rtype:Class<?> the return type of the method ptypes:Class<?>[] the parameter types of the method Returns:MethodHandle the method handle for the method

public MethodHandle findOwnSpecial(final String name, final Class<?> rtype, final Class<?>... ptypes)

Finds using findSpecial(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 than findSpecial in that you can just list the parameter types, and don't have to specify lookup class.

Parameters

name:String: the name of the method
rtype:Class<?>: the return type of the method
ptypes:Class<?>[]: the parameter types of the method

Returns:MethodHandle

the method handle for the method

findOwnStatic back to summary

findOwnStatic	back to summary
public static MethodHandle findOwnStatic(final MethodHandles.Lookup lookup, final String name, final Class<?> rtype, final Class<?>... ptypes) Given a lookup, finds using `findStatic(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 than `findStatic` in that you can just list the parameter types, and don't have to specify lookup class. Parameters lookup:MethodHandles.Lookup the lookup for the class name:String the name of the method rtype:Class<?> the return type of the method ptypes:Class<?>[] the parameter types of the method Returns:MethodHandle the method handle for the method

public static MethodHandle findOwnStatic(final MethodHandles.Lookup lookup, final String name, final Class<?> rtype, final Class<?>... ptypes)

Given a lookup, finds using findStatic(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 than findStatic in that you can just list the parameter types, and don't have to specify lookup class.

Parameters

lookup:MethodHandles.Lookup: the lookup for the class
name:String: the name of the method
rtype:Class<?>: the return type of the method
ptypes:Class<?>[]: the parameter types of the method

Returns:MethodHandle

the method handle for the method

findOwnStatic back to summary

findOwnStatic	back to summary
public MethodHandle findOwnStatic(final String name, final Class<?> rtype, final Class<?>... ptypes) Finds using `findStatic(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 than `findStatic` in that you can just list the parameter types, and don't have to specify lookup class. Parameters name:String the name of the method rtype:Class<?> the return type of the method ptypes:Class<?>[] the parameter types of the method Returns:MethodHandle the method handle for the method

public MethodHandle findOwnStatic(final String name, final Class<?> rtype, final Class<?>... ptypes)

Finds using findStatic(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 than findStatic in that you can just list the parameter types, and don't have to specify lookup class.

Parameters

name:String: the name of the method
rtype:Class<?>: the return type of the method
ptypes:Class<?>[]: the parameter types of the method

Returns:MethodHandle

the method handle for the method

findSpecial back to summary

findSpecial	back to summary
public MethodHandle findSpecial(final Class<?> declaringClass, final String name, final MethodType type) Performs a `java.lang.invoke.MethodHandles.Lookup#findSpecial(Class, String, MethodType, Class)` on the underlying lookup. Converts any encountered `IllegalAccessException` into an `IllegalAccessError` and `NoSuchMethodException` into a `NoSuchMethodError`. Parameters declaringClass:Class<?> class declaring the method name:String the name of the method type:MethodType the type of the method Returns:MethodHandle a method handle for the method Exceptions IllegalAccessError: if the method is inaccessible. NoSuchMethodError: if the method does not exist.

public MethodHandle findSpecial(final Class<?> declaringClass, final String name, final MethodType type)

Performs a java.lang.invoke.MethodHandles.Lookup#findSpecial(Class, String, MethodType, Class) on the underlying lookup. Converts any encountered IllegalAccessException into an IllegalAccessError and NoSuchMethodException into a NoSuchMethodError.

Parameters

declaringClass:Class<?>: class declaring the method
name:String: the name of the method
type:MethodType: the type of the method

Returns:MethodHandle

a method handle for the method

Exceptions

IllegalAccessError:: if the method is inaccessible.
NoSuchMethodError:: if the method does not exist.

findStatic back to summary

findStatic	back to summary
public MethodHandle findStatic(final Class<?> declaringClass, final String name, final MethodType type) Performs a `java.lang.invoke.MethodHandles.Lookup#findStatic(Class, String, MethodType)` on the underlying lookup. Converts any encountered `IllegalAccessException` into an `IllegalAccessError` and `NoSuchMethodException` into a `NoSuchMethodError`. Parameters declaringClass:Class<?> class declaring the method name:String the name of the method type:MethodType the type of the method Returns:MethodHandle a method handle for the method Exceptions IllegalAccessError: if the method is inaccessible. NoSuchMethodError: if the method does not exist.

public MethodHandle findStatic(final Class<?> declaringClass, final String name, final MethodType type)

Performs a java.lang.invoke.MethodHandles.Lookup#findStatic(Class, String, MethodType) on the underlying lookup. Converts any encountered IllegalAccessException into an IllegalAccessError and NoSuchMethodException into a NoSuchMethodError.

Parameters

declaringClass:Class<?>: class declaring the method
name:String: the name of the method
type:MethodType: the type of the method

Returns:MethodHandle

a method handle for the method

Exceptions

IllegalAccessError:: if the method is inaccessible.
NoSuchMethodError:: if the method does not exist.

findVirtual back to summary

findVirtual	back to summary
public MethodHandle findVirtual(final Class<?> declaringClass, final String name, final MethodType type) Performs a `java.lang.invoke.MethodHandles.Lookup#findVirtual(Class, String, MethodType)` on the underlying lookup. Converts any encountered `IllegalAccessException` into an `IllegalAccessError` and `NoSuchMethodException` into a `NoSuchMethodError`. Parameters declaringClass:Class<?> class declaring the method name:String the name of the method type:MethodType the type of the method Returns:MethodHandle a method handle for the method Exceptions IllegalAccessError: if the method is inaccessible. NoSuchMethodError: if the method does not exist.

public MethodHandle findVirtual(final Class<?> declaringClass, final String name, final MethodType type)

Performs a java.lang.invoke.MethodHandles.Lookup#findVirtual(Class, String, MethodType) on the underlying lookup. Converts any encountered IllegalAccessException into an IllegalAccessError and NoSuchMethodException into a NoSuchMethodError.

Parameters

declaringClass:Class<?>: class declaring the method
name:String: the name of the method
type:MethodType: the type of the method

Returns:MethodHandle

a method handle for the method

Exceptions

IllegalAccessError:: if the method is inaccessible.
NoSuchMethodError:: if the method does not exist.

methodDescription	back to summary
private static String methodDescription(final Class<?> declaringClass, final String name, final MethodType type)

unreflect back to summary

unreflect	back to summary
public MethodHandle unreflect(final Method m) Performs a `java.lang.invoke.MethodHandles.Lookup#unreflect(Method)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError`. Parameters m:Method the method to unreflect Returns:MethodHandle the unreflected method handle. Exceptions IllegalAccessError: if the method is inaccessible.

public MethodHandle unreflect(final Method m)

Performs a java.lang.invoke.MethodHandles.Lookup#unreflect(Method), converting any encountered IllegalAccessException into an IllegalAccessError.

Parameters

m:Method: the method to unreflect

Returns:MethodHandle

the unreflected method handle.

Exceptions

IllegalAccessError:: if the method is inaccessible.

unreflect back to summary

unreflect	back to summary
public static MethodHandle unreflect(final MethodHandles.Lookup lookup, final Method m) Performs a `java.lang.invoke.MethodHandles.Lookup#unreflect(Method)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError`. Parameters lookup:MethodHandles.Lookup the lookup used to unreflect m:Method the method to unreflect Returns:MethodHandle the unreflected method handle. Exceptions IllegalAccessError: if the method is inaccessible.

public static MethodHandle unreflect(final MethodHandles.Lookup lookup, final Method m)

Performs a java.lang.invoke.MethodHandles.Lookup#unreflect(Method), converting any encountered IllegalAccessException into an IllegalAccessError.

Parameters

lookup:MethodHandles.Lookup: the lookup used to unreflect
m:Method: the method to unreflect

Returns:MethodHandle

the unreflected method handle.

Exceptions

IllegalAccessError:: if the method is inaccessible.

unreflectConstructor back to summary

unreflectConstructor	back to summary
public MethodHandle unreflectConstructor(final Constructor<?> c) Performs a `java.lang.invoke.MethodHandles.Lookup#unreflectConstructor(Constructor)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError`. Parameters c:Constructor<?> the constructor to unreflect Returns:MethodHandle the unreflected constructor handle. Exceptions IllegalAccessError: if the constructor is inaccessible.

public MethodHandle unreflectConstructor(final Constructor<?> c)

Performs a java.lang.invoke.MethodHandles.Lookup#unreflectConstructor(Constructor), converting any encountered IllegalAccessException into an IllegalAccessError.

Parameters

c:Constructor<?>: the constructor to unreflect

Returns:MethodHandle

the unreflected constructor handle.

Exceptions

IllegalAccessError:: if the constructor is inaccessible.

unreflectConstructor back to summary

unreflectConstructor	back to summary
public static MethodHandle unreflectConstructor(final MethodHandles.Lookup lookup, final Constructor<?> c) Performs a `java.lang.invoke.MethodHandles.Lookup#unreflectConstructor(Constructor)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError`. Parameters lookup:MethodHandles.Lookup the lookup used to unreflect c:Constructor<?> the constructor to unreflect Returns:MethodHandle the unreflected constructor handle. Exceptions IllegalAccessError: if the constructor is inaccessible.

public static MethodHandle unreflectConstructor(final MethodHandles.Lookup lookup, final Constructor<?> c)

Performs a java.lang.invoke.MethodHandles.Lookup#unreflectConstructor(Constructor), converting any encountered IllegalAccessException into an IllegalAccessError.

Parameters

lookup:MethodHandles.Lookup: the lookup used to unreflect
c:Constructor<?>: the constructor to unreflect

Returns:MethodHandle

the unreflected constructor handle.

Exceptions

IllegalAccessError:: if the constructor is inaccessible.

unreflectGetter back to summary

unreflectGetter	back to summary
public MethodHandle unreflectGetter(final Field f) Performs a `java.lang.invoke.MethodHandles.Lookup#unreflectGetter(Field)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError`. Parameters f:Field the field for which a getter is unreflected Returns:MethodHandle the unreflected field getter handle. Exceptions IllegalAccessError: if the getter is inaccessible.

public MethodHandle unreflectGetter(final Field f)

Performs a java.lang.invoke.MethodHandles.Lookup#unreflectGetter(Field), converting any encountered IllegalAccessException into an IllegalAccessError.

Parameters

f:Field: the field for which a getter is unreflected

Returns:MethodHandle

the unreflected field getter handle.

Exceptions

IllegalAccessError:: if the getter is inaccessible.

unreflectSetter back to summary

unreflectSetter	back to summary
public MethodHandle unreflectSetter(final Field f) Performs a `java.lang.invoke.MethodHandles.Lookup#unreflectSetter(Field)`, converting any encountered `IllegalAccessException` into an `IllegalAccessError`. Parameters f:Field the field for which a setter is unreflected Returns:MethodHandle the unreflected field setter handle. Exceptions IllegalAccessError: if the field is inaccessible. NoSuchFieldError: if the field does not exist.

public MethodHandle unreflectSetter(final Field f)

Performs a java.lang.invoke.MethodHandles.Lookup#unreflectSetter(Field), converting any encountered IllegalAccessException into an IllegalAccessError.

Parameters

f:Field: the field for which a setter is unreflected

Returns:MethodHandle

the unreflected field setter handle.

Exceptions

IllegalAccessError:: if the field is inaccessible.
NoSuchFieldError:: if the field does not exist.

public final Class Lookup

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail