Spring中Assert工具类的用法

个人分类： spring java

Spring在提供一个强大的应用开发框架的同时也提供了很多优秀的开发工具类，合理的运用这些工具，将有助于提高开发效率、增强代码质量。下面就最常用的Assert工具类，简要介绍一下它的用法。
**Assert断言工具类，通常用于数据合法性检查**，在JAVA编程中，通常会编写如下代码：  

if (name == null || name.equls(“”)) { 
    throw new IllegalArgumentException(“参数错误!”); 
}  
    
在所有方法中都使用手工检测合法性的方式并不是太好，因为这样影响了代码的可读性，若使用Assert工具类上面的代码可以简化为： 
 
Assert.hasText((name, “参数错误!”);

这样可以大大增强代码的可读性，下面我们来介绍一下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 断言类进行方法入参检测
…
}