Guava Preconditions类使用【Guava学习笔记】

package com.lwl.guava.Preconditions;

import com.google.common.base.Preconditions;

public class UserPreconditions {

/**
* Preconditions提供静态方法来检查方法或构造函数，被调用是否给定适当的参数。
* 它检查的先决条件。其方法失败抛出IllegalArgumentException。
* @param args
* @author
* @create 2017-8-18 下午4:44:46
*/
public static void main(String[] args) {

//检查boolean是否为true，用来检查传递给方法的参数。
//		testCheckArgument();

//检查value是否为null，该方法直接返回value，因此可以内嵌使用checkNotNull。
//		testCheckNotNull();

//用来检查对象的某些状态。
//		testCheckState();

//确保索引指定一个数组，列表或尺寸大小的字符串有效的元素。
//		testCheckElementIndex();

//确保索引指定一个数组，列表或尺寸大小的字符串有效的元素。
//		textCheckPositionIndex();

//确保开始和结束指定数组，列表或字符串大小有效的位置，并按照顺序
//		testCheckPositionIndexes();

}

/**
* 确保开始和结束指定数组，列表或字符串大小有效的位置，并按照顺序
* @create 2017-8-18 下午5:26:23
*/
private static void testCheckPositionIndexes() {
/**
* 确保开始和结束指定数组，列表或字符串大小有效的位置，并按照顺序
* 这个方法只要表达的意思是
* start作为开始位置
* end作为结束位置
* size作为数组或者列表或者字符串的长度
*
* 开始的位置 (start) <= 结束的位置(end) <= 总长度(size)
* 如果有一个不满足则抛出异常：IndexOutOfBoundsException
*/
//		Preconditions.checkPositionIndexes(start, end, size)
}

/**
* 确保索引指定一个数组，列表或尺寸大小的字符串有效的元素。
* 异常信息：IndexOutOfBoundsException
* @create 2017-8-18 下午5:17:27
*/
private static void textCheckPositionIndex() {

String array = "aaa";
int index = 5;

try {
//			Preconditions.checkElementIndex(index,array.length);
int result = Preconditions.checkElementIndex(index,array.length(),"大于数组的长度啦");
System.out.println(result);
} catch (Exception e) {
e.printStackTrace();
System.out.println(e.getMessage());
}
/**
* Exception in thread "main" java.lang.IndexOutOfBoundsException: 大于数组的长度啦 (5) must be less than size (3)
at com.google.common.base.Preconditions.checkElementIndex(Preconditions.java:310)
at com.lwl.guava.Preconditions.UserPreconditions.testCheckElementIndex(UserPreconditions.java:35)
at com.lwl.guava.Preconditions.UserPreconditions.main(UserPreconditions.java:25)
*/
}

/**
* 确保索引指定一个数组，列表或尺寸大小的字符串有效的元素。
* 异常信息：IndexOutOfBoundsException
* @create 2017-8-18 下午5:17:27
*/
private static void testCheckElementIndex() {

int[] array = {1,2,3};
int index = 2;

try {
//			Preconditions.checkElementIndex(index,array.length);
int result = Preconditions.checkElementIndex(index,array.length,"大于数组的长度啦");
System.out.println(result);
} catch (Exception e) {
e.printStackTrace();
System.out.println(e.getMessage());
}
/**
* Exception in thread "main" java.lang.IndexOutOfBoundsException: 大于数组的长度啦 (5) must be less than size (3)
at com.google.common.base.Preconditions.checkElementIndex(Preconditions.java:310)
at com.lwl.guava.Preconditions.UserPreconditions.testCheckElementIndex(UserPreconditions.java:35)
at com.lwl.guava.Preconditions.UserPreconditions.main(UserPreconditions.java:25)
*/
}

/**
*
* 用来检查对象的某些状态。
* 确保涉及调用实例的状态，但不涉及任何参数来调用方法表达式的真相。
* 检查失败时抛出的异常：IllegalStateException
* @create 2017-8-18 下午5:07:46
*/
private static void testCheckState() {
//checkState(boolean expression)
//		Preconditions.checkState(2 > 5);
//checkState(boolean expression, String errorMessageTemplate)
//		Preconditions.checkState(2 > 5,"2不可能大于5");
try {
//checkState(boolean expression, String errorMessageTemplate, Object... errorMessageArgs)
Preconditions.checkState(2 > 5,"2不可能大于5",1,2,3,4);
} catch (Exception e) {
e.printStackTrace();
System.out.println(e.getMessage());
}
/**
* 错误信息：
* java.lang.IllegalStateException: 2不可能大于5 [1, 2, 3, 4]
at com.google.common.base.Preconditions.checkState(Preconditions.java:199)
at com.lwl.guava.Preconditions.UserPreconditions.testCheckState(UserPreconditions.java:40)
at com.lwl.guava.Preconditions.UserPreconditions.main(UserPreconditions.java:23)
2不可能大于5 [1, 2, 3, 4]
*/

}

/**
* 检查value是否为null，该方法直接返回value，因此可以内嵌使用checkNotNull。
* 检查失败时抛出的异常：NullPointerException
* @create 2017-8-18 下午5:00:27
*/
private static void testCheckNotNull() {

Integer first = null;
//确保对象引用作为参数传递给调用方法不为空。
//		Integer result1 = Preconditions.checkNotNull(first);
//确保对象引用作为参数传递给调用方法不为空。
//		Integer result2 = Preconditions.checkNotNull(first,"是空值哦");
//checkNotNull(T reference, String errorMessageTemplate, Object... errorMessageArgs)
//第三个参数是可变参数
Integer result3 = Preconditions.checkNotNull(first,"是空值哦",12,123,123);
System.out.println(result3);
/**
* 异常显示
* Exception in thread "main" java.lang.NullPointerException: 是空值哦 [12, 123, 123]
at com.google.common.base.Preconditions.checkNotNull(Preconditions.java:251)
at com.lwl.guava.Preconditions.UserPreconditions.testCheckNotNull(UserPreconditions.java:39)
at com.lwl.guava.Preconditions.UserPreconditions.main(UserPreconditions.java:18)
*/
}

/**
* 检查boolean是否为true，用来检查传递给方法的参数。
* 检查失败时抛出的异常：IllegalArgumentException
* @create 2017-8-18 下午4:56:28
*/
public static void testCheckArgument(){
//没有额外参数：抛出的异常中没有错误消息；
try {
Preconditions.checkArgument(5 > 10);
} catch (IllegalArgumentException e) {
e.printStackTrace();
System.out.println(e.getMessage());
}
//确保涉及的一个或多个参数来调用方法表达式的真相。checkArgument(boolean expression, Object errorMessage)
try {
Preconditions.checkArgument(5 > 10,"5肯定小于10 啦");
} catch (IllegalArgumentException e) {
e.printStackTrace();
System.out.println(e.getMessage());
}
//确保涉及的一个或多个参数来调用方法表达式的真相。 checkArgument(boolean expression,
//				String errorMessageTemplate, Object... errorMessageArgs)
try {
Preconditions.checkArgument(5 > 10,"5肯定小于10 啦",4,32,423);
} catch (IllegalArgumentException e) {
e.printStackTrace();
System.out.println(e.getMessage());
}
}
/**
* 异常信息：
* java.lang.IllegalArgumentException: 5肯定小于10 啦 [4, 32, 423]
at com.google.common.base.Preconditions.checkArgument(Preconditions.java:146)
at com.lwl.guava.Preconditions.UserPreconditions.testCheckArgument(UserPreconditions.java:77)
at com.lwl.guava.Preconditions.UserPreconditions.main(UserPreconditions.java:16)
*/
}