cn.sliew.milky.common.check

枚举 Ensures

java.lang.Object

java.lang.Enum<Ensures>

cn.sliew.milky.common.check.Ensures

所有已实现的接口:

Serializable, Comparable<Ensures>

public enum Ensures
extends Enum<Ensures>

Static convenience methods that help a method or constructor check whether it was invoked correctly.

Other types of preconditions

Not every type of precondition failure is supported by these methods. Continue to throw standard JDK exceptions such as NoSuchElementException or UnsupportedOperationException in the situations they are intended for.

href="https://github.com/google/guava/wiki/ConditionalFailuresExplained">Conditional failures explained

java.util.Objects.requireNonNull()

Projects which use com.google.common should generally avoid the use of Objects.requireNonNull(Object). Instead, use whichever of checkNotNull(Object) or Verify#verifyNotNull(Object) is appropriate to the situation. (The same goes for the message-accepting overloads.)

方法概要

限定符和类型	方法和说明
static void	checkArgument(boolean expression)
static void	checkArgument(boolean expression, Supplier<Object> errorMessage)
static <T> T	checkNotNull(T reference)
static <T> T	checkNotNull(T reference, Supplier<Object> errorMessage)
static void	checkState(boolean expression)
static void	checkState(boolean expression, Supplier<Object> errorMessage)
static void	condition(boolean predicate) Assert that the supplied predicate is true.
static void	condition(boolean predicate, Supplier<Object> errorMessage) Assert that the supplied predicate is true.
static String	notBlank(String str) Assert that the supplied String is not blank.
static String	notBlank(String str, Supplier<Object> errorMessage) Assert that the supplied String is not blank.
static <T extends Collection<?>> T	notEmpty(T collection) Assert that the supplied Collection is neither null nor empty.
static <T> T[]	notEmpty(T[] array) Assert that the supplied array is neither null nor empty.
static <T> T[]	notEmpty(T[] array, Supplier<Object> errorMessage) Assert that the supplied array is neither null nor empty.
static <T extends Collection<?>> T	notEmpty(T collection, Supplier<Object> errorMessage) Assert that the supplied Collection is neither null nor empty.
static Ensures	valueOf(String name) 返回带有指定名称的该类型的枚举常量。
static Ensures[]	values() 按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。

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

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

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

getClass, notify, notifyAll, wait, wait, wait

方法详细资料

values

public static Ensures[] values()

按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。该方法可用于迭代 常量, 如下所示:

for (Ensures c : Ensures.values())
    System.out.println(c);

返回:

按照声明该枚举类型的常量的顺序返回的包含这些常量的数组

valueOf

public static Ensures valueOf(String name)

返回带有指定名称的该类型的枚举常量。 字符串必须与用于声明该类型的枚举常量的 标识符完全匹配。(不允许有多余 的空格字符。)

参数:

name - 要返回的枚举常量的名称。

返回:

返回带有指定名称的枚举常量

抛出:

IllegalArgumentException - 如果该枚举类型没有带有指定名称的常量

NullPointerException - 如果参数为空值

checkArgument

public static void checkArgument(boolean expression)

checkArgument

public static void checkArgument(boolean expression,
                                 Supplier<Object> errorMessage)

checkState

public static void checkState(boolean expression)

checkState

public static void checkState(boolean expression,
                              Supplier<Object> errorMessage)

checkNotNull

public static <T> T checkNotNull(T reference)

checkNotNull

public static <T> T checkNotNull(T reference,
                                 Supplier<Object> errorMessage)

notEmpty

public static <T> T[] notEmpty(T[] array)

Assert that the supplied array is neither null nor empty.

WARNING: this method does NOT check if the supplied array contains any null elements.

参数:

array - the array to check

返回:

the supplied array as a convenience

抛出:

IllegalStateException - if the supplied array is null or empty

另请参阅:

condition(boolean)

notEmpty

public static <T> T[] notEmpty(T[] array,
                               Supplier<Object> errorMessage)

Assert that the supplied array is neither null nor empty.

WARNING: this method does NOT check if the supplied array contains any null elements.

参数:

array - the array to check

errorMessage - precondition violation message supplier

返回:

the supplied array as a convenience

抛出:

IllegalStateException - if the supplied array is null or empty

另请参阅:

condition(boolean, Supplier)

notEmpty

public static <T extends Collection<?>> T notEmpty(T collection)

Assert that the supplied Collection is neither null nor empty.

WARNING: this method does NOT check if the supplied collection contains any null elements.

参数:

collection - the collection to check

返回:

the supplied collection as a convenience

抛出:

IllegalStateException - if the supplied collection is null or empty

另请参阅:

condition(boolean)

notEmpty

public static <T extends Collection<?>> T notEmpty(T collection,
                                                   Supplier<Object> errorMessage)

Assert that the supplied Collection is neither null nor empty.

WARNING: this method does NOT check if the supplied collection contains any null elements.

参数:

collection - the collection to check

errorMessage - precondition violation message supplier

返回:

the supplied collection as a convenience

抛出:

IllegalStateException - if the supplied collection is null or empty

另请参阅:

condition(boolean, Supplier)

notBlank

public static String notBlank(String str)

Assert that the supplied String is not blank.

A String is blank if it is null or consists only of whitespace characters.

参数:

str - the string to check

返回:

the supplied string as a convenience

抛出:

IllegalStateException - if the supplied string is blank

另请参阅:

notBlank(String, Supplier)

notBlank

public static String notBlank(String str,
                              Supplier<Object> errorMessage)

Assert that the supplied String is not blank.

A String is blank if it is null or consists only of whitespace characters.

参数:

str - the string to check

errorMessage - precondition violation message supplier

返回:

the supplied string as a convenience

抛出:

IllegalStateException - if the supplied string is blank

另请参阅:

StringUtils.isNotBlank(String), condition(boolean, Supplier)

condition

public static void condition(boolean predicate)

Assert that the supplied predicate is true.

参数:

predicate - the predicate to check

抛出:

IllegalStateException - if the predicate is false

另请参阅:

condition(boolean, Supplier)

condition

public static void condition(boolean predicate,
                             Supplier<Object> errorMessage)

Assert that the supplied predicate is true.

参数:

predicate - the predicate to check

errorMessage - precondition violation message supplier

抛出:

IllegalStateException - if the predicate is false