在學習Spring Boot的過程中，接觸最多的就是starter。可以認為starter是一種服務——使得使用某個功能的開發者不需要關注各種依賴庫的處理，不需要具體的配置信息，由Spring Boot自動通過classpath路徑下的類發現需要的Bean，并織入bean。舉個例子，spring-boot-starter-jdbc這個starter的存在，使得我們只需要在BookPubApplication下用@Autowired引入DataSource的bean就可以，Spring Boot會自動創建DataSource的實例。

這里我們會用一個不太規范的starter展示Spring Boot的自動配置的運行原理。Spring Boot的自動配置、Command-line Runner一文中曾利用StartupRunner類在程序運行啟動后首先查詢數據庫中書的數目，現在換個需求：在系統啟動后打印各個實體的數量。

How Do

• 新建一個模塊db-count-starter，然后修改db-count-starter模塊下的pom文件，增加對應的庫。

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot</artifactId><!-- version繼承父模塊的--></dependency><dependency><groupId>org.springframework.data</groupId><artifactId>spring-data-commons</artifactId><version>1.9.3.RELEASE</version></dependency></dependencies>

• 新建包結構com/test/bookpubstarter/dbcount，然后新建DbCountRunner類，實現CommandLineRunner接口，在run方法中輸出每個實體的數量。

package com.test.bookpubstarter.dbcount;import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.boot.CommandLineRunner; import org.springframework.data.repository.CrudRepository; import java.util.Collection;public class DbCountRunner implements CommandLineRunner {protected final Logger logger = LoggerFactory.getLogger(DbCountRunner.class);private Collection<CrudRepository> repositories;public DbCountRunner(Collection<CrudRepository> repositories) {this.repositories = repositories;}@Overridepublic void run(String... strings) throws Exception {repositories.forEach(crudRepository -> {logger.info(String.format("%s has %s entries",getRepositoryName(crudRepository.getClass()),crudRepository.count()));});}private static String getRepositoryName(Class crudRepositoryClass) {for (Class repositoryInterface : crudRepositoryClass.getInterfaces()) {if (repositoryInterface.getName().startsWith("com.test.bookpub.repository")) {return repositoryInterface.getSimpleName();}}return "UnknownRepository";} }

• 增加自動配置文件DbCountAutoConfiguration

package com.test.bookpubstarter.dbcount; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.data.repository.CrudRepository; import java.util.Collection;@Configuration public class DbCountAutoConfiguration {@Beanpublic DbCountRunner dbCountRunner(Collection<CrudRepository> repositories) {return new DbCountRunner(repositories);} }

• 在src/main/resources目錄下新建META-INF文件夾，然后新建spring.factories文件，這個文件用于告訴Spring Boot去找指定的自動配置文件，因此它的內容是

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\ com.test.bookpubstarter.dbcount.DbCountAutoConfiguration

• 在之前的程序基礎上，在頂層pom文件中增加starter的依賴

<dependency><groupId>com.test</groupId><artifactId>db-count-starter</artifactId><version>0.0.1-SNAPSHOT</version> </dependency>

• 把StartupRunner相關的注釋掉，然后在main函數上右鍵Run BookPubApplication.main(...)，可以看出我們編寫的starter被主程序使用了。

自己的starter簡單演示.png

分析

正規的starter是一個獨立的工程，然后在maven中新倉庫注冊發布，其他開發人員就可以使用你的starter了。

常見的starter會包括下面幾個方面的內容：

自動配置文件，根據classpath是否存在指定的類來決定是否要執行該功能的自動配置。

spring.factories，非常重要，指導Spring Boot找到指定的自動配置文件。

endpoint：可以理解為一個admin，包含對服務的描述、界面、交互（業務信息的查詢）

health indicator：該starter提供的服務的健康指標

在應用程序啟動過程中，Spring Boot使用SpringFactoriesLoader類加載器查找org.springframework.boot.autoconfigure.EnableAutoConfiguration關鍵字對應的Java配置文件。Spring Boot會遍歷在各個jar包種META-INF目錄下的spring.factories文件，構建成一個配置文件鏈表。除了EnableAutoConfiguration關鍵字對應的配置文件，還有其他類型的配置文件：

• org.springframework.context.ApplicationContextInitializer
• org.springframework.context.ApplicationListener
• org.springframework.boot.SpringApplicationRunListener
• org.springframework.boot.env.PropertySourceLoader
• org.springframework.boot.autoconfigure.template.TemplateAvailabilityProvider
• org.springframework.test.contex.TestExecutionListener

Spring Boot的starter在編譯時不需要依賴Spring Boot的庫。這個例子中依賴spring boot并不是因為自動配置要用spring boot，而僅僅是因為需要實現CommandLineRunner接口。

兩個需要注意的點

@ConditionalOnMissingBean的作用是：只有對應的ban在系統中都沒有被創建，它修飾的初始化代碼塊才會執行，用戶自己手動創建的bean優先；

Spring Boot starter如何找到自動配置文件（xxxxAutoConfiguration之類的文件）？

• spring.factories：由Spring Boot觸發探測classpath目錄下的類，進行自動配置；
• @Enable：有時需要由starter的用戶觸發*查找自動配置文件的過程。

總結

以上是生活随笔為你收集整理的Spring Boot：定制自己的starter的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。