Guava-Preconditions（前置条件）

2019独角兽企业重金招聘Python工程师标准>>>

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
checkElementIndex(int index, int size)	检查index作为索引值对某个列表、字符串或数组是否有效。index>=0 && index<size 。	IndexOutOfBoundsException
checkPositionIndex(int index, int size)	检查index作为位置值对某个列表、字符串或数组是否有效。index>=0 && index<=size 。	IndexOutOfBoundsException
checkPositionIndexes(int start, int end, int size)	检查[start, end]表示的位置范围对某个列表、字符串或数组是否有效。	IndexOutOfBoundsException

本文概况性翻译：https://code.google.com/p/guava-libraries/wiki/PreconditionsExplained

转载于:https://my.oschina.net/stefanzhlg/blog/514307