集成测试

我们从 Hello World 项目入手，增加单元测试功能。

我们新家了一个名为hello-world-test的 Gradle 项目。

环境

  • Gradle 3.4.1
  • Spring Boot 1.5.2.RELEASE
  • Thymeleaf 3.0.3.RELEASE
  • Thymeleaf Layout Dialect 2.2.0
  • Spring Security Test 4.2.2.RELEASE

build.gradle

1. 修改项目的名称

修改 build.gradle 文件，让我们的hello-world项目成为一个新的项目。

修改内容也比较简单，修改项目名称及版本即可。

  1. jar {
  2.     baseName = 'hello-world-test'
  3.     version = '1.0.0'
  4. }

2. 指定依赖

  1. // 依赖关系
  2. dependencies {
  3.     ......
  4.     // 该依赖对于编译测试是必须的，默认包含编译产品依赖和编译时依
  5.     testCompile('org.springframework.security:spring-security-test:4.2.2.RELEASE')
  6.     ......
  7. }

编写测试类

测试 /users

首先我们测试 /users接口，编写UserControllerTest.java ：

  1. @RunWith(SpringRunner.class)
  2. @SpringBootTest
  3. @AutoConfigureMockMvc
  4. public class UserControllerTest {
  6.     @Autowired
  7.     private MockMvc mockMvc;
  9.     @Test
  10.     public void testList() throws Exception {
  11.         mockMvc.perform(MockMvcRequestBuilders.get("/users"))
  12.             .andExpect(status().isOk());
  13.     }
  14. }

运行 JUnit，结果是测试没有通过。在控制台，我们能看到如下请求和相应的结果：

  2. MockHttpServletRequest:
  3.       HTTP Method = GET
  4.       Request URI = /users
  5.        Parameters = {}
  6.           Headers = {}
  8. Handler:
  9.              Type = null
  11. Async:
  12.     Async started = false
  13.      Async result = null
  15. Resolved Exception:
  16.              Type = null
  18. ModelAndView:
  19.         View name = null
  20.              View = null
  21.             Model = null
  23. FlashMap:
  24.        Attributes = null
  26. MockHttpServletResponse:
  27.            Status = 302
  28.     Error message = null
  29.           Headers = {X-Content-Type-Options=[nosniff], X-XSS-Protection=[1; mode=block], Cache-Control=[no-cache, no-store, max-age=0, must-revalidate], Pragma=[no-cache], Expires=[0], X-Frame-Options=[DENY], Location=[http://localhost/login]}
  30.      Content type = null
  31.              Body = 
  32.     Forwarded URL = null
  33.    Redirected URL = http://localhost/login
  34.           Cookies = []

可以看到响应的状态码为 302，重定向到了 http://localhost/login URL。

我们再次修改测试接口，这一次我们使用 mock 用户名为“waylau”角色权限为“USER”的用户：

  1. @Test
  2. @WithMockUser(username="waylau", password="123456", roles={"USER"})  // mock 了一个用户
  3. public void testListWithUser() throws Exception {
  4.     mockMvc.perform(MockMvcRequestBuilders.get("/users"))
  5.         .andExpect(status().isOk());
  6. }

这次，我们的测试用例通过。如果我们把用的角色权限改为“ADMIN”，会怎么样呢？

  1. MockHttpServletRequest:
  2.       HTTP Method = GET
  3.       Request URI = /users
  4.        Parameters = {}
  5.           Headers = {}
  7. Handler:
  8.              Type = null
  10. Async:
  11.     Async started = false
  12.      Async result = null
  14. Resolved Exception:
  15.              Type = null
  17. ModelAndView:
  18.         View name = null
  19.              View = null
  20.             Model = null
  22. FlashMap:
  23.        Attributes = null
  25. MockHttpServletResponse:
  26.            Status = 403
  27.     Error message = Access is denied
  28.           Headers = {X-Content-Type-Options=[nosniff], X-XSS-Protection=[1; mode=block], Cache-Control=[no-cache, no-store, max-age=0, must-revalidate], Pragma=[no-cache], Expires=[0], X-Frame-Options=[DENY]}
  29.      Content type = null
  30.              Body = 
  31.     Forwarded URL = null
  32.    Redirected URL = null
  33.           Cookies = []

看到测试失败后，控制台打印的信息，状态码为 403，错误信息为 “Access is denied”。