Module java.base

Package java.lang.constant

Class DynamicCallSiteDesc

java.lang.Object

java.lang.constant.DynamicCallSiteDesc

public class DynamicCallSiteDesc
extends Object

A nominal descriptor for an invokedynamic call site.

Concrete subtypes of DynamicCallSiteDesc must be value-based.

Since:

12

Method Summary

Modifier and Type	Method	Description
ConstantDesc[]	bootstrapArgs()	Returns ConstantDescs describing the bootstrap arguments for the invokedynamic.
MethodHandleDesc	bootstrapMethod()	Returns a MethodHandleDesc descripbing the bootstrap method for the invokedynamic.
boolean	equals(Object o)	Compares the specified object with this descriptor for equality.
int	hashCode()	Returns a hash code value for the object.
String	invocationName()	Returns the invocation name that would appear in the NameAndType operand of the invokedynamic.
MethodTypeDesc	invocationType()	Returns a MethodTypeDesc describing the invocation type that would appear in the NameAndType operand of the invokedynamic.
static DynamicCallSiteDesc	of(DirectMethodHandleDesc bootstrapMethod, MethodTypeDesc invocationType)	Create a nominal descriptor for an invokedynamic call site whose bootstrap method has no static arguments and for which the name parameter is ConstantDescs.DEFAULT_NAME.
static DynamicCallSiteDesc	of(DirectMethodHandleDesc bootstrapMethod, String invocationName, MethodTypeDesc invocationType)	Create a nominal descriptor for an invokedynamic call site whose bootstrap method has no static arguments.
static DynamicCallSiteDesc	of(DirectMethodHandleDesc bootstrapMethod, String invocationName, MethodTypeDesc invocationType, ConstantDesc... bootstrapArgs)	Create a nominal descriptor for an invokedynamic call site.
CallSite	resolveCallSiteDesc(MethodHandles.Lookup lookup)	Reflectively invokes the bootstrap method with the specified arguments, and return the resulting CallSite
String	toString()	Returns a string representation of the object.
DynamicCallSiteDesc	withArgs(ConstantDesc... bootstrapArgs)	Return a nominal descriptor for an invokedynamic call site whose bootstrap method, name, and invocation type are the same as this one, but with the specified bootstrap arguments.
DynamicCallSiteDesc	withNameAndType(String invocationName, MethodTypeDesc invocationType)	Return a nominal descriptor for an invokedynamic call site whose bootstrap and bootstrap arguments are the same as this one, but with the specified invocationName and invocation invocationType

Methods inherited from class java.lang.Object

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

Method Detail

of

public static DynamicCallSiteDesc of(DirectMethodHandleDesc bootstrapMethod,
                                     String invocationName,
                                     MethodTypeDesc invocationType,
                                     ConstantDesc... bootstrapArgs)

Create a nominal descriptor for an invokedynamic call site.

Parameters:

bootstrapMethod - a DirectMethodHandleDescImpl describing the bootstrap method for the invokedynamic

invocationName - The unqualified name that would appear in the NameAndType operand of the invokedynamic

invocationType - a MethodTypeDesc describing the invocation type that would appear in the NameAndType operand of the invokedynamic

bootstrapArgs - ConstantDescs describing the static arguments to the bootstrap, that would appear in the BootstrapMethods attribute

Returns:

the nominal descriptor

Throws:

NullPointerException - if any parameter is null

IllegalArgumentException - if the invocation name has the incorrect format

of

public static DynamicCallSiteDesc of(DirectMethodHandleDesc bootstrapMethod,
                                     String invocationName,
                                     MethodTypeDesc invocationType)

Create a nominal descriptor for an invokedynamic call site whose bootstrap method has no static arguments.

Parameters:

bootstrapMethod - The bootstrap method for the invokedynamic

invocationName - The invocationName that would appear in the NameAndType operand of the invokedynamic

invocationType - The invocation invocationType that would appear in the NameAndType operand of the invokedynamic

Returns:

the nominal descriptor

Throws:

NullPointerException - if any parameter is null

of

public static DynamicCallSiteDesc of(DirectMethodHandleDesc bootstrapMethod,
                                     MethodTypeDesc invocationType)

Create a nominal descriptor for an invokedynamic call site whose bootstrap method has no static arguments and for which the name parameter is ConstantDescs.DEFAULT_NAME.

Parameters:

bootstrapMethod - a DirectMethodHandleDescImpl describing the bootstrap method for the invokedynamic

invocationType - a MethodTypeDesc describing the invocation type that would appear in the NameAndType operand of the invokedynamic

Returns:

the nominal descriptor

Throws:

NullPointerException - if any parameter is null

IllegalArgumentException - if the invocation name has the incorrect format

withArgs

public DynamicCallSiteDesc withArgs(ConstantDesc... bootstrapArgs)

Return a nominal descriptor for an invokedynamic call site whose bootstrap method, name, and invocation type are the same as this one, but with the specified bootstrap arguments.

Parameters:

bootstrapArgs - ConstantDescs describing the static arguments to the bootstrap, that would appear in the BootstrapMethods attribute

Returns:

the nominal descriptor

Throws:

NullPointerException - if any parameter is null

withNameAndType

public DynamicCallSiteDesc withNameAndType(String invocationName,
                                           MethodTypeDesc invocationType)

Return a nominal descriptor for an invokedynamic call site whose bootstrap and bootstrap arguments are the same as this one, but with the specified invocationName and invocation invocationType

Parameters:

invocationName - The unqualified name that would appear in the NameAndType operand of the invokedynamic

invocationType - a MethodTypeDesc describing the invocation type that would appear in the NameAndType operand of the invokedynamic

Returns:

the nominal descriptor

Throws:

NullPointerException - if any parameter is null

IllegalArgumentException - if the invocation name has the incorrect format

invocationName

public String invocationName()

Returns the invocation name that would appear in the NameAndType operand of the invokedynamic.

Returns:

the invocation name

invocationType

public MethodTypeDesc invocationType()

Returns a MethodTypeDesc describing the invocation type that would appear in the NameAndType operand of the invokedynamic.

Returns:

the invocation type

bootstrapMethod

public MethodHandleDesc bootstrapMethod()

Returns a MethodHandleDesc descripbing the bootstrap method for the invokedynamic.

Returns:

the bootstrap method for the invokedynamic

bootstrapArgs

public ConstantDesc[] bootstrapArgs()

Returns ConstantDescs describing the bootstrap arguments for the invokedynamic.

Returns:

the bootstrap arguments for the invokedynamic

resolveCallSiteDesc

public CallSite resolveCallSiteDesc(MethodHandles.Lookup lookup)
                             throws Throwable

Reflectively invokes the bootstrap method with the specified arguments, and return the resulting CallSite

Parameters:

lookup - The MethodHandles.Lookup used to resolve class names

Returns:

the CallSite

Throws:

Throwable - if any exception is thrown by the bootstrap method

equals

public boolean equals(Object o)

Compares the specified object with this descriptor for equality. Returns true if and only if the specified object is also a DynamicCallSiteDesc, and both descriptors have equal bootstrap methods, bootstrap argument lists, invocation name, and invocation type.

Overrides:

equals in class Object

Parameters:

o - the DynamicCallSiteDesc to compare to this DynamicCallSiteDesc

Returns:

true if the specified DynamicCallSiteDesc is equals to this DynamicCallSiteDesc.

See Also:

Object.hashCode(), HashMap

hashCode

public int hashCode()

Description copied from class: Object

Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by HashMap.

The general contract of hashCode is:

• Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
• If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
• It is not required that if two objects are unequal according to the Object.equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (The hashCode may or may not be implemented as some function of an object's memory address at some point in time.)

Overrides:

hashCode in class Object

Returns:

a hash code value for this object.

See Also:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

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 Object

Returns:

a string representation of the object.