知識庫 / Spring / Spring Boot RSS 訂閱

@RunWith(CustomRunner.class)
class JUnit4Test {
    // ...
}

正如我們所知，JUnit 4 現在處於停用狀態，已被 JUnit 5 取代。 新版本帶來了全新的引擎以及重寫的 API。 它還改變了擴展模型的概念。 現在，我們不再需要實現自定義的 Runner 或 Rule 類，而是可以使用 Extension API，並使用 @ExtendWith 註解：

@ExtendWith(CustomExtensionOne.class)
@ExtendWith(CustomExtensionTwo.class)
class JUnit5Test {
    // ...
}

與之前的跑步者模型不同，我們可以為單個類提供多個擴展。之前交付的跑步者模型也已針對其擴展版本進行了重寫。

3. Spring 示例應用程序

為了更好地理解，我們來介紹一個簡單的 Spring Boot 應用程序——一個將給定字符串映射為大寫的轉換器。

讓我們從數據提供者的實現開始：

@Component
public class DataProvider {
    
    private final List<String> memory = List.of("baeldung", "java", "dummy");
    
    public Stream<String> getValues() {
        return memory.stream();
    }
}

我們剛剛創建了一個包含硬編碼字符串值的 Spring 組件。 此外，它還提供了一個方法，用於流式傳輸這些字符串。

其次，讓我們實現一個服務類，用於轉換這些值：

@Service
public class StringConverter {
    
    private final DataProvider dataProvider;

    @Autowired
    public StringConverter(DataProvider dataProvider) {
        this.dataProvider = dataProvider;
    }
    
    public List<String> convert() {
        return dataProvider.getValues().map(String::toUpperCase).toList();
    }
}

這是一個簡單的 Bean，它從先前創建的 DataProvider 中獲取數據並應用大寫映射。

現在，我們可以使用我們的應用程序來創建 JUnit 測試。我們將看到 SpringRunner 和 MockitoJUnitRunner 類之間的差異。

4. MockitoJUnitRunner

我們知道，Mockito 是一個用於伴隨其他測試框架使用的 Mocking 框架，用於返回虛假數據並避免外部依賴。該庫為我們提供 MockitoJUnitRunner – 一個專門為 JUnit 4 設計的運行器，用於集成 Mockito 並充分利用該庫的功能。

現在，讓我們為 StringConverter 創建第一個測試：

public class StringConverterTest {
    @Mock
    private DataProvider dataProvider;

    @InjectMocks
    private StringConverter stringConverter;
    
    @Test
    public void givenStrings_whenConvert_thenReturnUpperCase() {
        Mockito.when(dataProvider.getValues()).thenReturn(Stream.of("first", "second"));

        val result = stringConverter.convert();

        Assertions.assertThat(result).contains("FIRST", "SECOND");
    }
}

我們剛剛模擬了 DataProvider 以返回兩個字符串。但是，如果運行它，測試就會失敗：

java.lang.NullPointerException: Cannot invoke "DataProvider.getValues()" because "this.dataProvider" is null

那是因為我們的 Mock 沒有正確初始化。<em @Mock@</em> 和 <em @InjectMocks@</em> 註解目前沒有任何作用。我們可以通過實現 <em init()@</em> 方法來解決這個問題：

@Before
public void init() {
    MockitoAnnotations.openMocks(this);
}

如果不想使用註解，我們也可以通過程序方式創建和注入模擬對象：

@Before
public void init() {
    dataProvider = Mockito.mock(DataProvider.class);
    stringConverter = new StringConverter(dataProvider);
}

我們已經通過使用 Mockito API 程序化地初始化了 mock 對象。現在，測試正常工作，我們的斷言也通過了。

接下來，讓我們回到我們第一次版本，刪除 init() 方法，並使用 MockitoJUnitRunner 註解該類：

@RunWith(MockitoJUnitRunner.class)
public class StringConverterTest {
    // ...
}

再次測試成功。我們調用了一個自定義的運行器，它負責管理我們的模擬對象。我們無需手動初始化它們。

總結一下，MockitoJUnitRunner 是專門為 Mockito 框架設計的運行器。它負責初始化 @Mock、@Spy 和 @InjectMock 註解，因此無需使用 MockitoAnnotations.openMocks() 進行顯式操作。 此外，它在每個測試方法後檢測未使用的樁對象並驗證 Mockito 的使用，就像 Mockito.validateMockitoUsage() 所做的那樣。

請記住，所有運行器最初都是為 JUnit 4 設計的。 如果我們想使用 Mockito 註解與 JUnit 5 配合使用，可以使用 MockitoExtension：

@ExtendWith(MockitoExtension.class)
public class StringConverterTest {
    // ...
}

此擴展將 MockitoJUnitRunner 的功能移植到新的擴展模型中。

5. SpringRunner

如果深入分析我們的測試，我們會發現，儘管使用了 Spring，我們實際上並沒有啓動任何 Spring 容器。現在，讓我們嘗試修改我們的示例並初始化 Spring 上下文。

首先，代替 MockitoJUnitRunner，我們只需將其替換為 SpringRunner 類並查看結果：

@RunWith(SpringRunner.class)
public class StringConverterTest {
    // ...
}

如前所述，測試通過，並且 Mock 對象已正確初始化。 此外，Spring Context 也在運行中。 可以得出結論，SpringRunner 不僅能夠啓用 Mockito 註解，就像 MockitoJUnitRunner 也能做到，還能夠初始化 Spring Context。

@ContextConfiguration(classes = StringConverter.class)
@RunWith(SpringRunner.class)
public class StringConverterTest {
    @MockBean
    private DataProvider dataProvider;

    @Autowired
    private StringConverter stringConverter;

    // ...
}

@ExtendWith(SpringExtension.class)
public class StringConverterTest {
    // ...
}