guava学习之——使用Preconditions类进行参数检查。

      参数检查是一个项目中必须要考虑到的。参数检查前端要做,后端更要做。这决定了一个项目的健壮性和安全性。

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


下面是一些小例子:

比如我们开发java web程序时,需要校验客户端传来的参数。


1.检查前端传来的电话号码,要求不能为空,并且正则匹配。

Preconditions.checkArgument(phoneNum!=null && !"".equals(phoneNum.trim()) &&phoneNum.matches("^(13[0-9]|15[0-9]|17[678]|18[0-9]|14[57])[0-9]{8}$"), "请输入正确的电话号码");


2.对方法的参数进行判断,如若不进行判断,就会引发很多问题。

public void f(Entry entry) {
        Preconditions.checkNotNull(entry);// 参数校验
        log.info(entry.getName()); // 如果不进行参数的检查,当entry为空时,程序就会出现问题。
    }




發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章