18-Sepring登録BenDefinition

29228 ワード

前回はSpring解析xmlのデフォルトの名前空間を解析し、解析したデータをBenDefinitionHolderオブジェクトに封じました.これからビーンDefinitionの登録ができます.このプロセスは二つの部分に分けて、BeanDefinitionと登録aliases(別名)を登録します.
1.引用
前のセクションではプロモーション方法の第一歩を分析しました.次に実行するのはビーンDefinitionオブジェクトを飾り、ビーンDefinition登録を実行するべきです.
/**
 *   bean       definition    BeanDefinitionRegistry
 * Process the given bean element, parsing the bean definition and registering it with the registry.
 */
protected void processBeanDefinition(Element ele, BeanDefinitionParserDelegate delegate) {
    // 1、           BeanDefinitionHolder  
    // BeanDefinitionHolder-->   BeanDefinition,beanName  aliases
    BeanDefinitionHolder bdHolder = delegate.parseBeanDefinitionElement(ele);
    if (bdHolder != null) {
        // 2、  BeanDefinition
        bdHolder = delegate.decorateBeanDefinitionIfRequired(ele, bdHolder);
        try {
            // Register the final decorated instance.
            // 3、    
            BeanDefinitionReaderUtils.registerBeanDefinition(bdHolder, getReaderContext().getRegistry());
        }
        catch (BeanDefinitionStoreException ex) {
            getReaderContext().error("Failed to register bean definition with name '" + bdHolder.getBeanName() + "'", ele, ex);
        }
        // Send registration event.
        // 4、      
        getReaderContext().fireComponentRegistered(new BeanComponentDefinition(bdHolder));
    }
}
1.BenDefinitionの登録手順を簡単に分析する
public static void registerBeanDefinition(BeanDefinitionHolder definitionHolder, BeanDefinitionRegistry registry) throws BeanDefinitionStoreException {

    // Register bean definition under primary name.
    // 1、  BeanDefinition
    String beanName = definitionHolder.getBeanName();
    registry.registerBeanDefinition(beanName, definitionHolder.getBeanDefinition());

    // Register aliases for bean name, if any.
    // 2、  aliases(  )
    String[] aliases = definitionHolder.getAliases();
    if (aliases != null) {
        for (String alias : aliases) {
            registry.registerAlias(beanName, alias);
        }
    }
}
コードから分かるように、このプロセスは全部で二つの部分に分けられています.
  • 、登録ビーンDefinition
  • 、登録aliases(別名)
  • この二つの過程を一つ一つ分析します.
    3.登録BeanDefinition
    登録するBenDefinitionの仕事はBenDefinitionRegistryインターフェースのデフォルト実現DefaultListable BeanFactoryに任せました.このプロセスはまだ複雑です.コードを見てください.
    @Override
    public void registerBeanDefinition(String beanName, BeanDefinition beanDefinition) throws BeanDefinitionStoreException {
    
        // 1、  beanDefinition AbstractBeanDefinition  ,   
        if (beanDefinition instanceof AbstractBeanDefinition) {
            try {
                //                   (            )
                ((AbstractBeanDefinition) beanDefinition).validate();
            }
            catch (BeanDefinitionValidationException ex) {
                throw new BeanDefinitionStoreException(beanDefinition.getResourceDescription(), beanName, "Validation of bean definition failed", ex);
            }
        }
    
        // 2、          BeanDefinition
        BeanDefinition existingDefinition = this.beanDefinitionMap.get(beanName);
        if (existingDefinition != null) {
            // beanName           ,    
            if (!isAllowBeanDefinitionOverriding()) {
                throw new BeanDefinitionOverrideException(beanName, beanDefinition, existingDefinition);
            }
            //     BeanDefinition       BeanDefinition,if else       ,     ,        
            else if (existingDefinition.getRole() < beanDefinition.getRole()) {}
            else if (!beanDefinition.equals(existingDefinition)) {}
            else {}
            this.beanDefinitionMap.put(beanName, beanDefinition);
        }
        // 3、       BeanDefinition,     
        else {
            //   beanDefinition        (      bean       )
            if (hasBeanCreationStarted()) {
                // Cannot modify startup-time collection elements anymore (for stable iteration)
                synchronized (this.beanDefinitionMap) {
                    //   beanDefinitionMap
                    this.beanDefinitionMap.put(beanName, beanDefinition);
                    //   List     beanDefinitionNames     beanName    
                    List<String> updatedDefinitions = new ArrayList<>(this.beanDefinitionNames.size() + 1);
                    updatedDefinitions.addAll(this.beanDefinitionNames);
                    updatedDefinitions.add(beanName);
                    //  updatedDefinitions   beanDefinitionNames
                    this.beanDefinitionNames = updatedDefinitions;
                    //   manualSingletonNames       beanName
                    if (this.manualSingletonNames.contains(beanName)) {
                        //   set    manualSingletonNames       set  
                        Set<String> updatedSingletons = new LinkedHashSet<>(this.manualSingletonNames);
                        //       beanName
                        updatedSingletons.remove(beanName);
                        this.manualSingletonNames = updatedSingletons;
                    }
                }
                //          beanDefinitionNames manualSingletonNames  ,           ...
            }
            else {
                //  beanDefinition       
                // beanDefinitionMap-->(key->beanName,value->beanDefinition)
                this.beanDefinitionMap.put(beanName, beanDefinition);
                // beanDefinitionNames-->   beanName  
                this.beanDefinitionNames.add(beanName);
                // manualSingletonNames          bean,        remove  ,  beanName  
                //   :xmlBeanFactory.registerSingleton("myDog", new Dog());
                //     manualSingletonNames     bean
                this.manualSingletonNames.remove(beanName);
            }
            this.frozenBeanDefinitionNames = null;
        }
    
        // 4、  BeanDefinition,
        //      bean      beanDefinitionMap     ,
        //             bean    
        if (existingDefinition != null || containsSingleton(beanName)) {
            resetBeanDefinition(beanName);
        }
    }
    
    登録プロセスはコードにはっきりと表示されています.その中で、synchronized方法のコードは分析があまり明確ではないので、ご了承ください.
    4.別名登録
    //     
    @Override
    public void registerAlias(String name, String alias) {
        Assert.hasText(name, "'name' must not be empty");
        Assert.hasText(alias, "'alias' must not be empty");
        synchronized (this.aliasMap) {
            //   beanName     
            if (alias.equals(name)) {
                //    
                this.aliasMap.remove(alias);
                if (logger.isDebugEnabled()) {
                    logger.debug("Alias definition '" + alias + "' ignored since it points to same name");
                }
            }
            else {
                //          
                String registeredName = this.aliasMap.get(alias);
                //            
                if (registeredName != null) {
                    //       beanName(  :    )  ,      ,       
                    if (registeredName.equals(name)) {
                        // An existing alias - no need to re-register
                        return;
                    }
                    //       ,      ,    
                    if (!allowAliasOverriding()) {
                        throw new IllegalStateException("Cannot define alias '" + alias + "' for name '" +
                                name + "': It is already registered for name '" + registeredName + "'.");
                    }
                }
                //                       ,              IllegalStateException
                checkForAliasCircle(name, alias);
                //    
                this.aliasMap.put(alias, name);
            }
        }
    }
    
    5.分析
    以上の操作はすでにビーンDefinition全体と別名登録を完了しました.以前の分析コードを加えると、いくつかのSpringソースの書き方が分かります.
  • 方法の職責は単一で、Springには長くて複雑な方法があまりないです.一つの方法で複数の論理を処理することも少ないです.あっても具体的な論理分岐を細分化し、主な方法で呼び出します.
  • 処理の流れが明確に分析され、Springには多くの方法があります.例えば、今日分析したBenDefinition登録や、次に分析するbean取得プロセスなどは、まず合法的な検証を行い、キャッシュから取得しようとします.キャッシュから取得できなかったら、本当にオブジェクトインスタンスを作成します.新たに作成したインスタンスをキャッシュに参加します.
  • 以上はただ二つの例です.コードをよく読んで、多くの追跡と調整してこそ、ソースコードを読む道です.読む回数が増えるにつれて、皆さんはもっとフレームに対する理解を深めてくれると信じています.Springのソースコードを本当に読んでから、他のソースコードを見ても、類推して読めると信じています.ソースコードを読む達人になります.