Spring Assert主张 (参议院检测工具的方法-主张)

Web 收到申请表格提交的数据后都需要对其进行合法性检查，假设表单数据是不合法的，该请求将被拒绝。分类似的，当我们写的类方法，该方法还经常需要组合成参法国检查。假设参议院不符合要求，方法通过抛出异常的方法也许是拒绝治疗。有关示例：：InputStream getData(String file)。为了使方法可以成功运行，必须保证 file 入參不能为 null 或空白字符，否则根本无须进行后继的处理。

这时方法的编写者一般会在方法体的最前面编写一段对入參进行检測的代码，例如以下所看到的：

public InputStream getData(String file) {
    if (file == null || file.length() == 0|| file.replaceAll("\s", "").length() == 0) {
        throw new IllegalArgumentException("file入參不是有效的文件地址");
    }
…
}

类似以上检測方法入參的代码是很常见，可是在每一个方法中都使用手工编写检測逻辑的方式并非一个好主意。阅读 Spring 源代码，您会发现 Spring 採用一个 org.springframework.util.Assert 通用类完毕这一任务。

Assert 翻译为中文为“断言”，使用过 JUnit 的读者都熟知这个概念，它断定某一个实际的执行值和预期想一样，否则就抛出异常。

Spring 对方法入參的检測借用了这个概念，其提供的 Assert 类拥有众多按规则对方法入參进行断言的方法。能够满足大部分方法入參检測的要求。这些断言方法在入參不满足要求时就会抛出 IllegalArgumentException。以下，我们来认识一下 Assert 类中的经常使用断言方法：
Spring Assert的全部方法：

断言方法说明
1. notNull(Object object)
当 object 不为 null 时抛出异常，notNull(Object object, String message) 方法同意您通过 message 定制异常信息。

和 notNull() 方法断言规则相反的方法是 isNull(Object object)/isNull(Object object, String message)，它要求入參一定是 null；

2. isTrue(boolean expression) / isTrue(boolean expression, String message)
当 expression 不为 true 抛出异常；

3. notEmpty(Collection collection) / notEmpty(Collection collection, String message)
当集合未包括元素时抛出异常。
notEmpty(Map map) / notEmpty(Map map, String message) 和 notEmpty(Object[] array, String message) / notEmpty(Object[] array, String message) 分别对 Map 和 Object[] 类型的入參进行推断；

4. hasLength(String text) / hasLength(String text, String message)

当 text 为 null 或长度为 0 时抛出异常；

5. hasText(String text) / hasText(String text, String message)

text 不能为 null 且必须至少包括一个非空格的字符。否则抛出异常。

6. isInstanceOf(Class clazz, Object obj) / isInstanceOf(Class type, Object obj, String message)

假设 obj 不能被正确造型为 clazz 指定的类将抛出异常。

7. isAssignable(Class superType, Class subType) / isAssignable(Class superType, Class subType, String message)

subType 必须能够按类型匹配于 superType。否则将抛出异常；

使用 Assert 断言类能够简化方法入參检測的代码。如 InputStream getData(String file) 在应用 Assert 断言类后。其代码能够简化为下面的形式：

public InputStream getData(String file){
Assert.hasText(file,"file入參不是有效的文件地址");
① 采用 Spring 断言类的方法来检测参议院
…
}