@SpringBootApplication注解的使用
一、前言
大部分的配置都可以用Java類(lèi)+注解來(lái)代替，而在SpringBoot項(xiàng)目中見(jiàn)的最多的莫過(guò)于@SpringBootApplication注解了，它在每個(gè)SpringBoot的啟動(dòng)類(lèi)上都有標(biāo)注。
這個(gè)注解對(duì)SpringBoot的啟動(dòng)和自動(dòng)配置到底有什么樣的影響呢？本文將為各位大佬解析它的源碼，揭開(kāi)@SpringBootApplication注解神秘的面紗。
二、正文
對(duì)SpringBoot工程的自動(dòng)配置很感興趣，于是學(xué)習(xí)其源碼并整理了其中一些內(nèi)容，如果有錯(cuò)誤請(qǐng)大家指正~話(huà)不多說(shuō)，直接上源碼；
@SpringBootApplication注解的源碼如下：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = {
@Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
@Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication {
...
}
可以看到這是一個(gè)復(fù)合注解，一共包括7個(gè)不同的注解，下面對(duì)這7個(gè)不同的注解進(jìn)行分析。
2.1 注解
2.1.1 注解1：@Target({ElementType.TYPE})
用來(lái)表示注解作用范圍，TYPE表示作用范圍為類(lèi)或接口。
2.1.2 注解2：@Retention(RetentionPolicy.RUNTIME)
2.1.3 注解3：@Documented
表明這個(gè)注釋是由 javadoc記錄的。
2.1.4 注解4：@Inherited
放在注解上，當(dāng)父類(lèi)加了@SpringBootApplication注解時(shí)，子類(lèi)也會(huì)繼承這個(gè)注解（對(duì)接口的實(shí)現(xiàn)類(lèi)無(wú)效）。
2.1.5 注解5：@SpringBootConfiguration
底層仍是@Configuration注解, 源碼如下：
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Configuration
public @interface SpringBootConfiguration {
}
2.1.6 注解6：@ComponetScan
@ComponentScan這個(gè)注解在Spring中很重要，它對(duì)應(yīng)XML配置中的元素@ComponentScan的功能其實(shí)就是自動(dòng)掃描并加載符合條件的組件（比如@Component和@Repository等）或者bean定義，最終將這些bean定義加載到IoC容器中。
可以通過(guò)basePackages等屬性來(lái)細(xì)粒度的定制@ComponentScan自動(dòng)掃描的范圍，如果不指定，則默認(rèn)Spring框架實(shí)現(xiàn)會(huì)從聲明@ComponentScan所在類(lèi)的package進(jìn)行掃描。所以SpringBoot的啟動(dòng)類(lèi)最好是放在root package下，因?yàn)槟J(rèn)不指定basePackages。
2.2 注解：@EnableAutoConfiguration
個(gè)人感覺(jué)@EnableAutoConfiguration這個(gè)Annotation最為重要它的作用可以概括為：借助@Import的幫助，將所有符合自動(dòng)配置條件的bean定義加載到IoC容器。
其源碼如下：
@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 {};
}
這里需要關(guān)注@AutoConfigurationPackage和@Import(AutoConfigurationImportSelector.class)兩個(gè)注解。
2.2.1 注釋?zhuān)篅AutoConfigurationPackage
源碼如下：
@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 {};
}
可以發(fā)現(xiàn)這個(gè)注解的核心其實(shí)也是Import注解，表示對(duì)于標(biāo)注該注解的類(lèi)的包，應(yīng)當(dāng)使用AutoConfigurationPackages注冊(cè)。接著看Registrar這個(gè)類(lèi)：
static class Registrar implements ImportBeanDefinitionRegistrar, DeterminableImports {
@Override
//metadata是我們注解所在的元信息
public void registerBeanDefinitions(AnnotationMetadata metadata, BeanDefinitionRegistry registry) {
//將我們注解所在包下所有的組件進(jìn)行注冊(cè)
register(registry, new PackageImport(metadata).getPackageName());
}
@Override
public Set<Object> determineImports(AnnotationMetadata metadata) {
return Collections.singleton(new PackageImport(metadata));
}
}
這個(gè)類(lèi)中的核心方法是register方法：
private static final String BEAN = AutoConfigurationPackages.class.getName();
public static void register(BeanDefinitionRegistry registry, String... packageNames) {
if (registry.containsBeanDefinition(BEAN)) {
BeanDefinition beanDefinition = registry.getBeanDefinition(BEAN);
ConstructorArgumentValues constructorArguments = beanDefinition.getConstructorArgumentValues();
constructorArguments.addIndexedArgumentValue(0, addBasePackages(constructorArguments, packageNames));
}
else {
GenericBeanDefinition beanDefinition = new GenericBeanDefinition();
beanDefinition.setBeanClass(BasePackages.class);
beanDefinition.getConstructorArgumentValues().addIndexedArgumentValue(0, packageNames);
beanDefinition.setRole(BeanDefinition.ROLE_INFRASTRUCTURE);
registry.registerBeanDefinition(BEAN, beanDefinition);
}
}
register方法的邏輯非常清晰：如果這個(gè)bean已經(jīng)被注冊(cè)，就獲取它的構(gòu)造函數(shù)參數(shù)值，并將包名添加進(jìn)去；否則就創(chuàng)建一個(gè)新的bean定義并進(jìn)行注冊(cè)。通過(guò)@AutoConfigurationPackage這個(gè)注解，可以將注解所在包下所有的組件進(jìn)行注冊(cè)。
2.2.2 注解：@Import(AutoConfigurationImportSelector.class)
這個(gè)注解導(dǎo)入了AutoConfigurationImportSelector這個(gè)類(lèi)這個(gè)類(lèi)的核心方法是selectImports方法，實(shí)現(xiàn)ImportSelector接口。方法基于我們?cè)趐om.xml文件中配置的jar包和組件進(jìn)行導(dǎo)入。所以方法返回的是一個(gè)Class全路徑的String數(shù)組，返回的Class會(huì)被Spring容器管理。方法源碼如下：
@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());
}
這個(gè)方法的結(jié)構(gòu)也很清晰，首先通過(guò)isEnabled方法判斷是否需要進(jìn)行導(dǎo)入，如果需要導(dǎo)入的話(huà)，通過(guò)loadMetadata方法獲取配置信息，并通過(guò)getAutoConfigurationEntry進(jìn)行自動(dòng)裝配。isEnabled方法源碼如下：
protected boolean isEnabled(AnnotationMetadata metadata) {
if (getClass() == AutoConfigurationImportSelector.class) {
return getEnvironment().getProperty(EnableAutoConfiguration.ENABLED_OVERRIDE_PROPERTY, Boolean.class, true);
}
return true;
}
這個(gè)方法通過(guò)EnableAutoConfiguration.ENABLED_OVERRIDE_PROPERTY這個(gè)配置項(xiàng)進(jìn)行判斷是否需要自動(dòng)配置，默認(rèn)為true。loadMetadata方法源碼如下：
protected static final String PATH = "META-INF/" + "spring-autoconfigure-metadata.properties";
public static AutoConfigurationMetadata loadMetadata(ClassLoader classLoader) {
return loadMetadata(classLoader, PATH);
}
static AutoConfigurationMetadata loadMetadata(ClassLoader classLoader, String path) {
try {
Enumeration<URL> urls = (classLoader != null) ? classLoader.getResources(path)
: ClassLoader.getSystemResources(path);
Properties properties = new Properties();
while (urls.hasMoreElements()) {
properties.putAll(PropertiesLoaderUtils.loadProperties(new UrlResource(urls.nextElement())));
}
return loadMetadata(properties);
}
catch (IOException ex) {
throw new IllegalArgumentException("Unable to load @ConditionalOnClass location [" + path + "]", ex);
}
}
static AutoConfigurationMetadata loadMetadata(Properties properties) {
return new PropertiesAutoConfigurationMetadata(properties);
}
可以看到這個(gè)方法會(huì)加載META-INF/spring-autoconfigure-metadata.properties下的所有配置信息并包裝成AutoConfigurationMetadata對(duì)象返回。
注：spring-autoconfigure-metadata.properties文件在spring-boot-autoconfigure-2.1.9.RELEASE.jar/META-INF下。
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);
}
這個(gè)方法是AutoConfiguration的主流程方法，可以將這個(gè)方法的每一行看做一個(gè)步驟，那么處理步驟如下：
1. 加載配置了@EnableAutoConfiguration注解的屬性值getAttribute方法：
protected AnnotationAttributes getAttributes(AnnotationMetadata metadata) {
String name = getAnnotationClass().getName();
AnnotationAttributes attributes = AnnotationAttributes.fromMap(metadata.getAnnotationAttributes(name, true));
Assert.notNull(attributes, () -> "No auto-configuration attributes found. Is " + metadata.getClassName()
+ " annotated with " + ClassUtils.getShortName(name) + "?");
return attributes;
}
2.得到META-INF/spring.factories文件中以@EnableAutoConfiguration完全限定類(lèi)名做key的value，getCandidateConfigurations方法：
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;
}
protected Class<?> getSpringFactoriesLoaderFactoryClass() {
return EnableAutoConfiguration.class;
}
其中，SpringFactoriesLoader.loadFactoryNames()這個(gè)方法的作用是使用給定的類(lèi)加載器從META-INF/spring.factories加載給定類(lèi)型的工廠(chǎng)實(shí)現(xiàn)的完全限定類(lèi)名；
3.去重；
4.得到需要排除的類(lèi)的類(lèi)名，這些類(lèi)可以在@EnableAutoConfiguration注解中配置；
5.檢查這兩個(gè)集合；
6.把需要排除的類(lèi)移除；
7.根據(jù)OnBeanCondition、OnClassCondition等條件進(jìn)行過(guò)濾（有興趣可以深入了解）；
8.廣播事件，得到AutoConfigurationImportListener所有實(shí)現(xiàn)類(lèi)，然后生成事件進(jìn)行廣播；
9.把需要裝配和排除的類(lèi)完全限定名封裝成了AutoConfigurationEntry對(duì)象返回。
因此，@EnableAutoConfiguration可以簡(jiǎn)單總結(jié)為：從classpath中搜尋所有的META-INF/spring.factories配置文件，并將其中EnableAutoConfiguration對(duì)應(yīng)的配置項(xiàng)通過(guò)反射實(shí)例化為對(duì)應(yīng)的標(biāo)注了@Configuration的IoC容器配置類(lèi)，并加載到IoC容器。
三、小結(jié)
通過(guò)以上分析可知@SpringBootApplication注解的運(yùn)作是通過(guò)@SpringApplicationConfiguration聲明被標(biāo)注類(lèi)為配置類(lèi)，從而被AnnotationConfigApplicationContext掃描并初始化Spring容器。
通過(guò)@EnableAutoConfiguration來(lái)掃描，過(guò)濾并加載所需要的組件；通過(guò)@ComponentScan掃描并注冊(cè)所有標(biāo)注了@Component及其子注解的類(lèi)；這些注解的共同運(yùn)作實(shí)現(xiàn)了springboot工程強(qiáng)大的自動(dòng)配置能力。
以上就是@SpringBootApplication注解的使用的詳細(xì)內(nèi)容，更多關(guān)于@SpringBootApplication注解的使用的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
使用Java注解和反射實(shí)現(xiàn)JSON字段自動(dòng)重命名
這篇文章主要介紹了如何使用Java注解和反射實(shí)現(xiàn)JSON字段自動(dòng)重命名,文中通過(guò)代碼示例和圖文介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作有一定的幫助,需要的朋友可以參考下2024-08-08
本文介紹了消息服務(wù)組件的基本概念，以及如何在SpringBoot中整合常見(jiàn)的消息服務(wù)組件，如ActiveMQ、RabbitMQ和Kafka，我們探討整合消息服務(wù)組件在實(shí)際應(yīng)用場(chǎng)景中的優(yōu)勢(shì)，感興趣的朋友跟隨小編一起看看吧2023-07-07
利用Java設(shè)置Word文本框中的文字旋轉(zhuǎn)方向的實(shí)現(xiàn)方法
Word文檔中可添加文本框,并設(shè)置文本框?yàn)闄M向文本排列或是縱向文本排列,或者設(shè)置文本框中的文字旋轉(zhuǎn)方向等.通過(guò)Java程序代碼,也可以實(shí)現(xiàn)以上文本框的操作.下面以Java代碼示例展示具體的實(shí)現(xiàn)步驟.另外,可參考C#及VB.NET代碼的實(shí)現(xiàn)方法,需要的朋友可以參考下2021-06-06
Java中什么時(shí)候類(lèi)加載,第一次需要使用類(lèi)信息時(shí)加載。類(lèi)加載的原則：延遲加載，能不加載就不加載。下面這篇文章主要介紹了Java中類(lèi)的加載順序,需要的朋友可以參考借鑒，下面來(lái)一起看看吧。2017-01-01
這篇文章主要給大家介紹了關(guān)于java枚舉原來(lái)還可以這么用的相關(guān)資料，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家學(xué)習(xí)或者使用java具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2019-09-09
在Java編程中,獲取堆棧信息對(duì)于調(diào)試和故障排除非常重要,Java提供了多種方式來(lái)獲取當(dāng)前線(xiàn)程的堆棧信息,下面就跟隨小編一起學(xué)習(xí)一下常用的三種吧2024-03-03
Java開(kāi)發(fā)中synchronized的定義及用法詳解
這篇文章主要介紹了Java開(kāi)發(fā)中synchronized的定義及用法詳解，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2020-07-07
springboot中設(shè)置定時(shí)任務(wù)的三種方法小結(jié)
在我們開(kāi)發(fā)項(xiàng)目過(guò)程中,經(jīng)常需要定時(shí)任務(wù)來(lái)幫助我們來(lái)做一些內(nèi)容,本文介紹了springboot中設(shè)置定時(shí)任務(wù)的三種方法,主要包括@Scheduled注解,Quartz框架和xxl-job框架的實(shí)現(xiàn),感興趣的可以了解一下2023-12-12
這篇文章主要介紹了Idea中如何修改項(xiàng)目的SVN地址問(wèn)題，具有很好的參考價(jià)值，希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2023-06-06
這篇文章主要為大家分享了Java面試資源中篇，百度“Java面試題”前200頁(yè)都在這里了，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2017-12-12