Module java.base

Package java.lang.invoke

Class VarHandle.VarHandleDesc

java.lang.Object

java.lang.constant.DynamicConstantDesc<VarHandle>

java.lang.invoke.VarHandle.VarHandleDesc

All Implemented Interfaces:

ConstantDesc

Enclosing class:

VarHandle

public static final class VarHandle.VarHandleDesc
extends DynamicConstantDesc<VarHandle>

A nominal descriptor for a VarHandle constant.

Since:

12

Method Summary

Modifier and Type	Method	Description
static VarHandle.VarHandleDesc	ofArray(ClassDesc arrayClass)	Returns a VarHandle.VarHandleDesc corresponding to a VarHandle for for an array type.
static VarHandle.VarHandleDesc	ofField(ClassDesc declaringClass, String name, ClassDesc fieldType)	Returns a VarHandle.VarHandleDesc corresponding to a VarHandle for an instance field.
static VarHandle.VarHandleDesc	ofStaticField(ClassDesc declaringClass, String name, ClassDesc fieldType)	Returns a VarHandle.VarHandleDesc corresponding to a VarHandle for a static field.
VarHandle	resolveConstantDesc(MethodHandles.Lookup lookup)	Resolve this descriptor reflectively, emulating the resolution behavior of JVMS 5.4.3 and the access control behavior of JVMS 5.4.4.
String	toString()	Returns a string representation of the object.
ClassDesc	varType()	Returns a ClassDesc describing the type of the variable described by this descriptor.

Methods inherited from class java.lang.constant.DynamicConstantDesc

bootstrapArgs, bootstrapArgsList, bootstrapMethod, constantName, constantType, equals, hashCode, of, of, ofCanonical, ofNamed

Methods inherited from class java.lang.Object

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

Method Detail

ofField

public static VarHandle.VarHandleDesc ofField(ClassDesc declaringClass,
                                              String name,
                                              ClassDesc fieldType)

Returns a VarHandle.VarHandleDesc corresponding to a VarHandle for an instance field.

Parameters:

name - the unqualifed name of the field

declaringClass - a ClassDesc describing the declaring class, for field var handles

fieldType - a ClassDesc describing the type of the field

Returns:

the VarHandle.VarHandleDesc

Throws:

NullPointerException - if any of the arguments are null

ofStaticField

public static VarHandle.VarHandleDesc ofStaticField(ClassDesc declaringClass,
                                                    String name,
                                                    ClassDesc fieldType)

Returns a VarHandle.VarHandleDesc corresponding to a VarHandle for a static field.

Parameters:

name - the unqualified name of the field

declaringClass - a ClassDesc describing the declaring class, for field var handles

fieldType - a ClassDesc describing the type of the field

Returns:

the VarHandle.VarHandleDesc

Throws:

NullPointerException - if any of the arguments are null

ofArray

public static VarHandle.VarHandleDesc ofArray(ClassDesc arrayClass)

Returns a VarHandle.VarHandleDesc corresponding to a VarHandle for for an array type.

Parameters:

arrayClass - a ClassDesc describing the type of the array

Returns:

the VarHandle.VarHandleDesc

Throws:

NullPointerException - if any of the arguments are null

varType

public ClassDesc varType()

Returns a ClassDesc describing the type of the variable described by this descriptor.

Returns:

the variable type

resolveConstantDesc

public VarHandle resolveConstantDesc(MethodHandles.Lookup lookup)
                              throws ReflectiveOperationException

Description copied from interface: ConstantDesc

Resolve this descriptor reflectively, emulating the resolution behavior of JVMS 5.4.3 and the access control behavior of JVMS 5.4.4. The resolution and access control context is provided by the MethodHandles.Lookup parameter. No caching of the resulting value is performed.

Specified by:

resolveConstantDesc in interface ConstantDesc

Overrides:

resolveConstantDesc in class DynamicConstantDesc<VarHandle>

Parameters:

lookup - The MethodHandles.Lookup to provide name resolution and access control context

Returns:

the resolved constant value

Throws:

ReflectiveOperationException - if a class, method, or field could not be reflectively resolved in the course of resolution

toString

public String toString()

Description copied from class: Object

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Overrides:

toString in class DynamicConstantDesc<VarHandle>

Returns:

a string representation of the object.