de.alpharogroup.test.objects.evaluations

Class EqualsEvaluator

java.lang.Object

de.alpharogroup.test.objects.evaluations.EqualsEvaluator

public class EqualsEvaluator
extends Object

The class EqualsEvaluator provides algorithms for evaluate the equals contract of an given object.

Constructor Summary

Constructors

Constructor and Description
EqualsEvaluator()

Method Summary

Modifier and Type	Method and Description
static <T> boolean	evaluateConsistency(T object, T anotherObject) Evaluate consistency of the given objects, that means according to Object.equals(Object) that this method should evaluate the following contract condition: It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
static <T> boolean	evaluateConsistency(T object, T anotherObject, int iterations) Evaluate consistency of the given objects, that means according to Object.equals(Object) that this method should evaluate the following contract condition: It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
static boolean	evaluateNonNull(Object object) Evaluate non-null condition is given of the given object, that means according to Object.equals(Object) that this method should evaluate the following contract condition: For any non-null reference value x, x.equals(null) should return false.
static boolean	evaluateReflexivity(Object object) Evaluate reflexivity of the given object, that means according to Object.equals(Object) that this method should evaluate the following contract condition: It is reflexive: for any non-null reference value x, x.equals(x) should return true.
static boolean	evaluateSymmetric(Object object, Object anotherObject) Evaluate symmetric of the given objects, that means according to Object.equals(Object) that this method should evaluate the following contract condition: It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
static boolean	evaluateTransitivity(Object a, Object b, Object c) Evaluate transitivity of the given objects, that means according to Object.equals(Object) that this method should evaluate the following contract condition: It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.

Methods inherited from class java.lang.Object

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

Constructor Detail

EqualsEvaluator

public EqualsEvaluator()

Method Detail

evaluateReflexivity

public static boolean evaluateReflexivity(Object object)

Evaluate reflexivity of the given object, that means according to Object.equals(Object) that this method should evaluate the following contract condition:

• It is reflexive: for any non-null reference value x, x.equals(x) should return true.

Note: The upper list is taken from the javadoc from Object.equals(Object)

Parameters:

object - the object

Returns:

true, if reflexivity contract condition is given otherwise false

evaluateSymmetric

public static boolean evaluateSymmetric(Object object,
                                        Object anotherObject)

Evaluate symmetric of the given objects, that means according to Object.equals(Object) that this method should evaluate the following contract condition:

• It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.

Note: The upper list is taken from the javadoc from Object.equals(Object)

Parameters:

object - the object

anotherObject - the another object

Returns:

true, if symmetric contract condition is given otherwise false

evaluateTransitivity

public static boolean evaluateTransitivity(Object a,
                                           Object b,
                                           Object c)

Evaluate transitivity of the given objects, that means according to Object.equals(Object) that this method should evaluate the following contract condition:

• It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.

Note: The upper list is taken from the javadoc from Object.equals(Object)

Parameters:

a - the object

b - other object

c - another object

Returns:

true, if symmetric contract condition is given otherwise false

evaluateNonNull

public static boolean evaluateNonNull(Object object)

Evaluate non-null condition is given of the given object, that means according to Object.equals(Object) that this method should evaluate the following contract condition:

• For any non-null reference value x, x.equals(null) should return false.

Note: The upper list is taken from the javadoc from Object.equals(Object)

Parameters:

object - the object

Returns:

true, if non-null contract condition is given otherwise false

evaluateConsistency

public static <T> boolean evaluateConsistency(T object,
                                              T anotherObject)

Evaluate consistency of the given objects, that means according to Object.equals(Object) that this method should evaluate the following contract condition:

• It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.

Note: The upper list is taken from the javadoc from Object.equals(Object)

This method calls the same name method with default iterations of 7

Type Parameters:

T - the generic type

Parameters:

object - the object

anotherObject - the another object

Returns:

true, if consistency contract condition is given otherwise false

evaluateConsistency

public static <T> boolean evaluateConsistency(T object,
                                              T anotherObject,
                                              int iterations)

Evaluate consistency of the given objects, that means according to Object.equals(Object) that this method should evaluate the following contract condition:

• It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.

Note: The upper list is taken from the javadoc from Object.equals(Object)

Type Parameters:

T - the generic type

Parameters:

object - the object

anotherObject - the another object

iterations - the iterations of call of equals method.

Returns:

true, if consistency contract condition is given otherwise false