Guava学习之Preconditions

在日常开发中,我们经常会对方法的输入参数做一些数据格式上的验证,以便保证方法能够按照正常流程执行下去。对于可预知的一些数据上的错误,我们一定要做事前检测和判断,来避免程序流程出错,而不是完全通过错误处理来保证流程正确执行,毕竟错误处理是比较消耗资源的方式。在平常情况下我们对参数的判断都需要自己来逐个写方法判断,代码量不少并且复用性不高。

Preconditions提供的就是测试时使用的验证逻辑,它可以简化我们代码中对于参数的预判断和处理,让我们对方法输入参数的验证实现起来更加简单优雅。

官方强烈建议在代码中使用这个类,而且在Preconditions类中的所有函数都是static修饰的,这意味着你不需要声明(你不可以申请一个Preconditions对象,因为Preconditions的构造函数用private修饰的)一个Preconditions类对象,而可以直接使用这个类提供的方法。

Preconditions里面常用的方法:

1 .checkArgument(boolean) **:**
功能描述:检查boolean是否为真。 用作方法中检查参数
失败时抛出的异常类型: IllegalArgumentException

2.checkNotNull(T)****
功能描述:检查value不为null, 直接返回value;
失败时抛出的异常类型:NullPointerException

**3.checkState(boolean)**:
功能描述:检查对象的一些状态,不依赖方法参数。 例如, Iterator可以用来next是否在remove之前被调用。
失败时抛出的异常类型:IllegalStateException

**4.checkElementIndex(int index, int size)**:
功能描述:检查index是否为在一个长度为size的list, string或array合法的范围。 index的范围区间是[0, size)(包含0不包含size)。无需直接传入list, string或array, 只需传入大小。返回index。
失败时抛出的异常类型:IndexOutOfBoundsException

5.checkPositionIndex(int index, int size)**:**
功能描述:检查位置index是否为在一个长度为size的list, string或array合法的范围。 index的范围区间是[0, size)(包含0不包含size)。无需直接传入list, string或array, 只需传入大小。返回index。
失败时抛出的异常类型:IndexOutOfBoundsException

6.checkPositionIndexes(int start, int end, int size)**:**

Comments

智能化石灰立窑: 必须给一个赞