org.evosuite.testcase.variable

Interface VariableReference

All Superinterfaces:

Comparable<VariableReference>, Serializable

All Known Implementing Classes:

ArrayIndex, ArrayReference, ConstantValue, FieldReference, InputVariable, NullReference, VariableReferenceImpl

public interface VariableReference
extends Comparable<VariableReference>, Serializable

This class represents a variable in a test case TODO: Store generic types in this variable - we know at creation what it is (from method calls)

Author:

Gordon Fraser

Method Summary

Modifier and Type	Method and Description
void	changeClassLoader(ClassLoader loader) changeClassLoader
VariableReference	clone() Create a copy of the current variable
VariableReference	clone(TestCase newTest) Create a copy of the current variable for new test
int	compareTo(VariableReference other)
VariableReference	copy(TestCase newTest, int offset) Create a copy of the current variable for new test
VariableReference	getAdditionalVariableReference() getAdditionalVariableReference
String	getClassName() Return class name
Class<?>	getComponentClass() Return raw class of this variable's component
String	getComponentName() getComponentName
Type	getComponentType() getComponentType
Object	getDefaultValue() getDefaultValue
String	getDefaultValueString() getDefaultValueString
int	getDistance() Distance metric used to select variables for mutation based on how close they are to the SUT
GenericClass	getGenericClass() getGenericClass
String	getName() Return name for source code representation
Object	getObject(Scope scope) Return the actual object represented by this variable for a given scope
String	getOriginalCode() getOriginalCode
String	getSimpleClassName() Return simple class name
int	getStPosition() The position of the statement, defining this VariableReference, in the testcase.
TestCase	getTestCase() getTestCase
Type	getType() Return type of this variable
Class<?>	getVariableClass() Return raw class of this variable
boolean	isAccessible() Return true if we can validly access this variable.
boolean	isArray() Return true if variable is an array
boolean	isArrayIndex() Return true if this is an index into an array variable
boolean	isAssignableFrom(Type other) Return true if other type can be assigned to this variable
boolean	isAssignableFrom(VariableReference other) Return true if other type can be assigned to this variable
boolean	isAssignableTo(Type other) Return true if this variable can by assigned to a variable of other type
boolean	isAssignableTo(VariableReference other) Return true if this variable can by assigned to a variable of other type
boolean	isEnum() Return true if variable is an enumeration
boolean	isFieldReference() Return true if this is a reference to a public field
boolean	isPrimitive() Return true if variable is a primitive type
boolean	isString() Return true if variable is a string
boolean	isVoid() Return true if variable is void
boolean	isWrapperType() Return true if type of variable is a primitive wrapper
void	loadBytecode(org.objectweb.asm.commons.GeneratorAdapter mg, Map<Integer,Integer> locals) loadBytecode
void	replaceAdditionalVariableReference(VariableReference var1, VariableReference var2) replaceAdditionalVariableReference
boolean	same(VariableReference r) same
void	setAdditionalVariableReference(VariableReference var) setAdditionalVariableReference
void	setDistance(int distance) Set the distance metric
void	setObject(Scope scope, Object value) Set the actual object represented by this variable in a given scope
void	setOriginalCode(String code) Set the code fragment that defined this variable reference if imported from an existing test case.
void	setType(Type type) Set type of this variable
void	storeBytecode(org.objectweb.asm.commons.GeneratorAdapter mg, Map<Integer,Integer> locals) storeBytecode
String	toString() Return string representation of the variable

Method Detail

getStPosition

int getStPosition()

The position of the statement, defining this VariableReference, in the testcase.

Returns:

a int.

getDistance

int getDistance()

Distance metric used to select variables for mutation based on how close they are to the SUT

Returns:

a int.

setDistance

void setDistance(int distance)

Set the distance metric

Parameters:

distance - a int.

clone

VariableReference clone()

Create a copy of the current variable

Returns:

a VariableReference object.

clone

VariableReference clone(TestCase newTest)

Create a copy of the current variable for new test

Parameters:

newTest - a TestCase object.

Returns:

a VariableReference object.

copy

VariableReference copy(TestCase newTest,
                       int offset)

Create a copy of the current variable for new test

Parameters:

newTest - a TestCase object.

offset - a int.

Returns:

a VariableReference object.

getSimpleClassName

String getSimpleClassName()

Return simple class name

Returns:

a String object.

getClassName

String getClassName()

Return class name

Returns:

a String object.

getComponentName

String getComponentName()

getComponentName

Returns:

a String object.

getComponentType

Type getComponentType()

getComponentType

Returns:

a Type object.

getGenericClass

GenericClass getGenericClass()

getGenericClass

Returns:

a GenericClass object.

getTestCase

TestCase getTestCase()

getTestCase

Returns:

a TestCase object.

isEnum

boolean isEnum()

Return true if variable is an enumeration

Returns:

a boolean.

isPrimitive

boolean isPrimitive()

Return true if variable is a primitive type

Returns:

a boolean.

isVoid

boolean isVoid()

Return true if variable is void

Returns:

a boolean.

isArray

boolean isArray()

Return true if variable is an array

Returns:

a boolean.

isArrayIndex

boolean isArrayIndex()

Return true if this is an index into an array variable

Returns:

a boolean

isFieldReference

boolean isFieldReference()

Return true if this is a reference to a public field

Returns:

a boolean

isString

boolean isString()

Return true if variable is a string

Returns:

a boolean.

isWrapperType

boolean isWrapperType()

Return true if type of variable is a primitive wrapper

Returns:

a boolean.

isAccessible

boolean isAccessible()

Return true if we can validly access this variable. This might not be the case for a field reference if the owner class is not accessible

Returns:

isAssignableFrom

boolean isAssignableFrom(Type other)

Return true if other type can be assigned to this variable

Parameters:

other - Right hand side of the assignment

Returns:

a boolean.

isAssignableTo

boolean isAssignableTo(Type other)

Return true if this variable can by assigned to a variable of other type

Parameters:

other - Left hand side of the assignment

Returns:

a boolean.

isAssignableFrom

boolean isAssignableFrom(VariableReference other)

Return true if other type can be assigned to this variable

Parameters:

other - Right hand side of the assignment

Returns:

a boolean.

isAssignableTo

boolean isAssignableTo(VariableReference other)

Return true if this variable can by assigned to a variable of other type

Parameters:

other - Left hand side of the assignment

Returns:

a boolean.

getType

Type getType()

Return type of this variable

Returns:

a Type object.

setType

void setType(Type type)

Set type of this variable

Parameters:

type - a Type object.

getVariableClass

Class<?> getVariableClass()

Return raw class of this variable

Returns:

a Class object.

getComponentClass

Class<?> getComponentClass()

Return raw class of this variable's component

Returns:

a Class object.

getObject

Object getObject(Scope scope)
          throws CodeUnderTestException

Return the actual object represented by this variable for a given scope

Parameters:

scope - The scope of the test case execution

Returns:

a Object object.

Throws:

CodeUnderTestException - if code from the class under test throws an exception. (E.g. the static init of a field)

getOriginalCode

String getOriginalCode()

getOriginalCode

Returns:

the code this variable reference stems from or null if it was generated.

setObject

void setObject(Scope scope,
               Object value)
        throws CodeUnderTestException

Set the actual object represented by this variable in a given scope

Parameters:

scope - The scope of the test case execution

value - The value to be assigned

Throws:

CodeUnderTestException - if code from the class under test throws an exception. (E.g. the static init of a field)

setOriginalCode

void setOriginalCode(String code)

Set the code fragment that defined this variable reference if imported from an existing test case.

Parameters:

code - The code fragment that defined this variable reference.

toString

String toString()

Return string representation of the variable

Overrides:

toString in class Object

getName

String getName()

Return name for source code representation

Returns:

a String object.

getAdditionalVariableReference

VariableReference getAdditionalVariableReference()

getAdditionalVariableReference

Returns:

a VariableReference object.

setAdditionalVariableReference

void setAdditionalVariableReference(VariableReference var)

setAdditionalVariableReference

Parameters:

var - a VariableReference object.

replaceAdditionalVariableReference

void replaceAdditionalVariableReference(VariableReference var1,
                                        VariableReference var2)

replaceAdditionalVariableReference

Parameters:

var1 - a VariableReference object.

var2 - a VariableReference object.

loadBytecode

void loadBytecode(org.objectweb.asm.commons.GeneratorAdapter mg,
                  Map<Integer,Integer> locals)

loadBytecode

Parameters:

mg - a GeneratorAdapter object.

locals - a Map object.

storeBytecode

void storeBytecode(org.objectweb.asm.commons.GeneratorAdapter mg,
                   Map<Integer,Integer> locals)

storeBytecode

Parameters:

mg - a GeneratorAdapter object.

locals - a Map object.

changeClassLoader

void changeClassLoader(ClassLoader loader)

changeClassLoader

Parameters:

loader - a ClassLoader object.

getDefaultValue

Object getDefaultValue()

getDefaultValue

Returns:

a Object object.

getDefaultValueString

String getDefaultValueString()

getDefaultValueString

Returns:

a String object.

compareTo

int compareTo(VariableReference other)

Specified by:

compareTo in interface Comparable<VariableReference>

same

boolean same(VariableReference r)

same

Parameters:

r - a VariableReference object.

Returns:

a boolean.