Guava中提供了一个作参数检查的工具类--Preconditions

柔情只为你懂 2022-05-17 05:19 149阅读 0赞

Guava中提供了一个作参数检查的工具类--Preconditions, 静态导入这个类, 可以大大地简化代码中对于参数的预判断和处理.

<table> 
 <tbody> 
  <tr> 
   <td> <p><code>import</code>&nbsp;<code>static</code>&nbsp;<code>com.google.common.base.Preconditions.*;</code></p> </td> 
  </tr> 
 </tbody> 
</table>

在以前, 我们需要判断一个参数不为空的话, 需要像下面这样写

<table> 
 <tbody> 
  <tr> 
   <td> <p><code>public</code>&nbsp;<code>void</code>&nbsp;<code>testMethod(Object obj) { </code></p> <p><code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>if</code>&nbsp;<code>(obj == </code><code>null</code><code>) { </code></p> <p><code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>throw</code>&nbsp;<code>new</code>&nbsp;<code>NullPointerException();</code></p> <p><code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>}</code></p> <p><code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>// ... other operations</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

每次都要添加if语句来做判断, 重复的工作会做好多次. 使用Preconditions可以简化成下面这样

<table> 
 <tbody> 
  <tr> 
   <td> <p><code>public</code>&nbsp;<code>void</code>&nbsp;<code>testMethod(Object obj) { </code></p> <p><code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>Object other = checkNotNull(obj);</code></p> <p><code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>// ... other operations</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

checkNotNull会检查参数是否为null, 当为null的时候会抛出NullPointerException, 否则直接返回参数.

checkNotNull, checkArgument和checkState, 都有三种形式的参数:

*  public static <T> T checkNotNull(T reference), 只包含需要判断的对象, 无其他多余的参数, 抛出的异常不带有任何异常信息
 *  public static <T> T checkNotNull(T reference, @Nullable Object errorMessage), 包含一个错误信息的额外参数, 抛出的异常带有errorMessage.toString()的异常信息
 *  public static <T> T checkNotNull(T reference, @Nullable String errorMessageTemplate, @Nullable Object... errorMessageArgs), 这种是printf风格的错误信息, 后面是变参, errorMessageTemplate可以使用一些占位符. 例如可以这样写

<table> 
 <tbody> 
  <tr> 
   <td> <p><code>checkArgument(i &gt;= </code><code>0</code><code>, </code><code>"Argument was %s but expected nonnegative"</code><code>, i);</code></p> <p><code>checkArgument(i &lt; j, </code><code>"Expected i &lt; j, but %s &gt; %s"</code><code>, i, j);</code></p> </td> 
  </tr> 
 </tbody> 
</table>

捕获异常后可以获取自定义的详细错误信息, 对于调试来说很有帮助, 而且代码也很简洁. 例如,

<table> 
 <tbody> 
  <tr> 
   <td> <p><code>Object obj = </code><code>null</code><code>;</code></p> <p><code>try</code>&nbsp;<code>{ </code></p> <p><code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>checkNotNull(obj, </code><code>"cannot be null"</code><code>);</code></p> <p><code>} </code><code>catch</code><code>(Exception e) { </code></p> <p><code>&nbsp;&nbsp;&nbsp;&nbsp;</code><code>System.out.println(e.getMessage());</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

运行后可以获得自定义的异常信息"cannot be null".

Preconditions里面的方法有下面几个

<table> 
 <tbody> 
  <tr> 
   <td>方法签名 (不包含额外参数)</td> 
   <td>功能描述</td> 
   <td>失败时抛出的异常类型</td> 
  </tr> 
  <tr> 
   <td><a href="http://docs.guava-libraries.googlecode.com/git-history/release/javadoc/com/google/common/base/Preconditions.html#checkArgument%28boolean%29" rel="nofollow">checkArgument(boolean)</a></td> 
   <td>检查boolean是否为真. 用作方法中检查参数.</td> 
   <td>IllegalArgumentException</td> 
  </tr> 
  <tr> 
   <td><a href="http://docs.guava-libraries.googlecode.com/git-history/release/javadoc/com/google/common/base/Preconditions.html#checkNotNull%28T%29" rel="nofollow">checkNotNull(T)</a></td> 
   <td>检查value不为null. 直接返回value.</td> 
   <td>NullPointerException</td> 
  </tr> 
  <tr> 
   <td><a href="http://docs.guava-libraries.googlecode.com/git-history/release/javadoc/com/google/common/base/Preconditions.html#checkState%28boolean%29" rel="nofollow">checkState(boolean)</a></td> 
   <td>检查对象的一些状态, 不依赖方法参数. 例如,&nbsp;Iterator可以用来next是否在remove之前被调用.&nbsp;</td> 
   <td>IllegalStateException</td> 
  </tr> 
  <tr> 
   <td><a href="http://docs.guava-libraries.googlecode.com/git-history/release/javadoc/com/google/common/base/Preconditions.html#checkElementIndex%28int,%20int%29" rel="nofollow">checkElementIndex(int index, int size)</a></td> 
   <td>检查index是否为在一个长度为size的list, string或array合法的范围. index的范围区间是[0, size)(包含0不包含size). 无需直接传入list, string或array, 只需传入大小.<br> 返回index.</td> 
   <td>IndexOutOfBoundsException</td> 
  </tr> 
  <tr> 
   <td><a href="http://docs.guava-libraries.googlecode.com/git-history/release/javadoc/com/google/common/base/Preconditions.html#checkPositionIndex%28int,%20int%29" rel="nofollow">checkPositionIndex(int index, int size)</a></td> 
   <td>检查位置index是否为在一个长度为size的list, string或array合法的范围. index的范围区间是[0, size)(包含0不包含size). 无需直接传入list, string或array, 只需传入大小.<br> 返回index.</td> 
   <td>IndexOutOfBoundsException</td> 
  </tr> 
  <tr> 
   <td><a href="http://docs.guava-libraries.googlecode.com/git-history/release/javadoc/com/google/common/base/Preconditions.html#checkPositionIndexes%28int,%20int,%20int%29" rel="nofollow">checkPositionIndexes(int start, int end, int size)</a></td> 
   <td>检查[start, end)是一个长度为size的list, string或array合法的范围子集.伴随着错误信息.&nbsp;</td> 
   <td>IndexOutOfBoundsException</td> 
  </tr> 
 </tbody> 
</table>

Guava的preconditions有这样几个优点:

*  在静态导入后, 方法很明确无歧义, checkNotNull可以清楚地告诉你它是干什么的, 它会抛出怎样的异常.
 *  checkNotNull在验证通过后直接返回, 可以这样方便地写代码: this.field = checkNotNull(field).
 *  简单而又强大的可变参数'printf'风格的自定义错误信息.

我们建议将preconditions放置在单独的行上, 这样可以在调试的时候清楚地指明哪个precondition出现错误. 另外, 提供有帮助的错误信息也非常有用.

简单的preconditions确实强大而且易用.

参考资料:

1.  官方wiki: [http://code.google.com/p/guava-libraries/wiki/GuavaExplained][http_code.google.com_p_guava-libraries_wiki_GuavaExplained]
2.  Preconditions: [http://code.google.com/p/guava-libraries/wiki/PreconditionsExplained][http_code.google.com_p_guava-libraries_wiki_PreconditionsExplained]

[http_code.google.com_p_guava-libraries_wiki_GuavaExplained]: http://code.google.com/p/guava-libraries/wiki/GuavaExplained
[http_code.google.com_p_guava-libraries_wiki_PreconditionsExplained]: http://code.google.com/p/guava-libraries/wiki/PreconditionsExplained