SpringBoot自动装配原理

迷南。 2023-01-18 09:29 356阅读 0赞

一、从@SpringBootApplication启动注解入手

1.1SpringBootApplication注解源码

  1. @Target(ElementType.TYPE)
  2. @Retention(RetentionPolicy.RUNTIME)
  3. @Documented
  4. @Inherited
  5. @SpringBootConfiguration
  6. @EnableAutoConfiguration
  7. @ComponentScan(excludeFilters = {
  8. @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
  9. @Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) })
  10. public @interface SpringBootApplication {
  11. @AliasFor(annotation = EnableAutoConfiguration.class)
  12. Class<?>[] exclude() default { };
  13. @AliasFor(annotation = EnableAutoConfiguration.class)
  14. String[] excludeName() default { };
  15. //根据包路径扫描
  16. @AliasFor(annotation = ComponentScan.class, attribute = "basePackages")
  17. String[] scanBasePackages() default { };
  18. //直接根据class类扫描
  19. @AliasFor(annotation = ComponentScan.class, attribute = "basePackageClasses")
  20. Class<?>[] scanBasePackageClasses() default { };
  21. }

1.2重要的注解只有三个Annotation:
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan

(1)@Configuration注解
这个注解实际上就是代表了一个配置类,相当于一个beans.xml文件。
@SpringBootConfiguration其实代表当前类是一个配置类。
(2)@ComponentScan
@ComponentScan的功能其实就是自动扫描并加载符合条件的组件或bean定义,最终将这些bean定义加载到容器中。
(3)@EnableAutoConfiguration
在Spring中有关于@Enablexxx的注解是开启某一项功能的注解,比如@EnableScheduling表示开启Spring的定时任务。其原理是借助@Import的帮助,将所有符合自动配置条件的bean定义加载到IOC容器。

1.3EnableAutoConfiguration代表开启springboot的自动装配

  1. @Target(ElementType.TYPE)
  2. @Retention(RetentionPolicy.RUNTIME)
  3. @Documented
  4. @Inherited
  5. @AutoConfigurationPackage
  6. @Import(AutoConfigurationImportSelector.class)
  7. public @interface EnableAutoConfiguration {
  8. String ENABLED_OVERRIDE_PROPERTY = "spring.boot.enableautoconfiguration";
  9. //按类型排除不需要自动装配的类
  10. Class<?>[] exclude() default { };
  11. //按名称排除不需要自动装配的类
  12. String[] excludeName() default { };
  13. }

从源码中可以知道,最关键的要属@Import(EnableAutoConfigurationImportSelector.class),借助EnableAutoConfigurationImportSelector

@EnableAutoConfiguration可以帮助SpringBoot应用将所有符合条件的@Configuration配置都加载到当前SpringBoot创建并使用的IoC容器。

同时借助于Spring框架原有的一个工具类:SpringFactoriesLoader,@EnableAutoConfiguration就可以实现智能的自动配置。

  1. //从这里可以看出该类实现很多的xxxAware和DeferredImportSelector,所有的aware都优先于selectImports
  2. //方法执行,也就是说selectImports方法最后执行,那么在它执行的时候所有需要的资源都已经获取到了
  3. public class AutoConfigurationImportSelector implements DeferredImportSelector, BeanClassLoaderAware, ResourceLoaderAware, BeanFactoryAware, EnvironmentAware, Ordered {
  4. ...
  5. public String[] selectImports(AnnotationMetadata annotationMetadata) {
  6. if (!this.isEnabled(annotationMetadata)) {
  7. return NO_IMPORTS;
  8. } else {
  9. //1加载META-INF/spring-autoconfigure-metadata.properties文件
  10. AutoConfigurationMetadata autoConfigurationMetadata = AutoConfigurationMetadataLoader.loadMetadata(this.beanClassLoader);
  11. //2获取注解的属性及其值(PS:注解指的是@EnableAutoConfiguration注解)
  12. AnnotationAttributes attributes = this.getAttributes(annotationMetadata);
  13. //3.在classpath下所有的META-INF/spring.factories文件中查找org.springframework.boot.autoconfigure.EnableAutoConfiguration的值,并将其封装到一个List中返回
  14. List<String> configurations = this.getCandidateConfigurations(annotationMetadata, attributes);
  15. //4.对上一步返回的List中的元素去重、排序
  16. configurations = this.removeDuplicates(configurations);
  17. //5.依据第2步中获取的属性值排除一些特定的类
  18. Set<String> exclusions = this.getExclusions(annotationMetadata, attributes);
  19. //6对上一步中所得到的List进行过滤,过滤的依据是条件匹配。这里用到的过滤器是
  20. //org.springframework.boot.autoconfigure.condition.OnClassCondition最终返回的是一个ConditionOutcome[]
  21. //数组。(PS:很多类都是依赖于其它的类的,当有某个类时才会装配,所以这次过滤的就是根据是否有某个
  22. //class进而决定是否装配的。这些类所依赖的类都写在META-INF/spring-autoconfigure-metadata.properties文件里)
  23. this.checkExcludedClasses(configurations, exclusions);
  24. configurations.removeAll(exclusions);
  25. configurations = this.filter(configurations, autoConfigurationMetadata);
  26. this.fireAutoConfigurationImportEvents(configurations, exclusions);
  27. return StringUtils.toStringArray(configurations);
  28. }
  29. }
  30. protected List<String> getCandidateConfigurations(AnnotationMetadata metadata, AnnotationAttributes attributes) {
  31. List<String> configurations = SpringFactoriesLoader.loadFactoryNames(this.getSpringFactoriesLoaderFactoryClass(), this.getBeanClassLoader());
  32. 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.");
  33. return configurations;
  34. }
  35. ...
  36. }

1.4SpringFactoriesLoader中加载配置
SpringFactoriesLoader属于Spring框架私有的一种扩展方案,其主要功能就是从指定的配置文件META-INF/spring.factories加载配置。

即根据@EnableAutoConfiguration的完整类名org.springframework.boot.autoconfigure.EnableAutoConfiguration作为查找的Key,获取对应的一组@Configuration类

  1. public abstract class SpringFactoriesLoader {
  2. public static final String FACTORIES_RESOURCE_LOCATION = "META-INF/spring.factories";
  3. private static Map<String, List<String>> loadSpringFactories(@Nullable ClassLoader classLoader) {
  4. MultiValueMap<String, String> result = cache.get(classLoader);
  5. if (result != null)
  6. return result;
  7. try {
  8. Enumeration<URL> urls = (classLoader != null ?
  9. classLoader.getResources(FACTORIES_RESOURCE_LOCATION) :
  10. ClassLoader.getSystemResources(FACTORIES_RESOURCE_LOCATION));
  11. result = new LinkedMultiValueMap<>();
  12. while (urls.hasMoreElements()) {
  13. URL url = urls.nextElement();
  14. UrlResource resource = new UrlResource(url);
  15. Properties properties = PropertiesLoaderUtils.loadProperties(resource);
  16. for (Map.Entry<?, ?> entry : properties.entrySet()) {
  17. List<String> factoryClassNames = Arrays.asList(
  18. StringUtils.commaDelimitedListToStringArray((String) entry.getValue()));
  19. result.addAll((String) entry.getKey(), factoryClassNames);
  20. }
  21. }
  22. cache.put(classLoader, result);
  23. return result;
  24. }
  25. catch (IOException ex) {
  26. throw new IllegalArgumentException("Unable to load factories from location [" +
  27. FACTORIES_RESOURCE_LOCATION + "]", ex);
  28. }
  29. }
  30. ...

1.5总结

@EnableAutoConfiguration作用就是从classpath中搜寻所有的META-INF/spring.factories配置文件,并将其中org.springframework.boot.autoconfigure.EnableutoConfiguration对应的配置项通过反射(Java Refletion)实例化为对应的标注了@Configuration的JavaConfig形式的IoC容器配置类,然后汇总为一个并加载到IoC容器。

这些功能配置类要生效的话,会去classpath中找是否有该类的依赖类(也就是pom.xml必须有对应功能的jar包才行)并且配置类里面注入了默认属性值类,功能类可以引用并赋默认值。

生成功能类的原则是自定义优先,没有自定义时才会使用自动装配类。

所以功能类能生效需要的条件:(1)spring.factories里面有这个类的配置类(一个配置类可以创建多个围绕该功能的依赖类)(2)pom.xml里面需要有对应的jar包(即spring-boot-starter-xxx命名的配置)

二、自动依赖过程总结

2.1通过各种注解实现了类与类之间的依赖关系,容器在启动的时候Application.run,会调用EnableAutoConfigurationImportSelector.class的selectImports方法(其实是其父类的方法)–这里需要注意,调用这个方法之前发生了什么和是在哪里调用这个方法需要进一步的探讨

2.2selectImports方法最终会调用SpringFactoriesLoader.loadFactoryNames方法来获取一个全面的常用BeanConfiguration列表

2.3loadFactoryNames方法会读取FACTORIES_RESOURCE_LOCATION(也就是spring-boot-autoconfigure.jar 下面的spring.factories),获取到所有的Spring相关的Bean的全限定名ClassName,大概120多个

2.4selectImports方法继续调用filter(configurations, autoConfigurationMetadata);这个时候会根据这些BeanConfiguration里面的条件,来一一筛选,最关键的是
@ConditionalOnClass这个条件注解,会去classpath下查找,jar包里面是否有这个条件依赖类,所以必须有了相应的jar包,才有这些依赖类,才会生成IOC环境需要的一些默认配置Bean

2.5最后把符合条件的BeanConfiguration注入默认的EnableConfigurationPropertie类里面的属性值,并且注入到IOC环境当中

三、自动装配案例说明以Redis为例

3.1从spring-boot-autoconfigure.jar/META-INF/spring.factories中获取redis的相关配置类全限定名(有120多个的配置类)RedisAutoConfiguration,一般一个功能配置类围绕该功能,负责管理创建多个相关的功能类,比如RedisAutoConfiguration负责:JedisConnectionFactory、RedisTemplate、StringRedisTemplate这3个功能类的创建
spring.factories中的redis配置类
3.2RedisAutoConfiguration配置类生效的一个条件是在classpath路径下有RedisOperations类存在,因此springboot的自动装配机制会会去classpath下去查找对应的class文件。

  1. @Configuration
  2. @ConditionalOnClass(RedisOperations.class)
  3. @EnableConfigurationProperties(RedisProperties.class)
  4. @Import({ LettuceConnectionConfiguration.class, JedisConnectionConfiguration.class })
  5. public class RedisAutoConfiguration {
  6. ...}

3.3如果pom.xml有对应的jar包,就能匹配到对应依赖class

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-data-redis</artifactId>
  4. </dependency>

3.4匹配成功,这个功能配置类才会生效,同时会注入默认的属性配置类@EnableConfigurationProperties(RedisProperties.class)

  1. @ConfigurationProperties(prefix = "spring.redis")
  2. public class RedisProperties {
  3. private int database = 0;
  4. private String url;
  5. private String host = "localhost";
  6. private String password;
  7. private int port = 6379;
  8. ...

3.5Redis功能配置里面会根据条件生成最终的JedisConnectionFactory、RedisTemplate,并提供了默认的配置形式@ConditionalOnMissingBean(name = “redisTemplate”)

  1. @Configuration
  2. @ConditionalOnClass(RedisOperations.class)
  3. @EnableConfigurationProperties(RedisProperties.class)
  4. @Import({ LettuceConnectionConfiguration.class, JedisConnectionConfiguration.class })
  5. public class RedisAutoConfiguration {
  6. @Bean
  7. //用户没定义就使用默认的
  8. @ConditionalOnMissingBean(name = "redisTemplate")
  9. public RedisTemplate<Object, Object> redisTemplate(
  10. RedisConnectionFactory redisConnectionFactory) throws UnknownHostException {
  11. RedisTemplate<Object, Object> template = new RedisTemplate<>();
  12. template.setConnectionFactory(redisConnectionFactory);
  13. return template;
  14. }
  15. @Bean
  16. @ConditionalOnMissingBean(StringRedisTemplate.class)
  17. public StringRedisTemplate stringRedisTemplate(
  18. RedisConnectionFactory redisConnectionFactory) throws UnknownHostException {
  19. StringRedisTemplate template = new StringRedisTemplate();
  20. template.setConnectionFactory(redisConnectionFactory);
  21. return template;
  22. }
  23. }

3.6最终创建好的默认装配类,会通过功能配置类里面的 @Bean注解,注入到IOC当中

3.7用户使用,当用户在配置文件中自定义时候就会覆盖默认的配置@ConditionalOnMissingBean(name = “redisTemplate”)

原文出处
https://www.jianshu.com/p/88eafeb3f351

发表评论

表情:
评论列表 (有 0 条评论,356人围观)

还没有评论,来说两句吧...

相关阅读