net.bytebuddy.utility

Class JavaInstance.MethodHandle

java.lang.Object

net.bytebuddy.utility.JavaInstance.MethodHandle

All Implemented Interfaces:

JavaInstance

Enclosing interface:

JavaInstance

public static class JavaInstance.MethodHandle
extends Object
implements JavaInstance

Represents a java.lang.invoke.MethodHandle object. Note that constant MethodHandles cannot be represented within the constant pool of a Java class and can therefore not be represented as an instance of this representation order.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	JavaInstance.MethodHandle.Dispatcher A dispatcher for analyzing a java.lang.invoke.MethodHandle instance.
static class	JavaInstance.MethodHandle.HandleType A representation of a method handle's type.

Nested classes/interfaces inherited from interface net.bytebuddy.utility.JavaInstance

JavaInstance.MethodHandle, JavaInstance.MethodType

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MethodHandle(JavaInstance.MethodHandle.HandleType handleType, TypeDescription ownerType, String name, TypeDescription returnType, List<? extends TypeDescription> parameterTypes) Creates a method handle representation.

Method Summary

Modifier and Type	Method and Description
Object	asConstantPoolValue() Returns the represented instance as a constant pool value.
StackManipulation	asStackManipulation() Returns the instance as loadable onto the operand stack.
boolean	equals(Object other)
JavaInstance.MethodHandle.HandleType	getHandleType() Returns the handle type represented by this instance.
TypeDescription	getInstanceType() Returns a description of the type of the represented instance or at least a stub.
String	getName() Returns the name represented by this instance.
TypeDescription	getOwnerType() Returns the owner type of this instance.
List<TypeDescription>	getParameterTypes() Returns the parameter types represented by this instance.
TypeDescription	getReturnType() Returns the return type represented by this instance.
int	hashCode()
static JavaInstance.MethodHandle	of(Constructor<?> constructor) Creates a method handle representation of the given constructor.
static JavaInstance.MethodHandle	of(Method method) Creates a method handle representation of the given method.
static JavaInstance.MethodHandle	of(MethodDescription methodDescription) Creates a method handle representation of the given method.
static JavaInstance.MethodHandle	of(Object methodHandle) Creates a method handles representation of a loaded method handle which is analyzed using a public MethodHandles.Lookup object.
static JavaInstance.MethodHandle	of(Object methodHandle, AccessControlContext accessControlContext) Creates a method handles representation of a loaded method handle which is analyzed using a public MethodHandles.Lookup object.
static JavaInstance.MethodHandle	of(Object methodHandle, Object lookup) Creates a method handles representation of a loaded method handle which is analyzed using the given lookup context.
static JavaInstance.MethodHandle	of(Object methodHandle, Object lookup, AccessControlContext accessControlContext) Creates a method handles representation of a loaded method handle which is analyzed using the given lookup context.
static JavaInstance.MethodHandle	ofGetter(Field field) Returns a method handle for a setter of the given field.
static JavaInstance.MethodHandle	ofGetter(FieldDescription fieldDescription) Returns a method handle for a setter of the given field.
static JavaInstance.MethodHandle	ofSetter(Field field) Returns a method handle for a getter of the given field.
static JavaInstance.MethodHandle	ofSetter(FieldDescription fieldDescription) Returns a method handle for a getter of the given field.
static JavaInstance.MethodHandle	ofSpecial(Method method, Class<?> type) Creates a method handle representation of the given method for an explicit special method invocation of an otherwise virtual method.
static JavaInstance.MethodHandle	ofSpecial(MethodDescription methodDescription, TypeDescription typeDescription) Creates a method handle representation of the given method for an explicit special method invocation of an otherwise virtual method.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MethodHandle

protected MethodHandle(JavaInstance.MethodHandle.HandleType handleType,
                       TypeDescription ownerType,
                       String name,
                       TypeDescription returnType,
                       List<? extends TypeDescription> parameterTypes)

Creates a method handle representation.

Parameters:

handleType - The handle type that is represented by this instance.

ownerType - The owner type that is represented by this instance.

name - The name that is represented by this instance.

returnType - The return type that is represented by this instance.

parameterTypes - The parameter types that is represented by this instance.

Method Detail

of

public static JavaInstance.MethodHandle of(Object methodHandle)

Creates a method handles representation of a loaded method handle which is analyzed using a public MethodHandles.Lookup object. A method handle can only be analyzed on virtual machines that support the corresponding API (Java 7+). For virtual machines before Java 8+, a method handle instance can only be analyzed by taking advantage of private APIs what might require a access context.

Parameters:

methodHandle - The loaded method handle to represent.

Returns:

A representation of the loaded method handle

of

public static JavaInstance.MethodHandle of(Object methodHandle,
                                           Object lookup)

Creates a method handles representation of a loaded method handle which is analyzed using the given lookup context. A method handle can only be analyzed on virtual machines that support the corresponding API (Java 7+). For virtual machines before Java 8+, a method handle instance can only be analyzed by taking advantage of private APIs what might require a access context.

Parameters:

methodHandle - The loaded method handle to represent.

lookup - The lookup object to use for analyzing the method handle.

Returns:

A representation of the loaded method handle

of

public static JavaInstance.MethodHandle of(Object methodHandle,
                                           AccessControlContext accessControlContext)

Creates a method handles representation of a loaded method handle which is analyzed using a public MethodHandles.Lookup object. A method handle can only be analyzed on virtual machines that support the corresponding API (Java 7+). For virtual machines before Java 8+, a method handle instance can only be analyzed by taking advantage of private APIs what might require a access context.

Parameters:

methodHandle - The loaded method handle to represent.

accessControlContext - The access control context to be used for making private methods accessible when using Java 7.

Returns:

A representation of the loaded method handle

of

public static JavaInstance.MethodHandle of(Object methodHandle,
                                           Object lookup,
                                           AccessControlContext accessControlContext)

Creates a method handles representation of a loaded method handle which is analyzed using the given lookup context. A method handle can only be analyzed on virtual machines that support the corresponding API (Java 7+). For virtual machines before Java 8+, a method handle instance can only be analyzed by taking advantage of private APIs what might require a access context.

Parameters:

methodHandle - The loaded method handle to represent.

lookup - The lookup object to use for analyzing the method handle.

accessControlContext - The access control context to be used for making private methods accessible when using Java 7.

Returns:

A representation of the loaded method handle

of

public static JavaInstance.MethodHandle of(Method method)

Creates a method handle representation of the given method.

Parameters:

method - The method ro represent.

Returns:

A method handle representing the given method.

of

public static JavaInstance.MethodHandle of(Constructor<?> constructor)

Creates a method handle representation of the given constructor.

Parameters:

constructor - The constructor ro represent.

Returns:

A method handle representing the given constructor.

of

public static JavaInstance.MethodHandle of(MethodDescription methodDescription)

Creates a method handle representation of the given method.

Parameters:

methodDescription - The method ro represent.

Returns:

A method handle representing the given method.

ofSpecial

public static JavaInstance.MethodHandle ofSpecial(Method method,
                                                  Class<?> type)

Creates a method handle representation of the given method for an explicit special method invocation of an otherwise virtual method.

Parameters:

method - The method ro represent.

type - The type on which the method is to be invoked on as a special method invocation.

Returns:

A method handle representing the given method as special method invocation.

ofSpecial

public static JavaInstance.MethodHandle ofSpecial(MethodDescription methodDescription,
                                                  TypeDescription typeDescription)

Creates a method handle representation of the given method for an explicit special method invocation of an otherwise virtual method.

Parameters:

methodDescription - The method ro represent.

typeDescription - The type on which the method is to be invoked on as a special method invocation.

Returns:

A method handle representing the given method as special method invocation.

ofGetter

public static JavaInstance.MethodHandle ofGetter(Field field)

Returns a method handle for a setter of the given field.

Parameters:

field - The field to represent.

Returns:

A method handle for a setter of the given field.

ofGetter

public static JavaInstance.MethodHandle ofGetter(FieldDescription fieldDescription)

Returns a method handle for a setter of the given field.

Parameters:

fieldDescription - The field to represent.

Returns:

A method handle for a setter of the given field.

ofSetter

public static JavaInstance.MethodHandle ofSetter(Field field)

Returns a method handle for a getter of the given field.

Parameters:

field - The field to represent.

Returns:

A method handle for a getter of the given field.

ofSetter

public static JavaInstance.MethodHandle ofSetter(FieldDescription fieldDescription)

Returns a method handle for a getter of the given field.

Parameters:

fieldDescription - The field to represent.

Returns:

A method handle for a getter of the given field.

asConstantPoolValue

public Object asConstantPoolValue()

Description copied from interface: JavaInstance

Returns the represented instance as a constant pool value.

Specified by:

asConstantPoolValue in interface JavaInstance

Returns:

The constant pool value in a format that can be written by ASM.

asStackManipulation

public StackManipulation asStackManipulation()

Description copied from interface: JavaInstance

Returns the instance as loadable onto the operand stack.

Specified by:

asStackManipulation in interface JavaInstance

Returns:

A stack manipulation that loads the represented value onto the operand stack.

getInstanceType

public TypeDescription getInstanceType()

Description copied from interface: JavaInstance

Returns a description of the type of the represented instance or at least a stub.

Specified by:

getInstanceType in interface JavaInstance

Returns:

A description of the type of the represented instance or at least a stub.

getHandleType

public JavaInstance.MethodHandle.HandleType getHandleType()

Returns the handle type represented by this instance.

Returns:

The handle type represented by this instance.

getOwnerType

public TypeDescription getOwnerType()

Returns the owner type of this instance.

Returns:

The owner type of this instance.

getName

public String getName()

Returns the name represented by this instance.

Returns:

The name represented by this instance.

getReturnType

public TypeDescription getReturnType()

Returns the return type represented by this instance.

Returns:

The return type represented by this instance.

getParameterTypes

public List<TypeDescription> getParameterTypes()

Returns the parameter types represented by this instance.

Returns:

The parameter types represented by this instance.

equals

public boolean equals(Object other)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object