|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
ObjectObserverEqValue
public final class ObserverEqValue extends Object implements ObjectContract
A check recording the value that an observer method
returned during execution, e.g. a check recording that
a collection's size() method returned 3
when called in particular sequence.
ObserverEqValue checks are not checks that must hold of all objects
of a given class (unlike a check like EqualsReflexive,
which must hold for any objects, no matter its execution context).
Randoop creates an instance of this contract when, during execution
of a sequence, it determines that the above property holds. The
property thus represents a regression as it captures the
behavior of the code when it is executed.
| Modifier and Type | Field and Description |
|---|---|
Method |
observer
The observer method. |
Object |
value
The runtime value of the observer. |
| Constructor and Description |
|---|
ObserverEqValue(Method observer,
Object value)
|
| 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. |
static ObserverEqValue |
getObserverEqValue(Method method,
Object val)
Create an ObserverEqValue from its basic parts (used when reading from a serialized file). |
int |
hashCode()
|
String |
toCodeString()
A string that can be used as Java source code and will result in the expression being evaluated. |
String |
toCodeStringPreStatement()
|
String |
toCommentString()
A string that will be inserted as a comment in the test before the code corresponding to this contract. |
String |
toString()
|
| Methods inherited from class Object |
|---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| Field Detail |
|---|
public Method observer
public Object value
| Constructor Detail |
|---|
public ObserverEqValue(Method observer,
Object value)
| Method Detail |
|---|
public boolean equals(Object o)
equals in class Objectpublic int hashCode()
hashCode in class Objectpublic String toCodeStringPreStatement()
public String toCodeString()
ObjectContractThe 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.
toCodeString in interface ObjectContract
public static ObserverEqValue getObserverEqValue(Method method,
Object val)
public boolean evaluate(Object... objects)
throws Throwable
ObjectContract
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.
evaluate in interface ObjectContractThrowablepublic int getArity()
ObjectContract
getArity in interface ObjectContractpublic String toCommentString()
ObjectContract
toCommentString in interface ObjectContractpublic boolean evalExceptionMeansFailure()
ObjectContractevaluate 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.
evalExceptionMeansFailure in interface ObjectContractpublic String get_observer_str()
ObjectContract
get_observer_str in interface ObjectContractpublic String toString()
toString in class Object
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||