de.ipcon.tools

Class NullCheckTools

java.lang.Object

de.ipcon.tools.NullCheckTools

public final class NullCheckTools
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
NullCheckTools()

Method Summary

Modifier and Type	Method and Description
static int	compare(java.lang.Comparable o1, java.lang.Comparable o2) Null-safe comparison of two Comparables with each other, using the compareTo Method.
static java.lang.Object	elvis(java.lang.Object[] arr) This method mimics a chained elvis operator in Groovy Object a ?
static java.lang.Object	elvis(java.lang.Object o, java.lang.Object nv) This method makes the elvis operator from Groovy available to NetRexx, i.e.
static java.lang.Object	elvis(java.lang.Object o1, java.lang.Object o2, java.lang.Object o3) This method mimics a chained elvis operator in Groovy Object ?
static int	groovyCompare(java.lang.Comparable o1, java.lang.Comparable o2) Uses the Groovy compare operator for comparing the given parameters, null-safe.
static java.math.BigDecimal	NN(java.math.BigDecimal n) Returns the given parameter bd (BigDecimal) if not null, otherwise BigDecimal.ZERO.
static java.math.BigDecimal	NN(java.math.BigDecimal n, java.math.BigDecimal nv) Returns the given parameter n (BigDecimal) if not null, otherwise the passed default.
static boolean	NN(java.lang.Boolean b) This method returns the booleanValue() of b, or boolean false as default.
static boolean	NN(java.lang.Boolean b, boolean nv) This method returns the booleanValue() of b, or the passed default value.
static double	NN(java.lang.Double n) Returns the doubleValue() of n, or 0 as default.
static double	NN(java.lang.Double n, double nv) Returns the doubleValue() of n, or the passed default.
static float	NN(java.lang.Float n) Returns the floatValue() of i, or 0 as default.
static float	NN(java.lang.Float n, float nv) Returns the floatValue() of i, or the passed default.
static int	NN(java.lang.Integer n) Returns the intValue() of n, or 0 as default.
static int	NN(java.lang.Integer n, int nv) Returns the intValue() of n, or the passed default.
static long	NN(java.lang.Long n) Returns the longValue() of n, or 0 as default.
static long	NN(java.lang.Long n, long nv) Returns the longValue() of n, or the passed default.
static java.lang.Object	NN(java.lang.Object o, java.lang.Object nv) Simply a wrapper for NullCheckTools#elvis(Object, Object)
static java.lang.String	NN(java.lang.String s) Returns the empty String if the passed String is null, otherwise returns the passed String as is.
static java.lang.String	NN(java.lang.String s, java.lang.String nv) Returns the passed fallback value if the passed String is null, otherwise returns the passed String as is.
static java.lang.String	NNString(java.lang.Boolean b, java.lang.String trueVal, java.lang.String falseVal) This method checks the given Boolean b, and returns falseVal if b is null or false, or trueVal if b is true
static java.lang.String	NNString(java.lang.Boolean b, java.lang.String trueVal, java.lang.String falseVal, java.lang.String nullVal) This method checks the given Boolean b, and returns nullVal if b is null, falseVal if b is false, or trueVal if b is true
static boolean	nonNullPayload(java.util.Map.Entry<?,?> entry) Helper to filter streams of a Map.entrySet().
static boolean	nullSafeEquals(java.math.BigDecimal a, java.math.BigDecimal b) Does a null safe equality check on two BigDecimals
static boolean	nullSafeEquals(java.lang.Object a, java.lang.Object b) Does a null safe equality check on two Objects If both Objects are BigDecimal, they will be typecasted as BigDecimal.
static boolean[]	requireNonEmpty(boolean[] possiblyEmptyArray, java.lang.String name) requireNonEmpty(T[], String)
static byte[]	requireNonEmpty(byte[] possiblyEmptyArray, java.lang.String name) requireNonEmpty(T[], String)
static char[]	requireNonEmpty(char[] possiblyEmptyArray, java.lang.String name) requireNonEmpty(T[], String)
static <T> java.util.Collection<T>	requireNonEmpty(java.util.Collection<T> possiblyEmptyCollection, java.lang.String name) Throws a EmptyCollectionException if the given Collection is null or empty.
static double[]	requireNonEmpty(double[] possiblyEmptyArray, java.lang.String name) requireNonEmpty(T[], String)
static float[]	requireNonEmpty(float[] possiblyEmptyArray, java.lang.String name) requireNonEmpty(T[], String)
static int[]	requireNonEmpty(int[] possiblyEmptyArray, java.lang.String name) requireNonEmpty(T[], String)
static long[]	requireNonEmpty(long[] possiblyEmptyArray, java.lang.String name) requireNonEmpty(T[], String)
static <T,K> java.util.Map<T,K>	requireNonEmpty(java.util.Map<T,K> possiblyEmptyMap, java.lang.String name) Throws a EmptyMapException if the given Map is null or empty.
static short[]	requireNonEmpty(short[] possiblyEmptyArray, java.lang.String name) requireNonEmpty(T[], String)
static java.lang.String	requireNonEmpty(java.lang.String possibleEmptyString, java.lang.String name) Throws a MissingArgumentException if the given value is null or empty.
static java.lang.String	requireNonEmpty(java.lang.String possibleEmptyString, java.lang.String name, boolean treatWhiteSpaceAsEmpty) Throws a MissingArgumentException if the given value is null or empty.
static <T> T[]	requireNonEmpty(T[] possiblyEmptyArray, java.lang.String name) throws a EmptyArrayException if the given Array is null or empty.
static void	requireNonNull(java.util.Collection<? extends java.lang.Object> possibleNullValues, java.util.Collection<java.lang.String> namesOfArguments) Deprecated. please use the requireNonNull functions taking "pairs" of object/denomination instead
static void	requireNonNull(java.lang.Object p1, java.lang.String name1, java.lang.Object p2, java.lang.String name2) Throws a MissingArgumentException if either of the given values is null.
static void	requireNonNull(java.lang.Object p1, java.lang.String name1, java.lang.Object p2, java.lang.String name2, java.lang.Object p3, java.lang.String name3) Throws a MissingArgumentException if any of the given values are null.
static void	requireNonNull(java.lang.Object p1, java.lang.String name1, java.lang.Object p2, java.lang.String name2, java.lang.Object p3, java.lang.String name3, java.lang.Object p4, java.lang.String name4) Throws a MissingArgumentException if any of the given values are null.
static void	requireNonNull(java.lang.Object p1, java.lang.String name1, java.lang.Object p2, java.lang.String name2, java.lang.Object p3, java.lang.String name3, java.lang.Object p4, java.lang.String name4, java.lang.Object p5, java.lang.String name5) Throws a MissingArgumentException if any of the given values are null.
static <T> void	requireNonNull(T[] possibleNullValues, java.lang.String[] namesOfArguments) Deprecated. please use the requireNonNull functions taking "pairs" of object/denomination instead
static <T> T	requireNonNull(T possibleNullValue, java.lang.String nameOfArgument) Throws a MissingArgumentException if the given value is null.
static void	requireNonNullAndNonEmpty(java.util.Collection<? extends java.lang.Object> possibleNullOrEmptyValues, java.util.Collection<java.lang.String> namesOfArguments) Deprecated. please use the requireNonNullAndNonEmpty functions taking "pairs" of object/denomination instead
static void	requireNonNullAndNonEmpty(java.lang.Object o, java.lang.String name)
static void	requireNonNullAndNonEmpty(java.lang.Object p1, java.lang.String name1, java.lang.Object p2, java.lang.String name2) Throws a MissingArgumentException if either of the given values is null or empty.
static void	requireNonNullAndNonEmpty(java.lang.Object p1, java.lang.String name1, java.lang.Object p2, java.lang.String name2, java.lang.Object p3, java.lang.String name3) Throws a MissingArgumentException if either of the given values is null or empty.
static void	requireNonNullAndNonEmpty(java.lang.Object p1, java.lang.String name1, java.lang.Object p2, java.lang.String name2, java.lang.Object p3, java.lang.String name3, java.lang.Object p4, java.lang.String name4) Throws a MissingArgumentException if either of the given values is null or empty.
static void	requireNonNullAndNonEmpty(java.lang.Object p1, java.lang.String name1, java.lang.Object p2, java.lang.String name2, java.lang.Object p3, java.lang.String name3, java.lang.Object p4, java.lang.String name4, java.lang.Object p5, java.lang.String name5) Throws a MissingArgumentException if either of the given values is null or empty.
static <T> void	requireNonNullAndNonEmpty(T[] possibleNullOrEmptyValues, java.lang.String[] namesOfArguments) Deprecated. please use the requireNonNullAndNonEmpty functions taking "pairs" of object/denomination instead
static <T> void	requireOneIsNonNull(T[] possibleNullValues, java.lang.String[] namesOfArguments) Checks that at least one of the arguments has a value.
static <T> void	requireOneIsNonNull(T[] possibleNullValues, java.lang.String[] namesOfArguments, java.lang.String additionalText) Checks that at least one of the arguments has a value.

Methods inherited from class java.lang.Object

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

Constructor Detail

NullCheckTools

public NullCheckTools()

Method Detail

elvis

public static final java.lang.Object elvis(java.lang.Object o,
                                           java.lang.Object nv)

This method makes the elvis operator from Groovy available to NetRexx, i.e. Object ?: Object but only checks for null.

Parameters:

o - the first object to elvis

nv - the second object to elvis

Returns:

the first of the passed objects which is not null, or null if both objects are null

elvis

public static final java.lang.Object elvis(java.lang.Object o1,
                                           java.lang.Object o2,
                                           java.lang.Object o3)

This method mimics a chained elvis operator in Groovy Object ?: Object ?: Object but only checks for null. Just a wrapper for #elvis(Object[]).

Parameters:

o1 - the first object to elvis

o2 - the second object to elvis

o3 - the third object to elvis

Returns:

the first of the passed objects which is not null, or null if all objects are null

elvis

public static final java.lang.Object elvis(java.lang.Object[] arr)

This method mimics a chained elvis operator in Groovy Object a ?: Object b ?: Object c ?: Object d ... but only checks for null.

Returns:

the first of the objects in the passed array which is not null, or null if all objects are null

NN

public static final boolean NN(java.lang.Boolean b)

This method returns the booleanValue() of b, or boolean false as default.

Parameters:

b - the value to test.

Returns:

the boolean value if b was not null, otherwise nv with default false.

NN

public static final boolean NN(java.lang.Boolean b,
                               boolean nv)

This method returns the booleanValue() of b, or the passed default value.

Parameters:

b - the value to test.

nv - the default return value - boolean false.

Returns:

the boolean value if b was not null, otherwise nv.

NNString

public static final java.lang.String NNString(java.lang.Boolean b,
                                              java.lang.String trueVal,
                                              java.lang.String falseVal)

This method checks the given Boolean b, and returns falseVal if b is null or false, or trueVal if b is true

Parameters:

b - the value to test.

trueVal - the return value if b is true

falseVal - the return value if b is null or false

Returns:

falseVal if b is null or false, or trueVal if b is true

NNString

public static final java.lang.String NNString(java.lang.Boolean b,
                                              java.lang.String trueVal,
                                              java.lang.String falseVal,
                                              java.lang.String nullVal)

This method checks the given Boolean b, and returns nullVal if b is null, falseVal if b is false, or trueVal if b is true

Parameters:

b - the value to test.

trueVal - the return value if b is true

falseVal - the return value if b is false

nullVal - the return value if b is null

Returns:

nullVal if b is null, falseVal if b is false, or trueVal if b is true

NN

public static final int NN(java.lang.Integer n)

Returns the intValue() of n, or 0 as default.

Parameters:

n - the value to test.

Returns:

the intValue() of n, or 0 as default.

NN

public static final int NN(java.lang.Integer n,
                           int nv)

Returns the intValue() of n, or the passed default.

Parameters:

n - the value to test.

nv - the default return value.

Returns:

the intValue() of n, or the passed default.

NN

public static final long NN(java.lang.Long n)

Returns the longValue() of n, or 0 as default.

Parameters:

n - the value to test.

Returns:

the longValue() of n, or 0 as default.

NN

public static final long NN(java.lang.Long n,
                            long nv)

Returns the longValue() of n, or the passed default.

Parameters:

n - the value to test.

nv - the default return value.

Returns:

the longValue() of n, or the default.

NN

public static final java.lang.String NN(java.lang.String s)

Returns the empty String if the passed String is null, otherwise returns the passed String as is.

Parameters:

s - the String to test

Returns:

the empty String if the passed String is null, otherwise returns the passed String as is

NN

public static final java.lang.String NN(java.lang.String s,
                                        java.lang.String nv)

Returns the passed fallback value if the passed String is null, otherwise returns the passed String as is.

Parameters:

s - the String to test

nv - the fallback value for a passed null String, defaults to the empty String

Returns:

the passed fallback value if the passed String is null, otherwise returns the passed String as is

NN

public static final java.math.BigDecimal NN(java.math.BigDecimal n)

Returns the given parameter bd (BigDecimal) if not null, otherwise BigDecimal.ZERO.

Parameters:

n - the value to test.

Returns:

the given parameter bd (BigDecimal) if not null, otherwise BigDecimal.ZERO.

NN

public static final java.math.BigDecimal NN(java.math.BigDecimal n,
                                            java.math.BigDecimal nv)

Returns the given parameter n (BigDecimal) if not null, otherwise the passed default.

Parameters:

n - the value to test.

nv - the default return value.

Returns:

the given parameter n (BigDecimal) if not null, otherwise the default.

NN

public static final float NN(java.lang.Float n)

Returns the floatValue() of i, or 0 as default.

Parameters:

n - the value to test.

Returns:

the floatValue() of n, or 0 as default.

NN

public static final float NN(java.lang.Float n,
                             float nv)

Returns the floatValue() of i, or the passed default.

Parameters:

n - the value to test.

nv - the default return value.

Returns:

the floatValue() of n, or the default.

NN

public static final double NN(java.lang.Double n)

Returns the doubleValue() of n, or 0 as default.

Parameters:

n - the value to test.

Returns:

the doubleValue() of n, or 0 as default.

NN

public static final double NN(java.lang.Double n,
                              double nv)

Returns the doubleValue() of n, or the passed default.

Parameters:

n - the value to test.

nv - the default return value.

Returns:

the doubleValue() of n, or the default.

NN

public static final java.lang.Object NN(java.lang.Object o,
                                        java.lang.Object nv)

Simply a wrapper for NullCheckTools#elvis(Object, Object)

Parameters:

o - the first object to elvis

nv - the second object to elvis

Returns:

the first of the passed objects which is not null

nullSafeEquals

public static final boolean nullSafeEquals(java.lang.Object a,
                                           java.lang.Object b)

Does a null safe equality check on two Objects If both Objects are BigDecimal, they will be typecasted as BigDecimal.

Parameters:

a - the one Object to compare

b - the other Object to compare

Returns:

true if the given Objects are equals

nullSafeEquals

public static final boolean nullSafeEquals(java.math.BigDecimal a,
                                           java.math.BigDecimal b)

Does a null safe equality check on two BigDecimals

Parameters:

a - the one BigDecimal to compare

b - the other BigDecimal to compare

Returns:

true if the given BigDecimals are equals

compare

public static final int compare(java.lang.Comparable o1,
                                java.lang.Comparable o2)

Null-safe comparison of two Comparables with each other, using the compareTo Method. Returns zero if both Comparables are null or identical in value. Returns -1 if only o1 is null, a negative number if o1 is smaller than o2. Returns 1 if only o2 is null, a positive number larger than zero if o2 is bigger than o1.

Parameters:

o1 - the one Comparable to be compared.

o2 - the other Comparable to be compared.

Returns:

the comparison result of both Comparables

groovyCompare

public static final int groovyCompare(java.lang.Comparable o1,
                                      java.lang.Comparable o2)

Uses the Groovy compare operator for comparing the given parameters, null-safe. Contrary to compare(Comparable, Comparable), this method allows comparing Numbers of different types by supporting 'type promotion'/widening of a smaller type to a larger one. e.g. when comparing Short and BigDecimal, then the Short is internally widened to BigDecimal first.

Returns:

Zero if null or identical in value, a negative number if only o1 is null or is smaller than o2, a positive number greater zero if only o2 is null or is larger than o1.

requireNonNull

public static final <T> T requireNonNull(T possibleNullValue,
                                         java.lang.String nameOfArgument)
                                  throws de.ipcon.tools.MissingArgumentException

Throws a MissingArgumentException if the given value is null. The name of the argument should be specified for the error message of the exception

Type Parameters:

T - the type of the value

Parameters:

possibleNullValue - the value to check for null

nameOfArgument - the name of the argument

Returns:

the given value, if it was not null

Throws:

MissingArgumentException - if the value was null

requireOneIsNonNull

public static final <T> void requireOneIsNonNull(T[] possibleNullValues,
                                                 java.lang.String[] namesOfArguments)

Checks that at least one of the arguments has a value.

Type Parameters:

T - the type of the values

Parameters:

possibleNullValues - the values to check for null

namesOfArguments - the names of the arguments

Throws:

MissingArgumentException - if none of the arguments has a value.

requireOneIsNonNull

public static final <T> void requireOneIsNonNull(T[] possibleNullValues,
                                                 java.lang.String[] namesOfArguments,
                                                 java.lang.String additionalText)

Checks that at least one of the arguments has a value.

Type Parameters:

T - the type of the values

Parameters:

possibleNullValues - the values to check for null

namesOfArguments - the names of the arguments

additionalText - additional text for the exception message

Throws:

MissingArgumentException - if none of the arguments has a value.

requireNonEmpty

public static final java.lang.String requireNonEmpty(java.lang.String possibleEmptyString,
                                                     java.lang.String name)

Throws a MissingArgumentException if the given value is null or empty. The name of the argument should be specified for the error message of the exception

Parameters:

possibleEmptyString - the value to check for null or empty

name - the name of the argument

Returns:

the given value, if it was not null or empty

Throws:

MissingArgumentException - if the value was null or empty

requireNonEmpty

public static final java.lang.String requireNonEmpty(java.lang.String possibleEmptyString,
                                                     java.lang.String name,
                                                     boolean treatWhiteSpaceAsEmpty)

Throws a MissingArgumentException if the given value is null or empty. The name of the argument should be specified for the error message of the exception

Parameters:

possibleEmptyString - the value to check for null or empty

name - the name of the argument

treatWhiteSpaceAsEmpty - flag to treat white space as empty

Returns:

the given value, if it was not null or empty

Throws:

MissingArgumentException - if the value was null or empty

requireNonEmpty

public static final byte[] requireNonEmpty(byte[] possiblyEmptyArray,
                                           java.lang.String name)
                                    throws de.ipcon.tools.EmptyArrayException

requireNonEmpty(T[], String)

Throws:

de.ipcon.tools.EmptyArrayException

requireNonEmpty

public static final short[] requireNonEmpty(short[] possiblyEmptyArray,
                                            java.lang.String name)
                                     throws de.ipcon.tools.EmptyArrayException

requireNonEmpty(T[], String)

Throws:

de.ipcon.tools.EmptyArrayException

requireNonEmpty

public static final int[] requireNonEmpty(int[] possiblyEmptyArray,
                                          java.lang.String name)
                                   throws de.ipcon.tools.EmptyArrayException

requireNonEmpty(T[], String)

Throws:

de.ipcon.tools.EmptyArrayException

requireNonEmpty

public static final long[] requireNonEmpty(long[] possiblyEmptyArray,
                                           java.lang.String name)
                                    throws de.ipcon.tools.EmptyArrayException

requireNonEmpty(T[], String)

Throws:

de.ipcon.tools.EmptyArrayException

requireNonEmpty

public static final float[] requireNonEmpty(float[] possiblyEmptyArray,
                                            java.lang.String name)
                                     throws de.ipcon.tools.EmptyArrayException

requireNonEmpty(T[], String)

Throws:

de.ipcon.tools.EmptyArrayException

requireNonEmpty

public static final double[] requireNonEmpty(double[] possiblyEmptyArray,
                                             java.lang.String name)
                                      throws de.ipcon.tools.EmptyArrayException

requireNonEmpty(T[], String)

Throws:

de.ipcon.tools.EmptyArrayException

requireNonEmpty

public static final boolean[] requireNonEmpty(boolean[] possiblyEmptyArray,
                                              java.lang.String name)
                                       throws de.ipcon.tools.EmptyArrayException

requireNonEmpty(T[], String)

Throws:

de.ipcon.tools.EmptyArrayException

requireNonEmpty

public static final char[] requireNonEmpty(char[] possiblyEmptyArray,
                                           java.lang.String name)
                                    throws de.ipcon.tools.EmptyArrayException

requireNonEmpty(T[], String)

Throws:

de.ipcon.tools.EmptyArrayException

requireNonEmpty

public static final <T> T[] requireNonEmpty(T[] possiblyEmptyArray,
                                            java.lang.String name)
                                     throws de.ipcon.tools.EmptyArrayException

throws a EmptyArrayException if the given Array is null or empty. The name of the argument should be specified for the error message of the exception

Returns:

the given value, if it was not null or empty

Throws:

EmptyCollectionException - if the value was null or empty

de.ipcon.tools.EmptyArrayException

requireNonEmpty

public static final <T> java.util.Collection<T> requireNonEmpty(java.util.Collection<T> possiblyEmptyCollection,
                                                                java.lang.String name)
                                                         throws de.ipcon.tools.EmptyCollectionException

Throws a EmptyCollectionException if the given Collection is null or empty. The name of the argument should be specified for the error message of the exception

Returns:

the given value, if it was not null or empty

Throws:

EmptyCollectionException - if the value was null or empty

requireNonEmpty

public static final <T,K> java.util.Map<T,K> requireNonEmpty(java.util.Map<T,K> possiblyEmptyMap,
                                                             java.lang.String name)
                                                      throws de.ipcon.tools.EmptyMapException

Throws a EmptyMapException if the given Map is null or empty. The name of the argument should be specified for the error message of the exception

Returns:

the given value, if it was not null or empty

Throws:

EmptyMapException - if the value was null or empty

requireNonNullAndNonEmpty

public static final void requireNonNullAndNonEmpty(java.lang.Object o,
                                                   java.lang.String name)

requireNonNull

public static final void requireNonNull(java.lang.Object p1,
                                        java.lang.String name1,
                                        java.lang.Object p2,
                                        java.lang.String name2)
                                 throws de.ipcon.tools.MissingArgumentException

Throws a MissingArgumentException if either of the given values is null.

Parameters:

p1 - The first value to check for null.

name1 - The name of the first value, used in the exception message.

p2 - The second value to check for null.

name2 - The name of the second value, used in the exception message.

Throws:

MissingArgumentException - if either of the given values was null

requireNonNull

public static final void requireNonNull(java.lang.Object p1,
                                        java.lang.String name1,
                                        java.lang.Object p2,
                                        java.lang.String name2,
                                        java.lang.Object p3,
                                        java.lang.String name3)
                                 throws de.ipcon.tools.MissingArgumentException

Throws a MissingArgumentException if any of the given values are null.

Parameters:

p1 - The first value to check for null.

name1 - The name of the first value, used in the exception message.

p2 - The second value to check for null.

name2 - The name of the second value, used in the exception message.

p3 - The third value to check for null.

name3 - The name of the third value, used in the exception message.

Throws:

MissingArgumentException - if any of the given values was null

requireNonNull

public static final void requireNonNull(java.lang.Object p1,
                                        java.lang.String name1,
                                        java.lang.Object p2,
                                        java.lang.String name2,
                                        java.lang.Object p3,
                                        java.lang.String name3,
                                        java.lang.Object p4,
                                        java.lang.String name4)
                                 throws de.ipcon.tools.MissingArgumentException

Throws a MissingArgumentException if any of the given values are null.

Parameters:

p1 - The first value to check for null.

name1 - The name of the first value, used in the exception message.

p2 - The second value to check for null.

name2 - The name of the second value, used in the exception message.

p3 - The third value to check for null.

name3 - The name of the third value, used in the exception message.

p4 - The fourth value to check for null.

name4 - The name of the fourth value, used in the exception message.

Throws:

MissingArgumentException - if any of the given values was null

requireNonNull

public static final void requireNonNull(java.lang.Object p1,
                                        java.lang.String name1,
                                        java.lang.Object p2,
                                        java.lang.String name2,
                                        java.lang.Object p3,
                                        java.lang.String name3,
                                        java.lang.Object p4,
                                        java.lang.String name4,
                                        java.lang.Object p5,
                                        java.lang.String name5)
                                 throws de.ipcon.tools.MissingArgumentException

Throws a MissingArgumentException if any of the given values are null.

Parameters:

p1 - The first value to check for null.

name1 - The name of the first value, used in the exception message.

p2 - The second value to check for null.

name2 - The name of the second value, used in the exception message.

p3 - The third value to check for null.

name3 - The name of the third value, used in the exception message.

p4 - The fourth value to check for null.

name4 - The name of the fourth value, used in the exception message.

p5 - The fifth value to check for null.

name5 - The name of the fifth value, used in the exception message.

Throws:

MissingArgumentException - if any of the given values was null

requireNonNull

@Deprecated
public static final <T> void requireNonNull(T[] possibleNullValues,
                                                        java.lang.String[] namesOfArguments)
                                                 throws de.ipcon.tools.MissingArgumentException

Deprecated. please use the requireNonNull functions taking "pairs" of object/denomination instead

Throws a MissingArgumentException for the first one of the given values whose value is null. The names of the arguments should be specified for the error message of the exception.

Throws:

MissingArgumentException - if one of the given values was null

requireNonNull

@Deprecated
public static final void requireNonNull(java.util.Collection<? extends java.lang.Object> possibleNullValues,
                                                    java.util.Collection<java.lang.String> namesOfArguments)
                                             throws de.ipcon.tools.MissingArgumentException

Deprecated. please use the requireNonNull functions taking "pairs" of object/denomination instead

Throws a MissingArgumentException for the first one of the given values whose value is null. The names of the arguments should be specified for the error message of the exception.

Throws:

MissingArgumentException - if one of the given values was null

requireNonNullAndNonEmpty

public static final void requireNonNullAndNonEmpty(java.lang.Object p1,
                                                   java.lang.String name1,
                                                   java.lang.Object p2,
                                                   java.lang.String name2)

Throws a MissingArgumentException if either of the given values is null or empty.

Parameters:

p1 - The first value to check for null or emptiness.

name1 - The name of the first value, used in the exception message.

p2 - The second value to check for null or emptiness.

name2 - The name of the second value, used in the exception message.

Throws:

MissingArgumentException - if either of the given values was null or empty

EmptyMapException - if one of the given values is an empty map

EmptyCollectionException - if one of the given values is any other empty collection

EmptyArrayException - if one of the given values is an empty array

requireNonNullAndNonEmpty

public static final void requireNonNullAndNonEmpty(java.lang.Object p1,
                                                   java.lang.String name1,
                                                   java.lang.Object p2,
                                                   java.lang.String name2,
                                                   java.lang.Object p3,
                                                   java.lang.String name3)

Throws a MissingArgumentException if either of the given values is null or empty.

Parameters:

p1 - The first value to check for null or emptiness.

name1 - The name of the first value, used in the exception message.

p2 - The second value to check for null or emptiness.

name2 - The name of the second value, used in the exception message.

p3 - The third value to check for null or emptiness.

name3 - The name of the third value, used in the exception message.

Throws:

MissingArgumentException - if either of the given values was null or empty

EmptyMapException - if one of the given values is an empty map

EmptyCollectionException - if one of the given values is any other empty collection

EmptyArrayException - if one of the given values is an empty array

requireNonNullAndNonEmpty

public static final void requireNonNullAndNonEmpty(java.lang.Object p1,
                                                   java.lang.String name1,
                                                   java.lang.Object p2,
                                                   java.lang.String name2,
                                                   java.lang.Object p3,
                                                   java.lang.String name3,
                                                   java.lang.Object p4,
                                                   java.lang.String name4)

Throws a MissingArgumentException if either of the given values is null or empty.

Parameters:

p1 - The first value to check for null or emptiness.

name1 - The name of the first value, used in the exception message.

p2 - The second value to check for null or emptiness.

name2 - The name of the second value, used in the exception message.

p3 - The third value to check for null or emptiness.

name3 - The name of the third value, used in the exception message.

p4 - The fourth value to check for null or emptiness.

name4 - The name of the fourth value, used in the exception message.

Throws:

MissingArgumentException - if either of the given values was null or empty

EmptyMapException - if one of the given values is an empty map

EmptyCollectionException - if one of the given values is any other empty collection

EmptyArrayException - if one of the given values is an empty array

requireNonNullAndNonEmpty

public static final void requireNonNullAndNonEmpty(java.lang.Object p1,
                                                   java.lang.String name1,
                                                   java.lang.Object p2,
                                                   java.lang.String name2,
                                                   java.lang.Object p3,
                                                   java.lang.String name3,
                                                   java.lang.Object p4,
                                                   java.lang.String name4,
                                                   java.lang.Object p5,
                                                   java.lang.String name5)

Throws a MissingArgumentException if either of the given values is null or empty.

Parameters:

p1 - The first value to check for null or emptiness.

name1 - The name of the first value, used in the exception message.

p2 - The second value to check for null or emptiness.

name2 - The name of the second value, used in the exception message.

p3 - The third value to check for null or emptiness.

name3 - The name of the third value, used in the exception message.

p4 - The fourth value to check for null or emptiness.

name4 - The name of the fourth value, used in the exception message.

p5 - The fourth value to check for null or emptiness.

name5 - The name of the fourth value, used in the exception message.

Throws:

MissingArgumentException - if either of the given values was null or empty

EmptyMapException - if one of the given values is an empty map

EmptyCollectionException - if one of the given values is any other empty collection

EmptyArrayException - if one of the given values is an empty array

requireNonNullAndNonEmpty

@Deprecated
public static final <T> void requireNonNullAndNonEmpty(T[] possibleNullOrEmptyValues,
                                                                   java.lang.String[] namesOfArguments)

Deprecated. please use the requireNonNullAndNonEmpty functions taking "pairs" of object/denomination instead

Throws a MissingArgumentException for the first one of the given values whose value is either of:

• null
• an empty String
• an empty Collection
• an empty array

if one of the arguments is a map or a collection and is empty. The names of the arguments should be specified for the error message of the exception.

Throws:

MissingArgumentException - if one of the given values was null

EmptyMapException - if one of the given values is an empty map

EmptyCollectionException - if one of the given values is any other empty collection

EmptyArrayException - if one of the given values is an empty array

requireNonNullAndNonEmpty

@Deprecated
public static final void requireNonNullAndNonEmpty(java.util.Collection<? extends java.lang.Object> possibleNullOrEmptyValues,
                                                               java.util.Collection<java.lang.String> namesOfArguments)

Deprecated. please use the requireNonNullAndNonEmpty functions taking "pairs" of object/denomination instead

Throws a MissingArgumentException for the first one of the given values whose value is either of:

• null
• an empty String
• an empty Collection
• an empty array

if one of the arguments is a map or a collection and is empty. The names of the arguments should be specified for the error message of the exception.

Throws:

MissingArgumentException - if one of the given values was null

EmptyMapException - if one of the given values is an empty map

EmptyCollectionException - if one of the given values is any other empty collection

EmptyArrayException - if one of the given values is an empty array

nonNullPayload

public static final boolean nonNullPayload(java.util.Map.Entry<?,?> entry)

Helper to filter streams of a Map.entrySet().

Parameters:

entry - the parameter to check, nullable.

Returns:

true if neither the parameter, key nor value of the entry is null. false otherwise.