Spring Boot 原理解析—自动装配原理

自动装配是Spring Boot的核心部分,也是Spring Boot功能的基础,正是由于自动装配,才将我们从Bean的繁复配置中解脱出来。那么Spring Boot中的自动装配指的是什么?我们继续以Spring MVC为例,不使用Spring Boot时,我们可能需要配置视图解析器,文件解析器,请求适配器等等各种Bean,如果在使用数据库,redis,还需要配置数据库、redis相关Bean。我们以配置redis为例,如下为Spring中Bean的配置:

<bean id="jedisPoolConfig" class="redis.clients.jedis.JedisPoolConfig">
    <property name="maxIdle" value="100"/><!-- 最大闲置 -->
    <property name="minIdle" value="10"/><!-- 最小闲置 -->
    <property name="testOnBorrow" value="true"/><!-- 可以获取 -->
    <!--<property name="testOnReturn" value="true"/>-->
</bean>
<!-- redis 配置,也可以把配置挪到properties配置文件中,再读取 -->
<bean id="jedisPool" class="redis.clients.jedis.JedisPool">
    <constructor-arg index="0" ref="jedisPoolConfig" />
    <!-- 端口,默认6379 -->
    <constructor-arg index="2" value="6379"  name="port" type="int"/>
    <constructor-arg index="3" value="5000"  name="timeout" type="int"/>
    <constructor-arg index="1" value="127.0.0.1" name="host" type="java.lang.String"/>
	    <!-- 如果你需要配置密码,请打开这里。-->
    <constructor-arg index="4" value="你的密码" name="password" type="java.lang.String"/>
	    -->
</bean>

而如果使用Spring,我们只需要添加spring-boot-starter-data-redis jar包,然后再application或者application.yml中配置redis所需要的属性如下,Spring Boot会自动装配与Redis有关的Bean,不需要我们在手动配置Bean。

spring.redis.database=0 
spring.redis.host=127.0.0.1
spring.redis.port=6379
spring.redis.pool.max-active=200
spring.redis.pool.max-wait=-1
spring.redis.pool.max-idle=10 
spring.redis.pool.min-idle=0
spring.redis.timeout=1000

了解Spring Boot的自动装配之后,我们就可以查看Spring Boot的自动装配原理了,这里我们还要从启动类说起,启动类上的注解@SpringBootApplication是一个复合注解,在它上面还有一个@EnableAutoConfiguration注解,代码如下:

@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 {};
}

这里我们介绍一下@Enable*注解,通过简单的@Enable*来开启一项功能的支持,从而避免自己配置大量的代码,大大降低了使用难度。Spring提供了一系列的@Enable注解,比如@EnableWebMvc,@EnableScheduling,@EnableAsync我们进入拿到这些注解中,毫无意外都是发现注解上都有一个@Import注解。该注解是用来导入配置类的,这也意味着这些开启的实现是导入了一些自动配置的Bean。关于@Import注解的使用可以参考Spring IOC 注解 — @ImportResource,@Import。Spring Boot就是利用该原理进行自动装配的,接下来我们通过源码讲解Spring Boot的自动装配,代码如下所示:

//该方法为ImportSelector的实现,用于返回要注入的Class的名称
public String[] selectImports(AnnotationMetadata annotationMetadata) {
    //判断是否开启自动装配功能,
    //可以通过spring.boot.enableautoconfiguration配置开启或者关闭
    //具体方法在该方法下面
    if (!this.isEnabled(annotationMetadata)) {
	return NO_IMPORTS;
    } else {
        //开启自动注解后,通过AutoConfigurationMetadataLoader加载自动配置的元配置数据
	AutoConfigurationMetadata autoConfigurationMetadata = AutoConfigurationMetadataLoader.loadMetadata(this.beanClassLoader);
	//根据加载的元数据配置,将要注入的配置类封装成AutoConfigurationEntry实例。
	AutoConfigurationImportSelector.AutoConfigurationEntry autoConfigurationEntry = this.getAutoConfigurationEntry(autoConfigurationMetadata, annotationMetadata);
	//返回要注入的配置类的名称。
	return StringUtils.toStringArray(autoConfigurationEntry.getConfigurations());
    }
}

接下来我们分步解析,上面的代码,首先是自动装配功能的启用,我们通过isEnabled方法判断,取取环境变量spring.boot.enableautoconfiguration的值进行判断,方法如下所示:

protected boolean isEnabled(AnnotationMetadata metadata) {
    //该Class实例如果等于AutoConfigurationImportSelector的Class实例
    //取环境变量spring.boot.enableautoconfiguration的值,默认为true
    //否则取true
    return this.getClass() == AutoConfigurationImportSelector.class ?
 (Boolean)this.getEnvironment().getProperty("spring.boot.enableautoconfiguration", Boolean.class, true)
 :true;
}

如果开启了自动装配,然后就是加载配置类,以及Bean的装配,其主要逻辑都在getAutoConfigurationEntry逻辑中,其中loadMetadata方法用于从META-INF/spring-autoconfigure-metadata.properties加载配置元数据,spring-autoconfigure-metadata.properties的内容可以参考spring-boot-autoconfigure-2.1.3.RELEASE.jar中的META-INF目录,里面配置了很多类,这里不再展示。然后封装成Properties属性,代码如下所示:

//从META-INF/spring-autoconfigure-metadata.properties加载配置元数据
public static AutoConfigurationMetadata loadMetadata(ClassLoader classLoader) {
    return loadMetadata(classLoader, "META-INF/spring-autoconfigure-metadata.properties");
}
//加载配置元数据
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(newUrlResource((URL)urls.nextElement())));
       }
            return loadMetadata(properties);
       } catch (IOException var4) {
            throw new IllegalArgumentException("Unable to load @ConditionalOnClass location [" + path + "]", var4);
        }
    }
//最后将配置元数据封装为AutoConfigurationMetadata
static AutoConfigurationMetadata loadMetadata(Properties properties) {
    return new AutoConfigurationMetadataLoader.PropertiesAutoConfigurationMetadata(properties);
 }

接下来我们查看重要的逻辑,getAutoConfigurationEntry方法:

protected AutoConfigurationImportSelector.AutoConfigurationEntry getAutoConfigurationEntry(AutoConfigurationMetadata autoConfigurationMetadata, AnnotationMetadata annotationMetadata) {
    if (!this.isEnabled(annotationMetadata)) {
	return EMPTY_ENTRY;
    } else {
        //获取注解的属性
	AnnotationAttributes attributes = this.getAttributes(annotationMetadata);
	//加载候选配置类,为什么称为候选,因为要加载的配置类,并不一定全部注入到Spring 容器中
	//而是根据某种条件帅选出需要的类注入到Spring中。
	List<String> configurations = this.getCandidateConfigurations(annotationMetadata, attributes);
	//删除重复的配置类
	configurations = this.removeDuplicates(configurations);
	//获取要排除的条件
	Set<String> exclusions = this.getExclusions(annotationMetadata, attributes);
	//检测排除的类是否在配置文件中加载的类中,如果不在会抛出异常
	this.checkExcludedClasses(configurations, exclusions);
	//配置类排除不需要注入的类
	configurations.removeAll(exclusions);
	//过滤不需要注入的类
	configurations = this.filter(configurations, autoConfigurationMetadata);
	//触发自动注入事件
	this.fireAutoConfigurationImportEvents(configurations, exclusions);
	//返回要注入的配置类
	return new AutoConfigurationImportSelector.AutoConfigurationEntry(configurations, exclusions);
    }
}

上面的逻辑中,加载配置类,删除重复的逻辑类,检测要排除的类,排除要排除的类这些逻辑都比较简单,其中配置类的加载是从/META-INF/spring.factories中加载的。在上述逻辑之后 this.filter(configurations, autoConfigurationMetadata)方法比较难理解,该方法也是过滤不需要注入的类,该方法使用AutoConfigurationImportFilter接口中的方法进行过滤;AutoConfigurationImportFilter是一个功能型接口,它的实现类是OnClassCondition。OnClassCondition继承FilteringSpringBootCondition,FilteringSpringBootCondition实现。

private List<String> filter(List<String> configurations, AutoConfigurationMetadata autoConfigurationMetadata) {
    long startTime = System.nanoTime();
    String[] candidates = StringUtils.toStringArray(configurations);
    boolean[] skip = new boolean[candidates.length];
    boolean skipped = false;
    //获取所有的AutoConfigurationImportFilter的实现类
    //AutoConfigurationImportFilter是一个功能型接口,它的实现类是OnClassCondition
    //OnClassCondition继承FilteringSpringBootCondition,FilteringSpringBootCondition实现AutoConfigurationImportFilter
    Iterator var8 = this.getAutoConfigurationImportFilters().iterator();
    while(var8.hasNext()) {
        AutoConfigurationImportFilter filter = (AutoConfigurationImportFilter)var8.next();
        this.invokeAwareMethods(filter);
        boolean[] match = filter.match(candidates, autoConfigurationMetadata);
        for(int i = 0; i < match.length; ++i) {
            if (!match[i]) {
                skip[i] = true;
                candidates[i] = null;
                skipped = true;
            }
        }
    }
		.....
}

然后我们只需要查看OnClassCondition 类的使用,我们可以任意选一个/META-INF/spring.factories中的配置类,比如DataSourceAutoConfiguration:

@Configuration
@ConditionalOnClass({DataSource.class, EmbeddedDatabaseType.class})
@EnableConfigurationProperties({DataSourceProperties.class})
@Import({DataSourcePoolMetadataProvidersConfiguration.class, DataSourceInitializationConfiguration.class})
public class DataSourceAutoConfiguration {
    ......
}

在DataSourceAutoConfiguration类上我们看到了@ConditionalOnClass注解,继续查看源码:

Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional({OnClassCondition.class})
public @interface ConditionalOnClass {
    Class<?>[] value() default {};
    String[] name() default {};
}

查看上面的源码,我们可以发现@ConditionalOnClass注解上传入了OnClassCondition ,我们可以查看OnClassCondition 类的层次结构图:

从上面的类图中,我们看到OnClassCondition最终实现了Condition接口,该接口可以根据某些条件向Spring容器中注入Bean。我们熟悉的@Profile注解也是由@Conditional注解实现的。OnClassCondition则是如果存在某个类,则向Spring中注入Bean,否则不注入该Bean。除了@ConditionalOnClass注解之外还有一下类似的注解:

@ConditionalOnClass : classpath中存在该类时起效 
@ConditionalOnMissingClass : classpath中不存在该类时起效 
@ConditionalOnBean : DI容器中存在该类型Bean时起效 
@ConditionalOnMissingBean : DI容器中不存在该类型Bean时起效 
@ConditionalOnSingleCandidate : DI容器中该类型Bean只有一个或@Primary的只有一个时起效 
@ConditionalOnExpression : SpEL表达式结果为true时 
@ConditionalOnProperty : 参数设置或者值一致时起效 
@ConditionalOnResource : 指定的文件存在时起效 
@ConditionalOnJndi : 指定的JNDI存在时起效 
@ConditionalOnJava : 指定的Java版本存在时起效 
@ConditionalOnWebApplication : Web应用环境下起效 
@ConditionalOnNotWebApplication : 非Web应用环境下起效

总结:Spring Boot之所以能够自动装配,是从配置文件中加载所有自动装配的类,然后根据规则排除不需要装配的类,最后将需要装配的类名称数组返回,注入到Spring中。看完本篇需要记住以下几点,我们也可以写出自己的starter和自动装配。

1.配置类的加载:/META-INF/spring.factories和META-INF/spring-autoconfigure-metadata.properties

2.@Import注解,可以根据某些规则向Spring 容器中注入一组相关联的类

3.@Conditional 可以根据条件判定该类是否向Spring中注入。

4.@ConditionalOn*注解,是否向Spring 中注入的条件

 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值