public final class Assert
extends java.lang.Object
限定符和类型 | 方法和说明 |
---|---|
static void |
doesNotContain(java.lang.String textToSearch,
java.lang.String substring)
Assert that the given text does not contain the given substring.
|
static void |
doesNotContain(java.lang.String textToSearch,
java.lang.String substring,
java.lang.String message)
Assert that the given text does not contain the given substring.
|
static void |
hasLength(java.lang.String text)
Assert that the given String is not empty; that is,
it must not be
null and not the empty String. |
static void |
hasLength(java.lang.String text,
java.lang.String message)
Assert that the given String is not empty; that is,
it must not be
null and not the empty String. |
static void |
hasText(java.lang.String text)
Assert that the given String has valid text content; that is, it must not
be
null and must contain at least one non-whitespace character. |
static void |
hasText(java.lang.String text,
java.lang.String message)
Assert that the given String has valid text content; that is, it must not
be
null and must contain at least one non-whitespace character. |
static void |
isAssignable(java.lang.Class superType,
java.lang.Class subType)
Assert that
superType.isAssignableFrom(subType) is true . |
static void |
isAssignable(java.lang.Class superType,
java.lang.Class subType,
java.lang.String message)
Assert that
superType.isAssignableFrom(subType) is true . |
static void |
isInstanceOf(java.lang.Class clazz,
java.lang.Object obj)
Assert that the provided object is an instance of the provided class.
|
static void |
isInstanceOf(java.lang.Class type,
java.lang.Object obj,
java.lang.String message)
Assert that the provided object is an instance of the provided class.
|
static void |
isNull(java.lang.Object object)
Assert that an object is
null . |
static void |
isNull(java.lang.Object object,
java.lang.String message)
Assert that an object is
null . |
static void |
isTrue(boolean expression)
Assert a boolean expression, throwing
IllegalArgumentException
if the test result is false . |
static void |
isTrue(boolean expression,
java.lang.String message)
Assert a boolean expression, throwing
IllegalArgumentException
if the test result is false . |
static void |
noNullElements(java.lang.Object[] array)
Assert that an array has no null elements.
|
static void |
noNullElements(java.lang.Object[] array,
java.lang.String message)
Assert that an array has no null elements.
|
static void |
notEmpty(byte[] array,
java.lang.String msg) |
static void |
notEmpty(java.util.Collection collection)
Assert that a collection has elements; that is, it must not be
null and must have at least one element. |
static void |
notEmpty(java.util.Collection collection,
java.lang.String message)
Assert that a collection has elements; that is, it must not be
null and must have at least one element. |
static void |
notEmpty(java.util.Map map)
Assert that a Map has entries; that is, it must not be
null
and must have at least one entry. |
static void |
notEmpty(java.util.Map map,
java.lang.String message)
Assert that a Map has entries; that is, it must not be
null
and must have at least one entry. |
static void |
notEmpty(java.lang.Object[] array)
Assert that an array has elements; that is, it must not be
null and must have at least one element. |
static void |
notEmpty(java.lang.Object[] array,
java.lang.String message)
Assert that an array has elements; that is, it must not be
null and must have at least one element. |
static void |
notNull(java.lang.Object object)
Assert that an object is not
null . |
static void |
notNull(java.lang.Object object,
java.lang.String message)
Assert that an object is not
null . |
static void |
state(boolean expression)
Assert a boolean expression, throwing
IllegalStateException
if the test result is false . |
static void |
state(boolean expression,
java.lang.String message)
Assert a boolean expression, throwing
IllegalStateException
if the test result is false . |
public static void isTrue(boolean expression, java.lang.String message)
IllegalArgumentException
if the test result is false
.
Assert.isTrue(i > 0, "The value must be greater than zero");
expression
- a boolean expressionmessage
- the exception message to use if the assertion failsjava.lang.IllegalArgumentException
- if expression is false
public static void isTrue(boolean expression)
IllegalArgumentException
if the test result is false
.
Assert.isTrue(i > 0);
expression
- a boolean expressionjava.lang.IllegalArgumentException
- if expression is false
public static void isNull(java.lang.Object object, java.lang.String message)
null
.
Assert.isNull(value, "The value must be null");
object
- the object to checkmessage
- the exception message to use if the assertion failsjava.lang.IllegalArgumentException
- if the object is not null
public static void isNull(java.lang.Object object)
null
.
Assert.isNull(value);
object
- the object to checkjava.lang.IllegalArgumentException
- if the object is not null
public static void notNull(java.lang.Object object, java.lang.String message)
null
.
Assert.notNull(clazz, "The class must not be null");
object
- the object to checkmessage
- the exception message to use if the assertion failsjava.lang.IllegalArgumentException
- if the object is null
public static void notNull(java.lang.Object object)
null
.
Assert.notNull(clazz);
object
- the object to checkjava.lang.IllegalArgumentException
- if the object is null
public static void hasLength(java.lang.String text, java.lang.String message)
null
and not the empty String.
Assert.hasLength(name, "Name must not be empty");
text
- the String to checkmessage
- the exception message to use if the assertion failsStrings.hasLength(java.lang.CharSequence)
public static void hasLength(java.lang.String text)
null
and not the empty String.
Assert.hasLength(name);
text
- the String to checkStrings.hasLength(java.lang.CharSequence)
public static void hasText(java.lang.String text, java.lang.String message)
null
and must contain at least one non-whitespace character.
Assert.hasText(name, "'name' must not be empty");
text
- the String to checkmessage
- the exception message to use if the assertion failsStrings.hasText(java.lang.CharSequence)
public static void hasText(java.lang.String text)
null
and must contain at least one non-whitespace character.
Assert.hasText(name, "'name' must not be empty");
text
- the String to checkStrings.hasText(java.lang.CharSequence)
public static void doesNotContain(java.lang.String textToSearch, java.lang.String substring, java.lang.String message)
Assert.doesNotContain(name, "rod", "Name must not contain 'rod'");
textToSearch
- the text to searchsubstring
- the substring to find within the textmessage
- the exception message to use if the assertion failspublic static void doesNotContain(java.lang.String textToSearch, java.lang.String substring)
Assert.doesNotContain(name, "rod");
textToSearch
- the text to searchsubstring
- the substring to find within the textpublic static void notEmpty(java.lang.Object[] array, java.lang.String message)
null
and must have at least one element.
Assert.notEmpty(array, "The array must have elements");
array
- the array to checkmessage
- the exception message to use if the assertion failsjava.lang.IllegalArgumentException
- if the object array is null
or has no elementspublic static void notEmpty(java.lang.Object[] array)
null
and must have at least one element.
Assert.notEmpty(array);
array
- the array to checkjava.lang.IllegalArgumentException
- if the object array is null
or has no elementspublic static void notEmpty(byte[] array, java.lang.String msg)
public static void noNullElements(java.lang.Object[] array, java.lang.String message)
Assert.noNullElements(array, "The array must have non-null elements");
array
- the array to checkmessage
- the exception message to use if the assertion failsjava.lang.IllegalArgumentException
- if the object array contains a null
elementpublic static void noNullElements(java.lang.Object[] array)
Assert.noNullElements(array);
array
- the array to checkjava.lang.IllegalArgumentException
- if the object array contains a null
elementpublic static void notEmpty(java.util.Collection collection, java.lang.String message)
null
and must have at least one element.
Assert.notEmpty(collection, "Collection must have elements");
collection
- the collection to checkmessage
- the exception message to use if the assertion failsjava.lang.IllegalArgumentException
- if the collection is null
or has no elementspublic static void notEmpty(java.util.Collection collection)
null
and must have at least one element.
Assert.notEmpty(collection, "Collection must have elements");
collection
- the collection to checkjava.lang.IllegalArgumentException
- if the collection is null
or has no elementspublic static void notEmpty(java.util.Map map, java.lang.String message)
null
and must have at least one entry.
Assert.notEmpty(map, "Map must have entries");
map
- the map to checkmessage
- the exception message to use if the assertion failsjava.lang.IllegalArgumentException
- if the map is null
or has no entriespublic static void notEmpty(java.util.Map map)
null
and must have at least one entry.
Assert.notEmpty(map);
map
- the map to checkjava.lang.IllegalArgumentException
- if the map is null
or has no entriespublic static void isInstanceOf(java.lang.Class clazz, java.lang.Object obj)
Assert.instanceOf(Foo.class, foo);
clazz
- the required classobj
- the object to checkjava.lang.IllegalArgumentException
- if the object is not an instance of clazzClass.isInstance(java.lang.Object)
public static void isInstanceOf(java.lang.Class type, java.lang.Object obj, java.lang.String message)
Assert.instanceOf(Foo.class, foo);
type
- the type to check againstobj
- the object to checkmessage
- a message which will be prepended to the message produced by
the function itself, and which may be used to provide context. It should
normally end in a ": " or ". " so that the function generate message looks
ok when prepended to it.java.lang.IllegalArgumentException
- if the object is not an instance of clazzClass.isInstance(java.lang.Object)
public static void isAssignable(java.lang.Class superType, java.lang.Class subType)
superType.isAssignableFrom(subType)
is true
.
Assert.isAssignable(Number.class, myClass);
superType
- the super type to checksubType
- the sub type to checkjava.lang.IllegalArgumentException
- if the classes are not assignablepublic static void isAssignable(java.lang.Class superType, java.lang.Class subType, java.lang.String message)
superType.isAssignableFrom(subType)
is true
.
Assert.isAssignable(Number.class, myClass);
superType
- the super type to check againstsubType
- the sub type to checkmessage
- a message which will be prepended to the message produced by
the function itself, and which may be used to provide context. It should
normally end in a ": " or ". " so that the function generate message looks
ok when prepended to it.java.lang.IllegalArgumentException
- if the classes are not assignablepublic static void state(boolean expression, java.lang.String message)
IllegalStateException
if the test result is false
. Call isTrue if you wish to
throw IllegalArgumentException on an assertion failure.
Assert.state(id == null, "The id property must not already be initialized");
expression
- a boolean expressionmessage
- the exception message to use if the assertion failsjava.lang.IllegalStateException
- if expression is false
public static void state(boolean expression)
IllegalStateException
if the test result is false
.
Call isTrue(boolean)
if you wish to
throw IllegalArgumentException
on an assertion failure.
Assert.state(id == null);
expression
- a boolean expressionjava.lang.IllegalStateException
- if the supplied expression is false