在日常开发中，我们经常会对方法的输入参数做一些数据格式上的验证，以便保证方法能够按照正常流程执行下去。对于可预知的一些数据上的错误，我们一定要做事前检测和判断，来避免程序流程出错，而不是完全通过错误处理来保证流程正确执行，毕竟错误处理是比较消耗资源的方式。在平常情况下我们对参数的判断都需要自己来逐个写方法判断，代码量不少并且复用性不高，比如总是用if .... else .... 这时，我们可以使用Preconditions的方法做一些基本验证
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
package
com.hanchao.test;
import
com.google.common.base.Preconditions;
/**
* 简化我们的参数验证的测试
* @author liweihan
*
*/
public
class
PreconditionsTest {
public
static
void
main(String[] args) {
//1.
try
{
getPersonByPrecondition(
1
,
null
);
}
catch
(Exception e) {
System.out.println(e.getMessage());
}
//2.
try
{
getPersonByPrecondition(
2
,
""
);
}
catch
(Exception e) {
System.out.println(e.getMessage());
}
try
{
getPersonByPrecondition(-
2
,
"tom"
);
}
catch
(Exception e) {
System.out.println(e.getMessage());
}
try
{
getPersonByPrecondition(
1
,
"tom3333333333333333333333"
);
}
catch
(Exception e) {
System.out.println(e.getMessage());
}
getPersonByPrecondition(
2
,
"JERRY"
);
//3.
String name =
"name"
;
//null;
String str = Preconditions.checkNotNull(name);
System.out.println(str);
}
private
static
void
getPersonByPrecondition(
int
age, String name) {
//1.验证是否为null
// Preconditions.checkNotNull(name);
Preconditions.checkNotNull(name,
"name为null"
);
//2.验证参数
Preconditions.checkArgument(name.length()>
0
,
"name为''"
);
Preconditions.checkArgument(age>
0
,
"age must > 0"
);
Preconditions.checkArgument(age >
0
&& name.length() <
10
,
"name too lang and max length is "
,
10
);
System.out.println(
"a person age:"
+ age +
",neme:"
+ name);
}
}
|
对一些方法的说明：
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
举例：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
package
com.hanchao.test;
import
java.util.ArrayList;
import
java.util.List;
import
com.google.common.base.Preconditions;
/**
* 简化我们的参数验证的测试2
* @author liweihan
*
*/
public
class
PreconditionsTest2 {
public
static
void
main(String[] args) {
//1.
List<Integer> intList =
new
ArrayList<Integer>();
for
(
int
i =
0
; i <
10
; i++) {
try
{
checkState(intList,
9
);
intList.add(i);
}
catch
(Exception e) {
System.out.println(e.getMessage());
}
}
//2.
try
{
checkPositionIndex(intList,
3
);
}
catch
(Exception e) {
System.out.println(e.getMessage());
}
try
{
checkPositionIndex(intList,
13
);
}
catch
(Exception e) {
System.out.println(e.getMessage());
}
//3.
try
{
checkPositionIndexes(intList,
3
,
7
);
}
catch
(Exception e) {
System.out.println(e.getMessage());
}
try
{
checkPositionIndexes(intList,
3
,
17
);
}
catch
(Exception e) {
System.out.println(e.getMessage());
}
try
{
checkPositionIndexes(intList,
13
,
17
);
}
catch
(Exception e) {
System.out.println(e.getMessage());
}
//4.
try
{
checkElementIndex(intList,
6
);
}
catch
(Exception e) {
System.out.println(e.getMessage());
}
try
{
checkElementIndex(intList,
16
);
}
catch
(Exception e) {
System.out.println(e.getMessage());
}
}
//4.
private
static
void
checkElementIndex(List<Integer> intList,
int
index)
throws
Exception{
Preconditions.checkElementIndex(index, intList.size(),
"index:"
+index+
"不在list中，list的size为："
+intList.size());
}
//3.
private
static
void
checkPositionIndexes(List<Integer> intList,
int
start,
int
end)
throws
Exception{
Preconditions.checkPositionIndexes(start, end, intList.size());
}
//2.
private
static
void
checkPositionIndex(List<Integer> intList,
int
index) {
Preconditions.checkPositionIndex(index, intList.size(),
"index:"
+index+
"不在list中，list的size为："
+intList.size());
}
//1.
private
static
void
checkState(List<Integer> intList,
int
index) {
//表达式为True时不抛出异常
Preconditions.checkState(intList.size()<index,
"intList size 不能大于"
+index);
}
}
|
