Spring Boot 中的 @RestController 注解是什么，原理，如何使用

待我称王封你为后i 2023-10-13 06:28 35阅读 0赞

## Spring Boot 中的 @RestController 注解是什么，原理，如何使用 ##

### 前言 ###

在现代化的 Web 应用程序中，RESTful API 是一种流行的架构风格，可以让客户端和服务器之间实现松散耦合的通信。Spring Boot 提供了 @RestController 注解，用于将 Java 类转换为 RESTful API 控制器。本文将介绍 @RestController 注解的原理和使用方法。

![在这里插入图片描述][2049a2dab68f49c3a2bce2250747a8e9.png]

### 什么是 @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!";
        }
    }

在上面的示例中，我们使用 @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) {
        
            // 获取用户列表
        }
    }

在上面的示例中，我们使用 @RequestParam 注解将请求参数 page 和 size 映射到方法参数中。我们还使用 defaultValue 属性指定了默认值，以防请求参数未提供。

#### 处理 HTTP 请求体 ####

在 Spring Boot 应用程序中，我们可以使用 @RequestBody 注解来处理 HTTP 请求体。以下是一个示例：

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

在上面的示例中，我们使用 @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);
            }
        }
    }

在上面的示例中，我们使用 @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;
        }
    }

在上面的示例中，我们使用 @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。

[2049a2dab68f49c3a2bce2250747a8e9.png]: https://img-blog.csdnimg.cn/2049a2dab68f49c3a2bce2250747a8e9.png