Class MockMvc

java.lang.Object
org.springframework.test.web.servlet.MockMvc

public final class MockMvc extends Object
Main entry point for server-side Spring MVC test support.

Example

 import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.*;
 import static org.springframework.test.web.servlet.setup.MockMvcBuilders.*;

 // ...

 WebApplicationContext wac = ...;

 MockMvc mockMvc = webAppContextSetup(wac).build();

 mockMvc.perform(get("/form"))
     .andExpectAll(
         status().isOk(),
         content().contentType("text/html"),
         forwardedUrl("/WEB-INF/layouts/main.jsp")
     );
 
Since:
3.2
Author:
Rossen Stoyanchev, Rob Winch, Sam Brannen
  • Method Details

    • getDispatcherServlet

      public org.springframework.web.servlet.DispatcherServlet getDispatcherServlet()
      Return the underlying DispatcherServlet instance that this MockMvc was initialized with.

      This is intended for use in custom request processing scenario where a request handling component happens to delegate to the DispatcherServlet at runtime and therefore needs to be injected with it.

      For most processing scenarios, simply use perform(org.springframework.test.web.servlet.RequestBuilder), or if you need to configure the DispatcherServlet, provide a DispatcherServletCustomizer to the MockMvcBuilder.

      Since:
      5.1
    • perform

      public ResultActions perform(RequestBuilder requestBuilder) throws Exception
      Perform a request and return a type that allows chaining further actions, such as asserting expectations, on the result.
      Parameters:
      requestBuilder - used to prepare the request to execute; see static factory methods in MockMvcRequestBuilders
      Returns:
      an instance of ResultActions (never null)
      Throws:
      Exception
      See Also: