温馨提示×

温馨提示×

您好,登录后才能下订单哦!

密码登录×
登录注册×
其他方式登录
点击 登录注册 即表示同意《亿速云用户服务条款》

Spring中Bean扫描原理是什么

发布时间:2022-09-20 15:46:33 来源:亿速云 阅读:113 作者:iii 栏目:开发技术

本篇内容主要讲解“Spring中Bean扫描原理是什么”,感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷,实用性强。下面就让小编来带大家学习“Spring中Bean扫描原理是什么”吧!

    环境建设

    由于创建包扫描的条件很简单,只要在Xml中配置一个属性即可。

    Spring中Bean扫描原理是什么

    正式开始

    在我前面的文章的阅读基础,我们直接这里节省时间,直接定位到ComponentScanBaeanDefinitionParser类中的parse方法。

    @Override
    @Nullable
    public BeanDefinition parse(Element element, ParserContext parserContext) {
       String basePackage = element.getAttribute(BASE_PACKAGE_ATTRIBUTE);
       basePackage = parserContext.getReaderContext().getEnvironment().resolvePlaceholders(basePackage);
       String[] basePackages = StringUtils.tokenizeToStringArray(basePackage,
             ConfigurableApplicationContext.CONFIG_LOCATION_DELIMITERS);
       // Actually scan for bean definitions and register them.
       // 实际上,扫描bean定义并注册它们。
       ClassPathBeanDefinitionScanner scanner = configureScanner(parserContext, element);
       Set<BeanDefinitionHolder> beanDefinitions = scanner.doScan(basePackages);
       registerComponents(parserContext.getReaderContext(), beanDefinitions, element);
    
       return null;
    }

    这个代码的前半部分比较简单,就是可能当前传进来的basePackage可能是多个,所以这里使用方法去处理这个字符串。比较重要的代码在下半部分。

    也就是三个方法:

    • configureScanner:配置一个扫描器

    • doScan:使用扫描器去扫描

    • registerComponents:注册扫描到的BeanDefintion

    configureScanner

    第一段代码

    boolean useDefaultFilters = true;
    if (element.hasAttribute(USE_DEFAULT_FILTERS_ATTRIBUTE)) {
       useDefaultFilters = Boolean.parseBoolean(element.getAttribute(USE_DEFAULT_FILTERS_ATTRIBUTE));
    }

    这一段声明了个变量,默认为True,在下方的If中去会去修改这个值。由于我们在applicatio.xml中没有设置这个属性,这里还是默认值。

    第二段代码

    // Delegate bean definition registration to scanner class.
    // 将 bean 定义注册委托给扫描程序类。
    ClassPathBeanDefinitionScanner scanner = createScanner(parserContext.getReaderContext(), useDefaultFilters);
    scanner.setBeanDefinitionDefaults(parserContext.getDelegate().getBeanDefinitionDefaults());
    scanner.setAutowireCandidatePatterns(parserContext.getDelegate().getAutowireCandidatePatterns());

    createScanner方法中,就是new了一个ClassPathBeanDefinitionScanner对象给返回回来了。 随后又为该扫描器加入了两个属性。

    第三段代码

    if (element.hasAttribute(RESOURCE_PATTERN_ATTRIBUTE)) {
       scanner.setResourcePattern(element.getAttribute(RESOURCE_PATTERN_ATTRIBUTE));
    }

    这里判断有无配置ResourcePattern属性,有的话设置。

    第四段代码

    try {
       parseBeanNameGenerator(element, scanner);
    }
    catch (Exception ex) {
        // ...
    }
    
    try {
       parseScope(element, scanner);
    }
    catch (Exception ex) {
        // ...
    }

    这两个方法代码跟进去有个共性。都是判断有没有配置一个属性,然后给sanner设置属性,具体看下方代码截图。

    Spring中Bean扫描原理是什么

    Spring中Bean扫描原理是什么

    这里这两个方法是干嘛的,我心里想了想,不知道,也不知道在什么地方会用到,所以这里接着往下看。

    parseTypeFilters

    protected void parseTypeFilters(Element element, ClassPathBeanDefinitionScanner scanner, ParserContext parserContext) {
       // Parse exclude and include filter elements.
       ClassLoader classLoader = scanner.getResourceLoader().getClassLoader();
       NodeList nodeList = element.getChildNodes();
       for (int i = 0; i &lt; nodeList.getLength(); i++) {
          Node node = nodeList.item(i);
          if (node.getNodeType() == Node.ELEMENT_NODE) {
             String localName = parserContext.getDelegate().getLocalName(node);
             try {
                if (INCLUDE_FILTER_ELEMENT.equals(localName)) {
                   TypeFilter typeFilter = createTypeFilter((Element) node, classLoader, parserContext);
                   scanner.addIncludeFilter(typeFilter);
                }
                else if (EXCLUDE_FILTER_ELEMENT.equals(localName)) {
                   TypeFilter typeFilter = createTypeFilter((Element) node, classLoader, parserContext);
                   scanner.addExcludeFilter(typeFilter);
                }
             }
             catch (ClassNotFoundException ex) {
                // ...
             }
             catch (Exception ex) {
                // ...
             }
          }
       }
    }

    首先看这个方法名parseTypeFilters,转换类型类型过滤器。

    Spring中Bean扫描原理是什么

    通过查看Spring的DTD文件,看到component-scan标签下还有两个子标签,想必就是对应上方的代码中解释了。

    随后该方法运行完后,就把创建好的scanner对象,给返回回去了。

    doScan

    protected Set&lt;BeanDefinitionHolder&gt; doScan(String... basePackages) {
       Assert.notEmpty(basePackages, "At least one base package must be specified");
       Set&lt;BeanDefinitionHolder&gt; beanDefinitions = new LinkedHashSet&lt;&gt;();
       for (String basePackage : basePackages) {
          Set&lt;BeanDefinition&gt; candidates = findCandidateComponents(basePackage);
          for (BeanDefinition candidate : candidates) {
             ScopeMetadata scopeMetadata = this.scopeMetadataResolver.resolveScopeMetadata(candidate);
             candidate.setScope(scopeMetadata.getScopeName());
             String beanName = this.beanNameGenerator.generateBeanName(candidate, this.registry);
             if (candidate instanceof AbstractBeanDefinition) {
                postProcessBeanDefinition((AbstractBeanDefinition) candidate, beanName);
             }
             if (candidate instanceof AnnotatedBeanDefinition) {
                AnnotationConfigUtils.processCommonDefinitionAnnotations((AnnotatedBeanDefinition) candidate);
             }
             if (checkCandidate(beanName, candidate)) {
                BeanDefinitionHolder definitionHolder = new BeanDefinitionHolder(candidate, beanName);
                definitionHolder =
                      AnnotationConfigUtils.applyScopedProxyMode(scopeMetadata, definitionHolder, this.registry);
                beanDefinitions.add(definitionHolder);
                registerBeanDefinition(definitionHolder, this.registry);
             }
          }
       }
       return beanDefinitions;
    }

    在第一行代码中,创建了个BeanDefinitions的Set,大概是用来存放结果的。

    随后根据basePacage,查找到了所有的候选BeanDefinition,至于获取的方法我在下方有讲到。

    随后遍历了刚刚获取到的BeanDefinition。

    findCandidateComponents

    private Set&lt;BeanDefinition&gt; scanCandidateComponents(String basePackage) {
       Set&lt;BeanDefinition&gt; candidates = new LinkedHashSet&lt;&gt;();
       try {
          String packageSearchPath = ResourcePatternResolver.CLASSPATH_ALL_URL_PREFIX +
                resolveBasePackage(basePackage) + '/' + this.resourcePattern;
          Resource[] resources = getResourcePatternResolver().getResources(packageSearchPath);
          // ... 
          for (Resource resource : resources) {
             // ... 暂时不看
          }
       }
       catch (IOException ex) {
          // ... throw
       }
       return candidates;
    }

    上面一段代码,方法一进入,创建了一个set集合,这个set机会也就是方法最后的返回值,后续的代码中会向这个set去追加属性。

    随后到了packageSearchPath,这里是通过拼接字符串的方式最终得到这个变量,拼接规则如下:

    classpath*: + 转换后的xml路径 + **/*.class classpath*:org/springframework/study/**/*.class

    随后根据resourceLoader,可以加载上方路径下的所有class文件。

    Spring中Bean扫描原理是什么

    随后进入For遍历环节。

    For遍历每一个资源

    当前的resource资源也就是读取到的class文件。

    for (Resource resource: resources) {
        try {
            MetadataReader metadataReader = getMetadataReaderFactory().getMetadataReader(resource);
            if (isCandidateComponent(metadataReader)) {
               ScannedGenericBeanDefinition sbd = new ScannedGenericBeanDefinition(metadataReader);
               sbd.setSource(resource);
               if (isCandidateComponent(sbd)) {
                  // ... 打印日志
                  candidates.add(sbd);
               }
               else {
                  // ... 打印日志
               }
            }
            else {
               // ... 打印日志
            }
        }
        catch (FileNotFoundException ex) {
        // ... 打印日志
        }
        catch (Throwable ex) {
        // ... throw
        }
    }

    进入For后,首先获取metadataReader。这里代码简单追一下。

    Spring中Bean扫描原理是什么

    Spring中Bean扫描原理是什么

    主要做的是两件事,一个new了一个SimpleMetaDataReader。然后把这个MetaDataReader放入了缓存中。随后返回了这个Reader对象。

    然后就进入了第一个比较关键的方法代码,isCandidateComponent方法,仔细一看,这个方法怎么被调用了两次,因为这个if进入后还会调用isCandidateComponent方法,然后我看了看入参,不一致,一个入参事Reader,一个入参事BeanDefinition。我们第一个if中点用的Reader的isCandidateComponent方法。

    isCandidateComponent(MetadataReader metadataReader)

    protected boolean
    isCandidateComponent(MetadataReader metadataReader) throws IOException {
       for (TypeFilter tf : this.excludeFilters) {
          if (tf.match(metadataReader, getMetadataReaderFactory())) {
             return false;
          }
       }
       for (TypeFilter tf : this.includeFilters) {
          if (tf.match(metadataReader, getMetadataReaderFactory())) {
             return isConditionMatch(metadataReader);
          }
       }
       return false;
    }

    上方的excludeFilters排除的我们不用看,主要是看下方的include

    Spring中Bean扫描原理是什么

    后续的代码我就不读了,大概实现我猜测是通过Reader去读到类上的注解,看看有没有当前filter中设置的注解。有的话返回true。

    继续后面的逻辑

    ScannedGenericBeanDefinition sbd = new ScannedGenericBeanDefinition(metadataReader);
    sbd.setSource(resource);
    if (isCandidateComponent(sbd)) {
       if (debugEnabled) {
          logger.debug("Identified candidate component class: " + resource);
       }
       candidates.add(sbd);
    }

    刚刚外层的If为True后,这里会创建一个ScannedGenericBeanDefinition,既然是BeanDefinition,那就可以被Spring加载。

    后面把创建的BeanDefinition放入了isCandidateComponent方法。

    isCandidateComponent(AnnotatedBeanDefintion)

    protected boolean isCandidateComponent(AnnotatedBeanDefinition beanDefinition) {
       AnnotationMetadata metadata = beanDefinition.getMetadata();
       return (metadata.isIndependent() &amp;&amp; (metadata.isConcrete() ||
             (metadata.isAbstract() &amp;&amp; metadata.hasAnnotatedMethods(Lookup.class.getName()))));
    }
    
    @Override
    public boolean isIndependent() {
       // enclosingClassName 为 null
       return (this.enclosingClassName == null || this.independentInnerClass);
    }
    
    default boolean isConcrete() {
       return !(isInterface() || isAbstract());
    }

    到这个方法基本第一个判断就返回了。isIndependent方法中一开始看到其中的两个单词我有点懵,enclosingClass和innerClass,可能是我英文不好的缘故或者基础差吧,百度搜了才知道的。我这里就不讲了,有兴趣你们可以自己搜索一下。自己搜索的记忆更深刻。只要是普通的Component的时候,这里为True。

    至于下民的isConcrete方法,就是判断一下当前类是不是接口,或者抽象类。很明显如果是正常的Component,这里是false,随后取反为True。

    继续后面的逻辑

    if (isCandidateComponent(sbd)) {
       if (debugEnabled) {
          logger.debug("Identified candidate component class: " + resource);
       }
       candidates.add(sbd);
    }

    当把BeanDefinition传入后返回为True,进入If,也就是添加当前的BeanDefinition进入结果集,返回结果集。

    doScan 继续后面的逻辑

    Set&lt;BeanDefinition&gt; candidates = findCandidateComponents(basePackage);
    for (BeanDefinition candidate : candidates) {
       ScopeMetadata scopeMetadata = this.scopeMetadataResolver.resolveScopeMetadata(candidate);
       candidate.setScope(scopeMetadata.getScopeName());
       String beanName = this.beanNameGenerator.generateBeanName(candidate, this.registry);
       if (candidate instanceof AbstractBeanDefinition) {
          postProcessBeanDefinition((AbstractBeanDefinition) candidate, beanName);
       }
       if (candidate instanceof AnnotatedBeanDefinition) {
          AnnotationConfigUtils.processCommonDefinitionAnnotations((AnnotatedBeanDefinition) candidate);
       }
       if (checkCandidate(beanName, candidate)) {
          BeanDefinitionHolder definitionHolder = new BeanDefinitionHolder(candidate, beanName);
          definitionHolder =
                AnnotationConfigUtils.applyScopedProxyMode(scopeMetadata, definitionHolder, this.registry);
          beanDefinitions.add(definitionHolder);
          registerBeanDefinition(definitionHolder, this.registry);
       }
    }

    把刚刚获取到BeanDefinition拿出来遍历.

    第一步获取MetaData,这个在刚刚的代码中有写到。随后把他的ScopeName赋值给了MetaData。

    接下来有两个if是对这个BeanDefinition设置一些参数的。可以简单扫一眼。捕捉一些关键信息即可。

    Spring中Bean扫描原理是什么

    这个里面设置一个属性,这里记录一下,后面有用到再看。

    Spring中Bean扫描原理是什么

    这个里面是针对类里添加的一些别的注解,来给BeanDefinition添加一些配置。看到几个比较眼熟的,Lazy,Primary,Description这些注解比较眼熟。

    doScan 最后一个IF

    if (checkCandidate(beanName, candidate)) {
       BeanDefinitionHolder definitionHolder = new BeanDefinitionHolder(candidate, beanName);
       definitionHolder =
             AnnotationConfigUtils.applyScopedProxyMode(scopeMetadata, definitionHolder, this.registry);
       beanDefinitions.add(definitionHolder);
       registerBeanDefinition(definitionHolder, this.registry);
    }

    粗略的扫一眼,这里可以看几个重要的地方,一个是进入If的条件,注册BeanDefinition。
    至于applyScopedProxyMode方法,因为我没的类上没有加Scope注解,所以这里都是不会配置代理。也就是直接返回当前传入的BeanDefinition。

    Spring中Bean扫描原理是什么

    checkCandidate方法

    protected boolean checkCandidate(String beanName, BeanDefinition beanDefinition) throws IllegalStateException {
       if (!this.registry.containsBeanDefinition(beanName)) {
          return true;
       }
       BeanDefinition existingDef = this.registry.getBeanDefinition(beanName);
       BeanDefinition originatingDef = existingDef.getOriginatingBeanDefinition();
       if (originatingDef != null) {
          existingDef = originatingDef;
       }
       if (isCompatible(beanDefinition, existingDef)) {
          return false;
       }
       // ... throw Exception.
    }

    因为是通过Bean扫描进入的,也就是BeanDefinitionRegister当中是没有这个BeanDefinition的。所以这里直接就返回True,不会有走到下面的机会。
    这个时候大家可以思考一下,如果走到下面了会怎么样。欢迎评论区讨论。

    继续代码逻辑

    beanDefinitions.add(definitionHolder);
    registerBeanDefinition(definitionHolder, this.registry);

    接下来就去registerBeanDefinition了,然后还把registry传进入了方法,那很明显了。这里是去注册BeanDefinition了。

    Spring中Bean扫描原理是什么

    到此,相信大家对“Spring中Bean扫描原理是什么”有了更深的了解,不妨来实际操作一番吧!这里是亿速云网站,更多相关内容可以进入相关频道进行查询,关注我们,继续学习!

    向AI问一下细节

    免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。

    AI