Spring 属性注入（二）BeanWrapper 结构

Spring 系列目录(https://www.cnblogs.com/binarylei/p/10117436.html)

BeanWrapper 位于 org.springframework.beans 包中，默认实现为 BeanWrapperImpl，提供分析和处理标准 JavaBean 用于 get 和 set 属性，取得属性描述，查询属性的读/写能力。

beans 包还提供了一个 PropertyValues 用于保存多个属性值，默认的实现 MutablePropertyValues。另外还有两个有用的工具类，BeanUtils 和 PropertyAccessorUtils。

一、BeanWrapper 类图

PropertyEditorRegistry PropertyEditor 注册、查找。
TypeConverter 类型转换，其主要的工作由 TypeConverterDelegate 这个类完成的。
PropertyAccessor 属性读写。
ConfigurablePropertyAccessor 配置一些属性，如设置 ConversionService、是否暴露旧值、嵌套注入时属性为 null 是否自动创建。
BeanWrapper 对 bean 进行封装。
AbstractNestablePropertyAccessor 实现了对嵌套属性注入的处理，其它实现见名知义就不介绍了。

BeanWrapper 的层次结构还是比较清晰的，继承于 ConfigurablePropertyAccessor 和 PropertyAccessor 接口。

有一点不太明白，为什么 BeanWrapper 要继承于 PropertyEditorRegistry。从字面意义上来说，PropertyEditorRegistry 提供了 PropertyEditor，而 TypeConverter 进行类型转换，和 BeanWrapper 不是继承关系，使用组合感觉更好。

二、PropertyEditorRegistry

PropertyEditor 将 String 转换为其它类型，PropertyEditorRegistry 统一管理所有的 PropertyEditor 注册和查找。

public interface PropertyEditorRegistry {

    // 1. 根据类型注册 PropertyEditor

    void registerCustomEditor(Class<?> requiredType, PropertyEditor propertyEditor);

    // 2. 根据类型(requiredType)和属性(propertyPath)注册 PropertyEditor

    //    查找时优先根据 propertyPath 查找对应的 PropertyEditor，propertyPath 可以为嵌套属性

    void registerCustomEditor(@Nullable Class<?> requiredType,

        @Nullable String propertyPath, PropertyEditor propertyEditor);

    // 3. 根据类型和属性查找 PropertyEditor

    PropertyEditor findCustomEditor(@Nullable Class<?> requiredType, @Nullable String propertyPath);

}

PropertyEditorRegistry 的实现类 PropertyEditorRegistrySupport 分析见这两篇文章：

三、TypeConverter

TypeConverter 负责类型转换，其主要的工作由 TypeConverterDelegate 这个类完成的。

public interface TypeConverter {

    // 1. value 转换成 requiredType

    <T> T convertIfNecessary(Object value, Class<T> requiredType) throws TypeMismatchException;

    // 2. methodParam 同下

    <T> T convertIfNecessary(Object value, Class<T> requiredType,

            MethodParameter methodParam) throws TypeMismatchException;

    // 3. field 是 value 转换成 requiredType 后需要赋值的 field 字段

    //    可以从该 field 字段拿到其泛型信息，从而进一步判断是否可以转换，毕竟 requiredType 只有 Class 信息

    <T> T convertIfNecessary(Object value, Class<T> requiredType, Field field)

            throws TypeMismatchException;

}

TypeConverter 的实现类 TypeConverterSupport 的所有功能，实际是都是委托给 TypeConverterDelegate 完成的。

四、PropertyAccessor

PropertyAccessor 提供了对 JavaBean 的基本操作。

public interface PropertyAccessor {

    boolean isReadableProperty(String propertyName);

    boolean isWritableProperty(String propertyName);

    Class<?> getPropertyType(String propertyName) throws BeansException;

    TypeDescriptor getPropertyTypeDescriptor(String propertyName) throws BeansException;

    Object getPropertyValue(String propertyName) throws BeansException;

    void setPropertyValue(String propertyName, @Nullable Object value) throws BeansException;

    void setPropertyValue(PropertyValue pv) throws BeansException;

    void setPropertyValues(Map<?, ?> map) throws BeansException;

    void setPropertyValues(PropertyValues pvs) throws BeansException;

    void setPropertyValues(PropertyValues pvs, boolean ignoreUnknown)

            throws BeansException;

    void setPropertyValues(PropertyValues pvs, boolean ignoreUnknown, boolean ignoreInvalid)

            throws BeansException;

}

PropertyAccessor 的实现类是 AbstractPropertyAccessor，这个类中 setPropertyValue 进行了处理，最终都是调用 setPropertyValue(String propertyName, Object value) 完成属性注入。

四、ConfigurablePropertyAccessor

public interface ConfigurablePropertyAccessor extends

        PropertyAccessor, PropertyEditorRegistry, TypeConverter {

    void setConversionService(@Nullable ConversionService conversionService);

    ConversionService getConversionService();

    // PropertyEditor 使用时是否暴露修改前后值

    void setExtractOldValueForEditor(boolean extractOldValueForEditor);

    boolean isExtractOldValueForEditor();

    // 嵌套注入时当属性为 null 时是否自动生成对象

    void setAutoGrowNestedPaths(boolean autoGrowNestedPaths);

    boolean isAutoGrowNestedPaths();

}

ConfigurablePropertyAccessor 的实现也类是 AbstractPropertyAccessor，这个类中默认 extractOldValueForEditor 和 autoGrowNestedPaths 都是 false，即不暴露旧值，也不支持嵌套注入时属性为 null 就自动创建对象。

五、BeanWrapper

public interface BeanWrapper extends ConfigurablePropertyAccessor {

    // @since 4.1 设置集合或数组自动生成对象的最大嵌套深度

    void setAutoGrowCollectionLimit(int autoGrowCollectionLimit);

    int getAutoGrowCollectionLimit();

    Object getWrappedInstance();

    Class<?> getWrappedClass();

    PropertyDescriptor[] getPropertyDescriptors();

    PropertyDescriptor getPropertyDescriptor(String propertyName) throws InvalidPropertyException;

}

Spring 属性注入（三）AbstractNestablePropertyAccessor
BeanWrapperImpl 源码分析如下：

BeanWrapper 的实现类是 BeanWrapperImpl，主要完成了 JavaBean 的内省，包括 PropertyDescriptor 的获取，属性的赋值等。

(1) JavaBean 的内省

private CachedIntrospectionResults cachedIntrospectionResults;

// 获取

private CachedIntrospectionResults getCachedIntrospectionResults() {

    if (this.cachedIntrospectionResults == null) {

        this.cachedIntrospectionResults = CachedIntrospectionResults.forClass(getWrappedClass());

    }

    return this.cachedIntrospectionResults;

}

JavaBean 的内省都是由 CachedIntrospectionResults 完成，通过 cachedIntrospectionResults 就可以获取对应属性的 PropertyDescriptor。例如下面两个方法：

@Override

public PropertyDescriptor[] getPropertyDescriptors() {

    return getCachedIntrospectionResults().getPropertyDescriptors();

}

@Override

public PropertyDescriptor getPropertyDescriptor(String propertyName) throws InvalidPropertyException {

    BeanWrapperImpl nestedBw = (BeanWrapperImpl) getPropertyAccessorForPropertyPath(propertyName);

    // 获取属性名称

    String finalPath = getFinalPath(nestedBw, propertyName);

    PropertyDescriptor pd = nestedBw.getCachedIntrospectionResults().getPropertyDescriptor(finalPath);

    return pd;

}

(2) BeanPropertyHandler

@Override

protected BeanPropertyHandler getLocalPropertyHandler(String propertyName) {

    PropertyDescriptor pd = getCachedIntrospectionResults().getPropertyDescriptor(propertyName);

    return (pd != null ? new BeanPropertyHandler(pd) : null);

}

BeanPropertyHandler 是 BeanWrapperImpl 的内部类，是对 PropertyDescriptor 的封装，完成对属性的各种操作，如赋值。

(3) convertForProperty

convertForProperty 在 AbstractAutowireCapableBeanFactory#applyPropertyValues 属性注入时使用

public Object convertForProperty(@Nullable Object value, String propertyName) throws TypeMismatchException {

    CachedIntrospectionResults cachedIntrospectionResults = getCachedIntrospectionResults();

    PropertyDescriptor pd = cachedIntrospectionResults.getPropertyDescriptor(propertyName);

    if (pd == null) {

        throw new InvalidPropertyException(getRootClass(), getNestedPath() + propertyName,

                "No property '" + propertyName + "' found");

    }

    TypeDescriptor td = cachedIntrospectionResults.getTypeDescriptor(pd);

    if (td == null) {

        td = cachedIntrospectionResults.addTypeDescriptor(pd, new TypeDescriptor(property(pd)));

    }

    // 父类 AbstractNestablePropertyAccessor 进行类型转换

    return convertForProperty(propertyName, null, value, td);

}

// Property 也是对 PropertyDescriptor 封装，在 Android 等环境中不存在 PropertyDescriptor 类

private Property property(PropertyDescriptor pd) {

    GenericTypeAwarePropertyDescriptor gpd = (GenericTypeAwarePropertyDescriptor) pd;

    return new Property(gpd.getBeanClass(), gpd.getReadMethod(), gpd.getWriteMethod(), gpd.getName());

}

每天用心记录一点点。内容也许不重要，但习惯很重要！