Spring Boot中的RESTful API详细介绍及使用

在Spring Boot中，RESTful API的实现通过控制器类中的方法和特定的注解来完成。每个注解对应不同的HTTP请求方法，并通过处理请求参数和返回响应来实现不同的操作。

下面将详细解释RESTful API中的各个方面，包括@GetMapping, @PostMapping, @PutMapping, 和 @DeleteMapping的作用及区别、请求参数和返回参数。

作用及区别

1. @GetMapping:

   • 作用: 处理HTTP GET请求，用于获取资源。通常用于读取数据，不应更改服务器上的资源。
   • 区别: 是幂等的，多次请求相同资源不会改变服务器状态。
   • 示例:

     1. @GetMapping("/users")

     2. public List<User> getAllUsers() {

     3. // 获取所有用户

     4. }

     6. @GetMapping("/users/{id}")

     7. public User getUserById(@PathVariable Long id) {

     8. // 获取指定ID的用户

     9. }

2. @PostMapping:

   • 作用: 处理HTTP POST请求，用于创建新资源。通常用于提交数据，服务器会创建新的资源。
   • 区别: 不是幂等的，多次请求会创建多个资源。
   • 示例:

     1. @PostMapping("/users")

     2. public User createUser(@RequestBody User user) {

     3. // 创建新用户

     4. }

3. @PutMapping:

   • 作用: 处理HTTP PUT请求，用于更新资源。通常用于更新现有资源的全部内容。
   • 区别: 是幂等的，多次请求相同资源会导致相同的更新结果。
   • 示例:

     1. @PutMapping("/users/{id}")

     2. public User updateUser(@PathVariable Long id, @RequestBody User user) {

     3. // 更新指定ID的用户

     4. }

4. @DeleteMapping:

   • 作用: 处理HTTP DELETE请求，用于删除资源。通常用于删除服务器上的资源。
   • 区别: 是幂等的，多次请求相同资源删除操作只会导致资源被删除一次。
   • 示例:

     1. @DeleteMapping("/users/{id}")

     2. public void deleteUser(@PathVariable Long id) {

     3. // 删除指定ID的用户

     4. }

请求参数

1. @RequestBody:

   • 作用: 将请求体中的JSON数据绑定到方法参数上。
   • 使用场景: 常用于@PostMapping和@PutMapping。
   • 示例:

     1. @PostMapping("/users")

     2. public User createUser(@RequestBody User user) {

     3. // 请求体中的JSON数据将绑定到user对象

     4. }

2. @PathVariable:

   • 作用: 将URL路径中的变量绑定到方法参数上。
   • 使用场景: 常用于@GetMapping, @PutMapping, 和 @DeleteMapping。
   • 示例:

     1. @GetMapping("/users/{id}")

     2. public User getUserById(@PathVariable Long id) {

     3. // URL中的id将绑定到方法参数id

     4. }

3. @RequestParam:

   • 作用: 将查询参数绑定到方法参数上。
   • 使用场景: 适用于各种HTTP方法。
   • 示例:

     1. @GetMapping("/users")

     2. public List<User> getUsersByAge(@RequestParam int age) {

     3. // URL中的查询参数age将绑定到方法参数age

     4. }

返回参数

1. 返回对象:

   • 作用: 方法可以直接返回对象，Spring Boot会自动将其转换为JSON格式。
   • 示例:

     1. @GetMapping("/users/{id}")

     2. public User getUserById(@PathVariable Long id) {

     3. // 返回User对象，自动转换为JSON

     4. }

2. ResponseEntity:

   • 作用: 可以自定义HTTP响应状态码、响应头和响应体。
   • 示例:

     1. @PostMapping("/users")

     2. public ResponseEntity<User> createUser(@RequestBody User user) {

     3. User createdUser = userService.createUser(user);

     4. return ResponseEntity.status(HttpStatus.CREATED).body(createdUser);

     5. }

综合示例

1. @RestController

2. @RequestMapping("/api/users")

3. public class UserController {

5. @GetMapping

6. public List<User> getAllUsers() {

7. // 获取所有用户

8. return userService.findAll();

9. }

11. @GetMapping("/{id}")

12. public ResponseEntity<User> getUserById(@PathVariable Long id) {

13. User user = userService.findById(id);

14. if (user == null) {

15. return ResponseEntity.notFound().build();

16. }

17. return ResponseEntity.ok(user);

18. }

20. @PostMapping

21. public ResponseEntity<User> createUser(@RequestBody User user) {

22. User createdUser = userService.createUser(user);

23. return ResponseEntity.status(HttpStatus.CREATED).body(createdUser);

24. }

26. @PutMapping("/{id}")

27. public ResponseEntity<User> updateUser(@PathVariable Long id, @RequestBody User user) {

28. User updatedUser = userService.updateUser(id, user);

29. if (updatedUser == null) {

30. return ResponseEntity.notFound().build();

31. }

32. return ResponseEntity.ok(updatedUser);

33. }

35. @DeleteMapping("/{id}")

36. public ResponseEntity<Void> deleteUser(@PathVariable Long id) {

37. userService.deleteUser(id);

38. return ResponseEntity.noContent().build();

39. }

40. }

总结

Spring Boot中的RESTful API通过使用@GetMapping, @PostMapping, @PutMapping, 和 @DeleteMapping注解，使得每种HTTP请求类型都能简便地映射到控制器的方法上。

通过@RequestBody, @PathVariable, 和 @RequestParam处理请求参数，并利用返回对象或ResponseEntity构建响应，使得RESTful API的开发变得高效且易维护。