一文掌握 Spring Boot 常用注解，保姆级整理，建议收藏！-编程知识

亲兄弟篇： SpringBoot注解大全（超详细）_Maiko Star的博客-CSDN博客

一、SpringBoot常用注解

二、Bean处理注解

`2.1 @Resource`

依赖注入，自动导入标注的对象到当前类中，比如我们的 Controller 类通常要导入 Service 类（需要注意这里 Service 类要被 Spring 容器管理）。

`2.2 @Component、@Repository、@Service、@Controller、@RestController`

我们一般使用 @Resource 注解让 Spring 容器帮我们自动装配 bean。要想把类标识成可用于 @Resource 注解自动装配的 bean 就需要我们使用这几个注解了，它们表示对应的类将被 Spring 容器管理。

@Component ：通用的注解，可标注任意类为 Spring 组件。如果一个 Bean 不知道属于哪个层，可以使用@Component 注解标注；
@Repository : 对应持久层即 Dao 层，主要用于数据库相关操作；
@Service : 对应服务层，主要涉及一些复杂的逻辑，需要用到 Dao 层；
@Controller : 对应 Spring MVC 控制层，一般需要注入 Service 类返回结果数据；
@RestController : 继承于 @Controller，区别在于标注后整个类所有方法将直接返回 JSON 数据，不再需要视图解析处理，目前前后端分离的项目后端都是直接用这个注解的；

2.3 `@Configuration`

标注是 Java 代码的配置类， Spring Boot 中推荐这种做法不再使用 xml 配置了；

2.4 `@Scope`

声明 Spring Bean 的作用域,作用于一共有以下几种：

singleton：唯一 bean 实例，Spring 中的 bean 默认都是单例的。
prototype：每次请求都会创建一个新的 bean 实例。
request：每一次 HTTP 请求都会产生一个新的 bean，该 bean 仅在当前 HTTP request 内有效。
session：每一次 HTTP 请求都会产生一个新的 bean，该 bean 仅在当前 HTTP session 内有效。

三、HTTP请求注解

3.1 `@GetMapping`

等价于 @RequestMapping(value="/test",method=RequestMethod.GET)

3.2 `@PostMapping`

3.3 `@PutMapping`

put 方式的请求，常用语更新服务器上的资源。举个例子：PUT /users/7（更新编号为 7 的学生）

3.4 `@DeleteMapping`

DELETE 请求，从服务器删除特定的资源。

四、前后端参数传递注解

4.1 `@RequestParam` & `@PathVariable`

@RequestParam 用在方法的参数前面，获取请求中表单类型的key=value格式的数据。

@PathVariable 用于获取请求路径中的参数。

4.2 `@RequestBody`

获取请求 body 中的数据，常用于搭配 @PostMapping 请求来提交对象数据. 请求体的Content-Type 必须为 application/json 格式的数据，接收到数据之后会自动将数据绑定到 Java 对象上去。

系统会使用 HttpMessageConverter 或者自定义的 HttpMessageConverter将请求的 body 中的 json 字符串转换为 java 对象。

强调一下：请求方法只可以有一个@RequestBody，但是可以有多个 @RequestParam 和 @PathVariable。如果你的方法必须要用两个 @RequestBody 来接受数据的话，那你就只思考下你的设计了，或者套娃形式的。

4.3 `@ResponseBody`

表示该方法的返回结果直接写入 HTTP response body 中，格式为 json。上面我们提到的 @RestController 其实就是 @Controller 和 @ResponseBody 两个结合起来的。

五、读取配置注解

5.1 `@value`

可以在任意 Spring 管理的 Bean 中通过这个注解获取任何来源配置的属性值。比如我们的 application.properties 或者 application.yml 配置文件中配置的属性值，当然也可以是 JVM 属性配置或者系统环境变量配置的值，如果对 Spring Boot 应用程序都有哪些属性配置源以及它们之间的优先级不了解的小伙伴可以看我之前的文章：Spring Boot 属性配置你所不知道的细节。

5.2 `@ConfigurationProperties`(重点)

上面 @Value 在每个类中获取属性配置值的做法其实是不推荐的，我们一般在企业项目开发中，不会使用那么杂乱无章的写法而且维护也麻烦，通过就是一次性读取到一个 Java 配置类，然后需要使用的地方直接引用这个类就可以多次访问了，方便维护。

5.3 `@PropertySource`

这个注解是用来指定读取我们自定义的配置文件的。

六、参数校验注解

数据的校验的重要性就不用说了，即使在前端对数据进行校验的情况下，我们还是要对传入后端的数据再进行一遍校验，避免用户绕过浏览器直接通过一些 HTTP 工具直接向后端请求一些违法数据。

JSR(Java Specification Requests） 是一套 JavaBean 参数校验的标准，它定义了很多常用的校验注解，我们可以直接将这些注解加在我们 JavaBean 的属性上面，这样就可以在需要校验的时候进行校验了，非常方便！

校验的时候我们实际用的是 Hibernate Validator 框架。Hibernate Validator 是 Hibernate 团队最初的数据校验框架，Hibernate Validator 4.x 是 Bean Validation 1.0（JSR 303）的参考实现，Hibernate Validator 5.x 是 Bean Validation 1.1（JSR 349）的参考实现，目前最新版的 Hibernate Validator 6.x 是 Bean Validation 2.0（JSR 380）的参考实现。

需要注意的是从 Spring Boot 2.3开始，我们还需要显式地添加 spring-boot-starter-validation 依赖项，在此之前的 Spring Boot 版本是在 spring-boot-starter-web 依赖项中包含的不需要额外引入。

我现在使用的是 Spring Boot 2.5.2 版本了，所以手动增加依赖：

👉 需要注意的是： 所有的注解，推荐使用 JSR 注解，即 javax.validation.constraints，而不是 org.hibernate.validator.constraints

6.1 Bean字段验证注解

@NotEmpty 被注释的字符串的不能为 null 也不能为空
@NotBlank 被注释的字符串非 null，并且必须包含一个非空白字符
@Null 被注释的元素必须为 null
@NotNull 被注释的元素必须不为 null
@AssertTrue 被注释的元素必须为 true
@AssertFalse 被注释的元素必须为 false
@Pattern(regex=,flag=)被注释的元素必须符合指定的正则表达式
@Email 被注释的元素必须是 Email 格式。
@Min(value)被注释的元素必须是一个数字，其值必须大于等于指定的最小值
@Max(value)被注释的元素必须是一个数字，其值必须小于等于指定的最大值
@DecimalMin(value)被注释的元素必须是一个数字，其值必须大于等于指定的最小值
@DecimalMax(value) 被注释的元素必须是一个数字，其值必须小于等于指定的最大值
@Size(max=, min=)被注释的元素的大小必须在指定的范围内
@Digits (integer, fraction)被注释的元素必须是一个数字，其值必须在可接受的范围内
@Past被注释的元素必须是一个过去的日期
@Future 被注释的元素必须是一个将来的日期

验证请求体(RequestBody)

只需要在请求处理方法中需要验证的参数前加上 @Valid 注解就会开启校验了，如果验证失败将抛出异常：MethodArgumentNotValidException。

6.2 @Validated

如果你的入参不是用一个 Java 对象来接收的话，比如用 @PathVariables 和 @RequestParam 注解来获取入参，这种情况下要校验参数不要忘记在类的头上加 @Validated 注解，这个参数可以告诉 Spring 去校验方法参数。

七、统一异常处理注解

异常处理通常也是我们在开发中一定要做的，因为不可能将一些程序员才能看懂的异常抛出到前端去（总会有不靠谱的同事忘记捕获异常的），所以一般都会加上统一的异常处理，在对用户不友好的错误堆栈转换为普通用户可以看懂的文案提示。

这里涉及到的注解只有两个：

@ControllerAdvice : 定义全局异常处理类，包含 @Component 所以可以被 Spring 扫描到。
@ExceptionHandler : 声明异常处理方法，表示遇到这个异常，就执行标注的方法。

八、JPA数据持久化注解

上面是百度百科给的概念，只能说在实际项目开发中还是用的不多，大家还是喜欢用 Mybatis，不过相比更加简洁的技术还是要学习下的。

创建表

@Entity
@Table

这俩是放在 Java Bean 上面用来标注数据库实体对象和表明之间的映射关系的。

创建主键

@Id
@GeneratedValue

这俩主键放在 Bean 的字段上，用来标识数据库的主键以及主键自动生成的。通过 @GeneratedValue直接使用 JPA 内置提供的四种主键生成策略来指定。

GenerationType.TABLE 持久化引擎通过关系数据库的一张特定的表格来生成主键；
GenerationType.SEQUENCE 随机序列；
GenerationType.IDENTITY 主键自增长；
GenerationType.AUTO 持久化引擎会根据数据库在以上三种主键生成策略中选择，默认选择的就是这个策略；

设置字段类型

@Column 声明字段。

比如：Java Bean 属性名为 nickName 对应的数据库字段名为 user_name，长度为 32，非空。

设置字段类型并且加默认值，这个还是挺常用的。

指定不持久化特定字段

@Transient ：有一些字段我们有时间不需要落库，就可以加上这个注解就好了。

@声明事务

这个注解可以作用于类上，也可以作用于方法上。前者表示所有该类的 public 方法都配置相同的事务属性信息，后者表示当类配置了@Transactional，方法也配置了@Transactional，方法的事务会覆盖类的事务配置信息。

Exception 分为运行时异常 RuntimeException 和非运行时异常。在 @Transactional 注解中如果不配置 rollbackFor 属性,那么事物只会在遇到 RuntimeException 的时候才会回滚,加上 rollbackFor=Exception.class ,可以让事物在遇到非运行时异常时也回滚。

九、 JSON格式处理注解

9.1 指定过滤字段

@JsonIgnoreProperties 作用在类上用于过滤掉特定字段不返回或者不解析。
@JsonIgnore一般用于类的属性上，作用和上面的@JsonIgnoreProperties 一样。

9.2 格式化 json 数据

要注意的是，它只会在类似 @ResponseBody 返回 json 数据的时候，才会返回格式化的 yyyy-MM-dd HH:mm:ss 时间，你直接使用System.out.println()输出的话，仍然是类似 Fri Dec 01 21:05:20 CST 2017 这样的时间样式。