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 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.
String	toString()	Returns a compact textual description of this constant description.
ClassDesc	varType()	Returns a ClassDesc describing the type of the variable described by this descriptor.

Methods declared in class DynamicConstantDesc

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

Modifier and Type	Method	Description
ConstantDesc[]	bootstrapArgs()	Returns the bootstrap arguments for this constant.
List<ConstantDesc>	bootstrapArgsList()	Returns the bootstrap arguments for this constant as an immutable List.
DirectMethodHandleDesc	bootstrapMethod()	Returns a MethodHandleDesc describing the bootstrap method for this constant.
String	constantName()	Returns the name that would appear in the NameAndType operand of the LDC for this constant.
ClassDesc	constantType()	Returns a ClassDesc describing the type that would appear in the NameAndType operand of the LDC for this constant.
final boolean	equals(Object o)	Compares the specified object with this descriptor for equality.
final int	hashCode()	Answers an integer hash code for the receiver.
static <T> DynamicConstantDesc<T>	of(DirectMethodHandleDesc bootstrapMethod)	Returns a nominal descriptor for a dynamic constant whose bootstrap has no static arguments, whose name parameter is ConstantDescs.DEFAULT_NAME, and whose type parameter is always the same as the bootstrap method return type.
static <T> DynamicConstantDesc<T>	of(DirectMethodHandleDesc bootstrapMethod, ConstantDesc... bootstrapArgs)	Returns a nominal descriptor for a dynamic constant whose name parameter is ConstantDescs.DEFAULT_NAME, and whose type parameter is always the same as the bootstrap method return type.
static <T> ConstantDesc	ofCanonical(DirectMethodHandleDesc bootstrapMethod, String constantName, ClassDesc constantType, ConstantDesc[] bootstrapArgs)	Returns a nominal descriptor for a dynamic constant, transforming it into a more specific type if the constant bootstrap is a well-known one and a more specific nominal descriptor type (e.g., ClassDesc) is available.
static <T> DynamicConstantDesc<T>	ofNamed(DirectMethodHandleDesc bootstrapMethod, String constantName, ClassDesc constantType, ConstantDesc... bootstrapArgs)	Returns a nominal descriptor for a dynamic constant.
VarHandle	resolveConstantDesc(MethodHandles.Lookup lookup)	Resolves this descriptor reflectively, emulating the resolution behavior of JVMS §5.4.3 and the access control behavior of JVMS §5.4.4.

Methods declared in class Object

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

Modifier and Type	Method	Description
protected Object	clone()	Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Method Details

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:

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

name - the unqualified name of the field

fieldType - a ClassDesc describing the type of the field

Returns:

the VarHandle.VarHandleDesc

Throws:

NullPointerException - if any of the arguments are null

See Java Virtual Machine Specification:

4.2.2 Unqualified Names

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:

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

name - the unqualified name of the field

fieldType - a ClassDesc describing the type of the field

Returns:

the VarHandle.VarHandleDesc

Throws:

NullPointerException - if any of the arguments are null

See Java Virtual Machine Specification:

4.2.2 Unqualified Names

ofArray

public static VarHandle.VarHandleDesc ofArray(ClassDesc arrayClass)

Returns a VarHandle.VarHandleDesc corresponding to a VarHandle 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

toString

public String toString()

Returns a compact textual description of this constant description. For a field VarHandle, includes the owner, name, and type of the field, and whether it is static; for an array VarHandle, the name of the component type.

Overrides:

toString in class DynamicConstantDesc<VarHandle>

Returns:

A compact textual description of this descriptor