net.sf.oness.common.model.bo
Class CollectionIgnoringEqualsBuilder

java.lang.Object
  org.apache.commons.lang.builder.EqualsBuilder
      net.sf.oness.common.model.bo.CollectionIgnoringEqualsBuilder

public class CollectionIgnoringEqualsBuilder

extends org.apache.commons.lang.builder.EqualsBuilder

Customized EqualsBuilder ignoring Collection fields.

Only append(Object, Object) was modified

Version:

$Revision: 1.1 $

Author:

Carlos Sanchez, Steve Downey , Stephen Colebourne, Gary Gregory, Pete Gieser

See Also:

EqualsBuilder

Constructor Summary

CollectionIgnoringEqualsBuilder()
Constructor for CollectionIgnoringEqualsBuilder.

Method Summary

org.apache.commons.lang.builder.EqualsBuilder	append(boolean[] lhs, boolean[] rhs) Deep comparison of array of boolean.
org.apache.commons.lang.builder.EqualsBuilder	append(boolean lhs, boolean rhs) Test if two booleanss are equal.
org.apache.commons.lang.builder.EqualsBuilder	append(byte[] lhs, byte[] rhs) Deep comparison of array of byte.
org.apache.commons.lang.builder.EqualsBuilder	append(byte lhs, byte rhs) Test if two bytes are equal.
org.apache.commons.lang.builder.EqualsBuilder	append(char[] lhs, char[] rhs) Deep comparison of array of char.
org.apache.commons.lang.builder.EqualsBuilder	append(char lhs, char rhs) Test if two chars are equal.
org.apache.commons.lang.builder.EqualsBuilder	append(double[] lhs, double[] rhs) Deep comparison of array of double.
org.apache.commons.lang.builder.EqualsBuilder	append(double lhs, double rhs) Test if two doubles are equal by testing that the pattern of bits returned by doubleToLong are equal.
org.apache.commons.lang.builder.EqualsBuilder	append(float[] lhs, float[] rhs) Deep comparison of array of float.
org.apache.commons.lang.builder.EqualsBuilder	append(float lhs, float rhs) Test if two floats are equal byt testing that the pattern of bits returned by doubleToLong are equal.
org.apache.commons.lang.builder.EqualsBuilder	append(int[] lhs, int[] rhs) Deep comparison of array of int.
org.apache.commons.lang.builder.EqualsBuilder	append(int lhs, int rhs) Test if two ints are equal.
org.apache.commons.lang.builder.EqualsBuilder	append(long[] lhs, long[] rhs) Deep comparison of array of long.
org.apache.commons.lang.builder.EqualsBuilder	append(long lhs, long rhs) Test if two longs are equal.
org.apache.commons.lang.builder.EqualsBuilder	append(java.lang.Object[] lhs, java.lang.Object[] rhs) Performs a deep comparison of two Object arrays.
org.apache.commons.lang.builder.EqualsBuilder	append(java.lang.Object lhs, java.lang.Object rhs) Test if two Objects are equal using their equals method, ignoring collections.
org.apache.commons.lang.builder.EqualsBuilder	append(short[] lhs, short[] rhs) Deep comparison of array of short.
org.apache.commons.lang.builder.EqualsBuilder	append(short lhs, short rhs) Test if two shorts are equal.
org.apache.commons.lang.builder.EqualsBuilder	appendSuper(boolean superEquals) Adds the result of super.equals() to this builder.
boolean	isEquals() Return true if the fields that have been checked are all equal.
static boolean	reflectionEquals(java.lang.Object lhs, java.lang.Object rhs) This method uses reflection to determine if the two Objects are equal.
static boolean	reflectionEquals(java.lang.Object lhs, java.lang.Object rhs, boolean testTransients) This method uses reflection to determine if the two Objects are equal.
static boolean	reflectionEquals(java.lang.Object lhs, java.lang.Object rhs, boolean testTransients, java.lang.Class reflectUpToClass) This method uses reflection to determine if the two Objects are equal.

Methods inherited from class java.lang.Object

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

Constructor Detail

CollectionIgnoringEqualsBuilder

public CollectionIgnoringEqualsBuilder()

Constructor for CollectionIgnoringEqualsBuilder.

Starts off assuming that equals is true.

See Also:

Object.equals(java.lang.Object)

Method Detail

reflectionEquals

public static boolean reflectionEquals(java.lang.Object lhs,
                                       java.lang.Object rhs)

This method uses reflection to determine if the two Objects are equal.

It uses AccessibleObject.setAccessible to gain access to private fields. This means that it will throw a security exception if run under a security manager, if the permissions are not set up correctly. It is also not as efficient as testing explicitly.

Transient members will be not be tested, as they are likely derived fields, and not part of the value of the Object.

Static fields will not be tested. Superclass fields will be included.

Parameters:

lhs - this object

rhs - the other object

Returns:

true if the two Objects have tested equals.

reflectionEquals

public static boolean reflectionEquals(java.lang.Object lhs,
                                       java.lang.Object rhs,
                                       boolean testTransients)

This method uses reflection to determine if the two Objects are equal.

It uses AccessibleObject.setAccessible to gain access to private fields. This means that it will throw a security exception if run under a security manager, if the permissions are not set up correctly. It is also not as efficient as testing explicitly.

If the TestTransients parameter is set to true, transient members will be tested, otherwise they are ignored, as they are likely derived fields, and not part of the value of the Object.

Static fields will not be tested. Superclass fields will be included.

Parameters:

lhs - this object

rhs - the other object

testTransients - whether to include transient fields

Returns:

true if the two Objects have tested equals.

reflectionEquals

public static boolean reflectionEquals(java.lang.Object lhs,
                                       java.lang.Object rhs,
                                       boolean testTransients,
                                       java.lang.Class reflectUpToClass)

This method uses reflection to determine if the two Objects are equal.

It uses AccessibleObject.setAccessible to gain access to private fields. This means that it will throw a security exception if run under a security manager, if the permissions are not set up correctly. It is also not as efficient as testing explicitly.

If the testTransients parameter is set to true, transient members will be tested, otherwise they are ignored, as they are likely derived fields, and not part of the value of the Object.

Static fields will not be included. Superclass fields will be appended up to and including the specified superclass. A null superclass is treated as java.lang.Object.

Parameters:

lhs - this object

rhs - the other object

testTransients - whether to include transient fields

reflectUpToClass - the superclass to reflect up to (inclusive), may be null

Returns:

true if the two Objects have tested equals.

Since:

2.0

appendSuper

public org.apache.commons.lang.builder.EqualsBuilder appendSuper(boolean superEquals)

Adds the result of super.equals() to this builder.

Parameters:

superEquals - the result of calling super.equals()

Returns:

EqualsBuilder - used to chain calls.

Since:

2.0

append

public org.apache.commons.lang.builder.EqualsBuilder append(java.lang.Object lhs,
                                                            java.lang.Object rhs)

Test if two Objects are equal using their equals method, ignoring collections.

Parameters:

lhs - the left hand object

rhs - the right hand object

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(long lhs,
                                                            long rhs)

Test if two longs are equal.

Parameters:

lhs - the left hand long

rhs - the right hand long

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(int lhs,
                                                            int rhs)

Test if two ints are equal.

Parameters:

lhs - the left hand int

rhs - the right hand int

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(short lhs,
                                                            short rhs)

Test if two shorts are equal.

Parameters:

lhs - the left hand short

rhs - the right hand short

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(char lhs,
                                                            char rhs)

Test if two chars are equal.

Parameters:

lhs - the left hand char

rhs - the right hand char

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(byte lhs,
                                                            byte rhs)

Test if two bytes are equal.

Parameters:

lhs - the left hand byte

rhs - the right hand byte

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(double lhs,
                                                            double rhs)

Test if two doubles are equal by testing that the pattern of bits returned by doubleToLong are equal.

This handles NaNs, Infinties, and -0.0.

It is compatible with the hash code generated by HashCodeBuilder.

Parameters:

lhs - the left hand double

rhs - the right hand double

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(float lhs,
                                                            float rhs)

Test if two floats are equal byt testing that the pattern of bits returned by doubleToLong are equal.

This handles NaNs, Infinties, and -0.0.

It is compatible with the hash code generated by HashCodeBuilder.

Parameters:

lhs - the left hand float

rhs - the right hand float

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(boolean lhs,
                                                            boolean rhs)

Test if two booleanss are equal.

Parameters:

lhs - the left hand boolean

rhs - the right hand boolean

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(java.lang.Object[] lhs,
                                                            java.lang.Object[] rhs)

Performs a deep comparison of two Object arrays.

This also will be called for the top level of multi-dimensional, ragged, and multi-typed arrays.

Parameters:

lhs - the left hand Object[]

rhs - the right hand Object[]

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(long[] lhs,
                                                            long[] rhs)

Deep comparison of array of long. Length and all values are compared.

The method append(long, long) is used.

Parameters:

lhs - the left hand long[]

rhs - the right hand long[]

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(int[] lhs,
                                                            int[] rhs)

Deep comparison of array of int. Length and all values are compared.

The method append(int, int) is used.

Parameters:

lhs - the left hand int[]

rhs - the right hand int[]

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(short[] lhs,
                                                            short[] rhs)

Deep comparison of array of short. Length and all values are compared.

The method append(short, short) is used.

Parameters:

lhs - the left hand short[]

rhs - the right hand short[]

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(char[] lhs,
                                                            char[] rhs)

Deep comparison of array of char. Length and all values are compared.

The method append(char, char) is used.

Parameters:

lhs - the left hand char[]

rhs - the right hand char[]

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(byte[] lhs,
                                                            byte[] rhs)

Deep comparison of array of byte. Length and all values are compared.

The method append(byte, byte) is used.

Parameters:

lhs - the left hand byte[]

rhs - the right hand byte[]

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(double[] lhs,
                                                            double[] rhs)

Deep comparison of array of double. Length and all values are compared.

The method append(double, double) is used.

Parameters:

lhs - the left hand double[]

rhs - the right hand double[]

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(float[] lhs,
                                                            float[] rhs)

Deep comparison of array of float. Length and all values are compared.

The method append(float, float) is used.

Parameters:

lhs - the left hand float[]

rhs - the right hand float[]

Returns:

EqualsBuilder - used to chain calls.

append

public org.apache.commons.lang.builder.EqualsBuilder append(boolean[] lhs,
                                                            boolean[] rhs)

Deep comparison of array of boolean. Length and all values are compared.

The method append(boolean, boolean) is used.

Parameters:

lhs - the left hand boolean[]

rhs - the right hand boolean[]

Returns:

EqualsBuilder - used to chain calls.

isEquals

public boolean isEquals()

Return true if the fields that have been checked are all equal.

Returns:

boolean