java断言Assert正确使用指南

Assert断言机制:

测试代码或者调试程序时，总会做出一些假设，断言就是用于在代码中捕捉这些假设。当要判断一个方法传入的参数时，我们就可以使用断言。

例如：

public Result create(String receiver) {
    try {
        Assert.isTrue(false, "购物项选择必须大于0");
        Assert.hasLength(receiver,"receiver不能为空！");
        
        //------------继续执行业务逻辑---------------
        
        return ResultGenerator.genSuccessResult();
    }catch (Exception e) {
        return ResultGenerator.genFailResult(e.getMessage());
    }
}

这样可以检测传入的参数是否符合要求，当这些断言方法在入参不满足要求时就会抛出 IllegalArgumentException。

断言常用的方法 :

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，否则将抛出异常；