springboot注解（全）

  Spring Boot是一个快速开发框架，快速的将一些常用的第三方依赖整合（通过Maven子父亲工程的方式），简化xml配置，全部采用注解形式，内置Http服务器（Jetty和Tomcat），最终以Java应用程序进行执行。

替代 @SpringBootConfiguration、@EnableAutoConfiguration、@ComponentScan

导入配置类，一般做测试的时候使用，正常优先使用@EnableAutoConfiguration 

替代@Configuration

将资源导入容器

导入properties文件

bean角色定义为ROLE_APPLICATION(默认值)、ROLE_SUPPORT(辅助角色)、ROLE_INFRASTRUCTURE(后台角色，用户无感)

指定bean的作用域，默认singleton，其它包括prototype、request、session、globalSession

使bean懒加载，取消bean预初始化。

自动装配时当出现多个Bean候选者时，被注解为@Primary的Bean将作为首选者，否者将抛出异常。

指定Bean在哪个环境下被激活

依赖的bean注册完成，才注册当前类，依赖bean不存在会报错。用于控制bean加载顺序

bean的属性都注入完毕后，执行注解标注的方式进行初始化工作

默认按类型装配，如果我们想使用按名称装配，可以结合@Qualifier注解一起使用。

根据方法返回的类型，去容器中捞出对应

申明bean名字，且可以按bean名字加载bean

检查bean的属性setXXX()方法，要求属性砸死配置阶段必须已配置

添加bean的文字描述

启动AspectJ自动配置

启加载器动态增强功能，使用instrumentation实现

包含该注解的package会被AutoConfigurationPackages注册

在指定配置类初始化前加载

在指定配置类初始化后加载

指定配置类初始化顺序，越小初始化越早

@ModelAttribute注解可被应用在方法和方法参数上。

public class ModelAttributeController {
  @ModelAttribute
  public void init(Model model) {
  System.out.println("@RequestMapping方法");
  }
  @RequestMapping("/model-attribute")
  public String get() {
  System.out.println("@ModelAttribute方法");
  return "model-attribute";
  }
}

@RequestMapping(path = "/owners/{ownerId}/pets/{petId}/edit", method = RequestMethod.POST)
public String processSubmit(@Valid @ModelAttribute("pet") Pet pet, BindingResult result) {
    if (result.hasErrors()) {
        return "petForm";
    }
    // ...
}

@RequestMapping(path = "/owners/{ownerId}/pets/{petId}/edit", method = RequestMethod.POST)
public String processSubmit(@Validated @ModelAttribute("pet") Pet pet, BindingResult result) {
    if (result.hasErrors()) {
        return "petForm";
    }
    // ...
}

@RequestMapping(path = "/owners/{ownerId}/pets/{petId}/edit", method = RequestMethod.POST)
public String processSubmit(@ModelAttribute("pet") Pet pet, BindingResult result) {
    // 自己编写一个校验方法来处理 result 对象
    new PetValidator().validate(pet, result);
    if (result.hasErrors()) {
        return "petForm";
    }
    // ...
}

@Conditional，当指定的条件都满足时，组件才被注册
@ConditionalOnBean，指定bean在上下文中时，才注册当前bean。用在方法上，则默认依赖类为方法的返回类型
@ConditionalOnClass，指定类在classpath上时，才初始化当前bean。用在方法上，则默认依赖类为方法的返回类型
@ConditionalOnCloudPlatform，在指定云平台才注册配置
@ConditionalOnExpression，指定spel为true时注册配置
@ConditionalOnJava，在指定java版本时注册配置
@ConditionalOnJndi
@ConditionalOnMissingBean，指定bean不在上下文中时，才初始化当前bean。用在方法上，则默认依赖类为方法的返回类型
@ConditionalOnMissingClass，指定类不在classpath上时，才初始化当前bean。用在方法上，则默认依赖类为方法的返回类型
@ConditionalOnNotWebApplication，不是在web环境才注册配置
@ConditionalOnProperty，配置文件中的值与指定值是否相等，相等才注册配置
@ConditionalOnResource，指定resources都在classpath上才注册配置
@ConditionalOnSingleCandidate，上下文中只有一个候选者bean时才注册配置
@ConditionalOnWebApplication，是在web环境才注册配置

@EnableCaching，开启缓存配置，支持子类代理或者AspectJ增强
@CacheConfig，在一个类下，提供公共缓存配置
@Cacheable，放着方法和类上，缓存方法或类下所有方法的返回值
@CachePut，每次先执行方法，再将结果放入缓存
@CacheEvict，删除缓存
@Caching，可以配置@Cacheable、@CachePut、@CacheEvict

@EnableScheduling，开启定时任务功能
@Scheduled，按指定执行周期执行方法
@Schedules，包含多个@Scheduled，可同时运行多个周期配置
@EnableAsync，开启方法异步执行的能力，通过@Async或者自定义注解找到需要异步执行的方法。通过实现AsyncConfigurer接口的getAsyncExecutor()和getAsyncUncaughtExceptionHandler()方法自定义Executor和异常处理。
@Async，标记方法为异步线程中执行

@EnableConfigurationProperties，启动@ConfigurationProperties功能
@ConfigurationProperties，将properties文件里的内容，自动注入bean对应的属性中
@DeprecatedConfigurationProperty，用在配置文件的getter()方法上，标记字段已经过期，并提示替换的字段。一般给spring-boot-configuration-processor使用。
@NestedConfigurationProperty，标记在配置文件的字段上，提示spring-boot-configuration-processor，配置包含嵌套的配置。

表明这是一个实体类，一般用于jpa，这两个注解一块使用，但是如果表名和实体类名相同的话，@Table可以省略。

基于代码复用和模型分离的思想，在项目开发中使用jpa的@MappedSuperClass注解，将实体类的多个属性分别封装到不同的非实体类中。例如，数据库表中都需要id来表示编号，id是这些映射实体类的通用属性，交给jpa统一生产主键id编号，那么使用一个父类来封装这些通用属性，并用@MappedSuperClass标识。

标注为@MappedSuperClass的类将不是一个完整的实体类，它将不会映射到数据库表，但是它的属性都映射到其子类的数据库字段中。

一般用做父类的repository，有这个注解，spring不会去实例化该repository。

如果字段名和列名相同，则可以省略。

表示该属性为主键。

表示该属性并非一个到数据库表的字段的映射，ORM框架将忽略该属性。
如果一个属性并非数据库表的字段映射，就务必将其标注为@Transient，否则，ORM框架默认将其注解为@Basic。

@Basic 是实体类与数据库字段映射时最简单的类型。
类型支持Java基本类型（byte、short、int、long、float、double、char、boolean），包装类，枚举类，以及实现了serializable接口的类型。

1.fetch用来指定属性的加载机制

2. optional用来指定属性是否可空

在实体类向前台返回数据时用来忽略不想传递给前台的属性或接口。

引入单个properties文件：

@PropertySource(value = {"classpath:xxxx/xxxx.properties"})

引入多个properties文件
1
@PropertySource(value = {"classpath:xxxx/xxxx.properties","classpath:xxxx/xxxx.properties"}

@Value("${properties中的键}")
private String xxx;

@SpringBootApplication
@Import({SmsConfig.class})
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

编程式事务使用TransationTemplate或者直接使用底层的PlatformTransactionManager。对于编程式事务，spring推荐使用TransationTemplate。

建立在AOP基础上，其本质是对方法前后进行拦截，然后再目标方法开始之前创建或者加入一个事务，在执行完目标方法之后根据执行情况提交或者回滚事务，通过@Transactional就可以进行事务操作，更快捷而且简单。推荐使用。

用在springboot启动类上，表示这是一个eureka服务注册中心；

用在springboot启动类上，表示这是一个服务，可以被注册中心找到；

开启负载均衡能力；

用在启动类上，开启断路器功能；

用在方法上，fallbackMethod指定断路回调方法；

用在启动类上，表示这是一个配置中心，开启Config Server；

开启zuul路由，用在启动类上；

@SpringBootApplication
@EnableDiscovertyClient
@EnableCircuitBreaker

Spring源码中大量使用了ConfigurationProperties注解，比如server.port就是由该注解获取到的，通过与其他注解配合使用，能够实现Bean的按需配置。 
该注解有一个prefix属性，通过指定的前缀，绑定配置文件中的配置，该注解可以放在类上，也可以放在方法上。

spring.datasource.url=jdbc:mysql://127.0.0.1:8888/test?useUnicode=false&autoReconnect=true&characterEncoding=utf-8
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.type=com.alibaba.druid.pool.DruidDataSource
@ConfigurationProperties(prefix = "spring.datasource")
@Component
public class DatasourcePro {
    private String url;
    private String username;
    private String password;
    // 配置文件中是driver-class-name, 转驼峰命名便可以绑定成
    private String driverClassName;
    private String type;
    ...
}

@ConfigurationProperties 和 @value 有着相同的功能，但是  @ConfigurationProperties的写法更为方便；
@ConfigurationProperties 的 POJO类的命名比较严格,因为它必须和prefix的后缀名要一致, 不然值会绑定不上,