de.gsi.dataset.utils

Class AssertUtils

java.lang.Object

de.gsi.dataset.utils.AssertUtils

public final class AssertUtils
extends Object

Utility class used to examine function parameters. All the methods throw IllegalArgumentException if the argument doesn't fulfil constraints.

Author:

rstein

Method Summary

Modifier and Type	Method and Description
static boolean	areEqual(double v1, double v2) The method returns true if both values area equal.
static void	assertType(Object obj, Class<?> type) Asserts if the specified object is an instance of the specified type.
static void	belongsToEnum(String name, int[] allowedElements, int value)
static void	checkArrayDimension(String name, boolean[] array, int defaultLength)
static void	checkArrayDimension(String name, byte[] array, int defaultLength)
static void	checkArrayDimension(String name, double[] array, int defaultLength)
static void	checkArrayDimension(String name, float[] array, int defaultLength)
static void	checkArrayDimension(String name, int[] array, int defaultLength)
static <T> void	equalArrays(T[] array1, T[] array2) Asserts that the specified arrays have the same length.
static void	equalDoubleArrays(double[] array1, double[] array2) Asserts that the specified arrays have the same length.
static void	equalDoubleArrays(double[] array1, double[] array2, int nMinSize) Asserts that the specified arrays have the same length or are at least min size.
static void	equalFloatArrays(float[] array1, float[] array2) Asserts that the specified arrays have the same length.
static void	equalFloatArrays(float[] array1, float[] array2, int nMinSize) Asserts that the specified arrays have the same length or are at least min size.
static void	gtEqThanZero(String name, double value) Checks if the int value is >= 0
static void	gtEqThanZero(String name, int value) Checks if the int value is >= 0
static <T extends Number> void	gtEqThanZero(String name, T value) Checks if the value is >= 0
static void	gtOrEqual(String name, double ref, double len) Checks if the variable is less or equal than the reference
static void	gtOrEqual(String name, float ref, float len) Checks if the variable is less or equal than the reference
static void	gtOrEqual(String name, int ref, int len) Checks if the variable is greater or equal than the reference
static void	gtOrEqual(String name, long ref, long len) Checks if the variable is less or equal than the reference
static void	gtThanZero(String name, int value) Checks if the int value is >= 0
static <T extends Number> void	gtThanZero(String name, T value) Checks if the value is >= 0
static void	indexInBounds(int index, int bounds) Checks if the index is >= 0 and < bounds
static void	indexInBounds(int index, int bounds, String message) Checks if the index is >= 0 and < bounds
static void	indexOrder(int index1, int index2, String msg) Checks if the index1 <= index2
static void	indexOrder(int index1, String name1, int index2, String name2) Checks if the index1 <= index2
static void	nonEmptyArray(String name, boolean[] array)
static void	nonEmptyArray(String name, byte[] array)
static void	nonEmptyArray(String name, double[] array)
static void	nonEmptyArray(String name, float[] array)
static void	nonEmptyArray(String name, int[] array)
static void	nonEmptyArray(String name, Object[] array)
static <T> void	notNull(String name, T obj) Checks if the object is not null.

Methods inherited from class java.lang.Object

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

Method Detail

areEqual

public static boolean areEqual(double v1,
                               double v2)

The method returns true if both values area equal. The method differs from simple == compare because it takes into account that both values can be Double.NaN, in which case == operator returns false.

Parameters:

v1 - to be checked

v2 - to be checked

Returns:

true if v1 and v2 are Double.NaN or v1 == v2.

assertType

public static void assertType(Object obj,
                              Class<?> type)

Asserts if the specified object is an instance of the specified type.

Parameters:

obj - to be checked

type - required class type

Throws:

IllegalArgumentException - in case of problems

belongsToEnum

public static void belongsToEnum(String name,
                                 int[] allowedElements,
                                 int value)

checkArrayDimension

public static void checkArrayDimension(String name,
                                       boolean[] array,
                                       int defaultLength)

checkArrayDimension

public static void checkArrayDimension(String name,
                                       byte[] array,
                                       int defaultLength)

checkArrayDimension

public static void checkArrayDimension(String name,
                                       double[] array,
                                       int defaultLength)

checkArrayDimension

public static void checkArrayDimension(String name,
                                       float[] array,
                                       int defaultLength)

checkArrayDimension

public static void checkArrayDimension(String name,
                                       int[] array,
                                       int defaultLength)

equalArrays

public static <T> void equalArrays(T[] array1,
                                   T[] array2)

Asserts that the specified arrays have the same length.

Type Parameters:

T - generics object to be checked

Parameters:

array1 - to be checked

array2 - to be checked

equalDoubleArrays

public static void equalDoubleArrays(double[] array1,
                                     double[] array2)

Asserts that the specified arrays have the same length.

Parameters:

array1 - to be checked

array2 - to be checked

equalDoubleArrays

public static void equalDoubleArrays(double[] array1,
                                     double[] array2,
                                     int nMinSize)

Asserts that the specified arrays have the same length or are at least min size.

Parameters:

array1 - to be checked

array2 - to be checked

nMinSize - minimum required size

equalFloatArrays

public static void equalFloatArrays(float[] array1,
                                    float[] array2)

Asserts that the specified arrays have the same length.

Parameters:

array1 - to be checked

array2 - to be checked

equalFloatArrays

public static void equalFloatArrays(float[] array1,
                                    float[] array2,
                                    int nMinSize)

Asserts that the specified arrays have the same length or are at least min size.

Parameters:

array1 - to be checked

array2 - to be checked

nMinSize - minimum required size

gtEqThanZero

public static void gtEqThanZero(String name,
                                double value)

Checks if the int value is >= 0

Parameters:

name - name to be included in the exception message

value - to be checked

gtEqThanZero

public static void gtEqThanZero(String name,
                                int value)

Checks if the int value is >= 0

Parameters:

name - name to be included in the exception message

value - to be checked

gtEqThanZero

public static <T extends Number> void gtEqThanZero(String name,
                                                   T value)

Checks if the value is >= 0

Type Parameters:

T - generics object to be checked

Parameters:

name - name to be included in the exception message

value - to be checked

gtThanZero

public static void gtThanZero(String name,
                              int value)

Checks if the int value is >= 0

Parameters:

name - name to be included in the exception message

value - to be checked

gtThanZero

public static <T extends Number> void gtThanZero(String name,
                                                 T value)

Checks if the value is >= 0

Type Parameters:

T - generics object to be checked

Parameters:

name - name to be included in the exception message

value - to be checked

indexInBounds

public static void indexInBounds(int index,
                                 int bounds)

Checks if the index is >= 0 and < bounds

Parameters:

index - index to be checked

bounds - maximum bound

indexInBounds

public static void indexInBounds(int index,
                                 int bounds,
                                 String message)

Checks if the index is >= 0 and < bounds

Parameters:

index - index to be checked

bounds - maximum bound

message - exception message

indexOrder

public static void indexOrder(int index1,
                              int index2,
                              String msg)

Checks if the index1 <= index2

Parameters:

index1 - index1 to be checked

index2 - index1 to be checked

msg - exception message

indexOrder

public static void indexOrder(int index1,
                              String name1,
                              int index2,
                              String name2)

Checks if the index1 <= index2

Parameters:

index1 - index1 to be checked

name1 - name of index1

index2 - index1 to be checked

name2 - name of index2

gtOrEqual

public static void gtOrEqual(String name,
                             double ref,
                             double len)

Checks if the variable is less or equal than the reference

Parameters:

name - name to be included in exception message.

ref - reference

len - object to be checked

gtOrEqual

public static void gtOrEqual(String name,
                             float ref,
                             float len)

Checks if the variable is less or equal than the reference

Parameters:

name - name to be included in exception message.

ref - reference

len - object to be checked

gtOrEqual

public static void gtOrEqual(String name,
                             int ref,
                             int len)

Checks if the variable is greater or equal than the reference

Parameters:

name - name to be included in exception message.

ref - reference

len - object to be checked

gtOrEqual

public static void gtOrEqual(String name,
                             long ref,
                             long len)

Checks if the variable is less or equal than the reference

Parameters:

name - name to be included in exception message.

ref - reference

len - object to be checked

nonEmptyArray

public static void nonEmptyArray(String name,
                                 boolean[] array)

nonEmptyArray

public static void nonEmptyArray(String name,
                                 byte[] array)

nonEmptyArray

public static void nonEmptyArray(String name,
                                 double[] array)

nonEmptyArray

public static void nonEmptyArray(String name,
                                 float[] array)

nonEmptyArray

public static void nonEmptyArray(String name,
                                 int[] array)

nonEmptyArray

public static void nonEmptyArray(String name,
                                 Object[] array)

notNull

public static <T> void notNull(String name,
                               T obj)

Checks if the object is not null.

Type Parameters:

T - generics object to be checked

Parameters:

name - name to be included in exception message.

obj - object to be checked