Package org.objectweb.asm

Class ConstantDynamic

java.lang.Object
org.objectweb.asm.ConstantDynamic
public final class ConstantDynamic extends Object
A constant whose value is computed at runtime, with a bootstrap method.

  • Field Details

    • name

      private final String name
      The constant name (can be arbitrary).

    • descriptor

      private final String descriptor
      The constant type (must be a field descriptor).

    • bootstrapMethod

      private final Handle bootstrapMethod
      The bootstrap method to use to compute the constant value at runtime.

    • bootstrapMethodArguments

      private final Object[] bootstrapMethodArguments
      The arguments to pass to the bootstrap method, in order to compute the constant value at runtime.

  • Constructor Details

    • ConstantDynamic

      public ConstantDynamic(String name, String descriptor, Handle bootstrapMethod, Object... bootstrapMethodArguments)
      Constructs a new ConstantDynamic.
      Parameters:
      name - the constant name (can be arbitrary).
      descriptor - the constant type (must be a field descriptor).
      bootstrapMethod - the bootstrap method to use to compute the constant value at runtime.
      bootstrapMethodArguments - the arguments to pass to the bootstrap method, in order to compute the constant value at runtime.

  • Method Details

    • getName

      public String getName()
      Returns the name of this constant.
      Returns:
      the name of this constant.

    • getDescriptor

      public String getDescriptor()
      Returns the type of this constant.
      Returns:
      the type of this constant, as a field descriptor.

    • getBootstrapMethod

      public Handle getBootstrapMethod()
      Returns the bootstrap method used to compute the value of this constant.
      Returns:
      the bootstrap method used to compute the value of this constant.

    • getBootstrapMethodArgumentCount

      public int getBootstrapMethodArgumentCount()
      Returns the number of arguments passed to the bootstrap method, in order to compute the value of this constant.
      Returns:
      the number of arguments passed to the bootstrap method, in order to compute the value of this constant.

    • getBootstrapMethodArgument

      public Object getBootstrapMethodArgument(int index)
      Returns an argument passed to the bootstrap method, in order to compute the value of this constant.
      Parameters:
      index - an argument index, between 0 and getBootstrapMethodArgumentCount() (exclusive).
      Returns:
      the argument passed to the bootstrap method, with the given index.

    • getBootstrapMethodArgumentsUnsafe

      Object[] getBootstrapMethodArgumentsUnsafe()
      Returns the arguments to pass to the bootstrap method, in order to compute the value of this constant. WARNING: this array must not be modified, and must not be returned to the user.
      Returns:
      the arguments to pass to the bootstrap method, in order to compute the value of this constant.

    • getSize

      public int getSize()
      Returns the size of this constant.
      Returns:
      the size of this constant, i.e., 2 for long and double, 1 otherwise.

    • equals

      public boolean equals(Object object)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • toString

      private boolean toString(StringBuilder stringBuilder)
      Appends a string representation of this object into the given builder. Stops when the string reaches or exceeds 16384 characters. The nested ConstantDynamic, if any, are viewed as a tree (and represented as such in the resulting string), even if they actually form a DAG.
      Parameters:
      stringBuilder - where to append the string representation.
      Returns:
      whether the full string representation fits in 16384 characters.

    • subtractTreeSize

      int subtractTreeSize(int size)
      Returns the given value minus the total number of ConstantDynamic objects in this constant and its bootstrap method arguments (recursively, and viewing the structure as a tree). Stops as soon as the total number found so far is equal to the given value (and returns 0).
      Parameters:
      size - the maximum number of ConstantDynamic objects to visit (the same object can be visited several times in case a DAG, or if there is a cycle).
      Returns:
      size minus the number of nested ConstantDynamic objects found, clamped to 0.