org.jadira.reflection.equals

Class EqualsBuilder

java.lang.Object

org.jadira.reflection.equals.EqualsBuilder

public class EqualsBuilder
extends Object

This class is based on the capabilities provided by Commons-Lang's EqualsBuilder. 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. EqualsBuilder 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 equals(), the default behaviour is to rely on Object.equals(Object) which compares 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
EqualsBuilder()

Method Summary

Modifier and Type	Method and Description
EqualsBuilder	append(boolean[] lhs, boolean[] rhs)
EqualsBuilder	append(boolean lhs, boolean rhs)
EqualsBuilder	append(byte[] lhs, byte[] rhs)
EqualsBuilder	append(byte lhs, byte rhs)
EqualsBuilder	append(char[] lhs, char[] rhs)
EqualsBuilder	append(char lhs, char rhs)
EqualsBuilder	append(double[] lhs, double[] rhs)
EqualsBuilder	append(double lhs, double rhs)
EqualsBuilder	append(float[] lhs, float[] rhs)
EqualsBuilder	append(float lhs, float rhs)
EqualsBuilder	append(int[] lhs, int[] rhs)
EqualsBuilder	append(int lhs, int rhs)
EqualsBuilder	append(long[] lhs, long[] rhs)
EqualsBuilder	append(long lhs, long rhs)
EqualsBuilder	append(Object[] lhs, Object[] rhs)
EqualsBuilder	append(Object lhs, Object rhs)
EqualsBuilder	append(short[] lhs, short[] rhs)
EqualsBuilder	append(short lhs, short rhs)
boolean	isEquals()
static boolean	reflectionEquals(Object lhs, Object rhs)
void	reset()
EqualsBuilder	withClassAccessFactory(ClassAccessFactory classAccessFactory)
EqualsBuilder	withDefaultDeepReflect(boolean newDefaultDeepReflect)

Methods inherited from class java.lang.Object

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

Constructor Detail

EqualsBuilder

public EqualsBuilder()

Method Detail

withDefaultDeepReflect

public EqualsBuilder withDefaultDeepReflect(boolean newDefaultDeepReflect)

withClassAccessFactory

public EqualsBuilder withClassAccessFactory(ClassAccessFactory classAccessFactory)

reflectionEquals

public static boolean reflectionEquals(Object lhs,
                                       Object rhs)

append

public EqualsBuilder append(Object lhs,
                            Object rhs)

append

public EqualsBuilder append(long lhs,
                            long rhs)

append

public EqualsBuilder append(int lhs,
                            int rhs)

append

public EqualsBuilder append(short lhs,
                            short rhs)

append

public EqualsBuilder append(char lhs,
                            char rhs)

append

public EqualsBuilder append(byte lhs,
                            byte rhs)

append

public EqualsBuilder append(double lhs,
                            double rhs)

append

public EqualsBuilder append(float lhs,
                            float rhs)

append

public EqualsBuilder append(boolean lhs,
                            boolean rhs)

append

public EqualsBuilder append(Object[] lhs,
                            Object[] rhs)

append

public EqualsBuilder append(long[] lhs,
                            long[] rhs)

append

public EqualsBuilder append(int[] lhs,
                            int[] rhs)

append

public EqualsBuilder append(short[] lhs,
                            short[] rhs)

append

public EqualsBuilder append(char[] lhs,
                            char[] rhs)

append

public EqualsBuilder append(byte[] lhs,
                            byte[] rhs)

append

public EqualsBuilder append(double[] lhs,
                            double[] rhs)

append

public EqualsBuilder append(float[] lhs,
                            float[] rhs)

append

public EqualsBuilder append(boolean[] lhs,
                            boolean[] rhs)

isEquals

public boolean isEquals()

reset

public void reset()