Spring的Assert工具类的用法

标签: Assert工具类
5人阅读 评论(0) 收藏 举报
分类:

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 类中的常用断言方法:

复制代码
1. notNull(Object object)  
  当 object 不为 null 时抛出异常,notNull(Object object, String message) 方法允许您通过 message 定制异常信息。和 notNull() 方法断言规则相反的方法是 isNull(Object object)/isNull(Object object, String message),它要求入参一定是 null2. 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断...
  • qq_33376750
  • qq_33376750
  • 2017-03-23 10:56:08
  • 3811

关于spring中Assert的应用(方法入参检测工具类)

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

Spring中Assert工具类的用法

Spring在提供一个强大的应用开发框架的同时也提供了很多优秀的开发工具类,合理的运用这些工具,将有助于提高开发效率、增强代码质量。下面就最常用的Assert工具类,简要介绍一下它的用法。 Asse...
  • haschwalth
  • haschwalth
  • 2016-02-29 10:55:22
  • 1354

Spring Assert工具类的用法

Spring在提供一个强大的应用开发框架的同时也提供了很多优秀的开发工具类,合理的运用这些工具,将有助于提高开发效率、增强代码质量。下面就最常用的Assert工具类,简要介绍一下它的用法。 Asse...
  • wang1150413
  • wang1150413
  • 2015-09-17 14:34:43
  • 71

Assert断言工具类

Assert断言工具类
  • wangyanming123
  • wangyanming123
  • 2016-05-11 22:52:59
  • 581

SpringMVC断言--Assert

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

Assert.hasText():断言工具类

在此先放个链接,大家去看看           http://www.360doc.com/content/14/0513/17/8072791_377287362.shtml 转自:http...
  • ye_sheng
  • ye_sheng
  • 2015-09-02 15:51:19
  • 4843

spring工具类ClassUtils使用

获取到的class或interface为如下的形式: class org.apache.commons.lang3.ClassUtils 需要获得的形式:org.apache.commons....
  • wochunyang
  • wochunyang
  • 2017-05-08 09:55:57
  • 1026

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

Assert.notNull(Object object, "object is required")    -    对象非空 Assert.isTrue(Object obje...
  • yb464855952
  • yb464855952
  • 2018-02-23 15:41:47
  • 24

Spring中的Assert抽象类

/* * Copyright 2002-2007 the original author or authors. * * Licensed under the Apache License...
  • itpinpai
  • itpinpai
  • 2012-11-13 20:23:14
  • 2739
    个人资料
    持之以恒
    等级:
    访问量: 295
    积分: 183
    排名: 99万+
    文章分类
    文章存档
    最新评论