Class ObjectUtil

java.lang.Object

io.netty.util.internal.ObjectUtil

public final class ObjectUtil
extends Object

A grab-bag of useful utility methods.

Method Summary

Modifier and Type	Method	Description
static double	checkInRange(double d, double start, double end, String name)	Checks that the given argument is in range.
static int	checkInRange(int i, int start, int end, String name)	Checks that the given argument is in range.
static long	checkInRange(long l, long start, long end, String name)	Checks that the given argument is in range.
static byte[]	checkNonEmpty(byte[] array, String name)	Checks that the given argument is neither null nor empty.
static char[]	checkNonEmpty(char[] array, String name)	Checks that the given argument is neither null nor empty.
static CharSequence	checkNonEmpty(CharSequence value, String name)	Checks that the given argument is neither null nor empty.
static String	checkNonEmpty(String value, String name)	Checks that the given argument is neither null nor empty.
static <T> T[]	checkNonEmpty(T[] array, String name)	Checks that the given argument is neither null nor empty.
static <K, V, T extends Map<K,V>> T	checkNonEmpty(T value, String name)	Checks that the given argument is neither null nor empty.
static <T extends Collection<?>> T	checkNonEmpty(T collection, String name)	Checks that the given argument is neither null nor empty.
static String	checkNonEmptyAfterTrim(String value, String name)	Trims the given argument and checks whether it is neither null nor empty.
static <T> T	checkNotNull(T arg, String text)	Checks that the given argument is not null.
static <T> T	checkNotNullArrayParam(T value, int index, String name)	Checks that the given argument is not null.
static <T> T	checkNotNullWithIAE(T arg, String paramName)	Checks that the given argument is not null.
static double	checkPositive(double d, String name)	Checks that the given argument is strictly positive.
static float	checkPositive(float f, String name)	Checks that the given argument is strictly positive.
static int	checkPositive(int i, String name)	Checks that the given argument is strictly positive.
static long	checkPositive(long l, String name)	Checks that the given argument is strictly positive.
static short	checkPositive(short s, String name)	Checks that the given argument is positive or zero.
static double	checkPositiveOrZero(double d, String name)	Checks that the given argument is positive or zero.
static float	checkPositiveOrZero(float f, String name)	Checks that the given argument is positive or zero.
static int	checkPositiveOrZero(int i, String name)	Checks that the given argument is positive or zero.
static long	checkPositiveOrZero(long l, String name)	Checks that the given argument is positive or zero.
static <T> T[]	deepCheckNotNull(String text, T... varargs)	Check that the given varargs is not null and does not contain elements null elements.
static int	intValue(Integer wrapper, int defaultValue)	Resolves a possibly null Integer to a primitive int, using a default value.
static long	longValue(Long wrapper, long defaultValue)	Resolves a possibly null Long to a primitive long, using a default value.

Methods inherited from class Object

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

Method Details

checkNotNull

public static <T> T checkNotNull(T arg,
 String text)

Checks that the given argument is not null. If it is, throws NullPointerException. Otherwise, returns the argument.

deepCheckNotNull

public static <T> T[] deepCheckNotNull(String text,
 T... varargs)

Check that the given varargs is not null and does not contain elements null elements. If it is, throws NullPointerException. Otherwise, returns the argument.

checkNotNullWithIAE

public static <T> T checkNotNullWithIAE(T arg,
 String paramName)
                                 throws IllegalArgumentException

Checks that the given argument is not null. If it is, throws IllegalArgumentException. Otherwise, returns the argument.

Throws:

IllegalArgumentException

checkNotNullArrayParam

public static <T> T checkNotNullArrayParam(T value,
 int index,
 String name)
                                    throws IllegalArgumentException

Checks that the given argument is not null. If it is, throws IllegalArgumentException. Otherwise, returns the argument.

Type Parameters:

T - type of the given argument value.

Parameters:

value - to check.

index - of the array, belongs to the exception message.

name - of the parameter, belongs to the exception message.

Returns:

the given argument value.

Throws:

IllegalArgumentException - if value is null.

checkPositive

public static int checkPositive(int i,
 String name)

Checks that the given argument is strictly positive. If it is not, throws IllegalArgumentException. Otherwise, returns the argument.

checkPositive

public static long checkPositive(long l,
 String name)

Checks that the given argument is strictly positive. If it is not, throws IllegalArgumentException. Otherwise, returns the argument.

checkPositive

public static double checkPositive(double d,
 String name)

Checks that the given argument is strictly positive. If it is not, throws IllegalArgumentException. Otherwise, returns the argument.

checkPositive

public static float checkPositive(float f,
 String name)

Checks that the given argument is strictly positive. If it is not, throws IllegalArgumentException. Otherwise, returns the argument.

checkPositive

public static short checkPositive(short s,
 String name)

Checks that the given argument is positive or zero. If it is not , throws IllegalArgumentException. Otherwise, returns the argument.

checkPositiveOrZero

public static int checkPositiveOrZero(int i,
 String name)

Checks that the given argument is positive or zero. If it is not , throws IllegalArgumentException. Otherwise, returns the argument.

checkPositiveOrZero

public static long checkPositiveOrZero(long l,
 String name)

Checks that the given argument is positive or zero. If it is not, throws IllegalArgumentException. Otherwise, returns the argument.

checkPositiveOrZero

public static double checkPositiveOrZero(double d,
 String name)

Checks that the given argument is positive or zero. If it is not, throws IllegalArgumentException. Otherwise, returns the argument.

checkPositiveOrZero

public static float checkPositiveOrZero(float f,
 String name)

Checks that the given argument is positive or zero. If it is not, throws IllegalArgumentException. Otherwise, returns the argument.

checkInRange

public static int checkInRange(int i,
 int start,
 int end,
 String name)

Checks that the given argument is in range. If it is not, throws IllegalArgumentException. Otherwise, returns the argument.

checkInRange

public static long checkInRange(long l,
 long start,
 long end,
 String name)

Checks that the given argument is in range. If it is not, throws IllegalArgumentException. Otherwise, returns the argument.

checkInRange

public static double checkInRange(double d,
 double start,
 double end,
 String name)

Checks that the given argument is in range. If it is not, throws IllegalArgumentException. Otherwise, returns the argument.

checkNonEmpty

public static <T> T[] checkNonEmpty(T[] array,
 String name)

Checks that the given argument is neither null nor empty. If it is, throws NullPointerException or IllegalArgumentException. Otherwise, returns the argument.

checkNonEmpty

public static byte[] checkNonEmpty(byte[] array,
 String name)

Checks that the given argument is neither null nor empty. If it is, throws NullPointerException or IllegalArgumentException. Otherwise, returns the argument.

checkNonEmpty

public static char[] checkNonEmpty(char[] array,
 String name)

Checks that the given argument is neither null nor empty. If it is, throws NullPointerException or IllegalArgumentException. Otherwise, returns the argument.

checkNonEmpty

public static <T extends Collection<?>> T checkNonEmpty(T collection,
 String name)

Checks that the given argument is neither null nor empty. If it is, throws NullPointerException or IllegalArgumentException. Otherwise, returns the argument.

checkNonEmpty

public static String checkNonEmpty(String value,
 String name)

Checks that the given argument is neither null nor empty. If it is, throws NullPointerException or IllegalArgumentException. Otherwise, returns the argument.

checkNonEmpty

public static <K, V, T extends Map<K,V>> T checkNonEmpty(T value,
 String name)

Checks that the given argument is neither null nor empty. If it is, throws NullPointerException or IllegalArgumentException. Otherwise, returns the argument.

checkNonEmpty

public static CharSequence checkNonEmpty(CharSequence value,
 String name)

Checks that the given argument is neither null nor empty. If it is, throws NullPointerException or IllegalArgumentException. Otherwise, returns the argument.

checkNonEmptyAfterTrim

public static String checkNonEmptyAfterTrim(String value,
 String name)

Trims the given argument and checks whether it is neither null nor empty. If it is, throws NullPointerException or IllegalArgumentException. Otherwise, returns the trimmed argument.

Parameters:

value - to trim and check.

name - of the parameter.

Returns:

the trimmed (not the original) value.

Throws:

NullPointerException - if value is null.

IllegalArgumentException - if the trimmed value is empty.

intValue

public static int intValue(Integer wrapper,
 int defaultValue)

Resolves a possibly null Integer to a primitive int, using a default value.

Parameters:

wrapper - the wrapper

defaultValue - the default value

Returns:

the primitive value

longValue

public static long longValue(Long wrapper,
 long defaultValue)

Resolves a possibly null Long to a primitive long, using a default value.

Parameters:

wrapper - the wrapper

defaultValue - the default value

Returns:

the primitive value