Spring Assert(方法入参检测工具类-断言)

转载 2016年08月28日 20:11:14
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 断言类进行方法入参检测 
… 
}

spring的断言工具类Assert的基本使用

这几天比较闲看了下以前的项目,发现了这个spring下的Assert方法,(以前用过,不过好像忘的差不多了*.*) org.springframework.util.Assert; Assert断...

SpringMVC断言--Assert

Web 应用在接受表单提交的数据后都需要对其进行合法性检查,如果表单数据不合法,请求将被驳回。类似的,当我们在编写类的方法时,也常常需要对方法入参进行合 法性检查,如果入参不符合要求,方法将通过抛出异...

java编程中的断言工具类(org.springframework.util.Assert)

断言工具类:Assert类, java.lang.Object --->org.springframework.util.Assert   先举个例子, 当我们在编写类的方法时,常常需要...

junit4 Assert静态方法介绍

junit中的assert方法全部放在Assert类中,总结一下junit类中assert方法的分类。 1.assertTrue/False([String message,]boolean con...
  • ETTTTTSS
  • ETTTTTSS
  • 2013年12月05日 14:03
  • 14450

JUnit之断言assert

JUnit4.4引入了Hamcrest框架,Hamcest提供了一套匹配符Matcher,这些匹配符更接近自然语言,可读性高,更加灵活; 使用全新的断言语法:assertThat,结合Hamcest提...

使用SpringJUnit4ClassRunner进行单元测试+常用的断言方法

需要的jar包: spring-test-3.2.2.RELEASE.JAR 导入的import类: import org.junit.Test; import org.junit.runner...

Junit框架使用(4)--JUnit常用断言及注解

断言是编写测试用例的核心实现方式,即期望值是多少,测试的结果是多少,以此来判断测试是否通过。 断言核心方法 assertArrayEquals(expecteds, actuals...
  • jaune161
  • jaune161
  • 2014年10月12日 23:09
  • 13608

Java程序性能优化 读书笔记(九)优化组件:池

一、对象池化 对象池化,是目前非常常用的一种系统优化技术。它的核心思想是,如果一个类被频繁请求使用,那么不必每次都生成一个实例,可以将这个类的一些实例保存在一个"池"中,待需要使用的时候直接从池中获...

Spring 的优秀工具类盘点,第 1 部分: 文件资源操作和 Web 相关工具类

文件资源操作 文件资源的操作是应用程序中常见的功能,如当上传一个文件后将其保存在特定目录下,从指定地址加载一个配置文件等等。我们一般使用 JDK 的 I/O 处理类完成这些操作,但对于一般的应用程序...

Spring Assert(方法入参检测工具类-断言)

Web 应用在接受表单提交的数据后都需要对其进行合法性检查,如果表单数据不合法,请求将被驳回。类似的,当我们在编写类的方法时,也常常需要对方法入参进行合 法性检查,如果入参不符合要求,方法将通过抛出异...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Spring Assert(方法入参检测工具类-断言)
举报原因:
原因补充:

(最多只允许输入30个字)