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
checkElementIndex
- 校验集合的长度是否大于指定下标，此处集合长度为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"));
}
