Preconditions

用来做断言的，可以使代码变得优雅，不需要通过if去判断，并且还能抛出自定义内容的异常
checkNotNull

• 可以校验参数是否为空，参数第一位是个object类型，只要是基本数据类型以外的类型都能判断
• 可以自定义抛出的异常的内容
• 异常内容中有个占位符功能 %s,他会获取%s在内容中的下标，然后去后面可变参数中找到匹配的内容进行替换
• 占位符的替换结果如果填了一个null，会把null替换为字符串 (Object[])null

    public void test1(){
        checkNotNullErrorMsg(null);
    }

    private void checkNotNullErrorMsg(final List<String> list){
        Preconditions.checkNotNull(list,"结果为空！期望结果为 %s",2);
    }

image.png

• 校验集合的长度是否大于指定下标，此处集合长度为2，该集合最大下标为1，所以参数2超过了集合的下标
• 这边内部的方法会自动拼接内容 (2) must be less than size (2)

    public void test2(){
        //创建元素为a b的一个集合
        List<String> list = ImmutableList.of("a", "b");
        checkElementIndex(list);
    }

    private void checkElementIndex(final List<String> list){
        Preconditions.checkElementIndex(2,list.size(),"bad result:");
    }

image.png

Strings

emptyToNull&nullToEnpty

• 断言结果是通过的
• emptyToNull方法参数如果是空字符串会返回null，如果参数是非null的字符串，则返回原值
• nullToEmpty方法参数如果是null会返回空字符串，如果参数是非null的字符串，则返回原值

    public void test1(){
        assertThat(Strings.emptyToNull(""),nullValue());
        assertThat(Strings.emptyToNull("a"),equalTo("a"));
        assertThat(Strings.nullToEmpty(null),equalTo(""));
        assertThat(Strings.nullToEmpty("a"),equalTo("a"));
    }

commonPrefix&commonSuffix

• 断言结果是通过的
• commonPrefix会返回两个字符串的公共前缀，如果不匹配就返回空字符串
• commonSuffix会返回两个字符串的公共后缀，如果不匹配就返回空字符串

    public void test2(){
        assertThat(Strings.commonPrefix("hello","hi"),equalTo("h"));
        assertThat(Strings.commonPrefix("hello","no"),equalTo(""));
        assertThat(Strings.commonSuffix("hello","no"),equalTo("o"));
        assertThat(Strings.commonSuffix("hello","hi"),equalTo(""));
    }

isNullOrEmpty

• 断言结果是通过的
• isNullOrEmpty会校验是否为null或空字符串，相当于StringUtils的isEmpty()方法
• 需要注意的是如果是空格字符串，会返回false，不能当做StringUtils的isBlank()方法使用

    public void test3(){
        assertThat(Strings.isNullOrEmpty(null),equalTo(true));
        assertThat(Strings.isNullOrEmpty(""),equalTo(true));
    }

padStart&padEnd

• 断言结果是通过的
• padStart会校验字符串是否满足指定长度，不满足就在字符串前面加N个指定字符，直到满足指定长度
• padEnd会校验字符串是否满足指定长度，不满足就在字符串后面加N个指定字符，直到满足指定长度

    public void test4(){
        assertThat(Strings.padStart("hello",6,'X'),equalTo("Xhello"));
        assertThat(Strings.padEnd("hello",6,'X'),equalTo("helloX"));
    }