RESTful 就是一种按照HTTP协议规范来设计的通讯方式。它让你在通讯的过程中，把你的操作理解成一个“资源的操作”，就好比你操作一个书库的书一样，你可以从书库中获取一本书（GET），你可以把一本书放回书库（PUT），也可以从书库里删除一本书（DELETE），或者把新书加入书库（POST），等等。
RESTful让你把互相通讯的内容格式化成一种标准的形式（比如XML或JSON），这种格式方便双方在互相通讯时理解和处理，同时也提高了通讯的效率和可读性。
简介
RESTful API 通常被用于支持前后端分离的 web 应用程序。客户端（通常是前端）将请求发送到服务器，然后服务器响应。响应的格式通常是 JSON 字符串。
Spring Boot 和 Spring MVC（Model-View-Controller）框架可以帮助您构建 RESTful API，支持匹配 RESTful API 的 URL。Spring Boot 还可以预加载许多框架，从而使开发这些应用程序变得更加容易。
使用场景
Spring Boot 实现 RESTful 请求的场景非常广泛，适用于以下场景：
- 前后端分离的 web 应用程序，前端将请求发送到服务器端并接收 JSON 字符串响应。
- 应用程序的微服务架构，若不同微服务之间需要进行通信，则需要使用 RESTful API 进行通信。
原理分析
Spring Boot 和 Spring MVC 可以让您很方便地构建 RESTful API，无论是为单独的 web 应用程序还是作为大型分布式系统的一部分，都是非常有利的。以下是 Spring Boot 支持的 HTTP 方法：
- GET - 用于获取资源
- POST - 用于创建资源
- PUT - 用于更新资源
- DELETE - 用于删除资源
Spring Boot 支持通过设置“Content-Type” HTTP 标头来指定请求和响应的表示形式，常用的格式有 JSON、XML 和 HTML 等。
Spring MVC 使用控制器（Controller）和注解来处理 RESTful API 请求和响应，而不是传统的 servlet。通过注解，您可以将 URL 映射到请求处理方法。
代码示例
以下是使用 Spring Boot 实现的 RESTful 请求示例代码：
@RestController
@RequestMapping("/users")
public class UserController {
private final UserService userService;
public UserController(UserService userService) {
this.userService = userService;
}
@GetMapping("/")
public ResponseEntity<List<User>> getAllUsers() {
List<User> allUsers = userService.getAllUsers();
return new ResponseEntity<>(allUsers, HttpStatus.OK);
}
@GetMapping("/{id}")
public ResponseEntity<User> getUser(@PathVariable("id") Integer id) {
User user = userService.getUserById(id);
if (user == null) {
return new ResponseEntity<>(HttpStatus.NOT_FOUND);
}
return new ResponseEntity<>(user, HttpStatus.OK);
}
@PostMapping("/")
public ResponseEntity<User> createUser(@RequestBody @Valid User newUser) {
User createdUser = userService.createUser(newUser);
return new ResponseEntity<>(createdUser, HttpStatus.CREATED);
}
@PutMapping("/{id}")
public ResponseEntity<?> updateUser(@PathVariable("id") Integer id, @RequestBody User user) {
boolean updated = userService.updateUser(id, user);
if (updated) {
return new ResponseEntity<>(HttpStatus.OK);
} else {
return new ResponseEntity<>(HttpStatus.NOT_FOUND);
}
}
@DeleteMapping("/{id}")
public ResponseEntity<Void> deleteUser(@PathVariable("id") Integer id) {
userService.deleteUser(id);
return new ResponseEntity<>(HttpStatus.NO_CONTENT);
}
}
以上代码实现了一个简单的用户管理功能，包括查看所有用户、查看特定用户、创建用户、更新用户和删除用户等操作。
-
@RestController注释表示 Usercontroller 类是一个 RESTful 控制器。 -
@RequestMapping注释指定所有请求都位于/users路径下。 -
@GetMapping、@PostMapping、@PutMapping和@DeleteMapping注释分别指定 GET、POST、PUT 和 DELETE 操作的路径。
此外，该示例中还使用了 Spring Boot 内置的 ResponseEntity 类库。它可以设置 HTTP 响应状态码、HTTP headers 和响应数据，并返回封装了响应数据和状态的 ResponseEntity 对象。
总结
Spring Boot 可以很容易地实现 RESTful API，它包含了许多库和工具，可以让您快速开始使用。在 Spring Boot 应用程序中，控制器通过注解处理 HTTP 请求和响应，并返回指定格式的数据。对于不同的 HTTP 方法，使用对应的注解来实现。
