如何创建可测试的 api使用 @data 和 lombok 简化实体类代码。使用 assertj 验证 api 响应。使用 mockmvc 模拟请求和响应以测试控制器。
Java 框架中创建可测试 API 的指南
创建可测试的 API 是确保软件质量和可维护性的关键。本指南将介绍使用 Spring Boot 框架创建可测试 REST API 的最佳实践。
1. 使用 @Data 和 Lombok
@Data 注解由 Lombok 库提供,它生成getter、setter 和 toString 方法,简化了实体类代码。这使 API 响应易于测试。
1
2
3
4
5
6
@Data
public class User {
private Long id;
private String username;
private String email;
}
2. 使用 AssertJ
AssertJ 库提供简洁易用的断言语法,用于验证 API 响应。
1
2
3
4
import static org.assertj.core.api.Assertions.;
assertThat(user.getUsername()).isEqualTo("john");
assertThat(user.getEmail()).isEqualTo("john@example.com");
3. 使用 MockMVC
MockMVC 是 Spring Boot 测试模块的一部分,它提供了一种模拟请求和响应的方法,以便测试控制器。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
@ExtendWith(SpringExtension.class)
@WebMvcTest(UserController.class)
public class UserControllerTest {
@Autowired
private MockMvc mockMvc;
@Test
public void shouldGetUser() throws Exception {
mockMvc.perform(get("/api/users/1"))
.andExpect(status().isOk())
.andExpect(content().json("{\"id\": 1, \"username\": \"john\"}"));
}
}
实战案例
让我们考虑一个简单的 API,用于创建用户。
实体类:
1
2
3
4
5
6
@Data
public class User {
private Long id;
private String username;
private String email;
}
控制器:
1
2
3
4
5
6
7
8
9
10
@RestController
@RequestMapping("/api/users")
public class UserController {
@PostMapping
public User createUser(@RequestBody User user) {
// 服务逻辑,例如保存用户到数据库
return user;
}
}
测试类:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
@ExtendWith(SpringExtension.class)
@WebMvcTest(UserController.class)
public class UserControllerTest {
@Autowired
private MockMvc mockMvc;
@Test
public void shouldCreateUser() throws Exception {
User user = new User(null, "john", "john@example.com");
mockMvc.perform(post("/api/users")
.contentType(MediaType.APPLICATION_JSON)
.content(asJsonString(user)))
.andExpect(status().isOk())
.andExpect(content().json("{\"id\": 1, \"username\": \"john\"}"));
}
}
以上就是Java框架如何创建可测试的API?的详细内容,更多请关注其它相关文章!