Apache
/
commons-lang
mirror of https://github.com/apache/commons-lang.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Move firstNonNull() to better place in file 

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/lang/trunk@881205 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Stephen Colebourne 2009-11-17 09:19:05 +00:00
parent a14051481e
commit ac719ec4ab
1 changed files with 31 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
src/java/org/apache/commons/lang/ObjectUtils.java
View File

@ -90,6 +90,37 @@ public static Object defaultIfNull(Object object, Object defaultValue) {
return object != null ? object : defaultValue; return object != null ? object : defaultValue;
} }
/**
* <p>Returns the first value in the array which is not <code>null</code>.
* If all the values are <code>null</code> or the array is <code>null</code>
* or empty then <code>null</code> is returned.</p>
*
* <pre>
* 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
* </pre>
*
* @param values the values to test, may be <code>null</code> or empty
* @return the first value from <code>values</code> which is not <code>null</code>,
* or <code>null</code> if there are no non-null values
*/
public static <T> T firstNonNull(T... values) {
for (T val : values) {
if (val != null && val != ObjectUtils.NULL) {
return val;
}
}
return null;
}
// Null-safe equals/hashCode
//-----------------------------------------------------------------------
/** /**
* <p>Compares two objects for equality, where either one or both * <p>Compares two objects for equality, where either one or both
* objects may be <code>null</code>.</p> * objects may be <code>null</code>.</p>
@ -318,36 +349,4 @@ private Object readResolve() {
} }
} }
/**
* <p>Returns the first passed value which is not <code>null</code> or
* <code>null</code> otherwise.</p>
*
* <pre>
* 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
* </pre>
*
* @param values the values to test, may be <code>null</code> or empty
*
* @return The first value from <code>values</code> which is not
* <code>null</code> or <code>null</code> otherwise.
*/
public static <T> T firstNonNull(T... values) {
// This is a trivial implementation. There may be faster ones.
// According to the JRE Libraries, overloading the method with fixed
// parameter sizes may be faster.
for (T val : values) {
if (val != null && val != ObjectUtils.NULL) {
return val;
}
}
return null;
}
} }