Guava基础工具-Preconditions 优雅的检验参数

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

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)：
　　功能描述：检查[start, end)是一个长度为size的list， string或array合法的范围子集。伴随着错误信息。
　　失败时抛出的异常类型：IndexOutOfBoundsException

示例

import com.google.common.base.Preconditions;
import java.util.ArrayList;
import java.util.List;

/**
 * @author Kevin
 * @description
 * @date 2016/8/4
 */
public class PreconditionsTest {
    public static void main(String[] args) {
        checkData("Han", 1);
        try {
            checkData("Han", 0);
        } catch (Exception e) {
            // age必须大于0
            System.out.println(e.getMessage());
        }

        try {
            checkData("", 1);
        } catch (Exception e) {
            // name是空串
            System.out.println(e.getMessage());
        }

        try {
            checkData(null, 1);
        } catch (Exception e) {
            // name为null
            System.out.println(e.getMessage());
        }

        List<Integer> intList = new ArrayList<Integer>();
        for (int i = 0; i < 10; i++) {
            try {
                checkState(intList, 9);
                intList.add(i);
            } catch (Exception e) {
                // intList size不能大于 9
                System.out.println(e.getMessage());
            }
        }

        try {
            // 越界检查
            checkPositionIndex(intList, 100);
        } catch (Exception e) {
            // index 100 不在list中,List size = 9 (100) must not be greater than size (9)
            System.out.println(e.getMessage());
        }

        try {
            // 越界检查,起始和结束
            checkPositionIndexes(intList, 5, 15);
        } catch (Exception e) {
            // end index (15) must not be greater than size (9)
            System.out.println(e.getMessage());
        }

        try {
            checkElementIndex(intList, 6);
        } catch (Exception e) {
            System.out.println(e.getMessage());
        }

        try {
            checkElementIndex(intList, 16);
        } catch (Exception e) {
            // index 为 16 不在 list中， List size为： 9 (16) must be less than size (9)
            System.out.println(e.getMessage());
        }
    }

    private static void checkElementIndex(List<Integer> intList, int index) {
        Preconditions.checkElementIndex(index, intList.size(), "index 为 " + index + " 不在 list中， List size = " + intList.size());
    }

    private static void checkPositionIndexes(List<Integer> intList, int start, int end) {
        Preconditions.checkPositionIndexes(start, end, intList.size());
    }

    private static void checkPositionIndex(List<Integer> intList, int index) {
        Preconditions.checkPositionIndex(index, intList.size(), "index " + index + " 不在list中,List size = " + intList.size());
    }

    private static void checkState(List<Integer> intList, int index) {
        Preconditions.checkState(intList.size() < index, "intList size不能大于 " + index);
    }

    private static void checkData(String name, int age) {
        Preconditions.checkNotNull(name, "name为null");
        Preconditions.checkArgument(name.length() > 0, "name是空串");
        Preconditions.checkArgument(age > 0, "age必须大于0");
        System.out.println("name is " + name + ",age is " + age);
    }
}

 

转载于:https://my.oschina.net/kevinair/blog/727257