Package serp.bytecode
Class MethodInstruction
- java.lang.Object
-
- serp.bytecode.CodeEntry
-
- serp.bytecode.Instruction
-
- serp.bytecode.MethodInstruction
-
- All Implemented Interfaces:
BCEntity
,VisitAcceptor
public class MethodInstruction extends Instruction
An instruction that invokes a method.
-
-
Constructor Summary
Constructors Constructor Description MethodInstruction(Code owner, int opcode)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
acceptVisit(BCVisitor visit)
Accept a visit from aBCVisitor
, calling the appropriate methods to notify the visitor that it has entered this entity, and to provide it with the proper callbacks for each sub-entity owned by this one.boolean
equalsInstruction(Instruction other)
MethodInstructions are equal if the method they reference is the same, or if the method of either is unset.(package private) int
getLength()
Return the length in bytes of this opcode, including all arguments.int
getLogicalStackChange()
Return the logical number of stack positions changed by this instruction.BCMethod
getMethod()
Return the method this instruction operates on, or null if not set.BCClass
getMethodDeclarerBC()
Return the declaring type of the method this instruction operates on, or null if not set.java.lang.String
getMethodDeclarerName()
Return the declaring type of the method this instruction operates on, or null if not set.java.lang.Class
getMethodDeclarerType()
Return the declaring type of the method this instruction operates on, or null if not set.int
getMethodIndex()
Return the index in the classConstantPool
of theComplexEntry
describing the method to operate on.java.lang.String
getMethodName()
Return the name of the method this instruction operates on, or null if not set.BCClass[]
getMethodParamBCs()
Return the param types of the method this instruction operates on, or empty array if none.java.lang.String[]
getMethodParamNames()
Return the param types of the method this instruction operates on, or empty array if none.java.lang.Class[]
getMethodParamTypes()
Return the param types of the method this instruction operates on, or empty array if none.BCClass
getMethodReturnBC()
Return the return type of the method this instruction operates on, or null if not set.java.lang.String
getMethodReturnName()
Return the return type of the method this instruction operates on, or null if not set.java.lang.Class
getMethodReturnType()
Return the return type of the method this instruction operates on, or null if not set.int
getStackChange()
Return the number of stack positions this instruction pushes or pops during its execution.(package private) void
read(java.io.DataInput in)
Read the arguments for this opcode from the given stream.(package private) void
read(Instruction orig)
Copy the given instruction data.MethodInstruction
setMethod(java.lang.Class dec, java.lang.String name, java.lang.Class returnType, java.lang.Class[] params)
Set the method this instruction operates on.MethodInstruction
setMethod(java.lang.reflect.Constructor method)
Set the method this instruction operates on.MethodInstruction
setMethod(java.lang.reflect.Method method)
Set the method this instruction operates on.MethodInstruction
setMethod(java.lang.String name, java.lang.Class returnType, java.lang.Class[] params)
Set the method this instruction operates on, for methods that are declared by the current class.MethodInstruction
setMethod(java.lang.String name, java.lang.String returnType, java.lang.String[] params)
Set the method this instruction operates on, for methods that are declared by the current class.MethodInstruction
setMethod(java.lang.String dec, java.lang.String name, java.lang.String returnType, java.lang.String[] params)
Set the method this instruction operates on.private MethodInstruction
setMethod(java.lang.String dec, java.lang.String name, java.lang.String returnType, java.lang.String[] params, boolean copy)
Set the method this instruction operates on.MethodInstruction
setMethod(java.lang.String name, BCClass returnType, BCClass[] params)
Set the method this instruction operates on, for methods that are declared by the current class.MethodInstruction
setMethod(BCClass dec, java.lang.String name, BCClass returnType, BCClass[] params)
Set the method this instruction operates on.MethodInstruction
setMethod(BCMethod method)
Set the method this instruction operates on.MethodInstruction
setMethodDeclarer(java.lang.Class type)
Set the declaring type of the method this instruction operates on.MethodInstruction
setMethodDeclarer(java.lang.String type)
Set the declaring type of the method this instruction operates on.MethodInstruction
setMethodDeclarer(BCClass type)
Set the declaring type of the method this instruction operates on.MethodInstruction
setMethodIndex(int index)
Set the index in the classConstantPool
of theComplexEntry
describing the method to operate on.MethodInstruction
setMethodName(java.lang.String name)
Set the name of the method this instruction operates on.void
setMethodParams(java.lang.Class[] types)
Set the param types of the method this instruction operates on.MethodInstruction
setMethodParams(java.lang.String[] types)
Set the param types of the method this instruction operates on.void
setMethodParams(BCClass[] types)
Set the param types of the method this instruction operates on.MethodInstruction
setMethodReturn(java.lang.Class type)
Set the return type of the method this instruction operates on.MethodInstruction
setMethodReturn(java.lang.String type)
Set the return type of the method this instruction operates on.MethodInstruction
setMethodReturn(BCClass type)
Set the return type of the method this instruction operates on.(package private) void
write(java.io.DataOutput out)
Write the arguments for this opcode to the given stream.-
Methods inherited from class serp.bytecode.Instruction
getByteIndex, getClassLoader, getCode, getLineNumber, getName, getOpcode, getPool, getProject, invalidate, invalidateByteIndexes, isValid, setOpcode
-
-
-
-
Constructor Detail
-
MethodInstruction
MethodInstruction(Code owner, int opcode)
-
-
Method Detail
-
getLength
int getLength()
Description copied from class:Instruction
Return the length in bytes of this opcode, including all arguments. For many opcodes this method relies on an up-to-date byte index.- Overrides:
getLength
in classInstruction
-
getLogicalStackChange
public int getLogicalStackChange()
Description copied from class:Instruction
Return the logical number of stack positions changed by this instruction. In other words, ignore weirdness with longs and doubles taking two stack positions.- Overrides:
getLogicalStackChange
in classInstruction
-
getStackChange
public int getStackChange()
Description copied from class:Instruction
Return the number of stack positions this instruction pushes or pops during its execution.- Overrides:
getStackChange
in classInstruction
- Returns:
- 0 if the stack is not affected by this instruction, a positive number if it pushes onto the stack, and a negative number if it pops from the stack
-
getMethodIndex
public int getMethodIndex()
Return the index in the classConstantPool
of theComplexEntry
describing the method to operate on.
-
setMethodIndex
public MethodInstruction setMethodIndex(int index)
Set the index in the classConstantPool
of theComplexEntry
describing the method to operate on.- Returns:
- this instruction, for method chaining
-
getMethod
public BCMethod getMethod()
Return the method this instruction operates on, or null if not set.
-
setMethod
public MethodInstruction setMethod(BCMethod method)
Set the method this instruction operates on.- Returns:
- this instruction, for method chaining
-
setMethod
public MethodInstruction setMethod(java.lang.reflect.Method method)
Set the method this instruction operates on.- Returns:
- this instruction, for method chaining
-
setMethod
public MethodInstruction setMethod(java.lang.reflect.Constructor method)
Set the method this instruction operates on.- Returns:
- this instruction, for method chaining
-
setMethod
public MethodInstruction setMethod(java.lang.String dec, java.lang.String name, java.lang.String returnType, java.lang.String[] params)
Set the method this instruction operates on.- Parameters:
dec
- the full class name of the method's declaring classname
- the method namereturnType
- the full class name of the method return typeparam
- the full class names of the method param types- Returns:
- this instruction, for method chaining
-
setMethod
private MethodInstruction setMethod(java.lang.String dec, java.lang.String name, java.lang.String returnType, java.lang.String[] params, boolean copy)
Set the method this instruction operates on.- Parameters:
dec
- the full class name of the method's declaring class, or the bootstrap index for InvokeDynamicname
- the method namereturnType
- the full class name of the method return typeparam
- the full class names of the method param typescopy
- whether to copy the the parameter array- Returns:
- this instruction, for method chaining
-
setMethod
public MethodInstruction setMethod(java.lang.String name, java.lang.String returnType, java.lang.String[] params)
Set the method this instruction operates on, for methods that are declared by the current class.- Parameters:
name
- the method namereturnType
- the full class name of the method return typeparam
- the full class names of the method param types- Returns:
- this instruction, for method chaining
-
setMethod
public MethodInstruction setMethod(java.lang.Class dec, java.lang.String name, java.lang.Class returnType, java.lang.Class[] params)
Set the method this instruction operates on.- Parameters:
dec
- the method's declaring classname
- the method namereturnType
- the class of the method return typeparam
- the class of the method param types- Returns:
- this instruction, for method chaining
-
setMethod
public MethodInstruction setMethod(java.lang.String name, java.lang.Class returnType, java.lang.Class[] params)
Set the method this instruction operates on, for methods that are declared by the current class.- Parameters:
name
- the method namereturnType
- the class of the method return typeparam
- the class of the method param types- Returns:
- this instruction, for method chaining
-
setMethod
public MethodInstruction setMethod(BCClass dec, java.lang.String name, BCClass returnType, BCClass[] params)
Set the method this instruction operates on.- Parameters:
dec
- the method's declaring classname
- the method namereturnType
- the class of the method return typeparam
- the class of the method param types- Returns:
- this instruction, for method chaining
-
setMethod
public MethodInstruction setMethod(java.lang.String name, BCClass returnType, BCClass[] params)
Set the method this instruction operates on, for methods that are declared by the current class.- Parameters:
name
- the method namereturnType
- the class of the method return typeparam
- the class of the method param types- Returns:
- this instruction, for method chaining
-
getMethodName
public java.lang.String getMethodName()
Return the name of the method this instruction operates on, or null if not set.
-
setMethodName
public MethodInstruction setMethodName(java.lang.String name)
Set the name of the method this instruction operates on.- Returns:
- this instruction, for method chaining
-
getMethodReturnName
public java.lang.String getMethodReturnName()
Return the return type of the method this instruction operates on, or null if not set.
-
getMethodReturnType
public java.lang.Class getMethodReturnType()
Return the return type of the method this instruction operates on, or null if not set.
-
getMethodReturnBC
public BCClass getMethodReturnBC()
Return the return type of the method this instruction operates on, or null if not set.
-
setMethodReturn
public MethodInstruction setMethodReturn(java.lang.String type)
Set the return type of the method this instruction operates on.- Returns:
- this instruction, for method chaining
-
setMethodReturn
public MethodInstruction setMethodReturn(java.lang.Class type)
Set the return type of the method this instruction operates on.- Returns:
- this instruction, for method chaining
-
setMethodReturn
public MethodInstruction setMethodReturn(BCClass type)
Set the return type of the method this instruction operates on.- Returns:
- this instruction, for method chaining
-
getMethodParamNames
public java.lang.String[] getMethodParamNames()
Return the param types of the method this instruction operates on, or empty array if none.
-
getMethodParamTypes
public java.lang.Class[] getMethodParamTypes()
Return the param types of the method this instruction operates on, or empty array if none.
-
getMethodParamBCs
public BCClass[] getMethodParamBCs()
Return the param types of the method this instruction operates on, or empty array if none.
-
setMethodParams
public MethodInstruction setMethodParams(java.lang.String[] types)
Set the param types of the method this instruction operates on.- Returns:
- this instruction, for method chaining
-
setMethodParams
public void setMethodParams(java.lang.Class[] types)
Set the param types of the method this instruction operates on.
-
setMethodParams
public void setMethodParams(BCClass[] types)
Set the param types of the method this instruction operates on.
-
getMethodDeclarerName
public java.lang.String getMethodDeclarerName()
Return the declaring type of the method this instruction operates on, or null if not set.
-
getMethodDeclarerType
public java.lang.Class getMethodDeclarerType()
Return the declaring type of the method this instruction operates on, or null if not set.
-
getMethodDeclarerBC
public BCClass getMethodDeclarerBC()
Return the declaring type of the method this instruction operates on, or null if not set.
-
setMethodDeclarer
public MethodInstruction setMethodDeclarer(java.lang.String type)
Set the declaring type of the method this instruction operates on.- Returns:
- this instruction, for method chaining
-
setMethodDeclarer
public MethodInstruction setMethodDeclarer(java.lang.Class type)
Set the declaring type of the method this instruction operates on.- Returns:
- this instruction, for method chaining
-
setMethodDeclarer
public MethodInstruction setMethodDeclarer(BCClass type)
Set the declaring type of the method this instruction operates on.- Returns:
- this instruction, for method chaining
-
equalsInstruction
public boolean equalsInstruction(Instruction other)
MethodInstructions are equal if the method they reference is the same, or if the method of either is unset.- Overrides:
equalsInstruction
in classInstruction
-
acceptVisit
public void acceptVisit(BCVisitor visit)
Description copied from interface:VisitAcceptor
Accept a visit from aBCVisitor
, calling the appropriate methods to notify the visitor that it has entered this entity, and to provide it with the proper callbacks for each sub-entity owned by this one.- Specified by:
acceptVisit
in interfaceVisitAcceptor
- Overrides:
acceptVisit
in classInstruction
-
read
void read(Instruction orig)
Description copied from class:Instruction
Copy the given instruction data.- Overrides:
read
in classInstruction
-
read
void read(java.io.DataInput in) throws java.io.IOException
Description copied from class:Instruction
Read the arguments for this opcode from the given stream. This method should be overridden by opcodes that take arguments.- Overrides:
read
in classInstruction
- Throws:
java.io.IOException
-
write
void write(java.io.DataOutput out) throws java.io.IOException
Description copied from class:Instruction
Write the arguments for this opcode to the given stream. This method should be overridden by opcodes that take arguments.- Overrides:
write
in classInstruction
- Throws:
java.io.IOException
-
-