Spring Boot 注解
Spring Boot 注解
目前刚入手，也不会ssm的bean那套，听说spring boot只需要会用类的注解就可以，不需要在xml里面配置bean，所以就记录一下常用的注解。资料来自于JavaGuide
注解原理
Spring Boot 利用 AOP 和 依赖注入（DI） 机制来实现注解驱动的功能，具体地，它是通过以下步骤进行处理的：
- 扫描注解: Spring Boot 在启动时会扫描所有 Bean 定义，找到被注解标记的类和方法。
- 创建动态代理对象: 对于标记了 @Transactional 这样的注解的方法，Spring 会使用动态代理技术生成一个代理对象，对该方法进行拦截。
一般注解会由在JVM中nio-x线程的ThreadLocal中的管理器给管理 - 拦截执行: 当该方法被调用时，动态代理对象会拦截方法调用，并在方法执行前执行事务开启操作，并在方法执行后进行事务提交或回滚操作。
Spring Boot 常用注解
-
@SpringBootApplication 这个注解是SpringBoot的核心注解，可以标注在启动类上(会默认加在主类上)，SpringBoot会自动扫描该类所在的包及其子包下所有的类。并且这玩意由三个注解组合而成：
- @EnableAutoConfiguration：启用 SpringBoot 的自动配置机制。触发Spring Boot的自动配置特性，即根据classpath（类路径）下的jar包，自动配置程序所需的bean。
- @ComponentScan：扫描被@Component (@Repository,@Service, @Controller)注解的 bean，注解默认会扫描该类所在的包下所有的类。
- @Configuration：允许在 Spring 上下文中注册额外的 bean 或导入其他配置类
-
@Bean
放在启动类的方法的上面， 把方法的返回值对象，注入到spring容器中。 -
@Autowired
加在类的method上，通过容器自动注入bean。当然如果某个类基本都被加@Autowired，那么可以直接加在类上。 -
@Component,@Mapper,@Service, @Controller
@Component：通用的注解，标记某个代码段使得容器可以扫描到它，从而成为 Spring 组件。如果一个 Bean 不知道属于哪个层，可以使用@Component注解标注。而下面这三个其实都是它的衍生注解。放在类的上面，创建此类的对象，放入到容器中。
@Mapper: 让MyBatis找到接口， 创建它的代理对象。
@Service : 对应服务层，主要涉及一些复杂的逻辑，需要用到 Dao 层。一般标注在Service层。
@Controller : 对应 Spring MVC 控制层，主要用于接受用户请求并调用 Service 层返回数据给前端页面。一般标注在Controller层。 -
@RestController (@Controller + @ResponseBody)
@RestController 注解相当于@Controller和@ResponseBody注解的组合，可以将返回值直接写入 HTTP 响应体中。现在很少裸用@Controller，一般都是用@RestController。 -
Scope
@Scope注解用于指定 Spring Bean 的作用域(生命周期)，共有以下几种：- singleton：单例模式，Spring 容器中只会存在一个 Bean 实例。
- prototype：原型模式，每次调用getBean()方法时，都会返回一个新的 Bean 实例。
- request：请求作用域，每个 HTTP 请求都会产生一个新的 Bean 实例，仅适用于 Web 应用。
- session：会话作用域，每个 HTTP 会话都会产生一个新的 Bean 实例，仅适用于 Web 应用。
- global-session：全局会话作用域，一般用于 Portlet 应用。
- websocket：WebSocket 作用域，每个 WebSocket 会话都会产生一个新的 Bean 实例，仅适用于 WebSocket 应用。
-
@Configuration
@Configuration注解用于将类声明为 Spring 配置类，可以用来注册 Bean。也可以用@Component代替。表示这是个配置类，相当于xml配置文件。 -
HTTP 请求
- 总结来说 Get获取特定数据，Post创建新数据，Put更新数据，Delete删除特定数据。
@GetMapping,@PostMapping,@PutMapping,@DeleteMapping
这几个注解用于映射 HTTP 请求方法和 URL。- @PathVariable
用于绑定 URL 路径参数到方法参数。 - @RequestParam
用于绑定请求参数到方法参数。 - @RequestBody
用于绑定请求体中的 JSON 数据到方法参数。（Json -> Java） - @RequestHeader
用于绑定请求头信息到方法参数。 - @ResponseBody
用于将方法的返回值直接写入 HTTP 响应体中。表示方法的返回值是数据，而不是视图。
-
读取配置信息
- @Value
用于读取简单的配置信息 - @ConfigurationProperties
用于读取复杂的配置信息，将配置文件中的属性映射到 bean 的属性上。
- @Value
-
校验
@NotNull被注释元素不能为null@NotEmpty被注释的字符串不能为空@NotBlank被注释的字符串不能为空并且必须包含一个非空白字符@Email被注释的字符串必须是有效的电子邮件地址@Pattern被注释的字符串必须匹配指定的正则表达式,@Positive被注释的元素必须是一个正数@Max(value)被注释的元素必须小于等于value@Min(value)被注释的元素必须大于等于value@DecimalMax@DecimalMin类似同上@Size(max=, min=)被注释的元素的大小必须在min和max之间@Past被注释的元素必须是一个过去的日期@Future被注释的元素必须是一个将来的日期@PastOrPresent@FutureOrPresent同上@Range被注释的元素必须在指定的范围内@Valid被注释的元素必须是一个合法的对象@Validated被注释的元素必须是一个合法的对象，并且应用 Bean Validation 验证规则
-
JPA (Java Persistence API) 即数据库相关
@Entity声明一个类对应一个数据库实体。@Table设置表名@Id设置主键@GeneratedValue设置主键生成策略，如AUTO(数据库默认), IDENTITY(数据库自增长), SEQUENCE(序列), TABLE(通过特定的表)@Column设置列名和类型@Transient声明属性不映射到数据库表@Lob声明一个大字段，比如图片、视频等@enumerated设置枚举类型@Transacional声明事务，具体用来配置事务传播属性。- 对于Transactional这个事务注解，常用的就是ROLLBACK_FOR(默认)、REQUIRED、REQUIRES_NEW、NEVER、MANDATORY这几个属性。ROLLBACK_FOR表示遇到运行时异常，事务回滚，里面一般填写Exception.class；REQUIRED表示遇到运行时异常，事务不回滚，继续运行；REQUIRES_NEW表示遇到运行时异常，开启一个新的事务，继续运行；NEVER表示不管遇到什么异常，都不开启事务；MANDATORY表示必须开启事务，如果没有事务，就抛出异常。
-
@Slf4j日志注解，可以自动生成日志对象。打印日志时，可以直接使用log.info()等方法。 -
@ActiveProfiles作用于测试类种，用于指定激活的配置文件，默认使用 application.properties。 -
@Test 作用于测试方法，对一个method进行测试声明，用于声明测试用例。
-
@Transactional 作用于方法上，声明一个事务，用于测试事务相关的操作。
-
Mock相关：Mock是一种测试技术，可以模拟一个对象，使其在测试中可以替代真实的对象。Spring Boot中提供了Mock相关的注解，包括：
- @Mock 用于创建Mock对象
- @Spy 用于创建Spy对象
- @InjectMocks 用于注入Spy对象到被测试对象中
- @MockBean 用于创建Mock对象并注入到Spring容器中