org.evosuite.testcase.statements

Class AbstractStatement

java.lang.Object

org.evosuite.testcase.statements.AbstractStatement

All Implemented Interfaces:

Serializable, Statement

Direct Known Subclasses:

ArrayStatement, AssignmentStatement, EntityWithParametersStatement, FieldStatement, PrimitiveExpression, PrimitiveStatement

public abstract class AbstractStatement
extends Object
implements Statement, Serializable

Abstract superclass of test case statements

Author:

Gordon Fraser

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	AbstractStatement.Executer An interface to enable the concrete statements to use the executer/1 method.

Field Summary

Fields

Modifier and Type	Field and Description
protected Set<Assertion>	assertions
protected String	comment
protected static org.slf4j.Logger	logger Constant logger
protected VariableReference	retval The return value of this statement.
protected TestCase	tc Reference of the test case this statement belongs to.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractStatement(TestCase tc, Type type) Constructor for AbstractStatement.
protected	AbstractStatement(TestCase tc, VariableReference retval) Constructor for AbstractStatement.

Method Summary

Modifier and Type	Method and Description
void	addAssertion(Assertion assertion) Add a new assertion to statement
void	addComment(String comment) A statement can have a textual comment that will be included in the JUnit output
void	changeClassLoader(ClassLoader loader) Class instances are bound to a class loader - if we want to reexecute a test on a different classloader we need to be able to change the class of the reflection object
Statement	clone() Create deep copy of statement
Statement	clone(TestCase newTestCase) clone
Set<Assertion>	copyAssertions(TestCase newTestCase, int offset) copyAssertions
protected Throwable	exceptionHandler(AbstractStatement.Executer code) This method abstracts the exception handling away from the concrete statements.
String	getAssertionCode() Get Java code representation of assertions
protected Set<VariableReference>	getAssertionReferences() getAssertionReferences
Set<Assertion>	getAssertions() Return list of assertions
String	getCode() Create a string representing the statement as Java code
String	getCode(Throwable exception) Create a string representing the statement as Java code
String	getComment() Retrieve comment for this statement
Set<Class<?>>	getDeclaredExceptions() getDeclaredExceptions
static Class<?>	getExceptionClass(Throwable t) getExceptionClass
int	getNumParameters() Retrieve the number of parameters of this statement
int	getPosition() getPosition
Class<?>	getReturnClass() getReturnClass
Type	getReturnType() getReturnType
VariableReference	getReturnValue() getReturnValue
TestCase	getTestCase() Retrieve the test case this statement is part of
boolean	hasAssertions() Check if there are assertions
boolean	isAccessible() Determine if the underlying reflection object is currently accessible
boolean	isDeclaredException(Throwable t) Tests if the throwable defined by t is declared to be thrown by the underlying type.
boolean	isReflectionStatement()
boolean	isValid() Various consistency checks.
boolean	mutate(TestCase test, TestFactory factory) mutate
void	negate() negate
boolean	references(VariableReference var) Check if the statement makes use of var
void	removeAssertion(Assertion assertion) Delete assertion attached to this statement
void	removeAssertions() Delete all assertions attached to this statement
void	setAssertions(Set<Assertion> assertions) Sets the set of assertions to statement
void	setRetval(VariableReference newRetVal) setRetval

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.evosuite.testcase.statements.Statement

copy, equals, execute, getAccessibleObject, getUniqueVariableReferences, getVariableReferences, hashCode, isAssignmentStatement, replace, same

Field Detail

logger

protected static final org.slf4j.Logger logger

Constant logger

retval

protected VariableReference retval

The return value of this statement. Should never be null.

tc

protected final TestCase tc

Reference of the test case this statement belongs to. Should never be null.

assertions

protected Set<Assertion> assertions

comment

protected String comment

Constructor Detail

AbstractStatement

protected AbstractStatement(TestCase tc,
                            VariableReference retval)
                     throws IllegalArgumentException

Constructor for AbstractStatement.

Parameters:

tc - a TestCase object.

retval - a VariableReference object.

Throws:

IllegalArgumentException

AbstractStatement

protected AbstractStatement(TestCase tc,
                            Type type)
                     throws IllegalArgumentException

Constructor for AbstractStatement.

Parameters:

tc - a TestCase object.

type - a Type object.

Throws:

IllegalArgumentException

Method Detail

exceptionHandler

protected Throwable exceptionHandler(AbstractStatement.Executer code)
                              throws InvocationTargetException,
                                     IllegalArgumentException,
                                     IllegalAccessException,
                                     InstantiationException

This method abstracts the exception handling away from the concrete statements. Thereby hopefully enabling us to have a more consistent approach to exceptions.

Parameters:

code - a AbstractStatement.Executer object.

Returns:

a Throwable object.

Throws:

InvocationTargetException - if any.

IllegalArgumentException - if any.

IllegalAccessException - if any.

InstantiationException - if any.

references

public boolean references(VariableReference var)

Check if the statement makes use of var

Specified by:

references in interface Statement

Parameters:

var - Variable we are checking for

Returns:

True if var is referenced

getAssertionReferences

protected Set<VariableReference> getAssertionReferences()

getAssertionReferences

Returns:

a Set object.

setRetval

public void setRetval(VariableReference newRetVal)
               throws IllegalArgumentException

setRetval

Specified by:

setRetval in interface Statement

Parameters:

newRetVal - a VariableReference object.

Throws:

IllegalArgumentException

getCode

public String getCode()

Create a string representing the statement as Java code

Specified by:

getCode in interface Statement

Returns:

a String object.

getCode

public String getCode(Throwable exception)

Create a string representing the statement as Java code

Specified by:

getCode in interface Statement

Parameters:

exception - a Throwable object.

Returns:

a String object.

addComment

public void addComment(String comment)

Description copied from interface: Statement

A statement can have a textual comment that will be included in the JUnit output

Specified by:

addComment in interface Statement

getComment

public String getComment()

Description copied from interface: Statement

Retrieve comment for this statement

Specified by:

getComment in interface Statement

Returns:

clone

public final Statement clone()

Create deep copy of statement

Specified by:

clone in interface Statement

Overrides:

clone in class Object

Returns:

a Statement object.

getReturnType

public Type getReturnType()

getReturnType

Specified by:

getReturnType in interface Statement

Returns:

Generic type of return value

getReturnClass

public Class<?> getReturnClass()

getReturnClass

Specified by:

getReturnClass in interface Statement

Returns:

Raw class of return value

getReturnValue

public VariableReference getReturnValue()

getReturnValue

Specified by:

getReturnValue in interface Statement

Returns:

Variable representing return value

getNumParameters

public int getNumParameters()

Description copied from interface: Statement

Retrieve the number of parameters of this statement

Specified by:

getNumParameters in interface Statement

Returns:

getTestCase

public TestCase getTestCase()

Description copied from interface: Statement

Retrieve the test case this statement is part of

Specified by:

getTestCase in interface Statement

Returns:

copyAssertions

public Set<Assertion> copyAssertions(TestCase newTestCase,
                                     int offset)

copyAssertions

Create copies of all attached assertions

Specified by:

copyAssertions in interface Statement

Parameters:

newTestCase - the testcase in which this statement will be inserted

offset - a int.

Returns:

a Set object.

hasAssertions

public boolean hasAssertions()

Check if there are assertions

Specified by:

hasAssertions in interface Statement

Returns:

True if there are assertions

addAssertion

public void addAssertion(Assertion assertion)

Add a new assertion to statement

Specified by:

addAssertion in interface Statement

Parameters:

assertion - Assertion to be added

setAssertions

public void setAssertions(Set<Assertion> assertions)

Sets the set of assertions to statement

Specified by:

setAssertions in interface Statement

Parameters:

assertions - a Set object.

getAssertionCode

public String getAssertionCode()

Get Java code representation of assertions

Specified by:

getAssertionCode in interface Statement

Returns:

String representing all assertions attached to this statement

removeAssertions

public void removeAssertions()

Delete all assertions attached to this statement

Specified by:

removeAssertions in interface Statement

removeAssertion

public void removeAssertion(Assertion assertion)

Delete assertion attached to this statement

Specified by:

removeAssertion in interface Statement

Parameters:

assertion - a Assertion object.

getAssertions

public Set<Assertion> getAssertions()

Return list of assertions

Specified by:

getAssertions in interface Statement

Returns:

a Set object.

getDeclaredExceptions

public Set<Class<?>> getDeclaredExceptions()

getDeclaredExceptions

Specified by:

getDeclaredExceptions in interface Statement

Returns:

a Set object.

getExceptionClass

public static Class<?> getExceptionClass(Throwable t)

getExceptionClass

Parameters:

t - a Throwable object.

Returns:

a Class object.

getPosition

public int getPosition()

getPosition

Specified by:

getPosition in interface Statement

Returns:

a int.

isAccessible

public boolean isAccessible()

Description copied from interface: Statement

Determine if the underlying reflection object is currently accessible

Specified by:

isAccessible in interface Statement

Returns:

isValid

public boolean isValid()

Various consistency checks. This method might also return with an assertionError Functionality might depend on the status of enableAssertions in this JVM

Specified by:

isValid in interface Statement

Returns:

a boolean.

isDeclaredException

public boolean isDeclaredException(Throwable t)

Tests if the throwable defined by t is declared to be thrown by the underlying type. Obviously this can only return true for methods and constructors.

Specified by:

isDeclaredException in interface Statement

Parameters:

t - a Throwable object.

Returns:

a boolean.

mutate

public boolean mutate(TestCase test,
                      TestFactory factory)

mutate

Specified by:

mutate in interface Statement

Parameters:

test - a TestCase object.

factory - a TestFactory object.

Returns:

a boolean.

clone

public Statement clone(TestCase newTestCase)

clone

Specified by:

clone in interface Statement

Parameters:

newTestCase - the testcase in which this statement will be inserted

Returns:

a Statement object.

changeClassLoader

public void changeClassLoader(ClassLoader loader)

Class instances are bound to a class loader - if we want to reexecute a test on a different classloader we need to be able to change the class of the reflection object

Specified by:

changeClassLoader in interface Statement

Parameters:

loader - a ClassLoader object.

negate

public void negate()

negate

isReflectionStatement

public boolean isReflectionStatement()

Specified by:

isReflectionStatement in interface Statement