Guava Preconditions 提供了很多前置条件判断的使用方法。
每个方法有三个变种:
没有额外参数。抛出的异常中没有错误消息。
一个Object对象作为参数.。用 object.toString()抛出错误错误消息。
String作为参数, 并且有一组任意数量的附加Object对象。这个变种处理异常消息的方式有点类似printf，但考虑GWT的兼容性和效率，只支持%s指示符。例如：
checkArgument(i >= 0, "Argument was %s but expected nonnegative", i); checkArgument(i < j, "Expected i < j, but %s > %s", i, j);
方法声明（不包括额外参数） |
描述 |
检查失败时抛出的异常 |
| checkArgument(boolean) | 检查boolean是否为true，用来检查传递给方法的参数。 |
IllegalArgumentException |
| checkNotNull(T) | 检查value是否为null，该方法直接返回value，因此可以内嵌使用checkNotNull。 |
NullPointerException |
| checkState(boolean) | 用来检查对象的某些状态。 |
IllegalStateException |
检查index作为索引值对某个列表、字符串或数组是否有效。index>=0 && index<size 。 |
IndexOutOfBoundsException | |
检查index作为位置值对某个列表、字符串或数组是否有效。index>=0 && index<=size 。 |
IndexOutOfBoundsException | |
检查[start, end]表示的位置范围对某个列表、字符串或数组是否有效。 |
IndexOutOfBoundsException |
本文概况性翻译：https://code.google.com/p/guava-libraries/wiki/PreconditionsExplained
《Guava类库》wiki系列-Preconditions（前置条件）
原文：http://my.oschina.net/stefanzhlg/blog/514307