断言-Assert
# 由来
Java中有assert
关键字,但是存在许多问题:
- assert关键字需要在运行时显式开启才能生效,否则你的断言就没有任何意义。
- 用assert代替if是陷阱之二。assert的判断和if语句差不多,但两者的作用有着本质的区别:assert关键字本意上是为测试调试程序时使用的,但如果不小心用assert来控制了程序的业务流程,那在测试调试结束后去掉assert关键字就意味着修改了程序的正常的逻辑。
- assert断言失败将面临程序的退出。
因此,并不建议使用此关键字。相应的,在Hutool中封装了更加友好的Assert类,用于断言判定。
# 介绍
Assert类更像是Junit中的Assert类,也很像Guava中的Preconditions,主要作用是在方法或者任何地方对参数的有效性做校验。当不满足断言条件时,会抛出IllegalArgumentException或IllegalStateException异常。
# 使用
String a = null;
cn.hutool.lang.Assert.isNull(a);
# 更多方法
- isTrue 必须为true,否则抛出IllegalArgumentException异常
- isNull 必须是null值
- notNull 不能是null值
- notEmpty 不能为空,支持字符串,数组,集合等
- notBlank 不能是空白字符串
- notContain 不能包含指定的子串
- noNullElements 数组中不能包含null元素
- isInstanceOf 必须是指定类的实例
- isAssignable 必须是子类和父类关系
- state 会抛出IllegalStateException异常
上次更新: 2023/10/21, 16:55:17