自定义的Spring Boot starter如何设置自动配置注解

本文首发于个人网站：自定义的Spring Boot starter如何设置自动配置注解

在Spring Boot实战之定制自己的starter一文最后提到，触发Spring Boot的配置过程有两种方法：

spring.factories：由Spring Boot触发探测classpath目录下的类，进行自动配置；
@Enable：有时需要由starter的用户触发*查找自动配置文件的过程。

实战

接着上篇文章的例子，首先将spring.factories中的内容注释掉

#org.springframework.boot.autoconfigure.EnableAutoConfiguration=\

#com.test.bookpubstarter.dbcount.DbCountAutoConfiguration

创建元注解（meta-annotation），即在db-count-starter/src/main/java/org/test/bookpubstarter/dbcount目录下新建EnableDbCounting.java文件。

package com.test.bookpubstarter.dbcount;

import org.springframework.context.annotation.Import;

import java.lang.annotation.*;

@Target(ElementType.TYPE)

@Retention(RetentionPolicy.RUNTIME)

@Import(DbCountAutoConfiguration.class)

@Documented

public @interface EnableDbCounting {

}

在BookPubApplication类中删去之前手动创建的DbCountRunner的spring bean，然后用@EnableDbCounting注解修饰BookPubApplication类。

package com.test.bookpub;

import com.test.bookpubstarter.dbcount.EnableDbCounting;

import org.springframework.boot.SpringApplication;

import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication

@EnableDbCounting

public class BookPubApplication {

    public static void main(String[] args) {

        SpringApplication.run(BookPubApplication.class, args);

    }

}

启动应用程序，设置日志级别为DEBUG

可以看出我们自己定义的注解起作用了。如果没有spring.factories，那么在程序启动的时候Spring Boot的自动配置机制不会试图解析DbCountAutoConfiguration类。一般来说，@Component注解的作用范围就是在BookPubApplication所在的目录以及各个子目录，即com.test.bookpub.*，而DbCountAutoConfiguration是在org.test.bookpubstarter.dbcount目录下，因此不会被扫描到。

@EnableDbCounting注解通过@Import(DbCountAutoConfiguration.class)找到对应的配置类，因此通过用@EnableDbCounting修饰BookPubApplication，就是告诉Spring Boot在启动过程中要把DbCountAutoConfiguration加入到应用上下文中。

Spring Boot 1.x系列

本号专注于后端技术、JVM问题排查和优化、Java面试题、个人成长和自我管理等主题，为读者提供一线开发者的工作和成长经验，期待你能在这里有所收获。

巴特西

自定义的Spring Boot starter如何设置自动配置注解

实战

Spring Boot 1.x系列

最新文章

热门文章