xdev.util

Class ObjectUtils

java.lang.Object

xdev.util.ObjectUtils

public final class ObjectUtils
extends Object

The ObjectUtils class provides utility methods for Object handling.

Since:

2.0

Author:

XDEV Software

Method Summary

Modifier and Type	Method and Description
static <T extends Cloneable> T	clone(T original) Creates a clone using the clone method of Object / Cloneable.
static boolean	equals(Object o1, Object o2) Compares two objects for equality, where either one or both objects may be null.
static <T> T	notNull(T object) Throws a NullPointerException if object is null.
static <T> T	nullValue(T value, T ifNull) Checks if the provided value is null.

Methods inherited from class java.lang.Object

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

Method Detail

equals

public static boolean equals(Object o1,
                             Object o2)

Compares two objects for equality, where either one or both objects may be null.

 ObjectUtils.equals(null, null)                  = true
 ObjectUtils.equals(null, "")                    = false
 ObjectUtils.equals("", null)                    = false
 ObjectUtils.equals("", "")                      = true
 ObjectUtils.equals(Boolean.TRUE, null)          = false
 ObjectUtils.equals(Boolean.TRUE, "true")        = false
 ObjectUtils.equals(Boolean.TRUE, Boolean.TRUE)  = true
 ObjectUtils.equals(Boolean.TRUE, Boolean.FALSE) = false
 

Parameters:

o1 - the first object, may be null

o2 - the second object, may be null

Returns:

true if the values of both objects are the same

clone

public static <T extends Cloneable> T clone(T original)
                                     throws RuntimeException

Creates a clone using the clone method of Object / Cloneable.

Type Parameters:

T - the type of the object that will be cloned

Parameters:

original - the original object that will be cloned

Returns:

a clone of the original object

Throws:

RuntimeException - if clone process does not succeed

See Also:

Copyable

nullValue

public static <T> T nullValue(T value,
                              T ifNull)
                       throws IllegalArgumentException

Checks if the provided value is null. In this case ifNull is returned. If value is not null value itself is returned.

Type Parameters:

T - type of the return value and all paramters

Parameters:

value - to check for null

ifNull - replacement if value is null

Returns:

ifNull if the provided value is null; otherwise value

Throws:

IllegalArgumentException - if ifNull is null

notNull

public static <T> T notNull(T object)

Throws a NullPointerException if object is null.

Parameters:

object -

Returns:

object

Since:

4.0