知識庫 / Spring RSS 訂閱

我們可以通過使用 doesNotContain() 方法來確定一個字符串參數是否不包含特定的子字符串：

public void startWithNotContain(String key) {
    Assert.doesNotContain(key, "123", "key mustn't contain 123");
    // ...
}

7. 集合和映射斷言

在斷言中，我們通常會檢查某個值是否滿足某個條件。對於集合和映射，我們需要專門的斷言來驗證它們的結構和內容。

集合斷言

• containsKey(key): 驗證集合中是否包含指定鍵。

  assertTrue(mySet.containsKey("key"));
  

• containsValue(value): 驗證集合中是否包含指定值。

  assertTrue(myMap.containsValue(10));
  

• size(): 驗證集合的大小是否符合預期。

  assertEquals(5, mySet.size());
  

映射斷言

• containsKey(key): 驗證映射中是否包含指定鍵。

  assertTrue(myMap.containsKey("key"));
  

• containsValue(value): 驗證映射中是否包含指定值。

  assertTrue(myMap.containsValue(10));
  

• size(): 驗證映射的大小是否符合預期。

  assertEquals(5, myMap.size());
  

7.1. 使用 notEmpty() 處理集合

正如其名稱所示，notEmpty() 方法斷言一個集合不為空，這意味着它既不是 null 也包含至少一個元素：

public void repair(Collection<String> repairParts) {
    Assert.notEmpty(
      repairParts, 
      "collection of repairParts mustn't be empty");
    // ...
}

7.2. notEmpty() 用於 Map

相同的該方法也針對 Map 進行了重載，我們可以檢查 Map 是否為空，並且至少包含一個條目：

public void repair(Map<String, String> repairParts) {
    Assert.notEmpty(
      repairParts, 
      "map of repairParts mustn't be empty");
    // ...
}

8. 數組斷言

數組斷言是一種用於驗證數組內容是否符合預期值的技術。當數組內容與預期不符時，斷言會拋出錯誤或異常，從而幫助開發者及早發現潛在問題。

以下是一些常見的數組斷言示例：

// 檢查數組長度是否為預期值
const myArray = [1, 2, 3, 4, 5];
const expectedLength = 5;
const actualLength = myArray.length;

if (actualLength !== expectedLength) {
  throw new Error("數組長度不正確");
}

// 檢查數組元素是否在預期範圍內
const numbers = [10, 20, 30, 40, 50];
for (let i = 0; i < numbers.length; i++) {
  if (numbers[i] < 0 || numbers[i] > 100) {
    throw new Error("數組元素超出範圍");
  }
}

8.1. 使用 () 處理數組

最後，我們可以通過使用 () 方法來檢查數組是否為空，並且至少包含一個元素：

public void repair(String[] repairParts) {
    Assert.notEmpty(
      repairParts, 
      "array of repairParts mustn't be empty");
    // ...
}

8.2. noNullElements()

我們可以通過使用 noNullElements() 方法來驗證數組中是否包含 null 元素：

public void repairWithNoNull(String[] repairParts) {
    Assert.noNullElements(
      repairParts, 
      "array of repairParts mustn't contain null elements");
    // ...
}

請注意，只要數組不包含任何null元素，即使數組為空，檢查仍然會通過。

9. 結論

在本文中，我們探討了 <em >Assert</em> 類。該類在 Spring 框架中被廣泛使用，但我們可以利用它編寫出更健壯和更具表現力的代碼。