轉載自:[url]http://www.ibm.com/developerworks/cn/java/j-lo-spring-utils2/index.html[/url]
方法入參檢測工具類

Web 應用在接受表單提交的資料後都需要對其進行合法性檢查，如果表單資料不合法，請求將被駁回。類似的，當我們在編寫類的方法時，也常常需要對方法入參進行合法性檢查，如果入參不符合要求，方法將通過丟擲異常的方式拒絕後續處理。舉一個例子：有一個根據檔名獲取輸入流的方法：InputStream getData(String file)，為了使方法能夠成功執行，必須保證 file 入參不能為 null 或空白字元，否則根本無須進行後繼的處理。這時方法的編寫者通常會在方法體的最前面編寫一段對入參進行檢測的程式碼，如下所示：

public InputStream getData(String file) {
if (file == null || file.length() == 0|| file.replaceAll("\\s", "").length() == 0) {
throw new IllegalArgumentException("file入參不是有效的檔案地址");
}
…
}

類似以上檢測方法入參的程式碼是非常常見，但是在每個方法中都使用手工編寫檢測邏輯的方式並不是一個好主意。閱讀 Spring 原始碼，您會發現 Spring 採用一個 org.springframework.util.Assert 通用類完成這一任務。

Assert 翻譯為中文為“斷言”，使用過 JUnit 的讀者都熟知這個概念，它斷定某一個實際的執行值和預期想一樣，否則就丟擲異常。Spring 對方法入參的檢測借用了這個概念，其提供的 Assert 類擁有眾多按規則對方法入參進行斷言的方法，可以滿足大部分方法入參檢測的要求。這些斷言方法在入參不滿足要求時就會丟擲 IllegalArgumentException。下面，我們來認識一下 Assert 類中的常用斷言方法：

斷言方法 說明
1. notNull(Object object)
當 object 不為 null 時丟擲異常，notNull(Object object, String message) 方法允許您通過 message 定製異常資訊。和 notNull() 方法斷言規則相反的方法是 isNull(Object object)/isNull(Object object, String message)，它要求入參一定是 null；

2. isTrue(boolean expression) / isTrue(boolean expression, String message)
當 expression 不為 true 丟擲異常；

3. notEmpty(Collection collection) / notEmpty(Collection collection, String message)
當集合未包含元素時丟擲異常。
notEmpty(Map map) / notEmpty(Map map, String message) 和 notEmpty(Object[] array, String message) / notEmpty(Object[] array, String message) 分別對 Map 和 Object[] 型別的入參進行判斷；

4. hasLength(String text) / hasLength(String text, String message) 當 text 為 null 或長度為 0 時丟擲異常；

5. hasText(String text) / hasText(String text, String message) text 不能為 null 且必須至少包含一個非空格的字元，否則丟擲異常；

6. isInstanceOf(Class clazz, Object obj) / isInstanceOf(Class type, Object obj, String message) 如果 obj 不能被正確造型為 clazz 指定的類將丟擲異常；
7. isAssignable(Class superType, Class subType) / isAssignable(Class superType, Class subType, String message) subType 必須可以按型別匹配於 superType，否則將丟擲異常；

使用 Assert 斷言類可以簡化方法入參檢測的程式碼，如 InputStream getData(String file) 在應用 Assert 斷言類後，其程式碼可以簡化為以下的形式：

public InputStream getData(String file){
Assert.hasText(file,"file入參不是有效的檔案地址");
① 使用 Spring 斷言類進行方法入參檢測
…
}



可見使用 Spring 的 Assert 替代自編碼實現的入參檢測邏輯後，方法的簡潔性得到了不少的提高。Assert 不依賴於 Spring 容器，您可以大膽地在自己的應用中使用這個工具類.