org.springframework.util.Assert-CSDN博客

本文链接：https://blog.csdn.net/Airuiliya520/article/details/120625005

本文介绍了如何利用Spring的Assert工具类简化方法入参的检查，避免手动编写复杂的判断逻辑。通过示例展示了如notNull、isTrue、notEmpty、hasLength、hasText等断言方法的使用，提升代码的可读性和规范性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

方法入参检测工具类

对于一般方法入参会使用手工编写检测逻辑的方式，类似：

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

Spring 采用一个 org.springframework.util.Assert 通用类完成这一任务，断言方法在入参不满足要求时就会抛出 IllegalArgumentException

断言方法	说明
`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 抛出异常；
`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[] 类型的入参进行判断；
`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，否则将抛出异常；

使用断言后代码简化：

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

https://blog.csdn.net/u014756827/article/details/52450359