Package com.ibm.wala.ssa

Class SSAInvokeDynamicInstruction

java.lang.Object

com.ibm.wala.ssa.SSAInstruction

com.ibm.wala.ssa.SSAAbstractInvokeInstruction

com.ibm.wala.ssa.SSAInvokeInstruction

com.ibm.wala.ssa.SSAInvokeDynamicInstruction

public class SSAInvokeDynamicInstruction
extends SSAInvokeInstruction

Used for representing the JVML invokedynamic instruction. When generated by the Java compiler for compilation of Java lambdas / method references, the instruction components are:

• the bootstrap method, which refers to LambdaMetafactory.metafactory(java.lang.invoke.MethodHandles.Lookup, String, java.lang.invoke.MethodType, java.lang.invoke.MethodType, java.lang.invoke.MethodHandle, java.lang.invoke.MethodType),
• the call site, which contains the static arguments passed to the bootstrap method (i.e., the method signature for the corresponding functional interface method), and
• the standard invoke instruction parameters, representing the dynamic arguments (captured local variables)

The behavior of WALA for other uses of invokedynamic is currently unspecified (though it aims to not crash for any valid use).

Nested Class Summary

Nested classes/interfaces inherited from class com.ibm.wala.ssa.SSAInstruction

SSAInstruction.IVisitor, SSAInstruction.Visitor

Field Summary

Fields inherited from class com.ibm.wala.ssa.SSAInvokeInstruction

params, result

Fields inherited from class com.ibm.wala.ssa.SSAAbstractInvokeInstruction

exception, site

Fields inherited from class com.ibm.wala.ssa.SSAInstruction

NO_INDEX

Constructor Summary

Constructors

Constructor	Description
SSAInvokeDynamicInstruction(int iindex, int[] params, int exception, CallSiteReference site, BootstrapMethodsReader.BootstrapMethod bootstrap)
SSAInvokeDynamicInstruction(int iindex, int result, int[] params, int exception, CallSiteReference site, BootstrapMethodsReader.BootstrapMethod bootstrap)

Method Summary

Modifier and Type	Method	Description
SSAInstruction	copyForSSA(SSAInstructionFactory insts, int[] defs, int[] uses)	This method is meant to be used during SSA conversion for an IR that is not in SSA form.
BootstrapMethodsReader.BootstrapMethod	getBootstrap()
String	toString(SymbolTable symbolTable)	Mark the instruction as an invokedynamic.

Methods inherited from class com.ibm.wala.ssa.SSAInvokeInstruction

assertParamsKosher, getNumberOfPositionalParameters, getNumberOfReturnValues, getNumberOfUses, getReturnValue, getUse, hashCode, visit

Methods inherited from class com.ibm.wala.ssa.SSAAbstractInvokeInstruction

getCallSite, getDeclaredResultType, getDeclaredTarget, getDef, getDef, getException, getInvocationCode, getNumberOfDefs, getProgramCounter, getReceiver, hasDef, isDispatch, isFallThrough, isPEI, isSpecial, isStatic

Methods inherited from class com.ibm.wala.ssa.SSAInstruction

equals, getExceptionTypes, getValueString, iIndex, setInstructionIndex, toString

Methods inherited from class java.lang.Object

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

Constructor Details

SSAInvokeDynamicInstruction

public SSAInvokeDynamicInstruction(int iindex,
 int result,
 int[] params,
 int exception,
 CallSiteReference site,
 BootstrapMethodsReader.BootstrapMethod bootstrap)

SSAInvokeDynamicInstruction

public SSAInvokeDynamicInstruction(int iindex,
 int[] params,
 int exception,
 CallSiteReference site,
 BootstrapMethodsReader.BootstrapMethod bootstrap)

Method Details

copyForSSA

public SSAInstruction copyForSSA(SSAInstructionFactory insts,
 int[] defs,
 int[] uses)

Description copied from class: SSAInstruction

This method is meant to be used during SSA conversion for an IR that is not in SSA form. It creates a new SSAInstruction of the same type as the receiver, with a combination of the receiver's uses and defs and those from the method parameters.

In particular, if the 'defs' parameter is null, then the new instruction has the same defs as the receiver. If 'defs' is not null, it must be an array with a size equal to the number of defs that the receiver instruction has. In this case, the new instruction has defs taken from the array. The uses of the new instruction work in the same way with the 'uses' parameter.

Note that this only applies to CAst-based IR translation, since Java bytecode-based IR generation uses a different SSA construction mechanism.

TODO: move this into the SSAInstructionFactory

Overrides:

copyForSSA in class SSAInvokeInstruction

getBootstrap

public BootstrapMethodsReader.BootstrapMethod getBootstrap()

toString

public String toString(SymbolTable symbolTable)

Mark the instruction as an invokedynamic. The String will also contain the invocation type of the boostrap method

Overrides:

toString in class SSAAbstractInvokeInstruction

Parameters:

symbolTable - the symbol table

Returns:

result of SSAAbstractInvokeInstruction.toString(SymbolTable) with "[invokedynamic] " pre-pended