@RestController
@RequestMapping("/api")
public class HelloController {
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, World!";
    }
}

@RestController
@RequestMapping("/api")
public class UserController {
    @GetMapping("/users")
    public List<User> getUsers(@RequestParam(value = "page", defaultValue = "0") int page,
                               @RequestParam(value = "size", defaultValue = "10") int size) {
        // 获取用户列表
    }
}

@RestController
@RequestMapping("/api")
public class UserController {
    @PostMapping("/users")
    public User createUser(@RequestBody User user) {
        // 创建用户
    }
}

@RestController
@RequestMapping("/api")
public class UserController {
    @GetMapping("/users/{id}")
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public void getUser(@PathVariable("id") Long id) {
        // 获取用户
        if (user == null) {
            throw new UserNotFoundException(id);
        }
    }
}

Spring Boot 中的 @RestController 注解是什么，原理，如何使用
前言
在现代化的 Web 应用程序中，RESTful API 是一种流行的架构风格，可以让客户端和服务器之间实现松散耦合的通信。Spring Boot 提供了 @RestController 注解，用于将 Java 类转换为 RESTful API 控制器。本文将介绍 @RestController 注解的原理和使用方法。
什么是 @RestController 注解
@RestController 注解是 Spring Boot 提供的一种注解，它是在 @Controller 注解的基础上添加了 @ResponseBody 注解。@Controller 注解用于标识一个类为控制器，而 @ResponseBody 注解用于指定将方法返回的对象转换为 JSON 或 XML 格式的响应体。
使用 @RestController 注解可以方便地将 Java 类转换为 RESTful API 控制器，以便用于处理 HTTP 请求和响应。
@RestController 注解的原理
当 Spring Boot 应用程序接收到 HTTP 请求时，它会查找与请求 URL 匹配的 @RestController 控制器。如果找到了匹配的控制器，Spring Boot 将调用匹配方法并将其返回值转换为 JSON 或 XML 响应体，并将其发送回客户端。
@RestController 注解的原理是使用 Spring MVC 框架来处理 HTTP 请求和响应。Spring MVC 框架使用 @RequestMapping 注解将请求 URL 映射到控制器方法，并使用 @ResponseBody 注解将方法返回的对象转换为响应体。@RestController 注解是 @Controller 和 @ResponseBody 注解的组合，可以方便地实现 RESTful API。
如何使用 @RestController 注解
在 Spring Boot 应用程序中，我们可以使用 @RestController 注解来创建 RESTful API 控制器。以下是一个简单的示例：
@RestController
@RequestMapping("/api")
public class HelloController {
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, World!";
    }
}
1
2
3
4
5
6
7
8
在上面的示例中，我们使用 @RestController 注解将 HelloController 类标记为 RESTful API 控制器。我们使用 @RequestMapping 注解将请求 URL 映射到 /api 路径，并使用 @GetMapping 注解将请求 URL 映射到 /hello 路径。在 sayHello 方法中，我们返回一个字符串 “Hello, World!”，它将被转换为 JSON 响应体并发送回客户端。
处理 HTTP 请求参数
在 Spring Boot 应用程序中，我们可以使用 @RequestParam 注解来处理 HTTP 请求参数。以下是一个示例：
@RestController
@RequestMapping("/api")
public class UserController {
    @GetMapping("/users")
    public List<User> getUsers(@RequestParam(value = "page", defaultValue = "0") int page,
                               @RequestParam(value = "size", defaultValue = "10") int size) {
        // 获取用户列表
    }
}
1
2
3
4
5
6
7
8
9
在上面的示例中，我们使用 @RequestParam 注解将请求参数 page 和 size 映射到方法参数中。我们还使用 defaultValue 属性指定了默认值，以防请求参数未提供。
处理 HTTP 请求体
在 Spring Boot 应用程序中，我们可以使用 @RequestBody 注解来处理 HTTP 请求体。以下是一个示例：
@RestController
@RequestMapping("/api")
public class UserController {
    @PostMapping("/users")
    public User createUser(@RequestBody User user) {
        // 创建用户
    }
}
1
2
3
4
5
6
7
8
在上面的示例中，我们使用 @RequestBody 注解将请求体映射到方法参数中。我们将请求体转换为 User 对象，并将其传递给 createUser 方法。
处理 HTTP 响应状态码
在 Spring Boot 应用程序中，我们可以使用 @ResponseStatus 注解来指定 HTTP 响应的状态码。以下是一个示例：
@RestController
@RequestMapping("/api")
public class UserController {
    @GetMapping("/users/{id}")
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public void getUser(@PathVariable("id") Long id) {
        // 获取用户
        if (user == null) {
            throw new UserNotFoundException(id);
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
在上面的示例中，我们使用 @ResponseStatus 注解将 HTTP 响应状态码设置为 HttpStatus.NOT_FOUND，如果找不到用户，则抛出 UserNotFoundException 异常。异常会被 Spring Boot 捕获，并将响应状态码设置为 NOT_FOUND。
处理 HTTP 响应头
在 Spring Boot 应用程序中，我们可以使用 @ResponseHeader 注解来设置 HTTP 响应头。以下是一个示例：
@RestController
@RequestMapping("/api")
public class UserController {
    @GetMapping("/users/{id}")
    @ResponseStatus(HttpStatus.OK)
    @ResponseHeader(name = "X-Total-Count", expression = "headers['X-Total-Count']")
    public User getUser(@PathVariable("id") Long id) {
        // 获取用户
        HttpHeaders headers = new HttpHeaders();
        headers.add("X-Total-Count", "1");
        return user;
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
在上面的示例中，我们使用 @ResponseHeader 注解将 X-Total-Count 响应头设置为 1。我们还使用 HttpHeaders 类来设置响应头，Spring Boot 将根据 @ResponseHeader 注解将其映射到响应头中。
总结
在本文中，我们介绍了 Spring Boot 中的 @RestController 注解的原理和使用方法。@RestController 注解是将 Java 类转换为 RESTful API 控制器的一种简单而强大的方式。在使用 @RestController 注解时，我们可以使用 @RequestParam 注解来处理 HTTP 请求参数，使用 @RequestBody 注解来处理 HTTP 请求体，使用 @ResponseStatus 注解来处理 HTTP 响应状态码，使用 @ResponseHeader 注解来处理 HTTP 响应头。掌握这些注解可以让我们更加方便地创建 RESTful API。
————————————————
版权声明：本文为CSDN博主「程序员徐师兄」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/JasonXu94/article/details/131455397