SpringBoot詳細(xì)分析自動裝配原理并實現(xiàn)starter
約定優(yōu)于配置
SpringBoot的預(yù)定優(yōu)于配置主要體現(xiàn)在以下幾個方面：
maven的目錄結(jié)構(gòu)：
- 配置文件默認(rèn)存放在
resources目錄下 - 項目編譯后的文件存放在
target目錄下 - 項目默認(rèn)打包成
jar格式
配置文件默認(rèn)為application.yml或application.yaml或application.properties
默認(rèn)通過 spring.profiles.active 屬性來決定運(yùn)行環(huán)境時的配置文件。
自動裝配
相對于傳統(tǒng)的Spring項目的繁瑣配置，SpringBoot項目只需要使用一個@SpringBootApplication注解就可以成功運(yùn)行，哪有什么歲月靜好，只不過是有人在替我們負(fù)重前行。讓我們來看一看在@SpringBootApplication注解的背后SpringBoot為我們做了哪些事情。
可以看到@SpringBootApplication是一個組合注解，上面四個不用看，因為是定義一個注解必須的，關(guān)鍵在于下面的@SpringBootConfiguration``@EnableAutoConfiguration``@ComponentScan三個注解。也就是說我們不用@SpringBootApplication，使用下這三個注解也可以成功運(yùn)行一個SpringBoot應(yīng)用。
@SpringBootConfiguration注解
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Configuration
public @interface SpringBootConfiguration {
}點(diǎn)進(jìn)源碼可以發(fā)現(xiàn)，它實際上就是一個@Configuration注解，@Configuration大家應(yīng)該都很熟悉了，加上這個注解后當(dāng)前類就會被Spring所管理 。
@ComponentScan注解
這個注解用于定義Spring的掃描路徑，等價于<context:component-scan>，如果沒有配置掃描路徑，那么SpringBoot會默認(rèn)掃描當(dāng)前類的包及其子包中所有標(biāo)注了需要被管理的類。
@EnableAutoConfiguration
這個注解才是SpringBoot自動裝配的關(guān)鍵，這也是一個組合注解
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@AutoConfigurationPackage
@Import(AutoConfigurationImportSelector.class)
public @interface EnableAutoConfiguration {
String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";
Class<?>[] exclude() default {};
String[] excludeName() default {};
}@AutoConfigurationPackage其實也是一個@Import注解
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@Import(AutoConfigurationPackages.Registrar.class)
public @interface AutoConfigurationPackage {
}
@Import注解
在@Configuration標(biāo)注的Class上可以使用@Import引入其它的配置類，其實它還可以引入org.springframework.context.annotation.ImportSelector實現(xiàn)類。ImportSelector接口只定義了一個selectImports()，用于指定需要注冊為bean的Class名稱。當(dāng)在@Configuration標(biāo)注的Class上使用@Import引入了一個ImportSelector實現(xiàn)類后，會把實現(xiàn)類中返回的Class名稱都定義為bean。
@EnableAutoConfiguration中@Import主要就是為了導(dǎo)入一個AutoConfigurationImportSelector，下面我們分析一下這個類：
AutoConfigurationImportSelector類
AutoConfigurationImportSelect類實現(xiàn)了ImportSelector接口，所以我們清楚只需關(guān)注selectImports()方法的返回結(jié)果即可：
@Override
public String[] selectImports(AnnotationMetadata annotationMetadata) {
if (!isEnabled(annotationMetadata)) {
return NO_IMPORTS;
}
AutoConfigurationMetadata autoConfigurationMetadata = AutoConfigurationMetadataLoader
.loadMetadata(this.beanClassLoader);
AutoConfigurationEntry autoConfigurationEntry = getAutoConfigurationEntry(autoConfigurationMetadata,
annotationMetadata);
return StringUtils.toStringArray(autoConfigurationEntry.getConfigurations());
}該方法返回的是要注冊到IOC容器中的對象的類型的全路徑名稱的字符串?dāng)?shù)組，所以我們要分析一下這個數(shù)組是從哪里來的？
進(jìn)入到getAutoConfigurationEntry方法中：
protected AutoConfigurationEntry getAutoConfigurationEntry(AutoConfigurationMetadata autoConfigurationMetadata,
AnnotationMetadata annotationMetadata) {
if (!isEnabled(annotationMetadata)) {
return EMPTY_ENTRY;
}
// 獲取注解的屬性信息
AnnotationAttributes attributes = getAttributes(annotationMetadata);
// 獲取候選配置
List<String> configurations = getCandidateConfigurations(annotationMetadata, attributes);
configurations = removeDuplicates(configurations);
Set<String> exclusions = getExclusions(annotationMetadata, attributes);
checkExcludedClasses(configurations, exclusions);
configurations.removeAll(exclusions);
configurations = filter(configurations, autoConfigurationMetadata);
fireAutoConfigurationImportEvents(configurations, exclusions);
return new AutoConfigurationEntry(configurations, exclusions);
}通過DEBUG可以看到，在getCandidateConfigurations方法中獲取到了很多java類全路徑
進(jìn)入getCandidateConfigurations方法，可以看到有一個斷言：如果configurations為空的話，會提示No auto configuration classes found in META-INF/spring.factories. If you are using a custom packaging, make sure that file is correct(在META-INF/spring.factories中找不到自動配置類。如果您使用的是自定義打包，請確保該文件正確無誤)
由此我們可以推測：自動配置的類名數(shù)組在META-INF/spring.factories文件中，并且我們可以通過在正確的路徑下面添加這個文件來自定義包來適配SpringBoot
protected List<String> getCandidateConfigurations(AnnotationMetadata metadata, AnnotationAttributes attributes) {
List<String> configurations = SpringFactoriesLoader.loadFactoryNames(getSpringFactoriesLoaderFactoryClass(),
getBeanClassLoader());
Assert.notEmpty(configurations, "No auto configuration classes found in META-INF/spring.factories. If you "
+ "are using a custom packaging, make sure that file is correct.");
return configurations;
}
進(jìn)入這個文件可以看到，這里配置了大量的需要自動裝配的類，當(dāng)我們啟動Springboot項目的時候，SpringBoot會掃描所有jar包下面的META-INF/spring.factories文件，并根據(jù)key進(jìn)行讀取，在經(jīng)過一系列的操作來完成自動裝配。
需要注意的是：上圖中的 spring.factories 文件是在 spring-boot-autoconfigure 包下面，這個包記錄了官方提供的 stater 中幾乎所有需要的自動裝配類，所以并不是每一個官方的 starter 下都會有 spring.factories 文件。
@AutoConfigurationPackage注解
@AutoConfigurationPackage注解的主要作用就是將主程序類所在包及所有子包下的組件到掃描到spring容器中。
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@Import(AutoConfigurationPackages.Registrar.class)
public @interface AutoConfigurationPackage {
}這個注解實際上是導(dǎo)入了AutoConfigurationPackages的一個內(nèi)部類Registrar，這個類的作用就是讀取到最外層@SpringBootApplication注解中配置的掃描路徑（沒有配置默認(rèn)當(dāng)前所在包），將該路徑下所有文件掃描，并分析注冊bean。
static class Registrar implements ImportBeanDefinitionRegistrar, DeterminableImports {
@Override
public void registerBeanDefinitions(AnnotationMetadata metadata, BeanDefinitionRegistry registry) {
register(registry, new PackageImport(metadata).getPackageName());
}
@Override
public Set<Object> determineImports(AnnotationMetadata metadata) {
return Collections.singleton(new PackageImport(metadata));
}
}
手寫一個starter組件
上面提到在自己的包中添加META-INF/spring.factories文件就可以適配SpringBoot實現(xiàn)自動配置，這其實是一種SPI的思想。
SPI，Service Provider Interface。即：接口服務(wù)的提供者。就是說我們應(yīng)該面向接口（抽象）編程，而不是面向具體的實現(xiàn)來編程，這樣一旦我們需要切換到當(dāng)前接口的其他實現(xiàn)就無需修改代碼。
starter的命名規(guī)范:
官方的starter命名格式為spring-boot-starter-{xxx}，例如：spring-boot-starter-web等
自定義starter命名格式一般為{xxx}-spring-boot-starter，例如mybatis的mybatis-spring-boot-starter
\1) 新建一個springboot項目myself-spring-boot-starter
\2) 新建自己的業(yè)務(wù)類
public class MyselfService {
private String myself;
// ……省略 getter setter
public String doBusiness(Object obj){
return myself+obj.toString();
}
}3）業(yè)務(wù)需要的一些屬性值
@ConfigurationProperties("myself")
public class MysefProperties {
private String myself;
// ……省略 getter setter
}4）新建自動裝配類，把自己的業(yè)務(wù)交給Spring管理
@Configuration
@EnableConfigurationProperties(MysefProperties.class)
public class MyselfAutoConfiguration {
@Autowired
MysefProperties mysefProperties;
@Bean
@ConditionalOnMissingBean(MyselfService.class)
public MyselfService myselfService(){
MyselfService myselfService = new MyselfService();
myselfService.setMyself(mysefProperties.getMyself());
return myselfService;
}
}5）在resources/META-INF下新建spring.factories，配置starter中配置類的位置
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.yy.autoconfigure.MyselfAutoConfiguration
6）mvn install將自己的包打到自己倉庫中，在另外的項目直接引用即可
7）測試
mybatis-plus-boot-starter
我們可以學(xué)習(xí)一下其他第三方的成熟的starter，會發(fā)現(xiàn)其實套路是很相似的
到此這篇關(guān)于SpringBoot詳細(xì)分析自動裝配原理并實現(xiàn)starter的文章就介紹到這了,更多相關(guān)SpringBoot自動裝配原理內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
這篇文章主要為大家詳細(xì)介紹了Spring Bean生命周期之屬性賦值階段，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下，希望能夠給你帶來幫助2022-03-03
SpringBoot使用MockMvc進(jìn)行單元測試的實例代碼
在Spring Boot應(yīng)用程序中,使用MockMvc進(jìn)行單元測試是一種有效的方式,可以驗證控制器的行為和API的正確性,在這篇博客中,我們將介紹如何使用MockMvc對用戶控制器進(jìn)行測試,感興趣的朋友可以參考下2024-01-01
這篇文章主要介紹了SpringCloud入門實驗環(huán)境搭建的相關(guān)資料，幫助大家更好的理解和學(xué)習(xí)使用SpringCloud，感興趣的朋友可以了解下2021-04-04
Java利用trueLicense實現(xiàn)項目離線證書授權(quán)操作步驟
文章介紹了如何使用trueLicense實現(xiàn)離線授權(quán)控制,包括生成公私鑰、創(chuàng)建證書校驗?zāi)K、生成證書模塊和測試模塊,通過這種方式,可以控制用戶使用的項目模塊、授權(quán)周期、使用的設(shè)備和服務(wù)器,感興趣的朋友跟隨小編一起看看吧2024-11-11
SpringBoot解決BigDecimal傳到前端后精度丟失問題
因BigDecimal類型數(shù)據(jù)引出的問題詳析
java基于雙向環(huán)形鏈表解決丟手帕問題的方法示例