Skip to content

程式語言 › Java › 測試

Java 測試 (Java Testing) ​

用 JUnit 寫單元測試、用 Mockito 隔離依賴、用參數化測試涵蓋多組輸入。測試的目的:確認正常行為,並刻意探測邊界與失敗路徑;只在 happy path 能跑的程式等於沒測。測試層級與 Python 的 pytest 寫法見 測試。

邊界情況 (Edge Cases) ​

類型例子
空值null、空字串、空集合
數值邊界0、負數、Integer.MAX_VALUE、溢位
規則邊界剛好在驗證門檻上、差一點點的值
格式多餘空白、大小寫、非預期字元

JUnit 基本寫法 ​

JUnit Jupiter(JUnit 5 起的 API)是 Java 的標準測試框架;Maven / Gradle 專案的測試放在 src/test/java/,以 mvn test 或 gradle test 執行。

java
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

class CalculatorTest {

    @Test
    void add_twoPositives_returnsSum() {
        // Arrange:準備輸入
        Calculator calc = new Calculator();
        // Act:呼叫受測程式
        int actual = calc.add(2, 2);
        // Assert:檢查結果
        assertEquals(4, actual);                       // 預期值在前、實際值在後
    }

    @Test
    void parse_badInput_throws() {
        assertThrows(NumberFormatException.class, () -> Integer.parseInt("abc"));
    }
}
斷言用途
assertEquals(expected, actual)相等;浮點數加容許誤差 assertEquals(0.3, x, 1e-9)
assertTrue / assertFalse條件
assertNull / assertNotNull空值
assertThrows(Type.class, () -> ...)預期丟出例外(失敗行為也是契約的一部分)
assertAll(...)多個斷言一起回報
註解用途
@Test標記測試方法
@BeforeEach / @AfterEach每個測試前後的準備與清理
@BeforeAll / @AfterAll整個類別前後執行一次(static)
@Disabled暫時跳過
@DisplayName報告中顯示的名稱

測試命名用 方法_情境_預期結果:isValidUsername_null_returnsFalse。CI 輸出失敗時,不必打開程式碼就知道哪個行為壞了。

單元測試 vs 整合測試 ​

單元測試整合測試
範圍單一元件,隔離依賴多個元件一起運作
速度快慢
失敗時容易定位要追查較多
依賴用 mock 取代真實(測試資料庫、容器)
優化精確與速度真實性

Mockito:隔離依賴 ​

依賴 (dependency) 是程式所依靠的其他元件:API client、資料庫層、外部服務。依賴慢、不確定或不受控時,單元測試用 mock 取代它。

java
import static org.mockito.Mockito.*;

@Test
void convert_mockedRate_returnsExpectedAmount() {
    RateServer bank = mock(RateServer.class);                 // 建立假的依賴
    when(bank.getRateEuroTo("JPY")).thenReturn(110.0);        // stubbing:設定回傳值

    Converter conv = new Converter(bank);                     // 依賴從建構子注入,才能替換
    assertEquals(1100.0, conv.convert(10, "JPY"), 1e-9);

    verify(bank).getRateEuroTo("JPY");                        // 驗證互動:確實呼叫了一次
    verifyNoMoreInteractions(bank);
}
重點說明
沒 stub 的方法回傳預設值(0、false、null、空集合),常讓測試以令人困惑的方式失敗
verify 何時用「有沒有呼叫」本身就是需求時(例如錯誤時要寫入 error store、成功時不寫)
可測試的設計依賴透過建構子傳入,而不是在類別內 new

參數化測試 ​

同一段邏輯用多組輸入驗證,避免複製貼上一堆幾乎相同的 @Test。

java
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.*;
import java.util.stream.Stream;

@ParameterizedTest
@NullSource                                                // 加入 null(@ValueSource 不能放 null)
@ValueSource(strings = {"", "jane doe", "a"})              // 每組一個值;屬性名是複數 strings / ints
void isValidUsername_invalid_returnsFalse(String username) {
    assertFalse(Validator.isValidUsername(username));
}

@ParameterizedTest
@CsvSource({
    "Hello World, 11",
    "DataCamp,    8",
    "'',          0"                                       // '' 代表空字串
})
void length_returnsExpected(String text, int expected) {
    assertEquals(expected, text.length());
}

@ParameterizedTest
@MethodSource("people")                                    // 物件等複雜輸入
void fullName_returnsExpected(Person p, String expected) {
    assertEquals(expected, p.fullName());
}
static Stream<Arguments> people() {
    return Stream.of(
        Arguments.of(new Person("John", "Doe"), "John Doe"),
        Arguments.of(new Person("Jane", "Doe"), "Jane Doe"));
}
來源何時用
@ValueSource單一簡單值
@NullSource / @EmptySource / @NullAndEmptySource加入 null / 空值
@CsvSource小型的多欄輸入 / 預期輸出表
@MethodSource物件或需要程式產生的輸入
@EnumSource每個 enum 值各測一次

常見錯誤 ​

錯誤說明
只測 happy path邊界與錯誤路徑最容易出 bug
assertEquals 參數順序顛倒失敗訊息的「預期 / 實際」會反過來
能用快速單元測試卻寫成整合測試測試變慢、難定位
mock 沒有 stub回傳預設值造成誤導
差異很大的案例硬塞進同一個參數化測試可讀性變差
測試之間共享可變狀態執行順序不同結果就不同