摘要：簡(jiǎn)介為了寫容器源碼分析系列的文章，我特地寫了一篇容器的導(dǎo)讀文章。在做完必要的準(zhǔn)備工作后，從本文開始，正式開始進(jìn)入源碼分析的階段。從緩存中獲取單例。返回以上就是和兩個(gè)方法的分析。

為了寫 Spring IOC 容器源碼分析系列的文章，我特地寫了一篇 Spring IOC 容器的導(dǎo)讀文章。在導(dǎo)讀一文中，我介紹了 Spring 的一些特性以及閱讀 Spring 源碼的一些建議。在做完必要的準(zhǔn)備工作后，從本文開始，正式開始進(jìn)入源碼分析的階段。

在本篇文章中，我將會(huì)詳細(xì)分析BeanFactory的getBean(String)方法實(shí)現(xiàn)細(xì)節(jié)，getBean(String) 及所調(diào)用的方法總體來說實(shí)現(xiàn)上較為復(fù)雜，代碼長(zhǎng)度比較長(zhǎng)。作為源碼分析文章，本文的文章長(zhǎng)度也會(huì)比較長(zhǎng)，希望大家耐心讀下去。

好了，其他的不多說了，進(jìn)入主題環(huán)節(jié)吧。

簡(jiǎn)單說一下本章的內(nèi)容安排吧，在本章的開始，也就是2.1節(jié)，我將會(huì)分析getBean(String)方法整體的實(shí)現(xiàn)邏輯。但不會(huì)分析它所調(diào)用的方法，這些方法將會(huì)在后續(xù)幾節(jié)中依次進(jìn)行分析。那接下來，我們就先來看看 getBean(String) 方法是如何實(shí)現(xiàn)的吧。

在本小節(jié)，我們先從戰(zhàn)略上俯瞰 getBean(String) 方法的實(shí)現(xiàn)源碼。代碼如下：

public Object getBean(String name) throws BeansException {
    // getBean 是一個(gè)空殼方法，所有的邏輯都封裝在 doGetBean 方法中
    return doGetBean(name, null, null, false);
}

protected  T doGetBean(
        final String name, final Class requiredType, final Object[] args, boolean typeCheckOnly)
        throws BeansException {

    /*
     * 通過 name 獲取 beanName。這里不使用 name 直接作為 beanName 有兩點(diǎn)原因：
     * 1. name 可能會(huì)以 & 字符開頭，表明調(diào)用者想獲取 FactoryBean 本身，而非 FactoryBean 
     *    實(shí)現(xiàn)類所創(chuàng)建的 bean。在 BeanFactory 中，F(xiàn)actoryBean 的實(shí)現(xiàn)類和其他的 bean 存儲(chǔ)
     *    方式是一致的，即 ，beanName 中是沒有 & 這個(gè)字符的。所以我們需要
     *    將 name 的首字符 & 移除，這樣才能從緩存里取到 FactoryBean 實(shí)例。
     * 2. 若 name 是一個(gè)別名，則應(yīng)將別名轉(zhuǎn)換為具體的實(shí)例名，也就是 beanName。
     */
    final String beanName = transformedBeanName(name);
    Object bean;

    /*
     * 從緩存中獲取單例 bean。Spring 是使用 Map 作為 beanName 和 bean 實(shí)例的緩存的，所以這
     * 里暫時(shí)可以把 getSingleton(beanName) 等價(jià)于 beanMap.get(beanName)。當(dāng)然，實(shí)際的
     * 邏輯并非如此簡(jiǎn)單，后面再細(xì)說。
     */
    Object sharedInstance = getSingleton(beanName);

    /*
     * 如果 sharedInstance = null，則說明緩存里沒有對(duì)應(yīng)的實(shí)例，表明這個(gè)實(shí)例還沒創(chuàng)建。
     * BeanFactory 并不會(huì)在一開始就將所有的單例 bean 實(shí)例化好，而是在調(diào)用 getBean 獲取 
     * bean 時(shí)再實(shí)例化，也就是懶加載。
     * getBean 方法有很多重載，比如 getBean(String name, Object... args)，我們?cè)谑状潍@取
     * 某個(gè) bean 時(shí)，可以傳入用于初始化 bean 的參數(shù)數(shù)組（args），BeanFactory 會(huì)根據(jù)這些參數(shù)
     * 去匹配合適的構(gòu)造方法構(gòu)造 bean 實(shí)例。當(dāng)然，如果單例 bean 早已創(chuàng)建好，這里的 args 就沒有
     * 用了，BeanFactory 不會(huì)多次實(shí)例化單例 bean。
     */
    if (sharedInstance != null && args == null) {
        if (logger.isDebugEnabled()) {
            if (isSingletonCurrentlyInCreation(beanName)) {
                logger.debug("Returning eagerly cached instance of singleton bean "" + beanName +
                        "" that is not fully initialized yet - a consequence of a circular reference");
            }
            else {
                logger.debug("Returning cached instance of singleton bean "" + beanName + """);
            }
        }
      
        /*
         * 如果 sharedInstance 是普通的單例 bean，下面的方法會(huì)直接返回。但如果 
         * sharedInstance 是 FactoryBean 類型的，則需調(diào)用 getObject 工廠方法獲取真正的 
         * bean 實(shí)例。如果用戶想獲取 FactoryBean 本身，這里也不會(huì)做特別的處理，直接返回
         * 即可。畢竟 FactoryBean 的實(shí)現(xiàn)類本身也是一種 bean，只不過具有一點(diǎn)特殊的功能而已。
         */
        bean = getObjectForBeanInstance(sharedInstance, name, beanName, null);
    }
    /*
     * 如果上面的條件不滿足，則表明 sharedInstance 可能為空，此時(shí) beanName 對(duì)應(yīng)的 bean 
     * 實(shí)例可能還未創(chuàng)建。這里還存在另一種可能，如果當(dāng)前容器有父容器，beanName 對(duì)應(yīng)的 bean 實(shí)例
     * 可能是在父容器中被創(chuàng)建了，所以在創(chuàng)建實(shí)例前，需要先去父容器里檢查一下。
     */
    else {
        // BeanFactory 不緩存 Prototype 類型的 bean，無法處理該類型 bean 的循環(huán)依賴問題
        if (isPrototypeCurrentlyInCreation(beanName)) {
            throw new BeanCurrentlyInCreationException(beanName);
        }

        // 如果 sharedInstance = null，則到父容器中查找 bean 實(shí)例
        BeanFactory parentBeanFactory = getParentBeanFactory();
        if (parentBeanFactory != null && !containsBeanDefinition(beanName)) {
            // 獲取 name 對(duì)應(yīng)的 beanName，如果 name 是以 & 字符開頭，則返回 & + beanName
            String nameToLookup = originalBeanName(name);
            // 根據(jù) args 是否為空，以決定調(diào)用父容器哪個(gè)方法獲取 bean
            if (args != null) {
                return (T) parentBeanFactory.getBean(nameToLookup, args);
            } 
            else {
                return parentBeanFactory.getBean(nameToLookup, requiredType);
            }
        }

        if (!typeCheckOnly) {
            markBeanAsCreated(beanName);
        }

        try {
            // 合并父 BeanDefinition 與子 BeanDefinition，后面會(huì)多帶帶分析這個(gè)方法
            final RootBeanDefinition mbd = getMergedLocalBeanDefinition(beanName);
            checkMergedBeanDefinition(mbd, beanName, args);

            // 檢查是否有 dependsOn 依賴，如果有則先初始化所依賴的 bean
            String[] dependsOn = mbd.getDependsOn();
            if (dependsOn != null) {
                for (String dep : dependsOn) {
                    /*
                     * 檢測(cè)是否存在 depends-on 循環(huán)依賴，若存在則拋異常。比如 A 依賴 B，
                     * B 又依賴 A，他們的配置如下：
                     *   
                     *   
                     *   
                     * beanA 要求 beanB 在其之前被創(chuàng)建，但 beanB 又要求 beanA 先于它
                     * 創(chuàng)建。這個(gè)時(shí)候形成了循環(huán)，對(duì)于 depends-on 循環(huán)，Spring 會(huì)直接
                     * 拋出異常
                     */
                    if (isDependent(beanName, dep)) {
                        throw new BeanCreationException(mbd.getResourceDescription(), beanName,
                                "Circular depends-on relationship between "" + beanName + "" and "" + dep + """);
                    }
                    // 注冊(cè)依賴記錄
                    registerDependentBean(dep, beanName);
                    try {
                        // 加載 depends-on 依賴
                        getBean(dep);
                    } 
                    catch (NoSuchBeanDefinitionException ex) {
                        throw new BeanCreationException(mbd.getResourceDescription(), beanName,
                                """ + beanName + "" depends on missing bean "" + dep + """, ex);
                    }
                }
            }

            // 創(chuàng)建 bean 實(shí)例
            if (mbd.isSingleton()) {
                /*
                 * 這里并沒有直接調(diào)用 createBean 方法創(chuàng)建 bean 實(shí)例，而是通過 
                 * getSingleton(String, ObjectFactory) 方法獲取 bean 實(shí)例。
                 * getSingleton(String, ObjectFactory) 方法會(huì)在內(nèi)部調(diào)用 
                 * ObjectFactory 的 getObject() 方法創(chuàng)建 bean，并會(huì)在創(chuàng)建完成后，
                 * 將 bean 放入緩存中。關(guān)于 getSingleton 方法的分析，本文先不展開，我會(huì)在
                 * 后面的文章中進(jìn)行分析
                 */
                sharedInstance = getSingleton(beanName, new ObjectFactory