public class ObjectUtils extends Object
Operations on Object.
This class tries to handle null input gracefully.
An exception will generally not be thrown for a null input.
Each method documents its behaviour in more detail.
#ThreadSafe#
| Modifier and Type | Class and Description |
|---|---|
static class |
ObjectUtils.Null
Class used as a null placeholder where
null
has another meaning. |
| Modifier and Type | Field and Description |
|---|---|
static ObjectUtils.Null |
NULL
Singleton used as a
null placeholder where
null has another meaning. |
| Constructor and Description |
|---|
ObjectUtils()
ObjectUtils instances should NOT be constructed in
standard programming. |
| Modifier and Type | Method and Description |
|---|---|
static <T> T |
clone(T obj)
Clone an object.
|
static <T> T |
cloneIfPossible(T obj)
Clone an object if possible.
|
static <T extends Comparable<? super T>> |
compare(T c1,
T c2)
Null safe comparison of Comparables.
|
static <T extends Comparable<? super T>> |
compare(T c1,
T c2,
boolean nullGreater)
Null safe comparison of Comparables.
|
static <T> T |
defaultIfNull(T object,
T defaultValue)
Returns a default value if the object passed is
null. |
static boolean |
equals(Object object1,
Object object2)
Compares two objects for equality, where either one or both
objects may be
null. |
static <T> T |
firstNonNull(T... values)
Returns the first value in the array which is not
null. |
static int |
hashCode(Object obj)
Gets the hash code of an object returning zero when the
object is
null. |
static int |
hashCodeMulti(Object... objects)
Gets the hash code for multiple objects.
|
static String |
identityToString(Object object)
Gets the toString that would be produced by
Object
if a class did not override toString itself. |
static void |
identityToString(StringBuffer buffer,
Object object)
Appends the toString that would be produced by
Object
if a class did not override toString itself. |
static <T extends Comparable<? super T>> |
max(T... values)
Null safe comparison of Comparables.
|
static <T> T |
median(Comparator<T> comparator,
T... items)
Find the "best guess" middle value among comparables.
|
static <T extends Comparable<? super T>> |
median(T... items)
Find the "best guess" middle value among comparables.
|
static <T extends Comparable<? super T>> |
min(T... values)
Null safe comparison of Comparables.
|
static <T> T |
mode(T... items)
Find the most frequently occurring item.
|
static boolean |
notEqual(Object object1,
Object object2)
Compares two objects for inequality, where either one or both
objects may be
null. |
static String |
toString(Object obj)
Gets the
toString of an Object returning
an empty string ("") if null input. |
static String |
toString(Object obj,
String nullStr)
Gets the
toString of an Object returning
a specified text if null input. |
public static final ObjectUtils.Null NULL
Singleton used as a null placeholder where
null has another meaning.
For example, in a HashMap the
HashMap.get(java.lang.Object) method returns
null if the Map contains null or if there
is no matching key. The Null placeholder can be used to
distinguish between these two cases.
Another example is Hashtable, where null
cannot be stored.
This instance is Serializable.
public ObjectUtils()
ObjectUtils instances should NOT be constructed in
standard programming. Instead, the static methods on the class should
be used, such as ObjectUtils.defaultIfNull("a","b");.
This constructor is public to permit tools that require a JavaBean instance to operate.
public static <T> T defaultIfNull(T object,
T defaultValue)
Returns a default value if the object passed is null.
ObjectUtils.defaultIfNull(null, null) = null
ObjectUtils.defaultIfNull(null, "") = ""
ObjectUtils.defaultIfNull(null, "zz") = "zz"
ObjectUtils.defaultIfNull("abc", *) = "abc"
ObjectUtils.defaultIfNull(Boolean.TRUE, *) = Boolean.TRUE
T - the type of the objectobject - the Object to test, may be nulldefaultValue - the default value to return, may be nullobject if it is not null, defaultValue otherwisepublic static <T> T firstNonNull(T... values)
Returns the first value in the array which is not null.
If all the values are null or the array is null
or empty then null is returned.
ObjectUtils.firstNonNull(null, null) = null
ObjectUtils.firstNonNull(null, "") = ""
ObjectUtils.firstNonNull(null, null, "") = ""
ObjectUtils.firstNonNull(null, "zz") = "zz"
ObjectUtils.firstNonNull("abc", *) = "abc"
ObjectUtils.firstNonNull(null, "xyz", *) = "xyz"
ObjectUtils.firstNonNull(Boolean.TRUE, *) = Boolean.TRUE
ObjectUtils.firstNonNull() = null
T - the component type of the arrayvalues - the values to test, may be null or emptyvalues which is not null,
or null if there are no non-null valuespublic static boolean equals(Object object1, Object object2)
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
object1 - the first object, may be nullobject2 - the second object, may be nulltrue if the values of both objects are the samepublic static boolean notEqual(Object object1, Object object2)
Compares two objects for inequality, where either one or both
objects may be null.
ObjectUtils.notEqual(null, null) = false
ObjectUtils.notEqual(null, "") = true
ObjectUtils.notEqual("", null) = true
ObjectUtils.notEqual("", "") = false
ObjectUtils.notEqual(Boolean.TRUE, null) = true
ObjectUtils.notEqual(Boolean.TRUE, "true") = true
ObjectUtils.notEqual(Boolean.TRUE, Boolean.TRUE) = false
ObjectUtils.notEqual(Boolean.TRUE, Boolean.FALSE) = true
object1 - the first object, may be nullobject2 - the second object, may be nullfalse if the values of both objects are the samepublic static int hashCode(Object obj)
Gets the hash code of an object returning zero when the
object is null.
ObjectUtils.hashCode(null) = 0 ObjectUtils.hashCode(obj) = obj.hashCode()
obj - the object to obtain the hash code of, may be nullpublic static int hashCodeMulti(Object... objects)
Gets the hash code for multiple objects.
This allows a hash code to be rapidly calculated for a number of objects.
The hash code for a single object is the not same as hashCode(Object).
The hash code for multiple objects is the same as that calculated by an
ArrayList containing the specified objects.
ObjectUtils.hashCodeMulti() = 1 ObjectUtils.hashCodeMulti((Object[]) null) = 1 ObjectUtils.hashCodeMulti(a) = 31 + a.hashCode() ObjectUtils.hashCodeMulti(a,b) = (31 + a.hashCode()) * 31 + b.hashCode() ObjectUtils.hashCodeMulti(a,b,c) = ((31 + a.hashCode()) * 31 + b.hashCode()) * 31 + c.hashCode()
objects - the objects to obtain the hash code of, may be nullpublic static String identityToString(Object object)
Gets the toString that would be produced by Object
if a class did not override toString itself. null
will return null.
ObjectUtils.identityToString(null) = null
ObjectUtils.identityToString("") = "java.lang.String@1e23"
ObjectUtils.identityToString(Boolean.TRUE) = "java.lang.Boolean@7fa"
object - the object to create a toString for, may be
nullnull if
null passed inpublic static void identityToString(StringBuffer buffer, Object object)
Appends the toString that would be produced by Object
if a class did not override toString itself. null
will throw a NullPointerException for either of the two parameters.
ObjectUtils.identityToString(buf, "") = buf.append("java.lang.String@1e23"
ObjectUtils.identityToString(buf, Boolean.TRUE) = buf.append("java.lang.Boolean@7fa"
ObjectUtils.identityToString(buf, Boolean.TRUE) = buf.append("java.lang.Boolean@7fa")
buffer - the buffer to append toobject - the object to create a toString forpublic static String toString(Object obj)
Gets the toString of an Object returning
an empty string ("") if null input.
ObjectUtils.toString(null) = ""
ObjectUtils.toString("") = ""
ObjectUtils.toString("bat") = "bat"
ObjectUtils.toString(Boolean.TRUE) = "true"
obj - the Object to toString, may be nullnull inputStringUtils.defaultString(String),
String.valueOf(Object)public static String toString(Object obj, String nullStr)
Gets the toString of an Object returning
a specified text if null input.
ObjectUtils.toString(null, null) = null
ObjectUtils.toString(null, "null") = "null"
ObjectUtils.toString("", "null") = ""
ObjectUtils.toString("bat", "null") = "bat"
ObjectUtils.toString(Boolean.TRUE, "null") = "true"
obj - the Object to toString, may be nullnullStr - the String to return if null input, may be nullnull inputStringUtils.defaultString(String,String),
String.valueOf(Object)public static <T extends Comparable<? super T>> T min(T... values)
Null safe comparison of Comparables.
T - type of the values processed by this methodvalues - the set of comparable values, may be nullpublic static <T extends Comparable<? super T>> T max(T... values)
Null safe comparison of Comparables.
T - type of the values processed by this methodvalues - the set of comparable values, may be nullpublic static <T extends Comparable<? super T>> int compare(T c1, T c2)
Null safe comparison of Comparables.
null is assumed to be less than a non-null value.
T - type of the values processed by this methodc1 - the first comparable, may be nullc2 - the second comparable, may be nullpublic static <T extends Comparable<? super T>> int compare(T c1, T c2, boolean nullGreater)
Null safe comparison of Comparables.
T - type of the values processed by this methodc1 - the first comparable, may be nullc2 - the second comparable, may be nullnullGreater - if true null is considered greater
than a non-null value or if false null is
considered less than a Non-null valueComparator.compare(Object, Object)public static <T extends Comparable<? super T>> T median(T... items)
T - type of values processed by this methoditems - to compareNullPointerException - if items is nullIllegalArgumentException - if items is empty or contains null valuespublic static <T> T median(Comparator<T> comparator, T... items)
T - type of values processed by this methodcomparator - to use for comparisonsitems - to compareNullPointerException - if items or comparator is nullIllegalArgumentException - if items is empty or contains null valuespublic static <T> T mode(T... items)
T - type of values processed by this methoditems - to checknull if non-unique or no items suppliedpublic static <T> T clone(T obj)
Clone an object.
T - the type of the objectobj - the object to clone, null returns nullCloneable otherwise nullCloneFailedException - if the object is cloneable and the clone operation failspublic static <T> T cloneIfPossible(T obj)
Clone an object if possible.
This method is similar to clone(Object), but will return the provided
instance as the return value instead of null if the instance
is not cloneable. This is more convenient if the caller uses different
implementations (e.g. of a service) and some of the implementations do not allow concurrent
processing or have state. In such cases the implementation can simply provide a proper
clone implementation and the caller's code does not have to change.
T - the type of the objectobj - the object to clone, null returns nullCloneable otherwise the object itselfCloneFailedException - if the object is cloneable and the clone operation failsCopyright © 2021 Internet2. All rights reserved.