LANG-781: add javadoc examples and since tags; add changes.xml entry
Project: http://git-wip-us.apache.org/repos/asf/commons-lang/repo Commit: http://git-wip-us.apache.org/repos/asf/commons-lang/commit/5d2728f6 Tree: http://git-wip-us.apache.org/repos/asf/commons-lang/tree/5d2728f6 Diff: http://git-wip-us.apache.org/repos/asf/commons-lang/diff/5d2728f6 Branch: refs/heads/master Commit: 5d2728f655abea3e64c9e7e247cff71ee0285a66 Parents: d190655 Author: pascalschumacher <pascalschumac...@gmx.net> Authored: Thu May 26 20:16:27 2016 +0200 Committer: pascalschumacher <pascalschumac...@gmx.net> Committed: Thu May 26 20:16:27 2016 +0200 ---------------------------------------------------------------------- src/changes/changes.xml | 1 + .../org/apache/commons/lang3/ObjectUtils.java | 25 ++++++++++++++++++-- 2 files changed, 24 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/commons-lang/blob/5d2728f6/src/changes/changes.xml ---------------------------------------------------------------------- diff --git a/src/changes/changes.xml b/src/changes/changes.xml index fe3c588..4f87fcc 100644 --- a/src/changes/changes.xml +++ b/src/changes/changes.xml @@ -22,6 +22,7 @@ <body> <release version="3.5" date="tba" description="tba"> + <action issue="LANG-781" type="add" dev="pschumacher" due-to="Krzysztof Wolny">Add methods to ObjectUtils class to check for null elements in the array</action> <action issue="LANG-1228" type="add" dev="pschumacher" due-to="Brad Hess">Prefer Throwable.getCause() in ExceptionUtils.getCause()</action> <action issue="LANG-1233" type="add" dev="pschumacher" due-to="Nick Manley">DiffBuilder add method to allow appending from a DiffResult</action> <action issue="LANG-1176" type="update" dev="pschumacher" due-to="Jeffery Yuan">Improve ArrayUtils removeElements time complexity to O(n)</action> http://git-wip-us.apache.org/repos/asf/commons-lang/blob/5d2728f6/src/main/java/org/apache/commons/lang3/ObjectUtils.java ---------------------------------------------------------------------- diff --git a/src/main/java/org/apache/commons/lang3/ObjectUtils.java b/src/main/java/org/apache/commons/lang3/ObjectUtils.java index e840031..8f1478f 100644 --- a/src/main/java/org/apache/commons/lang3/ObjectUtils.java +++ b/src/main/java/org/apache/commons/lang3/ObjectUtils.java @@ -129,29 +129,50 @@ public class ObjectUtils { } /** - * <p></p>Checks if any value in the array is not {@code null}. + * <p>Checks if any value in the array is not {@code null}. * If all the values are {@code null} or the array is {@code null} * or empty then {@code false} is returned. Otherwise {@code true} is returned.</p> * + * <pre> + * ObjectUtils.anyNotNull(*) = true + * ObjectUtils.anyNotNull(*, null) = true + * ObjectUtils.anyNotNull(null, *) = true + * ObjectUtils.anyNotNull(null, null, *, *) = true + * ObjectUtils.anyNotNull(null) = false + * ObjectUtils.anyNotNull(null, null) = false + * </pre> + * * @param values the values to test, may be {@code null} or empty * @return {@code true} if there is at least one non-null value in the array, * {@code false} if all values in the array are {@code null}s. * If the array is {@code null} or empty {@code false} is also returned. + * @since 3.5 */ public static boolean anyNotNull(final Object... values) { return firstNonNull(values) != null; } /** - * <p></p>Checks if all values in the array are not {@code null}s. + * <p>Checks if all values in the array are not {@code null}s. * If any value is {@code null} or the array is {@code null} * then {@code false} is returned. * If all elements in array are not {@code null} or the array is empty (contains no elements) * {@code true} is returned.</p> + * + * <pre> + * ObjectUtils.allNotNull(*) = true + * ObjectUtils.allNotNull(*, *) = true + * ObjectUtils.allNotNull(null) = false + * ObjectUtils.allNotNull(null, null) = false + * ObjectUtils.allNotNull(null, *) = false + * ObjectUtils.allNotNull(*, null) = false + * ObjectUtils.allNotNull(*, *, null, *) = false + * </pre> * * @param values the values to test, may be {@code null} or empty * @return {@code false} if there is at least one {@code null} value in the array or the array is {@code null}, * {@code true} if all values in the array are not {@code null}s or array contains no elements. + * @since 3.5 */ public static boolean allNotNull(final Object... values) { if (values == null) {
