de.alpharogroup.evaluate.object.evaluators

Class HashcodeEvaluator

java.lang.Object

de.alpharogroup.evaluate.object.evaluators.HashcodeEvaluator

public final class HashcodeEvaluator
extends Object

The class HashcodeEvaluator provides algorithms for evaluate the hashcode contract of an given object.

Constructor Summary

Constructors

Constructor and Description
HashcodeEvaluator()

Method Summary

Modifier and Type	Method and Description
static <T> boolean	evaluateConsistency(T object) Evaluate consistency of the given object, that means according to Object.hashCode() that this method should evaluate the following contract condition: Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified.
static <T> boolean	evaluateEquality(T object, T anotherObject) Evaluate equality of hash code from the given objects that should be equal(if not an IllegalArgumentException will be thrown), that means according to Object.hashCode() that this method should evaluate the following contract condition: If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
static <T> boolean	evaluateUnequality(T object, T anotherObject) Evaluate unequality of hash code from the given objects that should be unequal(if not an IllegalArgumentException will be thrown), that means according to Object.hashCode() that this method should evaluate the following contract condition: It is not required that if two objects are unequal according to the Object.equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results.

Methods inherited from class java.lang.Object

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

Constructor Detail

HashcodeEvaluator

public HashcodeEvaluator()

Method Detail

evaluateConsistency

public static <T> boolean evaluateConsistency(T object)

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

• Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.

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

Type Parameters:

T - the generic type

Parameters:

object - the object

Returns:

true, if consistency contract condition of Object.hashCode() is given otherwise false

evaluateEquality

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

Evaluate equality of hash code from the given objects that should be equal(if not an IllegalArgumentException will be thrown), that means according to Object.hashCode() that this method should evaluate the following contract condition:

• If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.

Type Parameters:

T - the generic type

Parameters:

object - the object

anotherObject - the another object

Returns:

true, if equality of hash code from the given objects is given otherwise false

evaluateUnequality

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

Evaluate unequality of hash code from the given objects that should be unequal(if not an IllegalArgumentException will be thrown), that means according to Object.hashCode() that this method should evaluate the following contract condition:

• It is not required that if two objects are unequal according to the Object.equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Type Parameters:

T - the generic type

Parameters:

object - the object

anotherObject - the another object

Returns:

true, if unequality of hash code from the given objects is given otherwise false