自定義的Spring Boot starter如何設置自動配置註解

本文首發於我的網站：自定義的Spring Boot starter如何設置自動配置註解

在Spring Boot實戰之定製本身的starter一文最後提到，觸發Spring Boot的配置過程有兩種方法：

1. spring.factories：由Spring Boot觸發探測classpath目錄下的類，進行自動配置；
2. @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系列

1. Spring Boot的自動配置、Command-line-Runner
2. 瞭解Spring Boot的自動配置
3. Spring Boot的@PropertySource註解在整合Redis中的使用
4. Spring Boot項目中如何定製HTTP消息轉換器
5. Spring Boot整合Mongodb提供Restful接口
6. Spring中bean的scope
7. Spring Boot項目中使用事件派發器模式
8. Spring Boot提供RESTful接口時的錯誤處理實踐
9. Spring Boot實戰之定製本身的starter
10. Spring Boot項目如何同時支持HTTP和HTTPS協議

---

本號專一於後端技術、JVM問題排查和優化、Java面試題、我的成長和自我管理等主題，爲讀者提供一線開發者的工做和成長經驗，期待你能在這裏有所收穫。