Statement (evosuite-client 1.0.5 API)

All Known Implementing Classes:

AbstractStatement, ArrayStatement, AssignmentStatement, BooleanPrimitiveStatement, BytePrimitiveStatement, CharPrimitiveStatement, ClassPrimitiveStatement, ConstructorStatement, DoublePrimitiveStatement, EntityWithParametersStatement, EnumPrimitiveStatement, EnvironmentDataStatement, FieldStatement, FileNamePrimitiveStatement, FloatPrimitiveStatement, FunctionalMockStatement, ImmutableStringPrimitiveStatement, IntPrimitiveStatement, LocalAddressPrimitiveStatement, LongPrimitiveStatement, MethodStatement, NamePrimitiveStatement, NullStatement, NumericalPrimitiveStatement, PrimitiveExpression, PrimitiveStatement, PrivateFieldStatement, PrivateMethodStatement, RemoteAddressPrimitiveStatement, ShortPrimitiveStatement, StringPrimitiveStatement, UrlPrimitiveStatement
```
public interface Statement
```
StatementInterface interface.

Author:

Sebastian Steenbuck, Gordon Fraser

Method Summary

All Methods Instance Methods Abstract Methods
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
`Statement`	`copy(TestCase newTestCase, int offset)` copy
`Set<Assertion>`	`copyAssertions(TestCase newTestCase, int offset)` copyAssertions
`boolean`	`equals(Object s)` Equality check
`Throwable`	`execute(Scope scope, PrintStream out)` This method executes the statement under the given scope.
`GenericAccessibleObject<?>`	`getAccessibleObject()` Returns the accessibleObject which is used to generate this kind of statement E.g.
`String`	`getAssertionCode()` Get Java code representation of assertions
`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
`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
`List<VariableReference>`	`getUniqueVariableReferences()` getUniqueVariableReferences
`Set<VariableReference>`	`getVariableReferences()` getVariableReferences
`boolean`	`hasAssertions()` Check if there are assertions
`int`	`hashCode()` Generate hash code
`boolean`	`isAccessible()` Determine if the underlying reflection object is currently accessible
`boolean`	`isAssignmentStatement()` Returns true if this statement should be handled as an AssignmentStatement.
`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
`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`	`replace(VariableReference var1, VariableReference var2)` Replace a VariableReference with another one
`boolean`	`same(Statement s)` Allows the comparing of Statements between TestCases.
`void`	`setAssertions(Set<Assertion> assertions)` Sets the set of assertions to statement
`void`	`setRetval(VariableReference newRetVal)` setRetval

- Method Detail
  - addAssertion
```
void addAssertion(Assertion assertion)
```
    Add a new assertion to statement
    
    Parameters:
    
    assertion - Assertion to be added
  - addComment
```
void addComment(String comment)
```
    A statement can have a textual comment that will be included in the JUnit output
    
    Parameters:
    
    comment -
  - changeClassLoader
```
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
    
    Parameters:
    
    loader - a ClassLoader object.
  - clone
```
Statement clone()
```
    Create deep copy of statement
    
    Returns:
    
    a Statement object.
  - clone
```
Statement clone(TestCase newTestCase)
```
    clone
    
    Parameters:
    
    newTestCase - the testcase in which this statement will be inserted
    
    Returns:
    
    a Statement object.
  - copy
```
Statement copy(TestCase newTestCase,
               int offset)
```
    copy
    
    Parameters:
    
    newTestCase - the testcase in which this statement will be inserted
    
    offset - a int.
    
    Returns:
    
    a Statement object.
  - copyAssertions
```
Set<Assertion> copyAssertions(TestCase newTestCase,
                              int offset)
```
    copyAssertions
    
    Parameters:
    
    newTestCase - the testcase in which this statement will be inserted
    
    offset - a int.
    
    Returns:
    
    a Set object.
  - equals
```
boolean equals(Object s)
```
    Equality check
    
    Overrides:
    
    equals in class Object
  - execute
```
Throwable execute(Scope scope,
                  PrintStream out)
           throws InvocationTargetException,
                  IllegalArgumentException,
                  IllegalAccessException,
                  InstantiationException
```
    This method executes the statement under the given scope. If execution of the statement is aborted abnormally (i.e. an exception is thrown.) The exception is returned. Otherwise the return value is null.
    
    Parameters:
    
    scope - the scope under which the statement is executed
    
    out - a PrintStream object.
    
    Returns:
    
    if an exception was thrown during execution this is the exception
    
    Throws:
    
    InvocationTargetException - if any.
    
    IllegalArgumentException - if any.
    
    IllegalAccessException - if any.
    
    InstantiationException - if any.
  - getAccessibleObject
```
GenericAccessibleObject<?> getAccessibleObject()
```
    Returns the accessibleObject which is used to generate this kind of statement E.g. the Field of a FieldStatement, the Method of a MethodStatement and so on MAY return NULL (for example for NullStatements)
    
    Returns:
    
    a AccessibleObject object.
  - getAssertionCode
```
String getAssertionCode()
```
    Get Java code representation of assertions
    
    Returns:
    
    String representing all assertions attached to this statement
  - getAssertions
```
Set<Assertion> getAssertions()
```
    Return list of assertions
    
    Returns:
    
    a Set object.
  - getCode
```
String getCode()
```
    Create a string representing the statement as Java code
    
    Returns:
    
    a String object.
  - getCode
```
String getCode(Throwable exception)
```
    Create a string representing the statement as Java code
    
    Parameters:
    
    exception - a Throwable object.
    
    Returns:
    
    a String object.
  - getComment
```
String getComment()
```
    Retrieve comment for this statement
    
    Returns:
  - getDeclaredExceptions
```
Set<Class<?>> getDeclaredExceptions()
```
    getDeclaredExceptions
    
    Returns:
    
    a Set object.
  - getNumParameters
```
int getNumParameters()
```
    Retrieve the number of parameters of this statement
    
    Returns:
  - getPosition
```
int getPosition()
```
    getPosition
    
    Returns:
    
    a int.
  - getReturnClass
```
Class<?> getReturnClass()
```
    getReturnClass
    
    Returns:
    
    Raw class of return value
  - getReturnType
```
Type getReturnType()
```
    getReturnType
    
    Returns:
    
    Generic type of return value
  - getReturnValue
```
VariableReference getReturnValue()
```
    getReturnValue
    
    Returns:
    
    Variable representing return value
  - getTestCase
```
TestCase getTestCase()
```
    Retrieve the test case this statement is part of
    
    Returns:
  - getUniqueVariableReferences
```
List<VariableReference> getUniqueVariableReferences()
```
    getUniqueVariableReferences
    
    Returns:
    
    a List object.
  - getVariableReferences
```
Set<VariableReference> getVariableReferences()
```
    getVariableReferences
    
    Returns:
    
    a Set object.
  - hasAssertions
```
boolean hasAssertions()
```
    Check if there are assertions
    
    Returns:
    
    True if there are assertions
  - hashCode
```
int hashCode()
```
    Generate hash code
    
    Overrides:
    
    hashCode in class Object
  - isAccessible
```
boolean isAccessible()
```
    Determine if the underlying reflection object is currently accessible
    
    Returns:
  - isAssignmentStatement
```
boolean isAssignmentStatement()
```
    Returns true if this statement should be handled as an AssignmentStatement. This method was added to allow the wrapping of AssignmentStatements (in which case "a instanceof AssignmentStatement" is no longer working)
    
    Returns:
    
    a boolean.
  - isReflectionStatement
```
boolean isReflectionStatement()
```
  - isDeclaredException
```
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.
    
    Parameters:
    
    t - a Throwable object.
    
    Returns:
    
    a boolean.
  - isValid
```
boolean isValid()
```
    Various consistency checks. This method might also return with an assertionError Functionality might depend on the status of enableAssertions in this JVM
    
    Returns:
    
    a boolean.
  - mutate
```
boolean mutate(TestCase test,
               TestFactory factory)
```
    mutate
    
    Parameters:
    
    test - a TestCase object.
    
    factory - a TestFactory object.
    
    Returns:
    
    a boolean.
  - references
```
boolean references(VariableReference var)
```
    Check if the statement makes use of var
    
    Parameters:
    
    var - Variable we are checking for
    
    Returns:
    
    True if var is referenced
  - removeAssertion
```
void removeAssertion(Assertion assertion)
```
    Delete assertion attached to this statement
    
    Parameters:
    
    assertion - a Assertion object.
  - removeAssertions
```
void removeAssertions()
```
    Delete all assertions attached to this statement
  - replace
```
void replace(VariableReference var1,
             VariableReference var2)
```
    Replace a VariableReference with another one
    
    Parameters:
    
    var1 - The old variable
    
    var2 - The new variable
  - same
```
boolean same(Statement s)
```
    Allows the comparing of Statements between TestCases. I.e. this is a more semantic comparison than the one done by equals. E.g. two Variable are equal if they are at the same position and they reference to objects of the same type.
    
    Parameters:
    
    s - a Statement object.
    
    Returns:
    
    a boolean.
  - setAssertions
```
void setAssertions(Set<Assertion> assertions)
```
    Sets the set of assertions to statement
    
    Parameters:
    
    assertions - a Set object.
  - setRetval
```
void setRetval(VariableReference newRetVal)
```
    setRetval
    
    Parameters:
    
    newRetVal - a VariableReference object.

Interface Statement

Method Summary

Method Detail

addAssertion

addComment

changeClassLoader

clone

clone

copy

copyAssertions

equals

execute

getAccessibleObject

getAssertionCode

getAssertions

getCode

getCode

getComment

getDeclaredExceptions

getNumParameters

getPosition

getReturnClass

getReturnType

getReturnValue

getTestCase

getUniqueVariableReferences

getVariableReferences

hasAssertions

hashCode

isAccessible

isAssignmentStatement

isReflectionStatement

isDeclaredException

isValid

mutate

references

removeAssertion

removeAssertions

replace

same

setAssertions

setRetval