约定优于配置
SpringBoot的预定优于配置主要体现在以下几个方面:
maven的目录结构:
- 配置文件默认存放在
resources
目录下 - 项目编译后的文件存放在
target
目录下 - 项目默认打包成
jar
格式
配置文件默认为application.yml
或application.yaml
或application.properties
默认通过 spring.profiles.active 属性来决定运行环境时的配置文件。
自动装配
相对于传统的Spring项目的繁琐配置,SpringBoot项目只需要使用一个@SpringBootApplication
注解就可以成功运行,哪有什么岁月静好,只不过是有人在替我们负重前行。让我们来看一看在@SpringBootApplication
注解的背后SpringBoot为我们做了哪些事情。
可以看到@SpringBootApplication
是一个组合注解,上面四个不用看,因为是定义一个注解必须的,关键在于下面的@SpringBootConfiguration``@EnableAutoConfiguration``@ComponentScan
三个注解。也就是说我们不用@SpringBootApplication
,使用下这三个注解也可以成功运行一个SpringBoot应用。
@SpringBootConfiguration注解
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Configuration
public @interface SpringBootConfiguration {
}
点进源码可以发现,它实际上就是一个@Configuration
注解,@Configuration
大家应该都很熟悉了,加上这个注解后当前类就会被Spring所管理 。
@ComponentScan注解
这个注解用于定义Spring的扫描路径,等价于<context:component-scan>
,如果没有配置扫描路径,那么SpringBoot会默认扫描当前类的包及其子包中所有标注了需要被管理的类。
@EnableAutoConfiguration
这个注解才是SpringBoot自动装配的关键,这也是一个组合注解
@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
标注的Class上可以使用@Import
引入其它的配置类,其实它还可以引入org.springframework.context.annotation.ImportSelector
实现类。ImportSelector
接口只定义了一个selectImports()
,用于指定需要注册为bean的Class名称。当在@Configuration
标注的Class上使用@Import
引入了一个ImportSelector
实现类后,会把实现类中返回的Class名称都定义为bean。
@EnableAutoConfiguration
中@Import
主要就是为了导入一个AutoConfigurationImportSelector
,下面我们分析一下这个类:
AutoConfigurationImportSelector类
AutoConfigurationImportSelect
类实现了ImportSelector
接口,所以我们清楚只需关注selectImports()
方法的返回结果即可:
@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容器中的对象的类型的全路径名称的字符串数组,所以我们要分析一下这个数组是从哪里来的?
进入到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类全路径
进入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中找不到自动配置类。如果您使用的是自定义打包,请确保该文件正确无误)
由此我们可以推测:自动配置的类名数组在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;
}
进入这个文件可以看到,这里配置了大量的需要自动装配的类,当我们启动Springboot项目的时候,SpringBoot会扫描所有jar包下面的META-INF/spring.factories
文件,并根据key进行读取,在经过一系列的操作来完成自动装配。
需要注意的是:上图中的 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 {
}
这个注解实际上是导入了AutoConfigurationPackages
的一个内部类Registrar
,这个类的作用就是读取到最外层@SpringBootApplication
注解中配置的扫描路径(没有配置默认当前所在包),将该路径下所有文件扫描,并分析注册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实现自动配置,这其实是一种SPI的思想。
SPI,Service Provider Interface。即:接口服务的提供者。就是说我们应该面向接口(抽象)编程,而不是面向具体的实现来编程,这样一旦我们需要切换到当前接口的其他实现就无需修改代码。
starter的命名规范:
官方的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) 新建自己的业务类
public class MyselfService {
private String myself;
// ……省略 getter setter
public String doBusiness(Object obj){
return myself+obj.toString();
}
}
3)业务需要的一些属性值
@ConfigurationProperties("myself")
public class MysefProperties {
private String myself;
// ……省略 getter setter
}
4)新建自动装配类,把自己的业务交给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
我们可以学习一下其他第三方的成熟的starter,会发现其实套路是很相似的
到此这篇关于SpringBoot详细分析自动装配原理并实现starter的文章就介绍到这了,更多相关SpringBoot自动装配原理内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网!