Spring IOC 容器源码分析 - getBean调用方法解析(三) -- 实例化 Bean 对象

    protected BeanWrapper createBeanInstance(String beanName, RootBeanDefinition mbd, @Nullable Object[] args) {
        // 解析 bean ，将 bean 类名解析为 class 引用
        Class<?> beanClass = resolveBeanClass(mbd, beanName);

        /*
         * 检测类的访问权限。默认情况下，对于非 public 的类，是允许访问的。
         * 若禁止访问，这里会抛出异常
         */
        if (beanClass != null && !Modifier.isPublic(beanClass.getModifiers()) && !mbd.isNonPublicAccessAllowed()) {
            throw new BeanCreationException(mbd.getResourceDescription(), beanName,
                    "Bean class isn‘t public, and non-public access not allowed: " + beanClass.getName());
        }

        Supplier<?> instanceSupplier = mbd.getInstanceSupplier();
        if (instanceSupplier != null) {
            return obtainFromSupplier(instanceSupplier, beanName);
        }

        /*
          *  <bean id="dynamicStu" factory-bean="stuFactory" factory-method="getDynamicStu">
         * 如果工厂方法不为空，则通过工厂方法构建 bean 对象
         */
        if (mbd.getFactoryMethodName() != null) {
            // 使用 FactoryBean 的 factory-method 来创建，支持静态工厂和实例工厂
            return instantiateUsingFactoryMethod(beanName, mbd, args);
        }

        /*
         * 当多次构建同一个 bean 时，可以使用此处的快捷路径，即无需再次推断应该使用哪种方式构造实例，
         * 以提高效率。比如在多次构建同一个 prototype 类型的 bean 时，就可以走此处的捷径。
         * 这里的 resolved 和 mbd.constructorArgumentsResolved 将会在 bean 第一次实例
         * 化的过程中被设置，在后面的源码中会分析到，先继续往下看。
         */
        boolean resolved = false;
        boolean autowireNecessary = false;
        if (args == null) {
            synchronized (mbd.constructorArgumentLock) {
                if (mbd.resolvedConstructorOrFactoryMethod != null) {
                    resolved = true;
                    autowireNecessary = mbd.constructorArgumentsResolved;
                }
            }
        }
        // 已经解析好了，直接注入即可
        if (resolved) {
            if (autowireNecessary) {
                //  autowire 自动注入，调用构造函数自动注入
                return autowireConstructor(beanName, mbd, null, null);
            }
            else {
                // 通过“默认构造方法”的方式构造 bean 对象
                return instantiateBean(beanName, mbd);
            }
        }

        // 确定解析的构造函数
        // 主要是检查已经注册的 SmartInstantiationAwareBeanPostProcessor
        Constructor<?>[] ctors = determineConstructorsFromBeanPostProcessors(beanClass, beanName);
        /*
         * 下面的条件分支条件用于判断使用什么方式构造 bean 实例，有两种方式可选 - 构造方法自动
         * 注入和默认构造方法。判断的条件由4部分综合而成，如下：
         *
         *    条件1：ctors != null -> 后置处理器返回构造方法数组是否为空
         *
         *    条件2：mbd.getResolvedAutowireMode() == RootBeanDefinition.AUTOWIRE_CONSTRUCTOR
         *              -> bean 配置中的 autowire 属性是否为 constructor
         *    条件3：mbd.hasConstructorArgumentValues()
         *              -> constructorArgumentValues 是否存在元素，即 bean 配置文件中
         *                 是否配置了 <construct-arg/>
         *    条件4：!ObjectUtils.isEmpty(args)
         *              -> args 数组是否存在元素，args 是由用户调用
         *                 getBean(String name, Object... args) 传入的
         *
         * 上面4个条件，只要有一个为 true，就会通过构造方法自动注入的方式构造 bean 实例
         */
        if (ctors != null || mbd.getResolvedAutowireMode() == AUTOWIRE_CONSTRUCTOR ||
                mbd.hasConstructorArgumentValues() || !ObjectUtils.isEmpty(args)) {
            // 通过“构造方法自动注入”的方式构造 bean 对象
            return autowireConstructor(beanName, mbd, ctors, args);
        }

        // Preferred constructors for default construction?
        ctors = mbd.getPreferredConstructors();
        if (ctors != null) {
            return autowireConstructor(beanName, mbd, ctors, null);
        }

        // 通过“默认构造方法”的方式构造 bean 对象
        return instantiateBean(beanName, mbd);
    }

public BeanWrapper autowireConstructor(String beanName, RootBeanDefinition mbd,
            @Nullable Constructor<?>[] chosenCtors, @Nullable Object[] explicitArgs) {

        // 创建 BeanWrapperImpl 对象
        BeanWrapperImpl bw = new BeanWrapperImpl();
        this.beanFactory.initBeanWrapper(bw);

        Constructor<?> constructorToUse = null;// 构造函数
        ArgumentsHolder argsHolderToUse = null;// 构造参数
        Object[] argsToUse = null;// 构造参数

        // 确定构造参数
        // 如果 getBean() 已经传递，则直接使用
        if (explicitArgs != null) {
            argsToUse = explicitArgs;
        }
        else {
            // 尝试从缓存中获取
            Object[] argsToResolve = null;
            synchronized (mbd.constructorArgumentLock) {
                // 缓存中的构造函数或者工厂方法
                constructorToUse = (Constructor<?>) mbd.resolvedConstructorOrFactoryMethod;
                if (constructorToUse != null && mbd.constructorArgumentsResolved) {
                    // 获取已解析的构造方法参数列表
                    argsToUse = mbd.resolvedConstructorArguments;
                    if (argsToUse == null) {
                        // 若 argsToUse 为空，则获取未解析的构造方法参数列表
                        argsToResolve = mbd.preparedConstructorArguments;
                    }
                }
            }
            // 缓存中存在,则解析存储在 BeanDefinition 中的参数
            // 如给定方法的构造函数 A(int ,int )，则通过此方法后就会把配置文件中的("1","1")转换为 (1,1)
            // 缓存中的值可能是原始值也有可能是最终值
            if (argsToResolve != null) {
                // 解析参数列表
                argsToUse = resolvePreparedArguments(beanName, mbd, bw, constructorToUse, argsToResolve, true);
            }
        }
        // 没有缓存，则尝试从配置文件中获取参数
        if (constructorToUse == null || argsToUse == null) {
            // 如果 chosenCtors 未传入，则获取构造方法们
            Constructor<?>[] candidates = chosenCtors;
            if (candidates == null) {
                Class<?> beanClass = mbd.getBeanClass();
                try {
                    candidates = (mbd.isNonPublicAccessAllowed() ?
                            beanClass.getDeclaredConstructors() : beanClass.getConstructors());
                }
                catch (Throwable ex) {
                    throw new BeanCreationException(mbd.getResourceDescription(), beanName,
                            "Resolution of declared constructors on bean Class [" + beanClass.getName() +
                            "] from ClassLoader [" + beanClass.getClassLoader() + "] failed", ex);
                }
            }

            if (candidates.length == 1 && explicitArgs == null && !mbd.hasConstructorArgumentValues()) {
                Constructor<?> uniqueCandidate = candidates[0];
                if (uniqueCandidate.getParameterCount() == 0) {
                    synchronized (mbd.constructorArgumentLock) {
                        mbd.resolvedConstructorOrFactoryMethod = uniqueCandidate;
                        mbd.constructorArgumentsResolved = true;
                        mbd.resolvedConstructorArguments = EMPTY_ARGS;
                    }
                    bw.setBeanInstance(instantiate(beanName, mbd, uniqueCandidate, EMPTY_ARGS));
                    return bw;
                }
            }

            // 是否需要解析构造器
            boolean autowiring = (chosenCtors != null ||
                    mbd.getResolvedAutowireMode() == AutowireCapableBeanFactory.AUTOWIRE_CONSTRUCTOR);
            // 用于承载解析后的构造函数参数的值
            ConstructorArgumentValues resolvedValues = null;

            int minNrOfArgs;
            if (explicitArgs != null) {
                minNrOfArgs = explicitArgs.length;
            }
            else {
                // 从 BeanDefinition 中获取构造参数，也就是从配置文件中提取构造参数
                ConstructorArgumentValues cargs = mbd.getConstructorArgumentValues();
                resolvedValues = new ConstructorArgumentValues();
                /*
                 * 确定构造方法参数数量，比如下面的配置：
                 *     <bean id="persion" class="xyz.coolblog.autowire.Person">
                 *         <constructor-arg index="0" value="xiaoming"/>
                 *         <constructor-arg index="1" value="1"/>
                 *         <constructor-arg index="2" value="man"/>
                 *     </bean>
                 *
                 * 此时 minNrOfArgs = maxIndex + 1 = 2 + 1 = 3，除了计算 minNrOfArgs，
                 * 下面的方法还会将 cargs 中的参数数据转存到 resolvedValues 中
                 */
                minNrOfArgs = resolveConstructorArguments(beanName, mbd, bw, cargs, resolvedValues);
            }
            // 对构造函数进行排序处理
            // public 构造函数优先参数数量降序，非public 构造函数参数数量降序
            AutowireUtils.sortConstructors(candidates);
            // 最小参数类型权重
            int minTypeDiffWeight = Integer.MAX_VALUE;
            Set<Constructor<?>> ambiguousConstructors = null;
            LinkedList<UnsatisfiedDependencyException> causes = null;
            // 迭代所有构造函数
            for (Constructor<?> candidate : candidates) {
                // 获取该构造函数的参数类型
                Class<?>[] paramTypes = candidate.getParameterTypes();

                /*
                 * 下面的 if 分支的用途是：若匹配到到合适的构造方法了，提前结束 for 循环
                 * constructorToUse != null 这个条件比较好理解，下面分析一下条件 argsToUse.length > paramTypes.length：
                 * 前面说到 AutowireUtils.sortConstructors(candidates) 用于对构造方法进行
                 * 排序，排序规则如下：
                 *   1. 具有 public 访问权限的构造方法排在非 public 构造方法前
                 *   2. 参数数量多的构造方法排在前面
                 *
                 * 假设现在有一组构造方法按照上面的排序规则进行排序，排序结果如下（省略参数名称）：
                 *
                 *   1. public Hello(Object, Object, Object)
                 *   2. public Hello(Object, Object)
                 *   3. public Hello(Object)
                 *   4. protected Hello(Integer, Object, Object, Object)
                 *   5. protected Hello(Integer, Object, Object)
                 *   6. protected Hello(Integer, Object)
                 *
                 * argsToUse = [num1, obj2]，可以匹配上的构造方法2和构造方法6。由于构造方法2有
                 * 更高的访问权限，所以没理由不选他（尽管后者在参数类型上更加匹配）。由于构造方法3
                 * 参数数量 < argsToUse.length，参数数量上不匹配，也不应该选。所以
                 * argsToUse.length > paramTypes.length 这个条件用途是：在条件
                 * constructorToUse != null 成立的情况下，通过判断参数数量与参数值数量
                 * （argsToUse.length）是否一致，来决定是否提前终止构造方法匹配逻辑。
                 */
                if (constructorToUse != null && argsToUse != null && argsToUse.length > paramTypes.length) {
                    // Already found greedy constructor that can be satisfied ->
                    // do not look any further, there are only less greedy constructors left.
                    break;
                }
                /*
                 * 构造方法参数数量低于配置的参数数量，则忽略当前构造方法，并重试。比如
                 * argsToUse = [obj1, obj2, obj3, obj4]，上面的构造方法列表中，
                 * 构造方法1、2和3显然不是合适选择，忽略之。
                 */
                if (paramTypes.length < minNrOfArgs) {
                    continue;
                }
                // 参数持有者 ArgumentsHolder 对象
                ArgumentsHolder argsHolder;
                if (resolvedValues != null) {
                    try {
                        /*
                         * 判断否则方法是否有 ConstructorProperties 注解，若有，则取注解中的
                         * 值。比如下面的代码：
                         *
                         *  public class Persion {
                         *      private String name;
                         *      private Integer age;
                         *
                         *      @ConstructorProperties(value = {"coolblog", "20"})
                         *      public Persion(String name, Integer age) {
                         *          this.name = name;
                         *          this.age = age;
                         *      }
                         * }
                         */
                        String[] paramNames = ConstructorPropertiesChecker.evaluate(candidate, paramTypes.length);
                        if (paramNames == null) {
                            ParameterNameDiscoverer pnd = this.beanFactory.getParameterNameDiscoverer();
                            if (pnd != null) {
                                /*
                                 * 获取构造方法参数名称列表，比如有这样一个构造方法:
                                 *   public Person(String name, int age, String sex)
                                 *
                                 * 调用 getParameterNames 方法返回 paramNames = [name, age, sex]
                                 */
                                paramNames = pnd.getParameterNames(candidate);
                            }
                        }
                        /*
                         * 创建参数值列表，返回 argsHolder 会包含进行类型转换后的参数值，比如下
                         * 面的配置:
                         *
                         *     <bean id="persion" class="xyz.coolblog.autowire.Person">
                         *         <constructor-arg name="name" value="xiaoming"/>
                         *         <constructor-arg name="age" value="1"/>
                         *         <constructor-arg name="sex" value="man"/>
                         *     </bean>
                         *
                         * Person 的成员变量 age 是 Integer 类型的，但由于在 Spring 配置中
                         * 只能配成 String 类型，所以这里要进行类型转换。
                         */
                        argsHolder = createArgumentArray(beanName, mbd, resolvedValues, bw, paramTypes, paramNames,
                                getUserDeclaredConstructor(candidate), autowiring, candidates.length == 1);
                    }
                    catch (UnsatisfiedDependencyException ex) {
                        if (logger.isTraceEnabled()) {
                            logger.trace("Ignoring constructor [" + candidate + "] of bean ‘" + beanName + "‘: " + ex);
                        }
                        // Swallow and try next constructor.
                        if (causes == null) {
                            causes = new LinkedList<>();
                        }
                        causes.add(ex);
                        continue;
                    }
                }
                else {
                    // Explicit arguments given -> arguments length must match exactly.
                    if (paramTypes.length != explicitArgs.length) {
                        continue;
                    }
                    argsHolder = new ArgumentsHolder(explicitArgs);
                }

                /*
                 * 计算参数值（argsHolder.arguments）每个参数类型与构造方法参数列表
                 * （paramTypes）中参数的类型差异量，差异量越大表明参数类型差异越大。参数类型差异
                 * 越大，表明当前构造方法并不是一个最合适的候选项。引入差异量（typeDiffWeight）
                 * 变量目的：是将候选构造方法的参数列表类型与参数值列表类型的差异进行量化，通过量化
                 * 后的数值筛选出最合适的构造方法。
                 *
                 * isLenientConstructorResolution 判断解析构造函数的时候是否以宽松模式还是严格模式
                 * 严格模式：解析构造函数时，必须所有的都需要匹配，否则抛出异常
                 * 宽松模式：使用具有"最接近的模式"进行匹配
                 * typeDiffWeight：类型差异权重
                 */
                int typeDiffWeight = (mbd.isLenientConstructorResolution() ?
                        argsHolder.getTypeDifferenceWeight(paramTypes) : argsHolder.getAssignabilityWeight(paramTypes));
                // 如果它代表着当前最接近的匹配则选择其作为构造函数
                if (typeDiffWeight < minTypeDiffWeight) {
                    constructorToUse = candidate;
                    argsHolderToUse = argsHolder;
                    argsToUse = argsHolder.arguments;
                    minTypeDiffWeight = typeDiffWeight;
                    ambiguousConstructors = null;
                }
                /*
                 * 如果两个构造方法与参数值类型列表之间的差异量一致，那么这两个方法都可以作为
                 * 候选项，这个时候就出现歧义了，这里先把有歧义的构造方法放入
                 * ambiguousConstructors 集合中
                 */
                else if (constructorToUse != null && typeDiffWeight == minTypeDiffWeight) {
                    if (ambiguousConstructors == null) {
                        ambiguousConstructors = new LinkedHashSet<>();
                        ambiguousConstructors.add(constructorToUse);
                    }
                    ambiguousConstructors.add(candidate);
                }
            }
            // 若上面未能筛选出合适的构造方法，这里将抛出 BeanCreationException 异常
            if (constructorToUse == null) {
                if (causes != null) {
                    UnsatisfiedDependencyException ex = causes.removeLast();
                    for (Exception cause : causes) {
                        this.beanFactory.onSuppressedException(cause);
                    }
                    throw ex;
                }
                throw new BeanCreationException(mbd.getResourceDescription(), beanName,
                        "Could not resolve matching constructor " +
                        "(hint: specify index/type/name arguments for simple parameters to avoid type ambiguities)");
            }
            /*
             * 如果 constructorToUse != null，且 ambiguousConstructors 也不为空，表明解析
             * 出了多个的合适的构造方法，此时就出现歧义了。Spring 不会擅自决定使用哪个构造方法，
             * 所以抛出异常。
             */
            else if (ambiguousConstructors != null && !mbd.isLenientConstructorResolution()) {
                throw new BeanCreationException(mbd.getResourceDescription(), beanName,
                        "Ambiguous constructor matches found in bean ‘" + beanName + "‘ " +
                        "(hint: specify index/type/name arguments for simple parameters to avoid type ambiguities): " +
                        ambiguousConstructors);
            }

            if (explicitArgs == null && argsHolderToUse != null) {
                /*
                 * 缓存相关信息，比如：
                 *   1. 已解析出的构造方法对象 resolvedConstructorOrFactoryMethod
                 *   2. 构造方法参数列表是否已解析标志 constructorArgumentsResolved
                 *   3. 参数值列表 resolvedConstructorArguments 或 preparedConstructorArguments
                 *
                 * 这些信息可用在其他地方，用于进行快捷判断
                 */
                argsHolderToUse.storeCache(mbd, constructorToUse);
            }
        }

        Assert.state(argsToUse != null, "Unresolved constructor arguments");
        bw.setBeanInstance(instantiate(beanName, mbd, constructorToUse, argsToUse));
        return bw;
    }

    protected BeanWrapper instantiateBean(final String beanName, final RootBeanDefinition mbd) {
        try {
            Object beanInstance;
            final BeanFactory parent = this;
            // if 条件分支里的一大坨是 Java 安全相关的代码，可以忽略，直接看 else 分支
            if (System.getSecurityManager() != null) {
                beanInstance = AccessController.doPrivileged((PrivilegedAction<Object>) () ->
                        getInstantiationStrategy().instantiate(mbd, beanName, parent),
                        getAccessControlContext());
            }
            else {
                /*
                 * 调用实例化策略创建实例，默认情况下使用反射创建对象。如果 bean 的配置信息中
                 * 包含 lookup-method 和 replace-method，则通过 CGLIB 创建 bean 对象
                 */
                beanInstance = getInstantiationStrategy().instantiate(mbd, beanName, parent);
            }
            // 创建 BeanWrapperImpl 对象
            BeanWrapper bw = new BeanWrapperImpl(beanInstance);
            initBeanWrapper(bw);
            return bw;
        }
        catch (Throwable ex) {
            throw new BeanCreationException(
                    mbd.getResourceDescription(), beanName, "Instantiation of bean failed", ex);
        }
    }

    public Object instantiate(RootBeanDefinition bd, @Nullable String beanName, BeanFactory owner) {
        // 检测 bean 配置中是否配置了 lookup-method 或 replace-method，若配置了，则需使用 CGLIB 构建 bean 对象
        if (!bd.hasMethodOverrides()) {
            Constructor<?> constructorToUse;
            synchronized (bd.constructorArgumentLock) {
                constructorToUse = (Constructor<?>) bd.resolvedConstructorOrFactoryMethod;
                if (constructorToUse == null) {
                    final Class<?> clazz = bd.getBeanClass();
                    if (clazz.isInterface()) {
                        throw new BeanInstantiationException(clazz, "Specified class is an interface");
                    }
                    try {
                        if (System.getSecurityManager() != null) {
                            constructorToUse = AccessController.doPrivileged(
                                    (PrivilegedExceptionAction<Constructor<?>>) clazz::getDeclaredConstructor);
                        }
                        else {
                            // 获取默认构造方法
                            constructorToUse = clazz.getDeclaredConstructor();
                        }
                        // 设置 resolvedConstructorOrFactoryMethod
                        bd.resolvedConstructorOrFactoryMethod = constructorToUse;
                    }
                    catch (Throwable ex) {
                        throw new BeanInstantiationException(clazz, "No default constructor found", ex);
                    }
                }
            }
            // 通过无参构造方法创建 bean 对象
            return BeanUtils.instantiateClass(constructorToUse);
        }
        else {
            // 使用 GCLIG 创建 bean 对象
            return instantiateWithMethodInjection(bd, beanName, owner);
        }
    }

    public static <T> T instantiateClass(Constructor<T> ctor, Object... args) throws BeanInstantiationException {
        Assert.notNull(ctor, "Constructor must not be null");
        try {
            // 设置构造方法为可访问
            ReflectionUtils.makeAccessible(ctor);
            if (KotlinDetector.isKotlinReflectPresent() && KotlinDetector.isKotlinType(ctor.getDeclaringClass())) {
                return KotlinDelegate.instantiateClass(ctor, args);
            }
            else {
                Class<?>[] parameterTypes = ctor.getParameterTypes();
                Assert.isTrue(args.length <= parameterTypes.length, "Can‘t specify more arguments than constructor parameters");
                Object[] argsWithDefaultValues = new Object[args.length];
                for (int i = 0 ; i < args.length; i++) {
                    if (args[i] == null) {
                        Class<?> parameterType = parameterTypes[i];
                        argsWithDefaultValues[i] = (parameterType.isPrimitive() ? DEFAULT_TYPE_VALUES.get(parameterType) : null);
                    }
                    else {
                        argsWithDefaultValues[i] = args[i];
                    }
                }
                // 通过反射创建 bean 实例，这里的 args 是一个没有元素的空数组
                return ctor.newInstance(argsWithDefaultValues);
            }
        }
        catch (InstantiationException ex) {
            throw new BeanInstantiationException(ctor, "Is it an abstract class?", ex);
        }
        catch (IllegalAccessException ex) {
            throw new BeanInstantiationException(ctor, "Is the constructor accessible?", ex);
        }
        catch (IllegalArgumentException ex) {
            throw new BeanInstantiationException(ctor, "Illegal arguments for constructor", ex);
        }
        catch (InvocationTargetException ex) {
            throw new BeanInstantiationException(ctor, "Constructor threw exception", ex.getTargetException());
        }
    }