Spring-boot @EnableAutoConfigura

作者: 八目朱勇铭 | 来源:发表于2017-09-21 23:43 被阅读754次

    阅读本文前,请先阅读作者的另一篇文章Spring-Boot之@Enable*注解的工作原理

    @EnableAutoConfiguration作用:从classpath中搜索所有的META-INF/spring.factories配置文件,然后将其中key为org.springframework.boot.autoconfigure.EnableAutoConfiguration的value加载到spring容器中

    首先我们来做一个小实验:
    1、创建一个spring项目jianshu-starter

    <?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        <groupId>com.bamu.jianshu</groupId>
        <artifactId>jianshu-starter</artifactId>
        <version>1.0-SNAPSHOT</version>
    
        <name>jianshu-starter</name>
        <description>The first Spring Boot project</description>
    
        <properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <maven.compiler.source>1.8</maven.compiler.source>
            <maven.compiler.target>1.8</maven.compiler.target>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>org.springframework</groupId>
                <artifactId>spring-context</artifactId>
                <version>4.3.11.RELEASE</version>
            </dependency>
        </dependencies>
    
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <configuration>
                        <source>1.8</source>
                        <target>1.8</target>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    </project>
    

    2、编写configuration类,注入到spring容器中

    @Configuration
    public class RunnableConfiguration {
        @Bean
        public Runnable runnable() {
            return () -> {};
        }
    }
    

    3、创建一个spring-boot项目blog,引入刚刚创建的外部项目jianshu-starter

    //...
    <dependency>
          <groupId>com.bamu.jianshu</groupId>
          <artifactId>jianshu-starter</artifactId>
          <version>1.0-SNAPSHOT</version>
    </dependency>
    //...
    

    4、在blog项目中编写启动类BlogApplication

    @SpringBootApplication
    public class BlogApplication {
        public static void main(String[] args) {
            ConfigurableApplicationContext context = SpringApplication.run(BlogApplication.class, args);
            //获取jianshu-starter项目中定义的bean runnable
            System.out.println(context.getBean("runnable").getClass().getName());
            context.close();
        }
    }
    

    5、启动

    console result
    咦?@SpringBootApplication注解中不是为我们配置了@EnableAutoConfiguration了吗?为什么这里获取不到外部项目注入到spring容器中的bean呢?

    为了解答这个疑惑,我们查阅@EnableAutoConfiguration注解中import进去的Selector的源码,追溯到AutoConfigurationImportSelector这个类后,我们发现了getCandidateConfigurations(AnnotationMetadata metadata, AnnotationAttributes attributes)这个方法。

    getCandidateConfigurations方法
    红框中的英文翻译后意思为:在META-INF / spring.factories中找不到自动配置类。 如果您使用自定义打包,请确保文件正确无误。

    继续带着疑惑,我们试着点进loadFactoryNames这个方法中去一探究竟:

    loadFactoryNames方法
    噢,原来,这个方法通过是ClassLoader,去我们的classpath目录下的META-INF/spring.factoried文件中去查找以EnableAutoConfiguration这个类的全类名为key的值,然后把它们add到一个集合当中return出去。看完这个方法的源码后,我们回到上一个截图getCandidateConfigurations方法的源码,发现他在做了一个非空校验后,接着往上层返回。那我们找到调用getCandidateConfigurations方法的代码看看。 selectImports方法
    我们追溯到了selectImports这个方法。阅读过Spring-Boot之@Enable*注解的工作原理这篇文章的读者肯定一下就看明白了,噢,原来这个方法获取到了List<String> configurations这个集合后,通过removeDuplicates方法做了去重、通过sort方法做了排序、通过getExclusions这个方法做了排除(那我们排除的依据从哪来呢?大家可以打开@EnableAutoConfiguration注解的源码一看便知,该注解给我们提供了两种方式排除我们不想注入到spring容器中的bean)......最后将configurations这个集合转为String[]返回,通过推荐的文章我们知道,selectImports()方法返回出去的数组是会被spring容器托管的,这下我们全知道了:
    在springboot项目中,其他包下自动装配的bean,是需要在classpath下的META-INF/spring.factories文件中配置,才能被spring容器注入

    so,我们按照springboot的要求,创建一个spring.factories并配置我们需要获取的bean runnable

    spring.factories
    META-INF/spring.factories
    提醒一下:loadFactoryNamesselectImports方法的源码我们发现,key必须是EnableAutoConfiguration注解的全类名,value必须是你想自动装配的bean的全类名
    再执行BlogApplication类试一试: console result

    完美地获取到了runnable这个对象

    另外,拓展一下springboot为我们提供的starter包如何实现开箱即用。事实上,我们看到的springboot提供的starter包,都引用了很多我们比较熟悉的jar包,它也是通过我在上文中介绍的方式,将它想要注入的bean,配置到spring.factories文件中。例如:

    spring-boot-autoconfiguration

    我们打开spring.factories文件看一看

    spring.properties文件冰山一角

    看看,spring-boot-autoconfiguration这个项目注入了这么多其他项目的bean。

    以上,就是Spring-boot @EnableAutoConfiguration源码分析的全部内容,望读者带着批判的心态阅读我的文章,发现错误,麻烦直接评论,共同学习,共同进步。
    也可以观看spring-boot系列的其他文章,都是干货哟~

    相关文章

      网友评论

      本文标题:Spring-boot @EnableAutoConfigura

      本文链接:https://www.haomeiwen.com/subject/sfitextx.html