Package io.smallrye.common.constraint

Class Assert

java.lang.Object

io.smallrye.common.constraint.Assert

public final class Assert
extends Object

A set of assertions and checks.

Method Summary

Modifier and Type	Method	Description
static boolean	assertFalse(boolean expr)	Assert that the given expression is always false.
static <T> T	assertHoldsLock(T monitor)	Assert that the given monitor is held by the current thread.
static <T> T	assertNotHoldsLock(T monitor)	Assert that the given monitor is not held by the current thread.
static <T> T	assertNotNull(T value)	Assert that the value is not null.
static boolean	assertTrue(boolean expr)	Assert that the given expression is always true.
static void	checkArrayBounds(byte[] array, int offs, int len)	Check that the given offset and length fall completely within the bounds of the given array.
static void	checkArrayBounds(char[] array, int offs, int len)	Check that the given offset and length fall completely within the bounds of the given array.
static void	checkArrayBounds(int[] array, int offs, int len)	Check that the given offset and length fall completely within the bounds of the given array.
static void	checkArrayBounds(int arrayLength, int offs, int len)	Check that the given offset and length fall completely within the bounds of the given array length.
static void	checkArrayBounds(long[] array, int offs, int len)	Check that the given offset and length fall completely within the bounds of the given array.
static void	checkArrayBounds(Object[] array, int offs, int len)	Check that the given offset and length fall completely within the bounds of the given array.
static void	checkMaximumParameter(String name, double max, double actual)	Check that the named parameter is less than or equal to max.
static void	checkMaximumParameter(String name, float max, float actual)	Check that the named parameter is less than or equal to max.
static void	checkMaximumParameter(String name, int max, int actual)	Check that the named parameter is less than or equal to max.
static void	checkMaximumParameter(String name, long max, long actual)	Check that the named parameter is less than or equal to max.
static <T extends Comparable<T>> void	checkMaximumParameter(String name, T max, T actual)	Check that the named parameter is less than or equal to max.
static void	checkMaximumParameterUnsigned(String name, int max, int actual)	Check that the named parameter is less than or equal to max using unsigned comparison.
static void	checkMaximumParameterUnsigned(String name, long max, long actual)	Check that the named parameter is less than or equal to max using unsigned comparison.
static void	checkMinimumParameter(String name, double min, double actual)	Check that the named parameter is greater than or equal to min.
static void	checkMinimumParameter(String name, float min, float actual)	Check that the named parameter is greater than or equal to min.
static void	checkMinimumParameter(String name, int min, int actual)	Check that the named parameter is greater than or equal to min.
static void	checkMinimumParameter(String name, long min, long actual)	Check that the named parameter is greater than or equal to min.
static <T extends Comparable<T>> void	checkMinimumParameter(String name, T min, T actual)	Check that the named parameter is greater than or equal to min.
static void	checkMinimumParameterUnsigned(String name, int min, int actual)	Check that the named parameter is greater than or equal to min using unsigned comparison.
static void	checkMinimumParameterUnsigned(String name, long min, long actual)	Check that the named parameter is greater than or equal to min using unsigned comparison.
static boolean[]	checkNotEmptyParam(String name, boolean[] value)	Check that the named parameter is not empty.
static byte[]	checkNotEmptyParam(String name, byte[] value)	Check that the named parameter is not empty.
static double[]	checkNotEmptyParam(String name, double[] value)	Check that the named parameter is not empty.
static float[]	checkNotEmptyParam(String name, float[] value)	Check that the named parameter is not empty.
static int[]	checkNotEmptyParam(String name, int[] value)	Check that the named parameter is not empty.
static long[]	checkNotEmptyParam(String name, long[] value)	Check that the named parameter is not empty.
static short[]	checkNotEmptyParam(String name, short[] value)	Check that the named parameter is not empty.
static CharSequence	checkNotEmptyParam(String name, CharSequence value)	Check that the named parameter is not empty.
static String	checkNotEmptyParam(String name, String value)	Check that the named parameter is not empty.
static <E,T extends Collection<E>> T	checkNotEmptyParam(String name, T value)	Check that the named parameter is not empty.
static <T> T[]	checkNotEmptyParam(String name, T[] value)	Check that the named parameter is not empty.
static <T> T	checkNotNullArrayParam(String name, int index, T value)	Check that a value within the named array parameter is not null.
static <T> T	checkNotNullParam(String name, T value)	Check that the named parameter is not null.
static IllegalStateException	impossibleSwitchCase(char val)	Return an exception indicating that the current switch case was intended to be unreachable.
static IllegalStateException	impossibleSwitchCase(int val)	Return an exception indicating that the current switch case was intended to be unreachable.
static IllegalStateException	impossibleSwitchCase(long val)	Return an exception indicating that the current switch case was intended to be unreachable.
static IllegalStateException	impossibleSwitchCase(Object obj)	Return an exception indicating that the current switch case was intended to be unreachable.
static IllegalStateException	unreachableCode()	Return an exception indicating that the current code was intended to be unreachable.
static UnsupportedOperationException	unsupported()	Return an exception explaining that the caller's method is not supported.

Methods inherited from class java.lang.Object

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

Method Detail

checkNotNullParam

@NotNull
public static <T> T checkNotNullParam(String name,
                                      T value)
                               throws IllegalArgumentException

Check that the named parameter is not null. Use a standard exception message if it is.

Type Parameters:

T - the value type

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is null

checkNotNullArrayParam

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

Check that a value within the named array parameter is not null. Use a standard exception message if it is.

Type Parameters:

T - the element value type

Parameters:

name - the parameter name

index - the array index

value - the array element value

Returns:

the array element value that was passed in

Throws:

IllegalArgumentException - if the value is null

checkNotEmptyParam

@NotNull
public static String checkNotEmptyParam(String name,
                                        String value)

Check that the named parameter is not empty. Use a standard exception message if it is.

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is empty

checkNotEmptyParam

@NotNull
public static CharSequence checkNotEmptyParam(String name,
                                              CharSequence value)

Check that the named parameter is not empty. Use a standard exception message if it is.

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is empty

checkNotEmptyParam

@NotNull
public static <E,T extends Collection<E>> T checkNotEmptyParam(String name,
                                                                     T value)

Check that the named parameter is not empty. Use a standard exception message if it is.

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is empty

checkNotEmptyParam

@NotNull
public static <K,V,T extends Map<K,V>> T checkNotEmptyParam(String name,
                                                                              T value)

Check that the named parameter is not empty. Use a standard exception message if it is.

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is empty

checkNotEmptyParam

@NotNull
public static <T> T[] checkNotEmptyParam(String name,
                                         T[] value)

Check that the named parameter is not empty. Use a standard exception message if it is.

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is empty

checkNotEmptyParam

@NotNull
public static boolean[] checkNotEmptyParam(String name,
                                           boolean[] value)

Check that the named parameter is not empty. Use a standard exception message if it is.

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is empty

checkNotEmptyParam

@NotNull
public static byte[] checkNotEmptyParam(String name,
                                        byte[] value)

Check that the named parameter is not empty. Use a standard exception message if it is.

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is empty

checkNotEmptyParam

@NotNull
public static short[] checkNotEmptyParam(String name,
                                         short[] value)

Check that the named parameter is not empty. Use a standard exception message if it is.

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is empty

checkNotEmptyParam

@NotNull
public static int[] checkNotEmptyParam(String name,
                                       int[] value)

Check that the named parameter is not empty. Use a standard exception message if it is.

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is empty

checkNotEmptyParam

@NotNull
public static long[] checkNotEmptyParam(String name,
                                        long[] value)

Check that the named parameter is not empty. Use a standard exception message if it is.

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is empty

checkNotEmptyParam

@NotNull
public static float[] checkNotEmptyParam(String name,
                                         float[] value)

Check that the named parameter is not empty. Use a standard exception message if it is.

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is empty

checkNotEmptyParam

@NotNull
public static double[] checkNotEmptyParam(String name,
                                          double[] value)

Check that the named parameter is not empty. Use a standard exception message if it is.

Parameters:

name - the parameter name

value - the parameter value

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the value is empty

checkMinimumParameter

public static <T extends Comparable<T>> void checkMinimumParameter(String name,
                                                                   T min,
                                                                   T actual)
                                                            throws IllegalArgumentException

Check that the named parameter is greater than or equal to min.

Type Parameters:

T - the parameter type

Parameters:

name - the parameter name

min - the minimum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is less than the minimum value

checkMinimumParameter

public static void checkMinimumParameter(String name,
                                         int min,
                                         int actual)
                                  throws IllegalArgumentException

Check that the named parameter is greater than or equal to min.

Parameters:

name - the parameter name

min - the minimum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is less than the minimum value

checkMinimumParameterUnsigned

public static void checkMinimumParameterUnsigned(String name,
                                                 int min,
                                                 int actual)
                                          throws IllegalArgumentException

Check that the named parameter is greater than or equal to min using unsigned comparison.

Parameters:

name - the parameter name

min - the minimum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is less than the minimum value

checkMinimumParameter

public static void checkMinimumParameter(String name,
                                         long min,
                                         long actual)
                                  throws IllegalArgumentException

Check that the named parameter is greater than or equal to min.

Parameters:

name - the parameter name

min - the minimum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is less than the minimum value

checkMinimumParameterUnsigned

public static void checkMinimumParameterUnsigned(String name,
                                                 long min,
                                                 long actual)
                                          throws IllegalArgumentException

Check that the named parameter is greater than or equal to min using unsigned comparison.

Parameters:

name - the parameter name

min - the minimum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is less than the minimum value

checkMinimumParameter

public static void checkMinimumParameter(String name,
                                         float min,
                                         float actual)
                                  throws IllegalArgumentException

Check that the named parameter is greater than or equal to min.

Parameters:

name - the parameter name

min - the minimum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is less than the minimum value

checkMinimumParameter

public static void checkMinimumParameter(String name,
                                         double min,
                                         double actual)
                                  throws IllegalArgumentException

Check that the named parameter is greater than or equal to min.

Parameters:

name - the parameter name

min - the minimum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is less than the minimum value

checkMaximumParameter

public static <T extends Comparable<T>> void checkMaximumParameter(String name,
                                                                   T max,
                                                                   T actual)
                                                            throws IllegalArgumentException

Check that the named parameter is less than or equal to max.

Type Parameters:

T - the parameter type

Parameters:

name - the parameter name

max - the maximum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is greater than the maximum value

checkMaximumParameter

public static void checkMaximumParameter(String name,
                                         int max,
                                         int actual)
                                  throws IllegalArgumentException

Check that the named parameter is less than or equal to max.

Parameters:

name - the parameter name

max - the maximum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is greater than the maximum value

checkMaximumParameterUnsigned

public static void checkMaximumParameterUnsigned(String name,
                                                 int max,
                                                 int actual)
                                          throws IllegalArgumentException

Check that the named parameter is less than or equal to max using unsigned comparison.

Parameters:

name - the parameter name

max - the maximum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is greater than the maximum value

checkMaximumParameter

public static void checkMaximumParameter(String name,
                                         long max,
                                         long actual)
                                  throws IllegalArgumentException

Check that the named parameter is less than or equal to max.

Parameters:

name - the parameter name

max - the maximum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is greater than the maximum value

checkMaximumParameterUnsigned

public static void checkMaximumParameterUnsigned(String name,
                                                 long max,
                                                 long actual)
                                          throws IllegalArgumentException

Check that the named parameter is less than or equal to max using unsigned comparison.

Parameters:

name - the parameter name

max - the maximum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is greater than the maximum value

checkMaximumParameter

public static void checkMaximumParameter(String name,
                                         float max,
                                         float actual)
                                  throws IllegalArgumentException

Check that the named parameter is less than or equal to max.

Parameters:

name - the parameter name

max - the maximum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is greater than the maximum value

checkMaximumParameter

public static void checkMaximumParameter(String name,
                                         double max,
                                         double actual)
                                  throws IllegalArgumentException

Check that the named parameter is less than or equal to max.

Parameters:

name - the parameter name

max - the maximum value

actual - the actual parameter value

Throws:

IllegalArgumentException - if the actual value is greater than the maximum value

checkArrayBounds

public static void checkArrayBounds(Object[] array,
                                    int offs,
                                    int len)
                             throws ArrayIndexOutOfBoundsException

Check that the given offset and length fall completely within the bounds of the given array.

Parameters:

array - the array to check

offs - the array offset

len - the array length

Throws:

ArrayIndexOutOfBoundsException - if the range of the offset and length do not fall within the array bounds

checkArrayBounds

public static void checkArrayBounds(byte[] array,
                                    int offs,
                                    int len)
                             throws ArrayIndexOutOfBoundsException

Check that the given offset and length fall completely within the bounds of the given array.

Parameters:

array - the array to check

offs - the array offset

len - the array length

Throws:

ArrayIndexOutOfBoundsException - if the range of the offset and length do not fall within the array bounds

checkArrayBounds

public static void checkArrayBounds(char[] array,
                                    int offs,
                                    int len)
                             throws ArrayIndexOutOfBoundsException

Check that the given offset and length fall completely within the bounds of the given array.

Parameters:

array - the array to check

offs - the array offset

len - the array length

Throws:

ArrayIndexOutOfBoundsException - if the range of the offset and length do not fall within the array bounds

checkArrayBounds

public static void checkArrayBounds(int[] array,
                                    int offs,
                                    int len)
                             throws ArrayIndexOutOfBoundsException

Check that the given offset and length fall completely within the bounds of the given array.

Parameters:

array - the array to check

offs - the array offset

len - the array length

Throws:

ArrayIndexOutOfBoundsException - if the range of the offset and length do not fall within the array bounds

checkArrayBounds

public static void checkArrayBounds(long[] array,
                                    int offs,
                                    int len)
                             throws ArrayIndexOutOfBoundsException

Check that the given offset and length fall completely within the bounds of the given array.

Parameters:

array - the array to check

offs - the array offset

len - the array length

Throws:

ArrayIndexOutOfBoundsException - if the range of the offset and length do not fall within the array bounds

checkArrayBounds

public static void checkArrayBounds(int arrayLength,
                                    int offs,
                                    int len)
                             throws ArrayIndexOutOfBoundsException

Check that the given offset and length fall completely within the bounds of the given array length.

Parameters:

arrayLength - the array length to check against

offs - the array offset

len - the array length

Throws:

ArrayIndexOutOfBoundsException - if the range of the offset and length do not fall within the array bounds

assertNotNull

@NotNull
public static <T> T assertNotNull(T value)

Assert that the value is not null. Use a standard assertion failure message if it is. Only runs if assert is enabled.

Type Parameters:

T - the value type

Parameters:

value - the not-null value

Returns:

the value that was passed in

assertHoldsLock

@NotNull
public static <T> T assertHoldsLock(@NotNull
                                    T monitor)

Assert that the given monitor is held by the current thread. Use a standard assertion failure message if it is not. Only runs if assert is enabled.

Type Parameters:

T - the monitor's type

Parameters:

monitor - the monitor object

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the monitor is null

assertNotHoldsLock

@NotNull
public static <T> T assertNotHoldsLock(@NotNull
                                       T monitor)

Assert that the given monitor is not held by the current thread. Use a standard assertion failure message if it is. Only runs if assert is enabled.

Type Parameters:

T - the monitor's type

Parameters:

monitor - the monitor object

Returns:

the value that was passed in

Throws:

IllegalArgumentException - if the monitor is null

assertTrue

public static boolean assertTrue(boolean expr)

Assert that the given expression is always true.

Parameters:

expr - the boolean expression

Returns:

the boolean expression

assertFalse

public static boolean assertFalse(boolean expr)

Assert that the given expression is always false.

Parameters:

expr - the boolean expression

Returns:

the boolean expression

unreachableCode

public static IllegalStateException unreachableCode()

Return an exception indicating that the current code was intended to be unreachable.

Returns:

the exception which may be immediately thrown

impossibleSwitchCase

@NotNull
public static IllegalStateException impossibleSwitchCase(@NotNull
                                                         Object obj)

Return an exception indicating that the current switch case was intended to be unreachable.

Parameters:

obj - the switch case value

Returns:

the exception which may be immediately thrown

impossibleSwitchCase

@NotNull
public static IllegalStateException impossibleSwitchCase(char val)

Return an exception indicating that the current switch case was intended to be unreachable.

Parameters:

val - the switch case value

Returns:

the exception which may be immediately thrown

impossibleSwitchCase

@NotNull
public static IllegalStateException impossibleSwitchCase(int val)

Return an exception indicating that the current switch case was intended to be unreachable.

Parameters:

val - the switch case value

Returns:

the exception which may be immediately thrown

impossibleSwitchCase

@NotNull
public static IllegalStateException impossibleSwitchCase(long val)

Return an exception indicating that the current switch case was intended to be unreachable.

Parameters:

val - the switch case value

Returns:

the exception which may be immediately thrown

unsupported

@NotNull
public static UnsupportedOperationException unsupported()

Return an exception explaining that the caller's method is not supported.

Returns:

the exception