org.jadira.reflection.hashcode

Class HashCodeBuilder

java.lang.Object

org.jadira.reflection.hashcode.HashCodeBuilder

public class HashCodeBuilder
extends Object

This class is based on the capabilities provided by Commons-Lang's HashCodeBuilder. It is not a complete "drop-in" replacement, but is near enough in functionality and in terms of its API that it should be quite straightforward to switch from one class to the other. HashCodeBuilder makes use of Jadira's reflection capabilities. This means, like Cloning there is a brief warm-up time entailed in preparing introspection when a class is first processed. If you are already performing cloning on a type you will not be impacted by this as any necessary warm-up will have already taken place. Once the initial warmup has been performed, you will, usually, find enhanced performance compared to standard reflection based approaches. The strategy to be used can be configured. Where objects that are reachable from the object being compared do not override hashCode(), the default behaviour is to rely on Object#hashCode(Object) which uses the object identity for those objects. This is also the behaviour of Commons Lang. You can modify this to reflect into any reachable object that does not override equals by enabling the defaultDeepReflect property. Transient fields are not compared by the current implementation of this class.

Constructor Summary

Constructors

Constructor and Description
HashCodeBuilder()
HashCodeBuilder(int initialNonZeroOddNumber, int multiplierNonZeroOddNumber)

Method Summary

Modifier and Type	Method and Description
HashCodeBuilder	append(boolean value)
HashCodeBuilder	append(boolean[] array)
HashCodeBuilder	append(byte value)
HashCodeBuilder	append(byte[] array)
HashCodeBuilder	append(char value)
HashCodeBuilder	append(char[] array)
HashCodeBuilder	append(double value)
HashCodeBuilder	append(double[] array)
HashCodeBuilder	append(float value)
HashCodeBuilder	append(float[] array)
HashCodeBuilder	append(int value)
HashCodeBuilder	append(int[] array)
HashCodeBuilder	append(long value)
HashCodeBuilder	append(long[] array)
HashCodeBuilder	append(Object object)
HashCodeBuilder	append(Object[] array)
HashCodeBuilder	append(short value)
HashCodeBuilder	append(short[] array)
protected void	appendNull()
HashCodeBuilder	appendSuper(int superHashCode)
int	hashCode()
static <T> int	reflectionHashCode(int initialNonZeroOddNumber, int multiplierNonZeroOddNumber, T object)
static <T> int	reflectionHashCode(T object)
void	reset()
int	toHashCode()
HashCodeBuilder	withClassAccessFactory(ClassAccessFactory classAccessFactory)
HashCodeBuilder	withDefaultDeepReflect(boolean newDefaultDeepReflect)

Methods inherited from class java.lang.Object

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

Constructor Detail

HashCodeBuilder

public HashCodeBuilder()

HashCodeBuilder

public HashCodeBuilder(int initialNonZeroOddNumber,
                       int multiplierNonZeroOddNumber)

Method Detail

reflectionHashCode

public static <T> int reflectionHashCode(T object)

reflectionHashCode

public static <T> int reflectionHashCode(int initialNonZeroOddNumber,
                                         int multiplierNonZeroOddNumber,
                                         T object)

withDefaultDeepReflect

public HashCodeBuilder withDefaultDeepReflect(boolean newDefaultDeepReflect)

withClassAccessFactory

public HashCodeBuilder withClassAccessFactory(ClassAccessFactory classAccessFactory)

append

public HashCodeBuilder append(boolean value)

append

public HashCodeBuilder append(boolean[] array)

append

public HashCodeBuilder append(byte value)

append

public HashCodeBuilder append(byte[] array)

append

public HashCodeBuilder append(char value)

append

public HashCodeBuilder append(char[] array)

append

public HashCodeBuilder append(double value)

append

public HashCodeBuilder append(double[] array)

append

public HashCodeBuilder append(float value)

append

public HashCodeBuilder append(float[] array)

append

public HashCodeBuilder append(int value)

append

public HashCodeBuilder append(int[] array)

append

public HashCodeBuilder append(long value)

append

public HashCodeBuilder append(long[] array)

append

public HashCodeBuilder append(Object object)

append

public HashCodeBuilder append(Object[] array)

append

public HashCodeBuilder append(short value)

append

public HashCodeBuilder append(short[] array)

appendSuper

public HashCodeBuilder appendSuper(int superHashCode)

appendNull

protected void appendNull()

toHashCode

public int toHashCode()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

reset

public void reset()