- java.lang.Object
-
- io.netty5.util.internal.ObjectUtil
-
public final class ObjectUtil extends Object
A grab-bag of useful utility methods.
-
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description 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 <T extends Collection<?>>
TcheckNonEmpty(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
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 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.
-
-
-
Method Detail
-
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, throwsNullPointerException
. 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, throwsIllegalArgumentException
. 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, throwsIllegalArgumentException
. Otherwise, returns the argument.- Type Parameters:
T
- type of the given argument value.- Parameters:
name
- of the parameter, belongs to the exception message.index
- of the array, belongs to the exception message.value
- to check.- 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, throwsIllegalArgumentException
. 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, throwsIllegalArgumentException
. 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, throwsIllegalArgumentException
. 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, throwsIllegalArgumentException
. 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 , throwsIllegalArgumentException
. 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, throwsIllegalArgumentException
. 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, throwsIllegalArgumentException
. 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, throwsIllegalArgumentException
. 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, throwsIllegalArgumentException
. 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, throwsIllegalArgumentException
. 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, throwsNullPointerException
orIllegalArgumentException
. 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, throwsNullPointerException
orIllegalArgumentException
. 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, throwsNullPointerException
orIllegalArgumentException
. 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, throwsNullPointerException
orIllegalArgumentException
. 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, throwsNullPointerException
orIllegalArgumentException
. 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, throwsNullPointerException
orIllegalArgumentException
. 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, throwsNullPointerException
orIllegalArgumentException
. 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, throwsNullPointerException
orIllegalArgumentException
. 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 wrapperdefaultValue
- 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 wrapperdefaultValue
- the default value- Returns:
- the primitive value
-
-