springmvc之單元測試（MockMvc）-獨立測試

spring mvc測試框架提供了兩種方式，獨立安裝和集成Web環境測試（此種方式並不會集成真正的web環境，而是通過相應的Mock API進行模擬測試，無須啟動服務器）

1、mockMvc.perform執行一個請求；

2、MockMvcRequestBuilders.get("/user/1")構造一個請求

3、ResultActions.andExpect添加執行完成后的斷言

4、ResultActions.andDo添加一個結果處理器，表示要對結果做點什么事情，比如此處使用MockMvcResultHandlers.print()輸出整個響應結果信息。

5、ResultActions.andReturn表示執行完成后返回相應的結果。

MockMvcBuilder是用來構造MockMvc的構造器，其主要有兩個實現：StandaloneMockMvcBuilder和DefaultMockMvcBuilder，StandaloneMockMvcBuilder繼承了DefaultMockMvcBuilder。直接使用靜態工廠MockMvcBuilders創建即可：

MockMvcBuilders.webAppContextSetup(WebApplicationContext context)：指定WebApplicationContext，將會從該上下文獲取相應的控制器並得到相應的MockMvc；

MockMvcBuilders.standaloneSetup(Object... controllers)：通過參數指定一組控制器，這樣就不需要從上下文獲取了；

其中DefaultMockMvcBuilder還提供了如下API：

addFilters(Filter... filters)/addFilter(Filter filter, String... urlPatterns)：添加javax.servlet.Filter過濾器

defaultRequest(RequestBuilder requestBuilder)：默認的RequestBuilder，每次執行時會合並到自定義的RequestBuilder中，即提供公共請求數據的；

alwaysExpect(ResultMatcher resultMatcher)：定義全局的結果驗證器，即每次執行請求時都進行驗證的規則；

alwaysDo(ResultHandler resultHandler)：定義全局結果處理器，即每次請求時都進行結果處理；

dispatchOptions：DispatcherServlet是否分發OPTIONS請求方法到控制器；

 

StandaloneMockMvcBuilder繼承了DefaultMockMvcBuilder，又提供了如下API：

setMessageConverters(HttpMessageConverter<?>...messageConverters)：設置HTTP消息轉換器；

setValidator(Validator validator)：設置驗證器；

setConversionService(FormattingConversionService conversionService)：設置轉換服務；

addInterceptors(HandlerInterceptor... interceptors)/addMappedInterceptors(String[] pathPatterns, HandlerInterceptor... interceptors)：添加spring mvc攔截器；

setContentNegotiationManager(ContentNegotiationManager contentNegotiationManager)：設置內容協商管理器；

setAsyncRequestTimeout(long timeout)：設置異步超時時間；

setCustomArgumentResolvers(HandlerMethodArgumentResolver... argumentResolvers)：設置自定義控制器方法參數解析器；

setCustomReturnValueHandlers(HandlerMethodReturnValueHandler... handlers)：設置自定義控制器方法返回值處理器；

setHandlerExceptionResolvers(List<HandlerExceptionResolver> exceptionResolvers)/setHandlerExceptionResolvers(HandlerExceptionResolver... exceptionResolvers)：設置異常解析器；

setViewResolvers(ViewResolver...resolvers)：設置視圖解析器；

setSingleView(View view)：設置單個視圖，即視圖解析時總是解析到這一個（僅適用於只有一個視圖的情況）；

setLocaleResolver(LocaleResolver localeResolver)：設置Local解析器；

setFlashMapManager(FlashMapManager flashMapManager)：設置FlashMapManager，如存儲重定向數據；

setUseSuffixPatternMatch(boolean useSuffixPatternMatch)：設置是否是后綴模式匹配，如“/user”是否匹配"/user.*"，默認真即匹配；

setUseTrailingSlashPatternMatch(boolean useTrailingSlashPatternMatch)：設置是否自動后綴路徑模式匹配，如“/user”是否匹配“/user/”，默認真即匹配；

addPlaceHolderValue(String name, String value) ：添加request mapping中的占位符替代；

因為StandaloneMockMvcBuilder不會加載Spring MVC配置文件，因此就不會注冊我們需要的一些組件，因此就提供了如上API用於注冊我們需要的相應組件。

　　

　　perform：執行一個RequestBuilder請求，會自動執行SpringMVC的流程並映射到相應的控制器執行處理；

　　andExpect：添加ResultMatcher驗證規則，驗證控制器執行完成后結果是否正確；

　　andDo：添加ResultHandler結果處理器，比如調試時打印結果到控制台；

　　andReturn：最后返回相應的MvcResult；然后進行自定義驗證/進行下一步的異步處理；

 

MockMvcRequestBuilders主要API：

MockHttpServletRequestBuilder get(String urlTemplate, Object... urlVariables)：根據uri模板和uri變量值得到一個GET請求方式的MockHttpServletRequestBuilder；如get("/user/{id}", 1L)；

MockHttpServletRequestBuilder post(String urlTemplate, Object... urlVariables)：同get類似，但是是POST方法；

MockHttpServletRequestBuilder put(String urlTemplate, Object... urlVariables)：同get類似，但是是PUT方法；

MockHttpServletRequestBuilder delete(String urlTemplate, Object... urlVariables) ：同get類似，但是是DELETE方法；

MockHttpServletRequestBuilder options(String urlTemplate, Object... urlVariables)：同get類似，但是是OPTIONS方法；

 

ResultActions

調用MockMvc.perform(RequestBuilder requestBuilder)后將得到ResultActions，通過ResultActions完成如下三件事：

ResultActions andExpect(ResultMatcher matcher) ：添加驗證斷言來判斷執行請求后的結果是否是預期的；

ResultActions andDo(ResultHandler handler) ：添加結果處理器，用於對驗證成功后執行的動作，如輸出下請求/結果信息用於調試；

MvcResult andReturn() ：返回驗證成功后的MvcResult；用於自定義驗證/下一步的異步處理；(主要是拿到結果進一步做自定義斷言)

 

String requestBody = "{\"id\":1, \"name\":\"zhang\"}";
mockMvc.perform(post("/user")
            .contentType(MediaType.APPLICATION_JSON).content(requestBody)
            .accept(MediaType.APPLICATION_JSON)) //執行請求
        .andExpect(content().contentType(MediaType.APPLICATION_JSON)) //驗證響應contentType
        .andExpect(jsonPath("$.id").value(1)); //使用Json path驗證JSON 請參考http://goessner.net/articles/JsonPath/

String errorBody = "{id:1, name:zhang}";
MvcResult result = mockMvc.perform(post("/user")
        .contentType(MediaType.APPLICATION_JSON).content(errorBody)
        .accept(MediaType.APPLICATION_JSON)) //執行請求
        .andExpect(status().isBadRequest()) //400錯誤請求
        .andReturn();

 

import org.junit.Before;
import org.junit.runner.RunWith;
import org.junit.Test;
import org.springframework.boot.SpringBootConfiguration;
import org.springframework.boot.test.SpringApplicationConfiguration;
import org.springframework.http.MediaType;
import org.springframework.mock.web.MockSessionCookieConfig;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
import org.springframework.test.context.web.WebAppConfiguration;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.RequestBuilder;
import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
import org.springframework.test.web.servlet.result.MockMvcResultHandlers;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
import org.sselab.controller.HelloController;
import org.sselab.controller.TestController;

import java.nio.charset.Charset;

import static org.hamcrest.Matchers.equalTo;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.*;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;

/**
 * Created by pinker on 2016/10/26.
 */
@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(classes = MockSessionCookieConfig.class)
@WebAppConfiguration
public class TestJunit {
    private MockMvc mvc;

    @Before
    public void setUp() throws Exception {
        mvc = MockMvcBuilders.standaloneSetup(new HelloController(), new TestController()).build();
    }

    @Test
    public void testHelloController() throws Exception {
        mvc.perform(MockMvcRequestBuilders.get("/hello").accept(MediaType.APPLICATION_JSON))
                .andExpect(status().isOk())
                .andExpect(content().string(equalTo("Hello")));
    }

    @Test
    public void testController() throws Exception {
        //get查一下列表應該為空。
        RequestBuilder request = null;
        request = get("/user");
        mvc.perform(request)
                .andDo(MockMvcResultHandlers.print())
                .andExpect(status().isOk())
                .andExpect(content().string(equalTo("[]")));
        //插入一個數據
        request = post("/user").param("id", "2").param("name", "HS").param("age", "24");
        mvc.perform(request)
                .andDo(MockMvcResultHandlers.print())
                .andExpect(content().string(equalTo("success")));
        //檢查剛才插入的數據
        request = get("/user");
        mvc.perform(request)
                .andDo(MockMvcResultHandlers.print())
                .andExpect(status().isOk())
                .andExpect(content().string(equalTo("[{\"id\":2,\"name\":\"HS\",\"age\":24}]")));
        //測試put方法
        request = put("/user/2")
                .param("name", "HGod")
                .param("age", "24");
        mvc.perform(request)
                .andDo(MockMvcResultHandlers.print())
                .andExpect(status().isOk())
                .andExpect(content().string(equalTo("success!")));
        //測試獲得一個用戶的get方法
        request=get("/user/2");
        mvc.perform(request)
                .andDo(MockMvcResultHandlers.print())
                .andExpect(content().string(equalTo("{\"id\":2,\"name\":\"HGod\",\"age\":24}")));
        //測試刪除用戶
        request=delete("/user/2");
        mvc.perform(request)
                .andDo(MockMvcResultHandlers.print())
                .andExpect(content().string(equalTo("success")))
                .andReturn();
    }
}