Spring 的优秀工具类盘点,第 二 部分: 特殊字符转义和方法入参检测工具类

Spring 的优秀工具类盘点,第 2 部分: 特殊字符转义和方法入参检测工具类
转自:http://www.ibm.com/developerworks/cn/java/j-lo-spring-utils2/

方法入参检测工具类,spring 提供的org.springframework.util.Assert:

Assert 翻译为中文为“断言”,使用过 JUnit 的读者都熟知这个概念,它断定某一个实际的运行值和预期想一样,否则就抛出异常。Spring 对方法入参的检测借用了这个概念,其提供的 Assert 类拥有众多按规则对方法入参进行断言的方法,可以满足大部分方法入参检测的要求。这些断言方法在入参不满足要求时就会抛出 IllegalArgumentException。下面,我们来认识一下 Assert 类中的常用断言方法:

notNull(Object object)
    当 object 不为 null 时抛出异常,notNull(Object object, String message) 方法允许您通过 message 定制异常信息。和 notNull() 方法断言规则相反的方法是 isNull(Object object)/isNull(Object object, String message),它要求入参一定是 null;

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

hasLength(String text) / hasLength(String text, String message)
   当 text 为 null 或长度为 0 时抛出异常

hasText(String text) / hasText(String text, String message)
   text 不能为 null 且必须至少包含一个非空格的字符,否则抛出异常

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

   如果 obj 不能被正确造型为 clazz 指定的类将抛出异常

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 断言类进行方法入参检测
…
}



可见使用 Spring 的 Assert 替代自编码实现的入参检测逻辑后,方法的简洁性得到了不少的提高。Assert 不依赖于 Spring 容器,您可以大胆地在自己的应用中使用这个工具类。
,Assert 工具类是通用性很强的工具类,它使用面向对象的方式解决方法入参检测的问题,您可以在自己的应用中使用 Assert 对方法入参进行检查。