SpringBoot的常用注解配置

SpringBoot的注解配置

常用注解

@Configuration

从Spring3.0,@Configuration用于定义配置类,可替换xml配置文件,被注解的类内部包含有一个或多个被@Bean注解的方法,这些方法将会被AnnotationConfigApplicationContext或AnnotationConfigWebApplicationContext类进行扫描,并用于构建bean定义,初始化Spring容器。

使用@Configuration注解的配置类有如下要求:

  • 不可以声明为final类型;
  • 不可以是匿名类;
  • 嵌套的内部类必须声明为静态。

@Bean

@Bean注解告诉Spring,一个带有@Bean注解的方法将返回一个对象,该对象应该被注册为在 Spring 应用程序上下文中的 bean。

@Bean是一个方法级别上的注解,主要用在@Configuration注解的类里,也可以用在@Component注解的类里。

@EnableConfigurationProperties

@ConfigurationProperties注解,主要是用来把properties或者yml配置文件转化为bean来使用的,而@EnableConfigurationProperties注解的作用是@ConfigurationProperties注解生效。

如果只配置@ConfigurationProperties注解,在IOC容器中是获取不到properties配置文件转化的bean的,当然在@ConfigurationProperties加入注解的类上加@Component也可以使交于springboot管理

@AutoConfigureAfter

@AutoConfigureAfter(DataSourceAutoConfiguration.class) //在加载配置的类之后再加载当前类

@PostConstruct

PostConstruct 注释用于在依赖关系注入完成之后需要执行的方法上,以执行任何初始化。

注意:该方法不得有任何参数;该方法的返回类型必须为 void;该方法不得抛出已检查异常;

条件加载注解

  • @ConditionalOnBean(DataSource.class),当存在DataSource.class的bean时,才实例化一个bean
  • @ConditionalOnMissingBean,不存在某个bean的时候实例化
  • @ConditionalOnClass,存在某个类时,才会实例化一个Bean
  • @ConditionalOnMissingClass,不存在某个类时,才会实例化一个Bean
  • @ConditionalOnProperty(prefix = “syj”, name = “algorithm”, havingValue = “counter”, matchIfMissing = true),当存在配置文件中以syj为前缀的属性,属性名称为algorithm,然后它的值为token时才会实例化一个类。

元注解

所谓元注解就是可以注解到别的注解上的注解,以下介绍4个基本元注解的作用

1、@Retention: 定义注解的保留策略

@Retention(RetentionPolicy.SOURCE)   //注解仅存在于源码中,在class字节码文件中不包含
    @Retention(RetentionPolicy.CLASS)     // 默认的保留策略,注解会在class字节码文件中存在,但运行时无法获得,
    @Retention(RetentionPolicy.RUNTIME)  // 注解会在class字节码文件中存在,在运行时可以通过反射获取到

2、@Target:定义注解的作用目标

@Target(ElementType.TYPE)   //接口、类、枚举、注解
@Target(ElementType.FIELD) //字段、枚举的常量
@Target(ElementType.METHOD) //方法
@Target(ElementType.PARAMETER) //方法参数
@Target(ElementType.CONSTRUCTOR)  //构造函数
@Target(ElementType.LOCAL_VARIABLE)//局部变量
@Target(ElementType.ANNOTATION_TYPE)//注解
@Target(ElementType.PACKAGE) ///包

3、@Document:说明该注解将被包含在javadoc中

4、@Inherited:说明子类可以继承父类中的该注解

综合使用(以mybatis为例)

一、声明一个Configuration配置类

@org.springframework.context.annotation.Configuration
@ConditionalOnClass({ SqlSessionFactory.class, SqlSessionFactoryBean.class })
@ConditionalOnBean(DataSource.class)
@EnableConfigurationProperties(MybatisProperties.class)
@AutoConfigureAfter(DataSourceAutoConfiguration.class)  //在加载配置的类之后再加载当前类
public class MybatisAutoConfiguration {

  private static final Logger logger = LoggerFactory.getLogger(MybatisAutoConfiguration.class);

  private final MybatisProperties properties;

  private final Interceptor[] interceptors;

  private final ResourceLoader resourceLoader;

  private final DatabaseIdProvider databaseIdProvider;

  private final List<ConfigurationCustomizer> configurationCustomizers;

  //会自动注入参数中已经被实例化的bean
  public MybatisAutoConfiguration(MybatisProperties properties,
                                  ObjectProvider<Interceptor[]> interceptorsProvider,
                                  ResourceLoader resourceLoader,
                                  ObjectProvider<DatabaseIdProvider> databaseIdProvider,
                                  ObjectProvider<List<ConfigurationCustomizer>> configurationCustomizersProvider) {
    this.properties = properties;
    this.interceptors = interceptorsProvider.getIfAvailable();
    this.resourceLoader = resourceLoader;
    this.databaseIdProvider = databaseIdProvider.getIfAvailable();
    this.configurationCustomizers = configurationCustomizersProvider.getIfAvailable();
  }

  @PostConstruct  //配置加载完后执行此方法
  public void checkConfigFileExists() {
    //检查配置的configLocation是否加载到资源
    if (this.properties.isCheckConfigLocation() && StringUtils.hasText(this.properties.getConfigLocation())) {
      Resource resource = this.resourceLoader.getResource(this.properties.getConfigLocation());
      Assert.state(resource.exists(), "Cannot find config location: " + resource
          + " (please add config file or check your Mybatis configuration)");
    }
  }

  @Bean
  @Primary  //当spring实例化了多个DataSource的bean,自动注入时默认注入这个
  @ConfigurationProperties(prefix = "spring.datasource.druid.oracle")
  public DataSource dataSource() {
      return DruidDataSourceBuilder.create().build();
  }

  //配合@Qualifier使用注入特定bean
  @Bean(name="transactionManager")  //**声明返回的bean名,默认为方法名tmOracle**
  DataSourceTransactionManager tmOracle(@Qualifier("dataSource") DataSource dataSource) {  
      DataSourceTransactionManager tm = new DataSourceTransactionManager(dataSource);
      return tm;
  }

  @Bean
  @ConditionalOnMissingBean
  public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {
    //以下省略sqlSessionFactory的初始化操作
  }

  @Bean
  @ConditionalOnMissingBean
  public SqlSessionTemplate sqlSessionTemplate(SqlSessionFactory sqlSessionFactory) {
    //...
  }

二、配置文件信息加载到Properties类

@ConfigurationProperties(prefix = "mybatis")
public class MybatisProperties {

  private String configLocation;  //对应配置 mybatis.configLocation=
  
  ...
  //set和get方法
}

自定义注解的使用

原文 

https://segmentfault.com/a/1190000020360098

本站部分文章源于互联网,本着传播知识、有益学习和研究的目的进行的转载,为网友免费提供。如有著作权人或出版方提出异议,本站将立即删除。如果您对文章转载有任何疑问请告之我们,以便我们及时纠正。

PS:推荐一个微信公众号: askHarries 或者qq群:474807195,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分析,高并发、高性能、分布式、微服务架构的原理,JVM性能优化这些成为架构师必备的知识体系。还能领取免费的学习资源,目前受益良多

转载请注明原文出处:Harries Blog™ » SpringBoot的常用注解配置

赞 (0)
分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址