ASMWrapper (evosuite-client 1.0.5 API)

java.lang.Object
- org.evosuite.graphs.cfg.ASMWrapper

Direct Known Subclasses:

BytecodeInstruction
```
public abstract class ASMWrapper
extends Object
```
Wrapper class for the underlying byteCode instruction library ASM Gives access to a lot of methods that interpret the raw information in AbstractInsnNode to usable chunks of information, inside EvoSuite This class is supposed to hide the ASM library from the rest of EvoSuite as much as possible After initialization, all information about byteCode instructions should be accessible via the BytecodeInstruction-, DefUse- and BranchPool. Each of those has data structures holding all BytecodeInstruction, DefUse and Branch objects respectively created during initialization. BytecodeInstruction directly extends ASMWrapper and is the first way to instantiate an ASMWrapper. Branch and DefUse extend BytecodeInstruction, where DefUse is abstract and Branch is not ("concrete"?) DefUse is further extended by Definition and Use

Author:

Andre Mis

Field Summary

Fields
Modifier and Type Field and Description

protected org.objectweb.asm.tree.AbstractInsnNode asmNode

protected CFGFrame frame

Fields
Modifier and Type	Field and Description
`protected org.objectweb.asm.tree.AbstractInsnNode`	`asmNode`
`protected CFGFrame`	`frame`

Constructor Summary

Constructors
Constructor and Description

ASMWrapper()

Constructors
Constructor and Description
`ASMWrapper()`

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`canReturnFromMethod()` canReturnFromMethod
`protected String`	`getArrayVariableName()`
`org.objectweb.asm.tree.AbstractInsnNode`	`getASMNode()` getASMNode
`String`	`getCalledMethod()` Returns the conjunction of the name and method descriptor of the method called by this instruction
`String`	`getCalledMethodName()` Returns the conjunction of the name of the method called by this instruction
`int`	`getCalledMethodsArgumentCount()` Returns the number of arguments of the method called by this instruction
`String`	`getCalledMethodsClass()` Returns the class of the method called by this instruction
`abstract String`	`getClassName()` getClassName
`abstract String`	`getFieldMethodCallName()`
`protected String`	`getFieldName()` getFieldName
`protected String`	`getFieldSimpleName()` getFieldName
`String`	`getFieldType()` getFieldName
`abstract int`	`getInstructionId()` getInstructionId
`String`	`getInstructionType()` getInstructionType
`int`	`getLineNumber()` getLineNumber
`protected String`	`getLocalVariableName()` getLocalVarName
`int`	`getLocalVariableSlot()` getLocalVar
`String`	`getMethodCallDescriptor()`
`abstract String`	`getMethodName()` getMethodName
`abstract RawControlFlowGraph`	`getRawCFG()`
`abstract BytecodeInstruction`	`getSourceOfArrayReference()`
`String`	`getType()` getType
`String`	`getVariableName()` getDUVariableName
`boolean`	`isActualBranch()` isActualBranch
`boolean`	`isArrayLoadInstruction()`
`boolean`	`isArrayStoreInstruction()`
`boolean`	`isBranch()` isBranch
`boolean`	`isBranchLabel()` isBranchLabel
`boolean`	`isConstant()` isConstant
`boolean`	`isConstructorInvocation()` Checks whether this instruction is an INVOKESPECIAL instruction that calls a constructor.
`boolean`	`isConstructorInvocation(String className)` Checks whether this instruction is an INVOKESPECIAL instruction that calls a constructor of the given class.
`boolean`	`isDefinition()` isDefinition
`boolean`	`isDefinitionForVariable(String var)` isDefinitionForVariable
`boolean`	`isDefUse()` isDefUse
`boolean`	`isFieldArrayDefinition()`
`boolean`	`isFieldDefinition()` isFieldDefinition
`boolean`	`isFieldDU()` isFieldDU
`abstract boolean`	`isFieldMethodCallDefinition()`
`abstract boolean`	`isFieldMethodCallUse()`
`boolean`	`isFieldNodeDefinition()` isFieldDefinition
`boolean`	`isFieldNodeDU()`
`boolean`	`isFieldNodeUse()` isFieldUse
`boolean`	`isFieldUse()` isFieldUse
`boolean`	`isFrame()` isFrame
`boolean`	`isGoto()` isGoto
`boolean`	`isIfNull()` isIfNull
`boolean`	`isIINC()`
`boolean`	`isInvokeSpecial()` isInvokeSpecial
`boolean`	`isInvokeStatic()` isInvokeStatic
`boolean`	`isJump()` isJump
`boolean`	`isLabel()` isLabel
`boolean`	`isLineNumber()` Determines if this instruction is a line number instruction More precisely this method checks if the underlying asmNode is a LineNumberNode
`boolean`	`isLoadConstant()` isLoadConstant
`boolean`	`isLocalArrayDefinition()`
`boolean`	`isLocalDU()` isLocalDU
`boolean`	`isLocalVariableDefinition()` isLocalVarDefinition
`boolean`	`isLocalVariableUse()` isLocalVarUse
`boolean`	`isLookupSwitch()` isLookupSwitch
`boolean`	`isMethodCall()` isMethodCall
`boolean`	`isMethodCallForClass(String className)` Returns true if and only if the class of the method called by this instruction is the same as the given className
`abstract boolean`	`isMethodCallOfField()`
`boolean`	`isReturn()` isReturn
`boolean`	`isStaticArrayUsage()`
`boolean`	`isStaticDefUse()` isStaticDefUse
`boolean`	`isSwitch()` isSwitch
`boolean`	`isTableSwitch()` isTableSwitch
`boolean`	`isThrow()` isThrow
`boolean`	`isUse()` isUse
`boolean`	`loadsReferenceToThis()` Determines whether this is the special ALOAD that pushes 'this' onto the stack In non static methods the variable slot 0 holds the reference to "this".
`boolean`	`sanityCheckAbstractInsnNode(org.objectweb.asm.tree.AbstractInsnNode node)` sanityCheckAbstractInsnNode

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - asmNode
```
protected org.objectweb.asm.tree.AbstractInsnNode asmNode
```
  - frame
```
protected CFGFrame frame
```
- Constructor Detail
  - ASMWrapper
```
public ASMWrapper()
```
- Method Detail
  - getASMNode
```
public org.objectweb.asm.tree.AbstractInsnNode getASMNode()
```
    getASMNode
    
    Returns:
    
    a AbstractInsnNode object.
  - getInstructionType
```
public String getInstructionType()
```
    getInstructionType
    
    Returns:
    
    a String object.
  - getMethodCallDescriptor
```
public String getMethodCallDescriptor()
```
  - getType
```
public String getType()
```
    getType
    
    Returns:
    
    a String object.
  - getInstructionId
```
public abstract int getInstructionId()
```
    getInstructionId
    
    Returns:
    
    a int.
  - getMethodName
```
public abstract String getMethodName()
```
    getMethodName
    
    Returns:
    
    a String object.
  - getClassName
```
public abstract String getClassName()
```
    getClassName
    
    Returns:
    
    a String object.
  - isMethodCallOfField
```
public abstract boolean isMethodCallOfField()
```
  - getFieldMethodCallName
```
public abstract String getFieldMethodCallName()
```
  - isActualBranch
```
public boolean isActualBranch()
```
    isActualBranch
    
    Returns:
    
    a boolean.
  - isSwitch
```
public boolean isSwitch()
```
    isSwitch
    
    Returns:
    
    a boolean.
  - canReturnFromMethod
```
public boolean canReturnFromMethod()
```
    canReturnFromMethod
    
    Returns:
    
    a boolean.
  - isReturn
```
public boolean isReturn()
```
    isReturn
    
    Returns:
    
    a boolean.
  - isThrow
```
public boolean isThrow()
```
    isThrow
    
    Returns:
    
    a boolean.
  - isTableSwitch
```
public boolean isTableSwitch()
```
    isTableSwitch
    
    Returns:
    
    a boolean.
  - isLookupSwitch
```
public boolean isLookupSwitch()
```
    isLookupSwitch
    
    Returns:
    
    a boolean.
  - isBranchLabel
```
public boolean isBranchLabel()
```
    isBranchLabel
    
    Returns:
    
    a boolean.
  - isJump
```
public boolean isJump()
```
    isJump
    
    Returns:
    
    a boolean.
  - isInvokeStatic
```
public boolean isInvokeStatic()
```
    isInvokeStatic
    
    Returns:
    
    a boolean representing whether the instruction is a static method call.
  - isGoto
```
public boolean isGoto()
```
    isGoto
    
    Returns:
    
    a boolean.
  - isBranch
```
public boolean isBranch()
```
    isBranch
    
    Returns:
    
    a boolean.
  - isIfNull
```
public boolean isIfNull()
```
    isIfNull
    
    Returns:
    
    a boolean.
  - isFrame
```
public boolean isFrame()
```
    isFrame
    
    Returns:
    
    a boolean.
  - isMethodCall
```
public boolean isMethodCall()
```
    isMethodCall
    
    Returns:
    
    a boolean.
  - getCalledMethod
```
public String getCalledMethod()
```
    Returns the conjunction of the name and method descriptor of the method called by this instruction
    
    Returns:
    
    a String object.
  - getCalledMethodName
```
public String getCalledMethodName()
```
    Returns the conjunction of the name of the method called by this instruction
    
    Returns:
    
    a String object.
  - isMethodCallForClass
```
public boolean isMethodCallForClass(String className)
```
    Returns true if and only if the class of the method called by this instruction is the same as the given className
    
    Parameters:
    
    className - a String object.
    
    Returns:
    
    a boolean.
  - getCalledMethodsClass
```
public String getCalledMethodsClass()
```
    Returns the class of the method called by this instruction
    
    Returns:
    
    a String object.
  - getCalledMethodsArgumentCount
```
public int getCalledMethodsArgumentCount()
```
    Returns the number of arguments of the method called by this instruction
    
    Returns:
    
    a int.
  - isLoadConstant
```
public boolean isLoadConstant()
```
    isLoadConstant
    
    Returns:
    
    a boolean.
  - isConstant
```
public boolean isConstant()
```
    isConstant
    
    Returns:
    
    a boolean.
  - isDefUse
```
public boolean isDefUse()
```
    isDefUse
    
    Returns:
    
    a boolean.
  - isFieldDU
```
public boolean isFieldDU()
```
    isFieldDU
    
    Returns:
    
    a boolean.
  - isFieldNodeDU
```
public boolean isFieldNodeDU()
```
  - isLocalDU
```
public boolean isLocalDU()
```
    isLocalDU
    
    Returns:
    
    a boolean.
  - isDefinition
```
public boolean isDefinition()
```
    isDefinition
    
    Returns:
    
    a boolean.
  - isUse
```
public boolean isUse()
```
    isUse
    
    Returns:
    
    a boolean.
  - isFieldMethodCallDefinition
```
public abstract boolean isFieldMethodCallDefinition()
```
  - isFieldMethodCallUse
```
public abstract boolean isFieldMethodCallUse()
```
  - isFieldDefinition
```
public boolean isFieldDefinition()
```
    isFieldDefinition
    
    Returns:
    
    a boolean.
  - isFieldNodeDefinition
```
public boolean isFieldNodeDefinition()
```
    isFieldDefinition
    
    Returns:
    
    a boolean.
  - isFieldUse
```
public boolean isFieldUse()
```
    isFieldUse
    
    Returns:
    
    a boolean.
  - isFieldNodeUse
```
public boolean isFieldNodeUse()
```
    isFieldUse
    
    Returns:
    
    a boolean.
  - isStaticDefUse
```
public boolean isStaticDefUse()
```
    isStaticDefUse
    
    Returns:
    
    a boolean.
  - getVariableName
```
public String getVariableName()
```
    getDUVariableName
    
    Returns:
    
    a String object.
  - getFieldSimpleName
```
protected String getFieldSimpleName()
```
    getFieldName
    
    Returns:
    
    a String object.
  - getFieldName
```
protected String getFieldName()
```
    getFieldName
    
    Returns:
    
    a String object.
  - getFieldType
```
public String getFieldType()
```
    getFieldName
    
    Returns:
    
    a String object.
  - getLocalVariableName
```
protected String getLocalVariableName()
```
    getLocalVarName
    
    Returns:
    
    a String object.
  - getLocalVariableSlot
```
public int getLocalVariableSlot()
```
    getLocalVar
    
    Returns:
    
    a int.
  - isLocalVariableDefinition
```
public boolean isLocalVariableDefinition()
```
    isLocalVarDefinition
    
    Returns:
    
    a boolean.
  - isLocalVariableUse
```
public boolean isLocalVariableUse()
```
    isLocalVarUse
    
    Returns:
    
    a boolean.
  - isIINC
```
public boolean isIINC()
```
  - loadsReferenceToThis
```
public boolean loadsReferenceToThis()
```
    Determines whether this is the special ALOAD that pushes 'this' onto the stack In non static methods the variable slot 0 holds the reference to "this". Loading this reference is not seen as a Use for defuse purposes. This method checks if this is the case
    
    Returns:
    
    a boolean.
  - getRawCFG
```
public abstract RawControlFlowGraph getRawCFG()
```
  - isLocalArrayDefinition
```
public boolean isLocalArrayDefinition()
```
  - isFieldArrayDefinition
```
public boolean isFieldArrayDefinition()
```
  - isStaticArrayUsage
```
public boolean isStaticArrayUsage()
```
  - isArrayStoreInstruction
```
public boolean isArrayStoreInstruction()
```
  - isArrayLoadInstruction
```
public boolean isArrayLoadInstruction()
```
  - getArrayVariableName
```
protected String getArrayVariableName()
```
  - getSourceOfArrayReference
```
public abstract BytecodeInstruction getSourceOfArrayReference()
```
  - isDefinitionForVariable
```
public boolean isDefinitionForVariable(String var)
```
    isDefinitionForVariable
    
    Parameters:
    
    var - a String object.
    
    Returns:
    
    a boolean.
  - isInvokeSpecial
```
public boolean isInvokeSpecial()
```
    isInvokeSpecial
    
    Returns:
    
    a boolean.
  - isConstructorInvocation
```
public boolean isConstructorInvocation()
```
    Checks whether this instruction is an INVOKESPECIAL instruction that calls a constructor.
    
    Returns:
    
    a boolean.
  - isConstructorInvocation
```
public boolean isConstructorInvocation(String className)
```
    Checks whether this instruction is an INVOKESPECIAL instruction that calls a constructor of the given class.
    
    Parameters:
    
    className - a String object.
    
    Returns:
    
    a boolean.
  - isLineNumber
```
public boolean isLineNumber()
```
    Determines if this instruction is a line number instruction More precisely this method checks if the underlying asmNode is a LineNumberNode
    
    Returns:
    
    a boolean.
  - getLineNumber
```
public int getLineNumber()
```
    getLineNumber
    
    Returns:
    
    a int.
  - isLabel
```
public boolean isLabel()
```
    isLabel
    
    Returns:
    
    a boolean.
  - sanityCheckAbstractInsnNode
```
public boolean sanityCheckAbstractInsnNode(org.objectweb.asm.tree.AbstractInsnNode node)
```
    sanityCheckAbstractInsnNode
    
    Parameters:
    
    node - a AbstractInsnNode object.

Class ASMWrapper

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

asmNode

frame

Constructor Detail

ASMWrapper

Method Detail

getASMNode

getInstructionType

getMethodCallDescriptor

getType

getInstructionId

getMethodName

getClassName

isMethodCallOfField

getFieldMethodCallName

isActualBranch

isSwitch

canReturnFromMethod

isReturn

isThrow

isTableSwitch

isLookupSwitch

isBranchLabel

isJump

isInvokeStatic

isGoto

isBranch

isIfNull

isFrame

isMethodCall

getCalledMethod

getCalledMethodName

isMethodCallForClass

getCalledMethodsClass

getCalledMethodsArgumentCount

isLoadConstant

isConstant

isDefUse

isFieldDU

isFieldNodeDU

isLocalDU

isDefinition

isUse

isFieldMethodCallDefinition

isFieldMethodCallUse

isFieldDefinition

isFieldNodeDefinition

isFieldUse

isFieldNodeUse

isStaticDefUse

getVariableName

getFieldSimpleName

getFieldName

getFieldType

getLocalVariableName

getLocalVariableSlot

isLocalVariableDefinition

isLocalVariableUse

isIINC

loadsReferenceToThis

getRawCFG

isLocalArrayDefinition

isFieldArrayDefinition

isStaticArrayUsage

isArrayStoreInstruction

isArrayLoadInstruction

getArrayVariableName

getSourceOfArrayReference

isDefinitionForVariable

isInvokeSpecial

isConstructorInvocation

isConstructorInvocation

isLineNumber

getLineNumber

isLabel