Spring Boot是Spring框架的一个子项目,它简化了Spring应用的初始搭建以及开发过程。REST API(Representational State Transfer API)是一种用于构建网络服务的架构风格。本教程将介绍如何在Spring Boot中创建REST API。
简介
Spring Boot REST API允许你轻松地创建基于HTTP的API。这些API可以用来提供数据、执行操作或与外部系统交互。
快速开始
以下是一个简单的Spring Boot REST API示例:
@RestController
@RequestMapping("/api")
public class UserController {
@GetMapping("/users")
public List<User> getAllUsers() {
// 返回所有用户
return Arrays.asList(new User(1, "Alice"), new User(2, "Bob"));
}
}
在这个例子中,我们创建了一个UserController
类,其中包含一个getAllUsers
方法。这个方法使用@GetMapping
注解来映射HTTP GET请求到/api/users
路径。
路径参数
路径参数允许你从URL中获取信息。以下是如何使用路径参数:
@GetMapping("/users/{id}")
public User getUserById(@PathVariable Long id) {
// 根据ID获取用户
return new User(id, "Alice");
}
在这个例子中,{id}
是一个路径参数,它表示用户ID。
请求体参数
请求体参数允许你在请求体中发送数据。以下是如何使用请求体参数:
@PostMapping("/users")
public User createUser(@RequestBody User user) {
// 创建用户
return user;
}
在这个例子中,@RequestBody
注解将请求体中的JSON数据映射到User
对象。
响应
Spring Boot REST API允许你返回不同类型的响应。以下是如何返回不同类型的响应:
@GetMapping("/users")
public ResponseEntity<List<User>> getAllUsers() {
// 返回所有用户
return ResponseEntity.ok(Arrays.asList(new User(1, "Alice"), new User(2, "Bob")));
}
在这个例子中,我们使用ResponseEntity
来返回一个包含用户列表的响应。
扩展阅读
想要了解更多关于Spring Boot REST API的信息,请查看以下链接:
图片
Spring Boot REST API的架构图: