在Spring框架中，Assert類主要用于在開發(fā)過程中對代碼進行驗證，確保程序的正確性和穩(wěn)定性。Assert類屬于org.springframework.util包。它提供了一系列靜態(tài)方法，用于在運行時檢測條件是否滿足，如果不滿足則拋出IllegalArgumentException異常。這對于參數(shù)校驗、狀態(tài)檢查等場景非常有用。

Assert

寫在前面

這篇文檔原本并不在我的計劃之內(nèi)。我原本打算先完成 Spring AI 框架篇的內(nèi)容，但那一部分的文檔進展不太順利，暫時難以成文。最近在研究 Spring AI 框架源碼的過程中，我發(fā)現(xiàn) Spring 團隊大量使用了 Assert 類來校驗方法參數(shù)的規(guī)范性。深入研究之后，我發(fā)現(xiàn)這個類非常實用，并且它與 org.junit 包下的 Assert 類有很大區(qū)別。本文旨在說明 org.springframework.util 包下的 Assert 類的作用、它與 org.junit 包下的 Assert 有何不同，以及它如何幫助我們簡化日常開發(fā)，使代碼更加優(yōu)雅。

一、Assert是什么

在 Spring 框架中，Assert 是 org.springframework.util 包下的一個工具類，它通過一系列靜態(tài)方法實現(xiàn)對方法參數(shù)、對象狀態(tài)或業(yè)務(wù)邏輯前提的校驗。其核心設(shè)計思想是：在程序運行時主動檢查關(guān)鍵條件是否滿足，若不滿足則立即拋出異常，快速暴露問題，避免錯誤在后續(xù)流程中被掩蓋或放大。

簡單來說，Assert 的作用可以概括為 “條件校驗 + 異常拋出的自動化封裝”，僅專注于 “校驗” 這一單一職責。它替代了傳統(tǒng)開發(fā)中 “if (!條件) { throw new 異常(...); }” 這種重復(fù)的校驗邏輯，用更簡潔的代碼表達校驗意圖，讓開發(fā)者能更專注于核心業(yè)務(wù)邏輯。

二、Assert怎么用

接下來讓我們來舉個例子說明這一點，在不使用 Assert 之前，我們大多數(shù)業(yè)務(wù)代碼中的數(shù)據(jù)校驗是這樣做的

List<ChatMemory> list = chatMemoryMapper.selectBySessionId("111");
if (list == null || list.isEmpty()){
    throw new RuntimeException("會話不存在");
}
//下面處理會話相關(guān)邏輯

判斷一個數(shù)據(jù)是否存在，如果存在繼續(xù)下面的業(yè)務(wù)代碼，如果不存在則拋出異常讓外層捕獲處理

使用Assert來進行處理是這樣子的

List<ChatMemory> list = chatMemoryMapper.selectBySessionId("111");
Assert.notEmpty(list, "會話不存在");
//下面處理會話相關(guān)邏輯

Assert.notEmpty()方法的實現(xiàn)如下

@Contract("null, _ -> fail")
public static void notEmpty(@Nullable Collection<?> collection, String message) {
    if (CollectionUtils.isEmpty(collection)) {
        throw new IllegalArgumentException(message);
    }
}

Assert 類本身不包含任何業(yè)務(wù)邏輯，僅專注于 “校驗” 這一單一職責。它的所有方法均為靜態(tài)方法，無需實例化即可直接調(diào)用（如 Assert.notNull(obj, "對象不能為空")），且校驗失敗時會拋出 IllegalArgumentException（參數(shù)不合法）或 IllegalStateException（狀態(tài)不合法）等運行時異常。

雖然拋出異常需要處理，但也不應(yīng)在所有業(yè)務(wù)接口中都重復(fù)編寫 try-catch 代碼，否則會降低代碼的可讀性并導(dǎo)致冗余?？蓪?code>Assert與 Spring MVC 的全局異常處理器結(jié)合使用

@ControllerAdvice
public class GlobalExceptionHandler {
    /**
     * 處理Assert拋出的IllegalArgumentException異常
     */
    @ExceptionHandler(IllegalArgumentException.class)
    @ResponseBody
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public Map<String, Object> handleIllegalArgumentException(IllegalArgumentException e) {
        Map<String, Object> result = new HashMap<>();
        result.put("code", 400);
        result.put("message", e.getMessage());
        // 可以根據(jù)需要添加更多信息，如時間戳、請求路徑等
        return result;
    }
    /**
     * 處理Assert拋出的IllegalStateException異常
     */
    @ExceptionHandler(IllegalStateException.class)
    @ResponseBody
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    public Map<String, Object> handleIllegalStateException(IllegalStateException e) {
        Map<String, Object> result = new HashMap<>();
        result.put("code", 500);
        result.put("message", e.getMessage());
        return result;
    }
}

當 Assert 校驗失敗拋出異常（如 IllegalArgumentException）時，全局異常處理器會捕獲并處理這些異常。這種做法的優(yōu)勢在于：

1. 職責分離：業(yè)務(wù)代碼只關(guān)注參數(shù)校驗邏輯，異常處理邏輯集中在全局異常處理器中
2. 代碼簡潔：避免了大量重復(fù)的if-else和try-catch代碼
3. 統(tǒng)一格式：所有異常響應(yīng)都遵循統(tǒng)一格式，便于前端處理
4. 易于維護：異常處理邏輯集中管理，修改時只需調(diào)整一處

通過這種方式，我們既利用了 Assert 的簡潔校驗?zāi)芰?，又通過全局異常處理器實現(xiàn)了異常的統(tǒng)一管理，讓代碼更加優(yōu)雅、易讀和易維護。

三、Assert有哪些方法

四、Assert與Assert的區(qū)別

org.springframework.util.Assert 與 org.junit.Assert 的最大區(qū)別一個拋出RuntimeException 另一個拋出 Error。

從設(shè)計角度看 org.springframework.util.Assert 適合用于生產(chǎn)代碼中的參數(shù)校驗、狀態(tài)檢查（業(yè)務(wù)邏輯層的前提校驗）

而 org.junit.Assert 適合用于測試代碼中的結(jié)果斷言（驗證測試用例的預(yù)期結(jié)果）

到此這篇關(guān)于Spring Assert 使用全面指南的文章就介紹到這了,更多相關(guān)Spring Assert 使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論