Google Guava学习笔记——基础工具类Preconditions类的使用

　　Preconditions类是一组静态方法用来验证我们代码的状态。Preconditons类很重要，它能保证我们的代码按照我们期望的执行，如果不是我们期望的，我们会立即得到反馈是哪里出来问题，现在我们使用Preconditions来保证我们代码的行为，并且对调试也非常方便。

　　当然，你也可以自己写预处理的代码，就像下面一样：

if (someObj == null) {

        throw new IllegalArgumentException(" someObj must not be null");

    }

　　但使用Preconditions类来处理参数为空的情况，会更加清晰可读：

Preconditions.checkNotNull(label, "Label can't not be null");

　　下面的类演示了Preconditions类的使用：

　　

package com.guava.felix;



import com.google.common.base.Preconditions;



public class PreconditionsDemo {



    private String label;



    private int[] values = new int[5];



    private int currentIndex;



    public PreconditionsDemo(String label) {

    this.label = Preconditions.checkNotNull(label, "Label can't not be null");

    }



    public void updateCurrentIndexValue(int index, int valueToSet) {

    // check index valid first

    this.currentIndex = Preconditions.checkElementIndex(index, values.length, "Index out of bounds for values.");

    // validate valueToSet

    Preconditions.checkArgument(valueToSet <= 100, "Value can't be more than 100");

    values[this.currentIndex] = valueToSet;

    }



    public void doOperation() {

    Preconditions.checkState(validateObjectState(), "Can't perform operation.");

    }



    private boolean validateObjectState() {

    return this.label.equalsIgnoreCase("open") && values[this.currentIndex] == 10;

    }



    public static void main(String[] args) {

    PreconditionsDemo demo = new PreconditionsDemo("open");



    demo.updateCurrentIndexValue(4, 10);



    demo.doOperation();



    }



}

　下面是例子中四个方法的总结：

　　checkNotNull(T object, Object message): object对象不为空的话返回，否则抛出异常。

　　checkElementIndex(int index, int size, Object message): index表示你要访问的数组，集合，字符串的位置，size表示的是长度，如果 index是有效的则返回，否则抛出异常；

　　checkArgument(Boolean expression, Object message):这个方法根据传递进来的参数是否满足方法中的逻辑判断，如果符合，返回true，否则抛出异常。

　　checkStatus(Boolean expression, Object message):这个方法没有参数，它判断一个对象的状态，期望返回true，否则抛出异常。