知識庫 / Spring RSS 訂閱

http://localhost:8080/spring-mvc-test/greetWithPost

我們應該獲得以下輸出：

{
    "id": 1,
    "message": "Hello World!!!"
}

我們的測試代碼如下：

@Test
public void givenGreetURIWithPost_whenMockMVC_thenVerifyResponse() {
    this.mockMvc.perform(post("/greetWithPost")).andDo(print())
      .andExpect(status().isOk()).andExpect(content()
      .contentType("application/json;charset=UTF-8"))
      .andExpect(jsonPath("$.message").value("Hello World!!!"));
}

MockMvcRequestBuilders.post(“/greetWithPost”) 將發送 POST 請求。 我們可以以與之前類似的方式設置路徑變量和查詢參數，而表單數據只能通過 param() 方法設置，類似於查詢參數，如下所示：

http://localhost:8080/spring-mvc-test/greetWithPostAndFormData

然後數據將會是：

id=1;name=John%20Doe

因此，我們應該得到:

{
    "id": 1,
    "message": "Hello World John Doe!!!"
}

讓我們看看我們的測試：

@Test
public void givenGreetURI_whenMockMVC_thenVerifyResponse() throws Exception {
    MvcResult mvcResult = this.mockMvc.perform(MockMvcRequestBuilders.get("/greet"))
      .andDo(print())
      .andExpect(MockMvcResultMatchers.status().isOk())
      .andExpect(MockMvcResultMatchers.jsonPath("$.message").value("Hello World!!!"))
      .andReturn();
 
   assertEquals("application/json;charset=UTF-8", mvcResult.getResponse().getContentType());
}

在上面的代碼片段中，我們添加了兩個參數：id 為“1”，name 為“John Doe”。

5. MockMvc 的侷限性

MockMvc 提供了一個優雅且易於使用的 API，用於調用 Web 端點，並在同一時間對其響應進行檢查和斷言。儘管它有很多優點，但它也有一些侷限性。

首先，它使用的是 DispatcherServlet 的子類來處理測試請求。更具體地説，TestDispatcherServlet 負責調用控制器並執行所有熟悉的 Spring 魔法。

MockMvc 類內部使用 包裝 了這個 TestDispatcherServlet。因此，每次我們使用 perform() 方法發送請求時，MockMvc 將直接使用底層的 TestDispatcherServlet。因此，不會建立任何實際的網絡連接，並且因此，使用 MockMvc 時，我們無法測試整個網絡堆棧。

此外，由於 Spring 準備了一個虛假的 Web 應用上下文來模擬 HTTP 請求和響應，因此它可能不支持完整版的 Spring 應用的所有功能。

例如，這個模擬設置不支持 HTTP 重定向。這在最初可能看起來不太重要。但是，Spring Boot 通過將當前請求重定向到 /error 端點來處理某些錯誤。因此，如果使用 MockMvc，我們可能無法測試某些 API 故障。

作為 MockMvc 的替代方案，我們可以設置一個更真實的應用程序上下文，然後使用 RestTemplate，甚至 REST-assured 來測試我們的應用程序。

例如，這在 Spring Boot 中很容易實現：

@SpringBootTest(webEnvironment = DEFINED_PORT)
public class GreetControllerRealIntegrationTest {

    @Before
    public void setUp() {
        RestAssured.port = DEFAULT_PORT;
    }

    @Test
    public void givenGreetURI_whenSendingReq_thenVerifyResponse() {
        given().get("/greet")
          .then()
          .statusCode(200);
    }
}

在這裏，我們甚至不需要添加 @ExtendWith(SpringExtension.class)。

這樣一來，每個測試都會向監聽在隨機 TCP 端口上的應用程序發出真實的 HTTP 請求。

6. 結論

在本文中，我們實施了幾項簡單的 Spring 支持集成測試。

我們還考察了 WebApplicationContext 和 MockMvc 對象創建，這在調用應用程序端點的過程中起着重要作用。

進一步地，我們討論瞭如何通過參數傳遞的變化發送 GET 和 POST 請求，以及如何驗證 HTTP 響應狀態、標題和內容。

然後，我們評估了 MockMvc 的一些侷限性。瞭解這些侷限性可以幫助我們做出明智的決策，關於我們如何實現測試。