SpringBoot注解汇总

1. Spring Boot 相关的 spring 注解

1.1. Configuration

这是 Spring 3.0 添加的一个注解,用于定义配置类,用来代替 applicationContext.xml 配置文件,所有这个配置文件里面能做到的事情都可以通过这个注解所在类来进行注册。被注解的类内部包含有一个或多个被@Bean注解的方法,这些方法将会被AnnotationConfigApplicationContextAnnotationConfigWebApplicationContext类进行扫描,并用于构建bean定义,初始化Spring容器。

  1. @Configuration
  2. public class TaskAutoConfiguration {
  3. @Bean
  4. @Profile("biz-electrfence-controller")
  5. public BizElectrfenceControllerJob bizElectrfenceControllerJob() {
  6. return new BizElectrfenceControllerJob();
  7. }
  8. @Bean
  9. @Profile("biz-consume-1-datasync")
  10. public BizBikeElectrFenceTradeSyncJob bizBikeElectrFenceTradeSyncJob() {
  11. return new BizBikeElectrFenceTradeSyncJob();
  12. }
  13. }

1.2. ComponentScan

这是 Spring 3.1 添加的一个注解,用来代替配置文件中的 component-scan 配置,开启组件扫描,即自动扫描包路径下的 @Component 注解进行注册 bean 实例到 context 中。
对于@Controller@Service@Repository注解,查看其源码会发现,它们中有一个共同的注解@Component,其实 @ComponentScan 注解默认就会装配标识了@Controller@Service@Repository@Component注解的类到spring容器中。

  1. package com.moon.test;
  2. import org.springframework.boot.SpringApplication;
  3. import org.springframework.context.annotation.ComponentScan;
  4. // 只有value属性时,value可以省略不写。@ComponentScan("com.moon.check.api")
  5. @ComponentScan(value = "com.moon.check.api")
  6. public class CheckApiApplication {
  7. public static void main(String[] args) {
  8. SpringApplication.run(CheckApiApplication.class, args);
  9. }
  10. }

@SpringBootApplication 注解也包含了 @ComponentScan 注解,所以在使用中也可以通过 @SpringBootApplication 注解的 scanBasePackages 属性进行配置

  1. package com.moon.test;
  2. import org.springframework.boot.SpringApplication;
  3. import org.springframework.boot.autoconfigure.SpringBootApplication;
  4. @SpringBootApplication(scanBasePackages = {"com.moon.check.api", "com.moon.check.service"})
  5. public class CheckApiApplication {
  6. public static void main(String[] args) {
  7. SpringApplication.run(CheckApiApplication.class, args);
  8. }
  9. }

1.3. Import

这是 Spring 3.0 添加的新注解,用来导入一个或者多个 @Configuration 注解修饰的类,此注解在 Spring Boot 里面应用很多。
通过导入的方式实现把实例加入springIOC容器中。可以在需要时将没有被Spring容器管理的类导入至Spring容器中。

  1. //类定义
  2. public class Square {
  3. }
  4. public class Circular {
  5. }
  6. //导入
  7. @Import({Square.class, Circular.class})
  8. @Configuration
  9. public class MainConfig {
  10. }

1.4. ImportResource

Spring 3.0 添加的新注解,用来导入一个或者多个 Spring 配置文件,这对 Spring Boot 兼容老项目非常有用,因为有些配置无法通过 Java Config 的形式来配置就只能用这个注解来导入。
@Import类似,区别就是@ImportResource导入的是配置文件

  1. package com.moon.test;
  2. import org.springframework.boot.SpringApplication;
  3. import org.springframework.context.annotation.ImportResource;
  4. // 导入xml配置
  5. @ImportResource("classpath:spring-redis.xml")
  6. public class CheckApiApplication {
  7. public static void main(String[] args) {
  8. SpringApplication.run(CheckApiApplication.class, args);
  9. }
  10. }

1.5. Component

@Component是一个spring框架的“元注解”,意思是可以注解其他类注解,如@Controller@Service@Repository。带此注解的类被看作组件,当使用基于注解的配置和类路径扫描的时候,这些类就会被实例化。其他类级别的注解也可以被认定为是一种特殊类型的组件,比如@Controller 控制器(注入服务)、@Service服务(注入dao)、@Repository dao(实现dao访问)。@Component泛指组件,当组件不好归类的时候,可以使用这个注解进行标注,作用就相当于 XML配置<bean id="" class=""/>

2. Spring Boot 核心注解

2.1. CrossOrigin (Spring Boot解决跨域问题)

SpringBoot 与 SpringMVC 一样可以使用@CrossOrigin注解解决跨域问题,均要求在Spring4.2及以上的版本

2.1.1. CrossOrigin 源码解析(翻译参考网络)

  1. @Target({ ElementType.METHOD, ElementType.TYPE })
  2. @Retention(RetentionPolicy.RUNTIME)
  3. @Documented
  4. public @interface CrossOrigin {
  5. String[] DEFAULT_ORIGINS = { "*" };
  6. String[] DEFAULT_ALLOWED_HEADERS = { "*" };
  7. boolean DEFAULT_ALLOW_CREDENTIALS = true;
  8. long DEFAULT_MAX_AGE = 1800;
  9. /**
  10. * 同origins属性一样
  11. */
  12. @AliasFor("origins")
  13. String[] value() default {};
  14. /**
  15. * 所有支持域的集合,例如"http://domain1.com"。
  16. * <p>这些值都显示在请求头中的Access-Control-Allow-Origin
  17. * "*"代表所有域的请求都支持
  18. * <p>如果没有定义,所有请求的域都支持
  19. * @see #value
  20. */
  21. @AliasFor("value")
  22. String[] origins() default {};
  23. /**
  24. * 允许请求头重的header,默认都支持
  25. */
  26. String[] allowedHeaders() default {};
  27. /**
  28. * 响应头中允许访问的header,默认为空
  29. */
  30. String[] exposedHeaders() default {};
  31. /**
  32. * 请求支持的方法,例如"{RequestMethod.GET, RequestMethod.POST}"}。
  33. * 默认支持RequestMapping中设置的方法
  34. */
  35. RequestMethod[] methods() default {};
  36. /**
  37. * 是否允许cookie随请求发送,使用时必须指定具体的域
  38. */
  39. String allowCredentials() default "";
  40. /**
  41. * 预请求的结果的有效期,默认30分钟
  42. */
  43. long maxAge() default -1;
  44. }

2.1.2. CrossOrigin 注解相关属性

  • origin属性
  • “*”代表所有域名都可访问
  • {“a”,”b”,..},指定多个域名可以访问
  • maxAge属性
  • 飞行前响应的缓存持续时间的最大年龄,简单来说就是Cookie的有效期 单位为秒。若maxAge是负数,则代表为临时Cookie,不会被持久化,Cookie信息保存在浏览器内存中,浏览器关闭Cookie就消失

2.1.3. 几种使用方式

  1. 如果想要对某一接口配置CORS,可以在方法上添加 @CrossOrigin 注解 ``` @CrossOrigin(origins = {“http://localhost:9000“, “null”}) @RequestMapping(value = “/test”, method = RequestMethod.GET) public String greetings() { return “{\”project\”:\”just a test\”}”; }
  1. 2. 如果想对一系列接口添加 CORS 配置,可以在类上添加注解,对该类声明所有接口都有效

@CrossOrigin(origins = {“http://localhost:9000“, “null”}) @RestController @SpringBootApplication public class SpringBootCorsTestApplication { …… }

  1. 3. 如果想添加全局配置,则需要添加一个配置类

@Configuration public class WebMvcConfig extends WebMvcConfigurerAdapter { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(“/*”) .allowedOrigins(““) .allowedMethods(“POST”, “GET”, “PUT”, “OPTIONS”, “DELETE”) .maxAge(3600) .allowCredentials(true); } }

  1. 4. 还可以通过添加 Filter 的方式,配置 CORS 规则,并手动指定对哪些接口有效

@Bean public FilterRegistrationBean corsFilter() { UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource(); CorsConfiguration config = new CorsConfiguration(); config.setAllowCredentials(true); config.addAllowedOrigin(“http://localhost:9000“); config.addAllowedOrigin(“null”); config.addAllowedHeader(““); config.addAllowedMethod(““); source.registerCorsConfiguration(“/**”, config); // CORS 配置对所有接口都有效 FilterRegistrationBean bean = newFilterRegistrationBean(new CorsFilter(source)); bean.setOrder(0); return bean; }

  1. ### 2.2. @SpringBootApplication
  2. Spring Boot 最最最核心的注解,用在 Spring Boot 主类上,标识这是一个 Spring Boot 应用,用来开启 Spring Boot 的各项能力<br />实际上这个注解就是 `@SpringBootConfiguration``@EnableAutoConfiguration``@ComponentScan` 这三个注解的组合,也可以用这三个注解来代替 `@SpringBootApplication` 注解。由于这些注解一般都是一起使用,所以Spring Boot提供了一个统一的注解@SpringBootApplication

package com.moon.test;

import org.mybatis.spring.boot.autoconfigure.MybatisAutoConfiguration; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.boot.autoconfigure.data.mongo.MongoDataAutoConfiguration; import org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration; import org.springframework.boot.autoconfigure.mail.MailSenderAutoConfiguration; import org.springframework.boot.autoconfigure.mongo.MongoAutoConfiguration; import org.springframework.boot.autoconfigure.validation.ValidationAutoConfiguration;

@SpringBootApplication(exclude = { MongoAutoConfiguration.class, MongoDataAutoConfiguration.class, DataSourceAutoConfiguration.class, ValidationAutoConfiguration.class, MybatisAutoConfiguration.class, MailSenderAutoConfiguration.class, }) public class SpringBootApplicationDemo { public static void main(String[] args) { SpringApplication.run(SpringBootApplicationDemo.class, args); } }

  1. ### 2.3. @EnableAutoConfiguration
  2. 允许 Spring Boot 自动配置注解,开启这个注解之后,Spring Boot 就能根据当前类路径下的包或者类来配置 Spring Bean
  3. > 如:当前类路径下有 Mybatis 这个 JAR 包,MybatisAutoConfiguration 注解就能根据相关参数来配置 Mybatis 的各个 Spring Bean
  4. `@EnableAutoConfiguration` 实现的关键在于引入了AutoConfigurationImportSelector,其核心逻辑为selectImports方法,逻辑大致如下:
  5. - 从配置文件`META-INF/spring.factories`加载所有可能用到的自动配置类;
  6. - 去重,并将 exclude excludeName 属性携带的类排除;
  7. - 过滤,将满足条件(`@Conditional`)的自动配置类返回;

@Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @Documented @Inherited @AutoConfigurationPackage // 导入AutoConfigurationImportSelector的子类 @Import(AutoConfigurationImportSelector.class) public @interface EnableAutoConfiguration {

  1. String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";
  2. /**
  3. * Exclude specific auto-configuration classes such that they will never be applied.
  4. * @return the classes to exclude
  5. */
  6. Class<?>[] exclude() default {};
  7. /**
  8. * Exclude specific auto-configuration class names such that they will never be
  9. * applied.
  10. * @return the class names to exclude
  11. * @since 1.3.0
  12. */
  13. String[] excludeName() default {};

}

  1. ### 2.4. @SpringBootConfiguration
  2. 此注解就是 `@Configuration` 注解的变体,只是用来修饰是 Spring Boot 配置而已,或者可利于 Spring Boot 后续的扩展。
  3. ### 2.5. [Conditional ](/Conditional )
  4. Spring 4.0 新提供的注解,用来标识一个 Spring Bean 或者 Configuration 配置文件,当满足指定的条件才开启配置。<br />通过 `@Conditional` 注解可以根据代码中设置的条件装载不同的bean,在设置条件注解之前,先要把装载的bean类去实现Condition接口,然后对该实现接口的类设置是否装载的条件。Spring Boot注解中的`@ConditionalOnProperty``@ConditionalOnBean`等以`@Conditional*`开头的注解,都是通过集成了`@Conditional`来实现相应功能的。
  5. #### 2.5.1. [ConditionalOnBean ](/ConditionalOnBean )
  6. 组合 `@Conditional` 注解,当容器中有指定的 Bean 才开启配置<br />`@ConditionalOnBean(A.class)` 仅仅在当前上下文中存在A对象时,才会实例化一个Bean,也就是说只有当A.class springapplicationContext中存在时,这个当前的bean才能够创建

package com.moon.test;

import org.apache.rocketmq.client.producer.DefaultMQProducer; import org.springframework.boot.SpringBootConfiguration; import org.springframework.boot.autoconfigure.condition.ConditionalOnBean; import org.springframework.context.annotation.Bean;

@SpringBootConfiguration public class SpringBootConfigurationDemo { // 当前环境上下文存在DefaultMQProducer实例时,才能创建RocketMQProducerLifecycle这个Bean @ConditionalOnBean(DefaultMQProducer.class) @Bean public RocketMQProducerLifecycle rocketMQLifecycle() { return new RocketMQProducerLifecycle(); } }

  1. #### 2.5.2. @ConditionalOnMissingBean
  2. 组合 `@Conditional` 注解,和 `@ConditionalOnBean` 注解相反,当容器中没有指定的 Bean 才开启配置。

@SpringBootConfiguration public class SpringBootConfigurationDemo { // 仅当当前环境上下文缺失RocketMQProducer对象时,才允许创建RocketMQProducer Bean对象 @ConditionalOnMissingBean(RocketMQProducer.class) @Bean public RocketMQProducer mqProducer() { return new RocketMQProducer(); } }

  1. #### 2.5.3. [ConditionalOnClass ](/ConditionalOnClass )
  2. 组合 `@Conditional` 注解,当容器中有指定的 Class 才开启配置。可以仅当某些类存在于classpath上时候才创建某个Bean

@SpringBootConfiguration public class SpringBootConfigurationDemo { // 当classpath中存在类HealthIndicator时,才创建HealthIndicator Bean对象 @ConditionalOnClass(HealthIndicator.class) @Bean public HealthIndicator rocketMQProducerHealthIndicator(Map producers) { if (producers.size() == 1) { return new RocketMQProducerHealthIndicator(producers.values().iterator().next()); } } }

  1. #### 2.5.4. @ConditionalOnMissingClass
  2. 组合 `@Conditional` 注解,和 `@ConditionalOnMissingClass` 注解相反,当容器(classpath)中没有指定的 Class 才开启配置
  3. #### 2.5.5. @ConditionalOnWebApplication
  4. 组合 `@Conditional` 注解,当前项目类型是 WEB 项目才开启配置。当前项目有以下 3 种类型。

enum Type { /**

  1. * Any web application will match.(任何Web项目都匹配)
  2. */
  3. ANY,
  4. /**
  5. * Only servlet-based web application will match.(仅但基础的Servelet项目才会匹配)
  6. */
  7. SERVLET,
  8. /**
  9. * Only reactive-based web application will match.(只有基于响应的web应用程序才匹配)
  10. */
  11. REACTIVE

}

  1. #### 2.5.6. @ConditionalOnNotWebApplication
  2. 组合 `@Conditional` 注解,和 `@ConditionalOnWebApplication` 注解相反,当前项目类型不是 WEB 项目才开启配置。
  3. #### 2.5.7. @ConditionalOnProperty
  4. 组合 `@Conditional` 注解,当指定的属性有指定的值时才开启配置。具体操作是通过其两个属性name以及havingValue来实现的,其中name用来从`application.properties`中读取某个属性值,如果该值为空,则返回false;如果值不为空,则将该值与havingValue指定的值进行比较,如果一样则返回true,否则返回false。如果返回值为false,则该configuration不生效;为true则生效。

// 匹配属性rocketmq.producer.enabled值是否为true,完全匹配后创建RocketMQProducer对象 @ConditionalOnProperty(value = “rocketmq.producer.enabled”, havingValue = “true”, matchIfMissing = true) @Bean public RocketMQProducer mqProducer() { return new RocketMQProducer(); }

  1. ```
  2. @Data
  3. @ConditionalOnProperty("rocketmq.consumer")
  4. public class RocketMQConsumerProperties extends RocketMQProperties {
  5. private boolean enabled = true;
  6. private String consumerGroup;
  7. private MessageModel messageModel = MessageModel.CLUSTERING;
  8. private ConsumeFromWhere consumeFromWhere = ConsumeFromWhere.CONSUME_FROM_LAST_OFFSET;
  9. private int consumeThreadMin = 20;
  10. private int consumeThreadMax = 64;
  11. private int consumeConcurrentlyMaxSpan = 2000;
  12. private int pullThresholdForQueue = 1000;
  13. private int pullInterval = 0;
  14. private int consumeMessageBatchMaxSize = 1;
  15. private int pullBatchSize = 32;
  16. }

2.5.8. @ConditionalOnExpression

组合 @Conditional 注解,当 SpEL 表达式为 true 时才开启配置。

  1. @Configuration
  2. @ConditionalOnExpression("${enabled:false}")
  3. public class SpringBootConfigurationDemo {
  4. @Bean
  5. public OrderMessageMonitor orderMessageMonitor(ConfigContext configContext) {
  6. return new OrderMessageMonitor(configContext);
  7. }
  8. }

2.5.9. ConditionalOnJava

组合 @Conditional 注解,当运行的 Java JVM 在指定的版本范围时才开启配置。

2.5.10. @ConditionalOnResource

组合 @Conditional 注解,当类路径下有指定的资源才开启配置。

  1. @Bean
  2. @ConditionalOnResource(resources="classpath:shiro.ini")
  3. protected Realm iniClasspathRealm(){
  4. return new Realm();
  5. }

2.5.11. ConditionalOnJndi

组合 @Conditional 注解,当指定的 JNDI 存在时才开启配置。

2.5.12. @ConditionalOnCloudPlatform

组合 @Conditional 注解,当指定的云平台激活时才开启配置。

2.5.13. @ConditionalOnSingleCandidate

组合 @Conditional 注解,当指定的 class 在容器中只有一个 Bean,或者同时有多个但为首选时才开启配置。

2.6. @ConfigurationProperties

用来加载额外的配置(如 *.properties 文件),可用在 @Configuration 注解类,或者 @Bean 注解方法上面,即使用注解的方式将自定义的properties文件映射到实体bean中

2.7. @EnableConfigurationProperties

一般要配合 @ConfigurationProperties 注解使用,用来开启对 @ConfigurationProperties 注解配置 Bean 的支持。
@EnableConfigurationProperties 注解应用到你的 @Configuration 时,任何被 @ConfigurationProperties 注解的beans将自动被Environment属性配置。这种风格的配置特别适合与SpringApplication的外部YAML配置进行配合使用。

  1. @Configuration
  2. @EnableConfigurationProperties({
  3. RocketMQProducerProperties.class,
  4. RocketMQConsumerProperties.class,
  5. })
  6. @AutoConfigureOrder
  7. public class RocketMQAutoConfiguration {
  8. @Value("${spring.application.name}")
  9. private String applicationName;
  10. }

2.8. AutoConfigureAfter

用在自动配置类上面,表示该自动配置类需要在另外指定的自动配置类配置完之后。如 Mybatis 的自动配置类,需要在数据源自动配置类之后。

  1. @AutoConfigureAfter(DataSourceAutoConfiguration.class)
  2. public class MybatisAutoConfiguration {
  3. }

2.9. AutoConfigureBefore

这个和 @AutoConfigureAfter 注解使用相反,表示该自动配置类需要在另外指定的自动配置类配置之前。

2.10. AutoConfigureOrder

Spring Boot 1.3.0中有一个新的注解@AutoConfigureOrder,用于确定配置加载的优先级顺序。

  1. @AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE) // 自动配置里面的最高优先级
  2. @Configuration
  3. @ConditionalOnWebApplication // 仅限于web应用
  4. @Import(ReactiveWebServerFactoryAutoConfiguration.BeanPostProcessorsRegistrar.class) // 导入内置容器的设置
  5. public class EmbeddedServletContainerAutoConfiguration {
  6. @Configuration
  7. @ConditionalOnClass({Servlet.class, Tomcat.class})
  8. @ConditionalOnMissingBean(value = EmbeddedServletContainerFactory.class, search = SearchStrategy.CURRENT)
  9. public static class EmbeddedTomcat {
  10. // ...
  11. }
  12. @Configuration
  13. @ConditionalOnClass({Servlet.class, Server.class, Loader.class, WebAppContext.class})
  14. @ConditionalOnMissingBean(value = EmbeddedServletContainerFactory.class, search = SearchStrategy.CURRENT)
  15. public static class EmbeddedJetty {
  16. // ...
  17. }
  18. }