Guava源码解析八：Preconditions源码解析

       提供静态方法来检查方法或构造函数，被调用是否给定适当的参数。它检查的先决条件。其方法失败抛出IllegalArgumentException。

对于Preconditions类的静态方法可以分为三大类：

1.对null的处理

2.对真假的处理

3.对数组下标是否符合的处理

 

一、对null的处理

public static <T> T checkNotNull(T reference)
public static <T> T checkNotNull(T reference, @Nullable Object errorMessage)
public static <T> T checkNotNull(T reference, @Nullable String errorMessageTemplate, @Nullable Object... errorMessageArgs)

根据三个方法的描述，reference是要进行判断的引用，接下来的信息是自定义异常打印信息

public static <T> T checkNotNull(T reference) {
    //如果引用为null，怎直接抛出异常，如果不为null，则直接返回这个引用
    if(reference == null) {
        throw new NullPointerException();
    } else {
        return reference;
    }
}

二、对真假的处理

       对真假的判断实现有两种实现函数checkArgument()和checkState()

两个函数的实现大体一致，都是对传入的boolean类型参数进行判断

如果为false，checkArgument方法会抛出IllegalArgumentException()

                       checkState方法会抛出IllegalStateException()

并且两种方法的实现也进行了多种参数的重载，可以讲自己想打印的错误信息进行抛出

 

三、对数组下标是否符合的处理

对数组下标合格的判断有三种方法checkElementIndex()、checkPositionIndex()、checkPositionIndexs()

checkElementIndex(int index, int size)方法是判断0 ～ size-1中是否存在index
checkPositionIndex(int index, int size)方法是判断 0 ~ size 中是否存在index
checkPositionIndexs(int start, int end, int size)方法判断传入的start和end与size的顺序关系并且start和end是否在 0 ~ size 范围中