randoop
Class ToStringReturnsNormally

Object
  extended by ToStringReturnsNormally
All Implemented Interfaces:
Serializable, ObjectContract

public final class ToStringReturnsNormally
extends Object
implements ObjectContract

Checks that calling toString() on an object does not throw an exception.

See Also:
Serialized Form

Constructor Summary
Constructor and Description
ToStringReturnsNormally()
           
 
Method Summary
Modifier and Type Method and Description
 boolean equals(Object o)
           
 boolean evalExceptionMeansFailure()
          Communicates to Randoop how to interpret exceptional behavior from the evaluate method.
 boolean evaluate(Object... objects)
          Evaluates the contract on the given values.
 String get_observer_str()
          Returns a string describing the observer
 int getArity()
          The number of values that this contract is over.
 int hashCode()
           
 String toCodeString()
          A string that can be used as Java source code and will result in the expression being evaluated.
 String toCommentString()
          A string that will be inserted as a comment in the test before the code corresponding to this contract.
 
Methods inherited from class Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ToStringReturnsNormally

public ToStringReturnsNormally()
Method Detail

equals

public boolean equals(Object o)
Overrides:
equals in class Object

hashCode

public int hashCode()
Overrides:
hashCode in class Object

evaluate

public boolean evaluate(Object... objects)
Description copied from interface: ObjectContract
Evaluates the contract on the given values.

When calling this method during execution of a test, Randoop guarantees that objects does not contain any null objects, and that objects.length == getArity().

This method should return true if the contract was satisfied and false if it was violated.

Specified by:
evaluate in interface ObjectContract

getArity

public int getArity()
Description copied from interface: ObjectContract
The number of values that this contract is over.

Specified by:
getArity in interface ObjectContract

toCommentString

public String toCommentString()
Description copied from interface: ObjectContract
A string that will be inserted as a comment in the test before the code corresponding to this contract.

Specified by:
toCommentString in interface ObjectContract

get_observer_str

public String get_observer_str()
Description copied from interface: ObjectContract
Returns a string describing the observer

Specified by:
get_observer_str in interface ObjectContract

evalExceptionMeansFailure

public boolean evalExceptionMeansFailure()
Description copied from interface: ObjectContract
Communicates to Randoop how to interpret exceptional behavior from the evaluate method.

If this method returns true, Randoop will interpret an exception that escapes during evaluation as a failure of the contract.

If the method returns false, Randoop will interpret an exception as passing behavior.

Specified by:
evalExceptionMeansFailure in interface ObjectContract

toCodeString

public String toCodeString()
Description copied from interface: ObjectContract
A string that can be used as Java source code and will result in the expression being evaluated.

The string should be formatted as follows: the N-th object that participates in the contract check should be referred to as "xN" (for N one of 0, ... , 9). For example, if the expression or arity 2 represents a call of the equals method between two objects, the comment should be something like "x0.equals(x1)".

The returned string should not be null.

Specified by:
toCodeString in interface ObjectContract