Class INVOKEDYNAMIC

java.lang.Object

org.apache.bcel.generic.Instruction

org.apache.bcel.generic.CPInstruction

org.apache.bcel.generic.FieldOrMethod

org.apache.bcel.generic.InvokeInstruction

org.apache.bcel.generic.INVOKEDYNAMIC

All Implemented Interfaces:

Cloneable, ExceptionThrower, IndexedInstruction, LoadClass, StackConsumer, StackProducer, TypedInstruction

public class INVOKEDYNAMIC
extends InvokeInstruction

Class for INVOKEDYNAMIC. Not an instance of InvokeInstruction, since that class expects to be able to get the class of the method. Ignores the bootstrap mechanism entirely.

Since:

6.0

See Also:

• The invokedynamic instruction in The Java Virtual Machine Specification

Field Summary

Fields inherited from class CPInstruction

index

Modifier and Type	Field	Description
protected int	index	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter

Fields inherited from class Instruction

length, opcode

Modifier and Type	Field	Description
protected short	length	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter
protected short	opcode	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter

Constructor Summary

Constructors

Constructor	Description
INVOKEDYNAMIC(int index)	Constructs an INVOKEDYNAMIC instruction.

Method Summary

Modifier and Type	Method	Description
void	accept(Visitor v)	Call corresponding visitor method(s).
void	dump(DataOutputStream out)	Dumps instruction as byte code to stream out.
String	getClassName(ConstantPoolGen cpg)	Gets the name of the method used to invoke the generated lambda method.
Class<?>[]	getExceptions()	Gets the exceptions that may be thrown by this instruction.
ReferenceType	getReferenceType(ConstantPoolGen cpg)	Gets the reference type, which is Object for this instruction.
protected void	initFromFile(ByteSequence bytes, boolean wide)	Reads needed data (that is, index) from file.

Methods inherited from class InvokeInstruction

consumeStack, getArgumentTypes, getMethodName, getReturnType, getType, produceStack, toString

Modifier and Type	Method	Description
int	consumeStack(ConstantPoolGen cpg)	Also works for instructions whose stack effect depends on the constant pool entry they reference.
Type[]	getArgumentTypes(ConstantPoolGen cpg)	Gets the argument types of referenced method.
String	getMethodName(ConstantPoolGen cpg)	Gets the name of referenced method.
Type	getReturnType(ConstantPoolGen cpg)	Gets the return type of referenced method.
Type	getType(ConstantPoolGen cpg)	Gets the return type of referenced method.
int	produceStack(ConstantPoolGen cpg)	Also works for instructions whose stack effect depends on the constant pool entry they reference.
String	toString(ConstantPool cp)	Gets the mnemonic for instruction with symbolic references resolved.

Methods inherited from class FieldOrMethod

getClassType, getLoadClassType, getName, getSignature

Modifier and Type	Method	Description
ObjectType	getClassType(ConstantPoolGen cpg)	Deprecated. If the instruction references an array class, the ObjectType returned will be invalid.
ObjectType	getLoadClassType(ConstantPoolGen cpg)	Gets the ObjectType of the method return or field.
String	getName(ConstantPoolGen cpg)	Gets the name of referenced method or field.
String	getSignature(ConstantPoolGen cpg)	Gets the signature of referenced method or field.

Methods inherited from class CPInstruction

getIndex, setIndex, toString

Modifier and Type	Method	Description
final int	getIndex()	Gets the constant pool index referred to by this instruction.
void	setIndex(int index)	Sets the index to constant pool.
String	toString(boolean verbose)	Long output format: <name of opcode> "["<opcode number>"]" "("<length of instruction>")" "<"< constant pool index>">"

Methods inherited from class Instruction

copy, equals, getComparator, getLength, getName, getOpcode, hashCode, isValidByte, isValidShort, readInstruction, setComparator, toString

Modifier and Type	Method	Description
Instruction	copy()	Use with caution, since 'BranchInstruction's have a 'target' reference which is not copied correctly (only basic types are).
boolean	equals(Object that)	Tests for equality, delegated to comparator
static InstructionComparator	getComparator()	Deprecated. (6.0) use the built in comparator, or wrap this class in another object that implements these methods
int	getLength()	Gets the length (in bytes) of instruction.
String	getName()	Gets the name of instruction, that is, opcode name.
short	getOpcode()	Gets this instruction's opcode.
int	hashCode()	Gets the hashCode of this object.
static boolean	isValidByte(int value)	Tests if the value can fit in a byte (signed).
static boolean	isValidShort(int value)	Tests if the value can fit in a short (signed).
static Instruction	readInstruction(ByteSequence bytes)	Reads an instruction from (byte code) input stream and return the appropriate object.
static void	setComparator(InstructionComparator c)	Deprecated. (6.0) use the built in comparator, or wrap this class in another object that implements these methods
String	toString()

Methods inherited from class Object

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

Constructor Details

INVOKEDYNAMIC

public INVOKEDYNAMIC(int index)

Constructs an INVOKEDYNAMIC instruction.

Parameters:

index - index into constant pool.

Method Details

accept

public void accept(Visitor v)

Call corresponding visitor method(s). The order is: Call visitor methods of implemented interfaces first, then call methods according to the class hierarchy in descending order, that is, the most specific visitXXX() call comes last.

Specified by:

accept in class Instruction

Parameters:

v - Visitor object.

dump

public void dump(DataOutputStream out)
          throws IOException

Dumps instruction as byte code to stream out.

Overrides:

dump in class CPInstruction

Parameters:

out - Output stream.

Throws:

IOException - Thrown when an I/O exception of some sort has occurred.

getClassName

public String getClassName(ConstantPoolGen cpg)

Gets the name of the method used to invoke the generated lambda method. Override the parent method because our class name is held elsewhere. Note: Contrary to this method's name it does not return the class name of the invoke target; rather it returns the name of the method that will be used to invoke the Lambda method generated by this invoke dynamic instruction.

Overrides:

getClassName in class InvokeInstruction

Parameters:

cpg - The constant pool generator.

Returns:

name of the referenced class/interface.

getExceptions

public Class<?>[] getExceptions()

Description copied from interface: ExceptionThrower

Gets the exceptions that may be thrown by this instruction.

Returns:

The exceptions that may be thrown by this instruction.

getReferenceType

public ReferenceType getReferenceType(ConstantPoolGen cpg)

Gets the reference type, which is Object for this instruction.

Since InvokeDynamic doesn't refer to a reference type, just return Object, as that is the only type we can say for sure the reference will be.

Overrides:

getReferenceType in class FieldOrMethod

Parameters:

cpg - The ConstantPoolGen used to create the instruction.

Returns:

An ObjectType for Object.

Since:

6.1

initFromFile

protected void initFromFile(ByteSequence bytes,
 boolean wide)
                     throws IOException

Reads needed data (that is, index) from file.

Overrides:

initFromFile in class CPInstruction

Parameters:

bytes - input stream.

wide - wide prefix?.

Throws:

IOException - Thrown if the implementation needs to read data from the file