Module java.base

Package java.lang.constant

Interface MethodHandleDesc

All Superinterfaces:

ConstantDesc

All Known Subinterfaces:

DirectMethodHandleDesc

public interface MethodHandleDesc
extends ConstantDesc

A nominal descriptor for a MethodHandle constant.

Since:

12

Method Summary

Modifier and Type	Method	Description
default MethodHandleDesc	asType(MethodTypeDesc type)	Return a MethodHandleDesc that describes this method handle adapted to a different type, as if by MethodHandle.asType(MethodType).
MethodTypeDesc	invocationType()	Return a MethodTypeDesc describing the invocation type of the method handle described by this nominal descriptor.
static DirectMethodHandleDesc	of(DirectMethodHandleDesc.Kind kind, ClassDesc clazz, String name, String lookupDescriptor)	Create a MethodHandleDesc corresponding to an invocation of a declared method, invocation of a constructor, or access to a field.
static DirectMethodHandleDesc	ofConstructor(ClassDesc clazz, ClassDesc... paramTypes)	Return a MethodHandleDesc corresponding to invocation of a constructor
static DirectMethodHandleDesc	ofField(DirectMethodHandleDesc.Kind kind, ClassDesc clazz, String fieldName, ClassDesc fieldType)	Create a MethodHandleDesc corresponding to a method handle that accesses a field.
static DirectMethodHandleDesc	ofMethod(DirectMethodHandleDesc.Kind kind, ClassDesc clazz, String name, MethodTypeDesc lookupMethodType)	Create a MethodHandleDesc corresponding to an invocation of a declared method or constructor.

Methods inherited from interface java.lang.constant.ConstantDesc

resolveConstantDesc

Method Detail

of

static DirectMethodHandleDesc of(DirectMethodHandleDesc.Kind kind,
                                 ClassDesc clazz,
                                 String name,
                                 String lookupDescriptor)

Create a MethodHandleDesc corresponding to an invocation of a declared method, invocation of a constructor, or access to a field.

The lookup descriptor string has the same format as for the various variants of CONSTANT_MethodHandle_info and for the lookup methods on MethodHandles.Lookup. For a method or constructor invocation, it is interpreted as a method type descriptor; for field access, it is interpreted as a field descriptor. If kind is CONSTRUCTOR, the name parameter is ignored and the return type of the lookup descriptor must be void. If kind corresponds to a virtual method invocation, the lookup type includes the method parameters but not the receiver type.

Parameters:

kind - The kind of method handle to be described

clazz - a ClassDesc describing the class containing the method, constructor, or field

name - the unqualified name of the method or field (ignored if kind is CONSTRUCTOR)

lookupDescriptor - a method descriptor string the lookup type, if the request is for a method invocation, or describing the invocation type, if the request is for a field or constructor

Returns:

the MethodHandleDesc

Throws:

NullPointerException - if any of the non-ignored arguments are null

ofMethod

static DirectMethodHandleDesc ofMethod(DirectMethodHandleDesc.Kind kind,
                                       ClassDesc clazz,
                                       String name,
                                       MethodTypeDesc lookupMethodType)

Create a MethodHandleDesc corresponding to an invocation of a declared method or constructor.

The lookup descriptor string has the same format as for the lookup methods on MethodHandles.Lookup. If kind is CONSTRUCTOR, the name is ignored and the return type of the lookup type must be void. If kind corresponds to a virtual method invocation, the lookup type includes the method parameters but not the receiver type.

Parameters:

kind - The kind of method handle to be described; must be one of SPECIAL, VIRTUAL, STATIC, INTERFACE_SPECIAL, INTERFACE_VIRTUAL, INTERFACE_STATIC, CONSTRUCTOR

clazz - a ClassDesc describing the class containing the method or constructor

name - the unqualified name of the method (ignored if kind is CONSTRUCTOR)

lookupMethodType - a MethodTypeDesc describing the lookup type

Returns:

the MethodHandleDesc

Throws:

NullPointerException - if any non-ignored arguments are null

IllegalArgumentException - if the name has the incorrect format, or the kind is invalid

ofField

static DirectMethodHandleDesc ofField(DirectMethodHandleDesc.Kind kind,
                                      ClassDesc clazz,
                                      String fieldName,
                                      ClassDesc fieldType)

Create a MethodHandleDesc corresponding to a method handle that accesses a field.

Parameters:

kind - the kind of the method handle to be described; must be one of GETTER, SETTER, STATIC_GETTER, or STATIC_SETTER

clazz - a ClassDesc describing the class containing the field

fieldName - the unqualified name of the field

fieldType - a ClassDesc describing the type of the field

Returns:

the MethodHandleDesc

Throws:

NullPointerException - if any of the arguments are null

IllegalArgumentException - if the kind is not one of the valid values

ofConstructor

static DirectMethodHandleDesc ofConstructor(ClassDesc clazz,
                                            ClassDesc... paramTypes)

Return a MethodHandleDesc corresponding to invocation of a constructor

Parameters:

clazz - a ClassDesc describing the class containing the constructor

paramTypes - ClassDescs describing the parameter types of the constructor

Returns:

the MethodHandleDesc

Throws:

NullPointerException - if any of the arguments are null

asType

default MethodHandleDesc asType(MethodTypeDesc type)

Return a MethodHandleDesc that describes this method handle adapted to a different type, as if by MethodHandle.asType(MethodType).

Parameters:

type - a MethodHandleDesc describing the new method type

Returns:

a MethodHandleDesc for the adapted method handle

invocationType

MethodTypeDesc invocationType()

Return a MethodTypeDesc describing the invocation type of the method handle described by this nominal descriptor. The invocation type describes the full set of stack values that are consumed by the invocation (including the receiver, if any).

Returns:

a MethodHandleDesc describing the method handle type