Validate (bboss-util 5.6.9 API)

java.lang.Object
- org.frameworkset.util.Validate

```
public class Validate
extends java.lang.Object
```
This class assists in validating arguments.

The class is based along the lines of JUnit. If an argument value is deemed invalid, an IllegalArgumentException is thrown. For example:
```
 Validate.isTrue( i > 0, "The value must be greater than zero: ", i);
 Validate.notNull( surname, "The surname must not be null");
 
```
从以下版本开始:

2.0

构造器概要

构造器
构造器和说明

Validate()
Constructor.

构造器
构造器和说明
`Validate()` Constructor.

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static void`	`allElementsOfType(java.util.Collection collection, java.lang.Class clazz)` Validate an argument, throwing `IllegalArgumentException` if the argument collection is `null` or has elements that are not of type `clazz` or a subclass.
`static void`	`allElementsOfType(java.util.Collection collection, java.lang.Class clazz, java.lang.String message)` Validate an argument, throwing `IllegalArgumentException` if the argument collection is `null` or has elements that are not of type `clazz` or a subclass.
`static void`	`isTrue(boolean expression)` Validate that the argument condition is `true`; otherwise throwing an exception.
`static void`	`isTrue(boolean expression, java.lang.String message)` Validate that the argument condition is `true`; otherwise throwing an exception with the specified message.
`static void`	`isTrue(boolean expression, java.lang.String message, double value)` Validate that the argument condition is `true`; otherwise throwing an exception with the specified message.
`static void`	`isTrue(boolean expression, java.lang.String message, long value)` Validate that the argument condition is `true`; otherwise throwing an exception with the specified message.
`static void`	`isTrue(boolean expression, java.lang.String message, java.lang.Object value)` Validate that the argument condition is `true`; otherwise throwing an exception with the specified message.
`static void`	`noNullElements(java.util.Collection collection)` Validate that the specified argument collection is neither `null` nor contains any elements that are `null`; otherwise throwing an exception.
`static void`	`noNullElements(java.util.Collection collection, java.lang.String message)` Validate that the specified argument collection is neither `null` nor contains any elements that are `null`; otherwise throwing an exception with the specified message.
`static void`	`noNullElements(java.lang.Object[] array)` Validate that the specified argument array is neither `null` nor contains any elements that are `null`; otherwise throwing an exception.
`static void`	`noNullElements(java.lang.Object[] array, java.lang.String message)` Validate that the specified argument array is neither `null` nor contains any elements that are `null`; otherwise throwing an exception with the specified message.
`static void`	`notEmpty(java.util.Collection collection)` Validate that the specified argument collection is neither `null` nor a size of zero (no elements); otherwise throwing an exception.
`static void`	`notEmpty(java.util.Collection collection, java.lang.String message)` Validate that the specified argument collection is neither `null` nor a size of zero (no elements); otherwise throwing an exception with the specified message.
`static void`	`notEmpty(java.util.Map map)` Validate that the specified argument map is neither `null` nor a size of zero (no elements); otherwise throwing an exception.
`static void`	`notEmpty(java.util.Map map, java.lang.String message)` Validate that the specified argument map is neither `null` nor a size of zero (no elements); otherwise throwing an exception with the specified message.
`static void`	`notEmpty(java.lang.Object[] array)` Validate that the specified argument array is neither `null` nor a length of zero (no elements); otherwise throwing an exception.
`static void`	`notEmpty(java.lang.Object[] array, java.lang.String message)` Validate that the specified argument array is neither `null` nor a length of zero (no elements); otherwise throwing an exception with the specified message.
`static void`	`notEmpty(java.lang.String string)` Validate that the specified argument string is neither `null` nor a length of zero (no characters); otherwise throwing an exception with the specified message.
`static void`	`notEmpty(java.lang.String string, java.lang.String message)` Validate that the specified argument string is neither `null` nor a length of zero (no characters); otherwise throwing an exception with the specified message.
`static void`	`notNull(java.lang.Object object)` Validate that the specified argument is not `null`; otherwise throwing an exception.
`static void`	`notNull(java.lang.Object object, java.lang.String message)` Validate that the specified argument is not `null`; otherwise throwing an exception with the specified message.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - Validate
```
public Validate()
```
    Constructor. This class should not normally be instantiated.
- 方法详细资料
  - isTrue
```
public static void isTrue(boolean expression,
                          java.lang.String message,
                          java.lang.Object value)
```
    Validate that the argument condition is true; otherwise throwing an exception with the specified message. This method is useful when validating according to an arbitrary boolean expression, such as validating an object or using your own custom validation expression.
```
Validate.isTrue( myObject.isOk(), "The object is not OK: ", myObject);
```
    For performance reasons, the object value is passed as a separate parameter and appended to the exception message only in the case of an error.
    参数:
    
    expression - the boolean expression to check
    
    message - the exception message if invalid
    
    value - the value to append to the message when invalid
    
    抛出:
    
    java.lang.IllegalArgumentException - if expression is false
  - isTrue
```
public static void isTrue(boolean expression,
                          java.lang.String message,
                          long value)
```
    Validate that the argument condition is true; otherwise throwing an exception with the specified message. This method is useful when validating according to an arbitrary boolean expression, such as validating a primitive number or using your own custom validation expression.
```
Validate.isTrue(i > 0.0, "The value must be greater than zero: ", i);
```
    For performance reasons, the long value is passed as a separate parameter and appended to the exception message only in the case of an error.
    参数:
    
    expression - the boolean expression to check
    
    message - the exception message if invalid
    
    value - the value to append to the message when invalid
    
    抛出:
    
    java.lang.IllegalArgumentException - if expression is false
  - isTrue
```
public static void isTrue(boolean expression,
                          java.lang.String message,
                          double value)
```
    Validate that the argument condition is true; otherwise throwing an exception with the specified message. This method is useful when validating according to an arbitrary boolean expression, such as validating a primitive number or using your own custom validation expression.
```
Validate.isTrue(d > 0.0, "The value must be greater than zero: ", d);
```
    For performance reasons, the double value is passed as a separate parameter and appended to the exception message only in the case of an error.
    参数:
    
    expression - the boolean expression to check
    
    message - the exception message if invalid
    
    value - the value to append to the message when invalid
    
    抛出:
    
    java.lang.IllegalArgumentException - if expression is false
  - isTrue
```
public static void isTrue(boolean expression,
                          java.lang.String message)
```
    Validate that the argument condition is true; otherwise throwing an exception with the specified message. This method is useful when validating according to an arbitrary boolean expression, such as validating a primitive number or using your own custom validation expression.
```
 Validate.isTrue( (i > 0), "The value must be greater than zero");
 Validate.isTrue( myObject.isOk(), "The object is not OK");
 
```
    参数:
    
    expression - the boolean expression to check
    
    message - the exception message if invalid
    
    抛出:
    
    java.lang.IllegalArgumentException - if expression is false
  - isTrue
```
public static void isTrue(boolean expression)
```
    Validate that the argument condition is true; otherwise throwing an exception. This method is useful when validating according to an arbitrary boolean expression, such as validating a primitive number or using your own custom validation expression.
```
 Validate.isTrue(i > 0);
 Validate.isTrue(myObject.isOk());
```
    The message of the exception is "The validated expression is false".
    参数:
    
    expression - the boolean expression to check
    
    抛出:
    
    java.lang.IllegalArgumentException - if expression is false
  - notNull
```
public static void notNull(java.lang.Object object)
```
    Validate that the specified argument is not null; otherwise throwing an exception.
```
Validate.notNull(myObject);
```
    The message of the exception is "The validated object is null".
    参数:
    
    object - the object to check
    
    抛出:
    
    java.lang.IllegalArgumentException - if the object is null
  - notNull
```
public static void notNull(java.lang.Object object,
                           java.lang.String message)
```
    Validate that the specified argument is not null; otherwise throwing an exception with the specified message.
```
Validate.notNull(myObject, "The object must not be null");
```
    参数:
    
    object - the object to check
    
    message - the exception message if invalid
  - notEmpty
```
public static void notEmpty(java.lang.Object[] array,
                            java.lang.String message)
```
    Validate that the specified argument array is neither null nor a length of zero (no elements); otherwise throwing an exception with the specified message.
```
Validate.notEmpty(myArray, "The array must not be empty");
```
    参数:
    
    array - the array to check
    
    message - the exception message if invalid
    
    抛出:
    
    java.lang.IllegalArgumentException - if the array is empty
  - notEmpty
```
public static void notEmpty(java.lang.Object[] array)
```
    Validate that the specified argument array is neither null nor a length of zero (no elements); otherwise throwing an exception.
```
Validate.notEmpty(myArray);
```
    The message in the exception is "The validated array is empty".
    参数:
    
    array - the array to check
    
    抛出:
    
    java.lang.IllegalArgumentException - if the array is empty
  - notEmpty
```
public static void notEmpty(java.util.Collection collection,
                            java.lang.String message)
```
    Validate that the specified argument collection is neither null nor a size of zero (no elements); otherwise throwing an exception with the specified message.
```
Validate.notEmpty(myCollection, "The collection must not be empty");
```
    参数:
    
    collection - the collection to check
    
    message - the exception message if invalid
    
    抛出:
    
    java.lang.IllegalArgumentException - if the collection is empty
  - notEmpty
```
public static void notEmpty(java.util.Collection collection)
```
    Validate that the specified argument collection is neither null nor a size of zero (no elements); otherwise throwing an exception.
```
Validate.notEmpty(myCollection);
```
    The message in the exception is "The validated collection is empty".
    参数:
    
    collection - the collection to check
    
    抛出:
    
    java.lang.IllegalArgumentException - if the collection is empty
  - notEmpty
```
public static void notEmpty(java.util.Map map,
                            java.lang.String message)
```
    Validate that the specified argument map is neither null nor a size of zero (no elements); otherwise throwing an exception with the specified message.
```
Validate.notEmpty(myMap, "The map must not be empty");
```
    参数:
    
    map - the map to check
    
    message - the exception message if invalid
    
    抛出:
    
    java.lang.IllegalArgumentException - if the map is empty
  - notEmpty
```
public static void notEmpty(java.util.Map map)
```
    Validate that the specified argument map is neither null nor a size of zero (no elements); otherwise throwing an exception.
```
Validate.notEmpty(myMap);
```
    The message in the exception is "The validated map is empty".
    参数:
    
    map - the map to check
    
    抛出:
    
    java.lang.IllegalArgumentException - if the map is empty
    
    另请参阅:
    
    #notEmpty(Map, String, Object...)
  - notEmpty
```
public static void notEmpty(java.lang.String string,
                            java.lang.String message)
```
    Validate that the specified argument string is neither null nor a length of zero (no characters); otherwise throwing an exception with the specified message.
```
Validate.notEmpty(myString, "The string must not be empty");
```
    参数:
    
    string - the string to check
    
    message - the exception message if invalid
    
    抛出:
    
    java.lang.IllegalArgumentException - if the string is empty
  - notEmpty
```
public static void notEmpty(java.lang.String string)
```
    Validate that the specified argument string is neither null nor a length of zero (no characters); otherwise throwing an exception with the specified message.
```
Validate.notEmpty(myString);
```
    The message in the exception is "The validated string is empty".
    参数:
    
    string - the string to check
    
    抛出:
    
    java.lang.IllegalArgumentException - if the string is empty
  - noNullElements
```
public static void noNullElements(java.lang.Object[] array,
                                  java.lang.String message)
```
    Validate that the specified argument array is neither null nor contains any elements that are null; otherwise throwing an exception with the specified message.
```
Validate.noNullElements(myArray, "The array contain null at position %d");
```
    If the array is null, then the message in the exception is "The validated object is null".
    参数:
    
    array - the array to check
    
    message - the exception message if the collection has null elements
    
    抛出:
    
    java.lang.IllegalArgumentException - if the array is null or an element in the array is null
  - noNullElements
```
public static void noNullElements(java.lang.Object[] array)
```
    Validate that the specified argument array is neither null nor contains any elements that are null; otherwise throwing an exception.
```
Validate.noNullElements(myArray);
```
    If the array is null, then the message in the exception is "The validated object is null".
    
    If the array has a null element, then the message in the exception is "The validated array contains null element at index: " followed by the index.
    参数:
    
    array - the array to check
    
    抛出:
    
    java.lang.IllegalArgumentException - if the array is null or an element in the array is null
  - noNullElements
```
public static void noNullElements(java.util.Collection collection,
                                  java.lang.String message)
```
    Validate that the specified argument collection is neither null nor contains any elements that are null; otherwise throwing an exception with the specified message.
```
Validate.noNullElements(myCollection, "The collection contains null elements");
```
    If the collection is null, then the message in the exception is "The validated object is null".
    参数:
    
    collection - the collection to check
    
    message - the exception message if the collection has
    
    抛出:
    
    java.lang.IllegalArgumentException - if the collection is null or an element in the collection is null
  - noNullElements
```
public static void noNullElements(java.util.Collection collection)
```
    Validate that the specified argument collection is neither null nor contains any elements that are null; otherwise throwing an exception.
```
Validate.noNullElements(myCollection);
```
    If the collection is null, then the message in the exception is "The validated object is null".
    
    If the collection has a null element, then the message in the exception is "The validated collection contains null element at index: " followed by the index.
    参数:
    
    collection - the collection to check
    
    抛出:
    
    java.lang.IllegalArgumentException - if the collection is null or an element in the collection is null
  - allElementsOfType
```
public static void allElementsOfType(java.util.Collection collection,
                                     java.lang.Class clazz,
                                     java.lang.String message)
```
    Validate an argument, throwing IllegalArgumentException if the argument collection is null or has elements that are not of type clazz or a subclass.
```
 Validate.allElementsOfType(collection, String.class, "Collection has invalid elements");
 
```
    参数:
    
    collection - the collection to check, not null
    
    clazz - the Class which the collection's elements are expected to be, not null
    
    message - the exception message if the Collection has elements not of type clazz
    
    从以下版本开始:
    
    2.1
  - allElementsOfType
```
public static void allElementsOfType(java.util.Collection collection,
                                     java.lang.Class clazz)
```
    Validate an argument, throwing IllegalArgumentException if the argument collection is null or has elements that are not of type clazz or a subclass.
```
 Validate.allElementsOfType(collection, String.class);
 
```
    The message in the exception is 'The validated collection contains an element not of type clazz at index: '.
    参数:
    
    collection - the collection to check, not null
    
    clazz - the Class which the collection's elements are expected to be, not null
    
    从以下版本开始:
    
    2.1

类 Validate

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

Validate

方法详细资料

isTrue

isTrue

isTrue

isTrue

isTrue

notNull

notNull

notEmpty

notEmpty

notEmpty

notEmpty

notEmpty

notEmpty

notEmpty

notEmpty

noNullElements

noNullElements

noNullElements

noNullElements

allElementsOfType

allElementsOfType