de.cismet.tools

Class Equals

java.lang.Object

de.cismet.tools.Equals

public final class Equals
extends Object

Equals helper operations.

Version:

$Revision$, $Date$

Author:

martin.scholl@cismet.de

Method Summary

Modifier and Type	Method and Description
static boolean	allNull(Object... obs) Tests if all given objects are null.
static boolean	beanDeepEqual(Object o, Object o2) Compares the bean properties of given objects.
static boolean	beanDeepEqual(Object o, Object o2, String... ignoreOps) Tests if the given objects 'o' and 'o2' are of the same type and if all bean getters of 'o' return the same values as the bean getters of 'o2'.
static boolean	isBeanGetter(Method m) Tests if a Method is a bean getter operation.
static boolean	nonNull(Object... obs) Test if non of the given objects is null.
static boolean	nullEqual(Object o1, Object o2) Tests if both objects are equals whereas they are considered equal if they are both null, too.
static boolean	xor(Object o1, Object o2) Tests if one of the objects is null and the other is not null.

Methods inherited from class java.lang.Object

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

Method Detail

beanDeepEqual

public static boolean beanDeepEqual(Object o,
                                    Object o2)

Compares the bean properties of given objects. This operation is equivalent to calling beanDeepEqual(java.lang.Object, java.lang.Object, java.lang.String[]) with a null String[].

Parameters:

o - object one

o2 - object two

Returns:

true, if object one and object two deliver the same result for every bean getter

See Also:

beanDeepEqual(java.lang.Object, java.lang.Object, java.lang.String[])

beanDeepEqual

public static boolean beanDeepEqual(Object o,
                                    Object o2,
                                    String... ignoreOps)

Tests if the given objects 'o' and 'o2' are of the same type and if all bean getters of 'o' return the same values as the bean getters of 'o2'. If both objects are null they're also considered equal nullEqual(java.lang.Object, java.lang.Object). This is also true for all the bean getter return values that are checked. There is also the possibility to provide an ignore list that can contain names of getter operations that shall be ignored when checking for equality.

Parameters:

o - object one

o2 - object two

ignoreOps - all operation names, that shall be ignored during the equality check, may be null

Returns:

true, if 'o' and 'o2' deliver the same result for every bean getter

See Also:

nullEqual(java.lang.Object, java.lang.Object), isBeanGetter(java.lang.reflect.Method)

isBeanGetter

public static boolean isBeanGetter(Method m)

Tests if a Method is a bean getter operation. A bean getter operation has different properties:

• public
• parameter count is 0
• is not native
• is not static
• name starts with 'get' (or 'is' for boolean getters)
• there exists a field with a corresponding name

Parameters:

m - given method

Returns:

true if all the requirements listed above are met, false otherwise

nullEqual

public static boolean nullEqual(Object o1,
                                Object o2)

Tests if both objects are equals whereas they are considered equal if they are both null, too.

Parameters:

o1 - object one

o2 - object two

Returns:

true if o1 == null and o2 == null or if o1.equals(o2), false otherwise

xor

public static boolean xor(Object o1,
                          Object o2)

Tests if one of the objects is null and the other is not null.

Parameters:

o1 - object one

o2 - object two

Returns:

true if object one is null and object two is not null and vice versa, false if both objects are null or both objects are not null.

allNull

public static boolean allNull(Object... obs)

Tests if all given objects are null. If no objects are provided at all, true is returned, too.

Parameters:

obs - the objects

Returns:

true if all given objects are null, false otherwise

nonNull

public static boolean nonNull(Object... obs)

Test if non of the given objects is null. If no objects are provided at all, false is returned, too.

Parameters:

obs - the objects

Returns:

true if all given objects are non-null, false otherwise