前提条件
Guava提供了许多前置条件检查实用程序。我们强烈建议您静态导入这些内容。
每种方法都有三种变体:
- 没有额外的争论。抛出任何异常都没有错误消息。
- 一个额外的
Object
论点。抛出任何异常并显示错误消息 object.toString()
。
- 一个额外的
String
参数,带有任意数量的附加Object
参数。这类似于printf,但对于GWT的兼容性和效率,它只允许使用%s
指标。
- 注:
checkNotNull
,checkArgument
并且checkState
有大量服用的原始组合和过载的Object
参数,而不是一个可变参数阵列-这使得上面的调用,如那些以避免两个原始拳击,并在绝大多数情况下varags数组分配。
第三种变体的例子:
checkArgument(i > = 0,“参数是%s但预期非负”,i);
checkArgument(i < j,“预期i <j,但%s> =%s ”,i,j);
出于几个原因,我们倾向于使用自己的前置条件检查,例如来自Apache Commons的类似实用程序。简述:
- 静态导入后,Guava方法清晰明确。
checkNotNull
清楚地表明正在做什么,以及将抛出什么异常。
-
checkNotNull
验证后返回其参数,允许构造函数中的简单单行:this.field = checkNotNull(field);
。
- 简单,varargs“printf-style”异常消息。(这个优势也是我们建议继续使用
checkNotNull
的原因Objects.requireNonNull
)
我们建议您将前提条件拆分为不同的行,这可以帮助您确定调试时哪些前提条件失败。此外,您应该提供有用的错误消息,这在每个检查都在自己的行上时更容易。
代码
public class Test {
static User user ;
public static void main(String[] args) {
//错误一
Preconditions.checkArgument(1==1,"{%s}","sss");
//错误二
Preconditions.checkNotNull(user);
//错误三
Preconditions.checkElementIndex(20,19,"越界");
}
}
错误一
Exception in thread "main" java.lang.IllegalArgumentException: {出错了}
at com.google.common.base.Preconditions.checkArgument(Preconditions.java:216)
at com.boolib.vcheck.Test.main(Test.java:11)
错误二
Exception in thread "main" java.lang.NullPointerException
at com.google.common.base.Preconditions.checkNotNull(Preconditions.java:877)
at com.boolib.vcheck.Test.main(Test.java:13)
错误三
Exception in thread "main" java.lang.IndexOutOfBoundsException: 越界 (20) must be less than size (19)
at com.google.common.base.Preconditions.checkElementIndex(Preconditions.java:1329)
at com.boolib.vcheck.Test.main(Test.java:14)