《SpringBoot》史上最全SpringBoot干系注解先容

@SpringBootApplication

@SpringBootApplication看作是 @Configuration、@EnableAutoConfiguration、@ComponentScan 注解的集合。

• @Configuration：答应注册额外的 bean 或导入其他配置类
  
• @EnableAutoConfiguration：启用 SpringBoot 的自动配置机制
  
• @ComponentScan：扫描被@Component (@Repository,@Service,@Controller)注解的 bean，注解默认会扫描该类所在的包下所有的类。
  

自动配置机制？在启动过程中，Spring Boot会扫描应用程序的类路径，根据定义条件匹配的各种AutoConfiguration类进行自动配置。通过条件化配置和默认属性值，根据应用程序的类路径和其他条件来自动配置Spring应用程序的各种组件。自动配置的目标是让开辟人员可以或许以最小的配置和干预自动获得功能完整的应用程序。
Spring Bean 干系

@Resource和@Autowired

• @Autowired：用于构造器、方法、参数或字段上，表明需要自动注入一个Bean。Spring会自动装配匹配的Bean，默认是按范例装配。
  
  
  
  • @Qualifier：与@Autowired一起使用时，指定要注入的Bean的名称，以克制与其他Bean的混淆。
    
  • @Primary: 当一个范例有多个Bean时，在不使用@Qualifier的环境下，Spring会优先选择标注了@Primary的Bean。
    
  
  
• @Resource：来自JDK，类似于@Autowired，但默认是按名称装配，也可以混合使用。
  
• @Inject：来自javax.inject包，类似于@Autowired，属于JSR-330标准的一部分。
  

两者的区别

@Autowired 是Spring框架提供的注解，重要用于根据范例自动装配依靠项。行为和特性：

• 按范例装配：默认环境下，@Autowired按范例自动装配Bean。
  
• 可选依靠：如果你的依靠是可选的，可以使用 required=false 设置：
  
• 构造器、方法或字段：可以用在构造器，属性字段或Setter方法上。
  
• 结合@Qualifier：可以和@Qualifier结合使用以实现按名称装配。
  
• 作为Spring特有的注解，它更深度地集成在Spring的生态体系中，更适合与其他Spring注解一起使用。
  

@Resource 是JDK提供的注解，属于Java依靠注入规范（JSR-250）的一部分。行为和特性：

• 按名称装配：默认环境下，@Resource按名称装配。如果没有匹配到名称，再按范例装配。
  
• 不支持required属性：与@Autowired差别，@Resource不支持required属性。
  
• 可以用于字段和Setter方法：固然也可以用于构造器，但不常见。通常用在字段或Setter方法上。
  
• 由于是Java EE规范的一部分，它可以与其他Java EE注解（如@PostConstruct和@PreDestroy）更好地配合使用。
  

依靠注入的优先级(紧张)

在使用 @Resource 注解进行依靠注入时，优先级规则如下：

• 明确指定名称：
  
  
  • 如果通过 @Resource(name="beanName") 明确指定了 Bean 的名称，那么 Spring 会首先按照名称匹配进行注入。
    
  • 在这种环境下，@Primary 注解不会影响注入结果。
    
  
  
• 按字段或属性名称匹配：
  
  
  • 如果没有通过 name 属性指定 Bean 的名称，Spring 会尝试按照字段或属性的名称进行匹配。
    
  • 在这种环境下，@Primary 注解也不会影响注入结果。
    
  
  
• 按范例匹配：
  
  
  • 如果按名称匹配失败（包括明确指定名称和按字段名称匹配都没有找到合适的 Bean），Spring 会按范例匹配。
    
  • 在这种环境下，如果存在多个同范例的 Bean，则 @Primary 注解会起作用，标记为 @Primary 的 Bean 将被优先注入。
    
  
  

在使用 @Autowired 注解进行依靠注入时，优先级规则如下：

• 按范例匹配：Spring 首先通过范例匹配找到所有符合要求的候选 Bean。如果只有一个候选 Bean，那么该 Bean 会被注入。
  
• 按名称匹配结合 @Qualifier：
  
  
  • 如果有多个同范例的 Bean，可以使用 @Qualifier 注解来指定具体的 Bean。
    
  • @Qualifier 的值必须与一个候选 Bean 的名称匹配，匹配乐成的 Bean 会被注入。
    
  • 使用 @Primary：如果仍存在多个符合要求的 Bean，并且其中一个 Bean 标记了 @Primary，Spring 会优先选择标记了 @Primary 的 Bean 进行注入。
    
  
  
• 按名称匹配字段或属性名称：在没有使用 @Qualifier 时，如果存在多个候选 Bean，Spring 会尝试通过字段或属性名称进行匹配。如果找到名称匹配的 Bean，则该 Bean 会被注入。
  
• NoUniqueBeanDefinitionException：如果存在多个候选Bean，但没有使用@Qualifier指定名称，且没有标记@Primary，会抛出NoUniqueBeanDefinitionException，表明有多个Bean范例匹配但无法确定注入哪个。
  

在使用 @Bean 方法中的参数 进行依靠注入时，默认的行为与 @Autowired 注解的工作方式是一致的。

@Component,@Repository,@Service, @Controller

一般使用 @Autowired 注解让 Spring 容器自动装配 bean。
但要想把类标识成可用于 @Autowired 注解自动装配的 bean 的类,可以采用以下注解实现：

• @Component：通用的注解，可标注任意类为 Spring 组件。如果一个 Bean 不知道属于哪个层，可以使用@Component 注解标注。
  
• @Repository : 对应长期层即 Dao 层，重要用于数据库干系操作。
  
• @Service : 对应服务层，重要涉及一些复杂的逻辑，需要用到 Dao 层。
  
• @Controller : 对应 Spring MVC 控制层，重要用于接受用户哀求并调用 Service 层返回数据给前端页面。
  

@RestController

@RestController注解是@Controller和@ResponseBody的合集，体现这是个控制器 bean,并且是将函数的返回值直接填入 HTTP 响应体中，是 REST 风格的控制器，更加适合目前前后端分离的架构下，返回 JSON 数据格式。
单独使用 @Controller 不加 @ResponseBody的话一般是用在要返回一个视图的环境，这种环境属于比较传统的 Spring MVC 的应用，对应于前后端不分离的环境。@Controller +@ResponseBody 返回 JSON 或 XML 形式数据
@Scope

声明 Spring Bean 的作用域
常见的 Spring Bean 的作用域：

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

@Configuration

用来声明配置类，可以使用 @Component注解替换，不过使用@Configuration注解声明配置类更加语义化。
常见的 HTTP 哀求范例

5 种常见的哀求范例:

• GET：哀求从服务器获取特定资源。举个例子：GET /users（获取所有门生）
  @GetMapping("users") 等价于@RequestMapping(value="/users",method=RequestMethod.GET)
  
• POST：在服务器上创建一个新的资源。举个例子：POST /users（创建门生）
  @PostMapping("users") 等价于@RequestMapping(value="/users",method=RequestMethod.POST)
  
• PUT：更新服务器上的资源（客户端提供更新后的整个资源）。举个例子：PUT /users/12（更新编号为 12 的门生）
  @PutMapping("/users/{userId}") 等价于@RequestMapping(value="/users/{userId}",method=RequestMethod.PUT)
  
• DELETE：从服务器删除特定的资源。举个例子：DELETE /users/12（删除编号为 12 的门生）
  @DeleteMapping("/users/{userId}")等价于@RequestMapping(value="/users/{userId}",method=RequestMethod.DELETE)
  
• PATCH：更新服务器上的资源（客户端提供更改的属性，可以看做作是部分更新），使用的比较少
  

@RequestMapping 和 @GetMapping 注解的区别

@RequestMapping：可注解在类和方法上；@GetMapping 仅可注册在方法上
@RequestMapping：可进行 GET、POST、PUT、DELETE 等哀求方法；@GetMapping 是@RequestMapping 的GET哀求方法的特例
前后端传值

@PathVariable 和 @RequestParam

@PathVariable用于获取路径参数，@RequestParam用于获取查询参数。

1. @GetMapping("/klasses/{klassId}/teachers")
2. public List<Teacher> getKlassRelatedTeachers(
3.          @PathVariable("klassId") Long klassId,
4.          @RequestParam(value = "type", required = false) String type ) {
5. ...
6. }

复制代码

如果哀求的 url 是：/klasses/123456/teachers?type=web，那么后端获取到的数据就是：klassId=123456,type=web
@RequestBody

用于读取 Request 哀求（可能是 POST,PUT,DELETE,GET 哀求）的 body 部分并且Content-Type 为 application/json 格式的数据，接收到数据之后会自动将数据绑定到 Java 对象上去。体系会使用HttpMessageConverter大概自定义的HttpMessageConverter将哀求的 body 中的 json 字符串转换为 java 对象。

1. @PostMapping("/sign-up")
2. public ResponseEntity signUp(@RequestBody @Valid UserRegisterRequest userRegisterRequest) {
3.   userService.save(userRegisterRequest);
4.   return ResponseEntity.ok().build();
5. }

复制代码

读取配置信息

@Value

使用 @Value("${property}") 读取比较简单的配置信息：
@ConfigurationProperties(常用)

通过@ConfigurationProperties读取配置信息并与 bean 绑定。
@PropertySource（不常用）

@PropertySource读取指定 properties 文件
参数校验

详情可以看 优雅的参数校验
字段验证的注解

• @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) 验证字符串是否是符合指定格式的数字，interger指定整数精度，fraction指定小数精度
  
• @Past被注释的元素必须是一个过去的日期@Future 被注释的元素必须是一个将来的日期
  
• .....
  

验证哀求体(RequestBody)

需要验证的参数上加上了@Valid注解，如果验证失败，它将抛出MethodArgumentNotValidException。

1. @RestController
2. @RequestMapping("/api")
3. public class PersonController {
5.     @PostMapping("/person")
6.     public ResponseEntity<Person> getPerson(@RequestBody @Valid Person person) {
7.         return ResponseEntity.ok().body(person);
8.     }
9. }

复制代码

验证哀求参数(Path Variables 和 Request Parameters)

要在类上加上 @Validated 注解，这个参数可以告诉 Spring 去校验方法参数。

1. @RestController
2. @RequestMapping("/api")
3. @Validated
4. public class PersonController {
6.     @GetMapping("/person/{id}")
7.     public ResponseEntity<Integer> getPersonByID(@Valid @PathVariable("id") @Max(value = 5,message = "超过 id 的范围了") Integer id) {
8.         return ResponseEntity.ok().body(id);
9.     }
10. }

复制代码

全局处理 Controller 层异常

• 使用体系定义好的异常处理器 SimpleMappingExceptionResolver
  
• 使用自定义异常处理器
  
• 使用异常处理注解
  

一般推荐使用注解的方式统一异常处理，具领会使用到 @ControllerAdvice + @ExceptionHandler 这两个注解 。

1. @ControllerAdvice
2. @ResponseBody
3. public class GlobalExceptionHandler {
5.     @ExceptionHandler(BaseException.class)
6.     public ResponseEntity<?> handleAppException(BaseException ex, HttpServletRequest request) {
7.       //......
8.     }
10.     @ExceptionHandler(value = ResourceNotFoundException.class)
11.     public ResponseEntity<ErrorReponse> handleResourceNotFoundException(ResourceNotFoundException ex, HttpServletRequest request) {
12.       //......
13.     }
14. }

复制代码

这种异常处理方式下，会给所有大概指定的 Controller 织入异常处理的逻辑（AOP），当 Controller 中的方法抛出异常的时候，由被@ExceptionHandler 注解修饰的方法进行处理。
ExceptionHandlerMethodResolver 中 getMappedMethod 方法决定了异常具体被哪个被 @ExceptionHandler 注解修饰的方法处理异常。
[code]@Nullable  private Method getMappedMethod(Class