Spring Assert(方法入?yún)z測工具類-斷言)

Web 應(yīng)用在接受表單提交的數(shù)據(jù)后都需要對其進行合法性檢查,如果表單數(shù)據(jù)不合法,請求將被駁回。類似的,當我們在編寫類的方法時,也常常需要對方法入?yún)⑦M行合 法性檢查,如果入?yún)⒉环弦?,方法將通過拋出異常的方式拒絕后續(xù)處理。舉一個例子:有一個根據(jù)文件名獲取輸入流的方法:InputStream getData(String file),為了使方法能夠成功執(zhí)行,必須保證 file 入?yún)⒉荒転?null 或空白字符,否則根本無須進行后繼的處理。這時方法的編寫者通常會在方法體的最前面編寫一段對入?yún)⑦M行檢測的代碼,如下所示:

public InputStream getData(String file) {
if (file == null || file.length() == 0|| file.replaceAll("\s", "").length() == 0) {
throw new IllegalArgumentException("file入?yún)⒉皇怯行У奈募刂?);
}

}

類似以上檢測方法入?yún)⒌拇a是非常常見,但是在每個方法中都使用手工編寫檢測邏輯的方式并不是一個好主意。閱讀 Spring 源碼,您會發(fā)現(xiàn) Spring 采用一個 org.springframework.util.Assert 通用類完成這一任務(wù)。

Assert 翻譯為中文為“斷言”,使用過 JUnit 的讀者都熟知這個概念,它斷定某一個實際的運行值和預期想一樣,否則就拋出異常。Spring 對方法入?yún)⒌臋z測借用了這個概念,其提供的 Assert 類擁有眾多按規(guī)則對方法入?yún)⑦M行斷言的方法,可以滿足大部分方法入?yún)z測的要求。這些斷言方法在入?yún)⒉粷M足要求時就會拋出 IllegalArgumentException。下面,我們來認識一下 Assert 類中的常用斷言方法:
Spring Assert的所有方法:

image

斷言方法 說明

  1. notNull(Object object)
    當 object 不為 null 時拋出異常,notNull(Object object, String message) 方法允許您通過 message 定制異常信息。和 notNull() 方法斷言規(guī)則相反的方法是 isNull(Object object)/isNull(Object object, String message),它要求入?yún)⒁欢ㄊ?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[] 類型的入?yún)⑦M行判斷;

  4. hasLength(String text) / hasLength(String text, String message)

當 text 為 null 或長度為 0 時拋出異常;

  1. hasText(String text) / hasText(String text, String message)

text 不能為 null 且必須至少包含一個非空格的字符,否則拋出異常;

  1. isInstanceOf(Class clazz, Object obj) / isInstanceOf(Class type, Object obj, String message)

如果 obj 不能被正確造型為 clazz 指定的類將拋出異常;

  1. isAssignable(Class superType, Class subType) / isAssignable(Class superType, Class subType, String message)

subType 必須可以按類型匹配于 superType,否則將拋出異常;

使用 Assert 斷言類可以簡化方法入?yún)z測的代碼,如 InputStream getData(String file) 在應(yīng)用 Assert 斷言類后,其代碼可以簡化為以下的形式:

public InputStream getData(String file){
Assert.hasText(file,"file入?yún)⒉皇怯行У奈募刂?);
① 使用 Spring 斷言類進行方法入?yún)z測

}

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容