io.polaris.core.asm.reflect

类 BeanCopier<S>

java.lang.Object

io.polaris.core.asm.reflect.BeanCopier<S>

public abstract class BeanCopier<S>
extends Object

提供Bean属性复制方法，包含基本方法与可定制方法。

• 基本方法：需要属性名完全匹配且字段类型兼容，复制过程忽略空值，非空值则直接覆盖目标属性值（无视目标属性原值），如提供类型转换器参数，则尽可能转换属性类型以适配目标
• 定制方法：可通过CopyOptions参数定制规则，CopyOptions参数默认值与基本复制方法规则保持一致，可定制如支持下划线与驼峰格式转换、不覆盖目标值、不忽略空值、属性key自定义转换、自定义类型转换器等规则

定制方法与基本方法相关性能会有所影响。

从以下版本开始:

Apr 14, 2024

作者:

Qt

字段概要

字段

限定符和类型	字段和说明
static String	FIELD_PREFIX_CLASS
static String	FIELD_PREFIX_TYPE
protected Map<String,BeanPropertyInfo>	properties
protected Class<S>	sourceType

构造器概要

构造器

限定符	构造器和说明
protected	BeanCopier()

方法概要

限定符和类型	方法和说明
protected Object	convert(Type type, Object value, BiFunction<Type,Object,Object> converter)
<T> void	copyBeanToBean(S source, Class<T> type, T target)
<T> void	copyBeanToBean(S source, Class<T> targetType, T target, CopyOptions options)
<T> void	copyBeanToBean(S source, T target)
<T> void	copyBeanToBean(S source, T target, CopyOptions options)
protected abstract void	copyBeanToBeanBySameType(S source, S target)
protected <T> void	copyBeanToBeanWithDynamicKeyMapping(BeanAccess<T> targetBeanAccess, T target, String sourceKey, String targetKey, Supplier<Object> valueSupplier, CopyOptions options, Set<String> targetKeys)
protected <T> void	copyBeanToBeanWithDynamicKeyMappings(BeanAccess<S> sourceBeanAccess, S source, BeanAccess<T> targetBeanAccess, T target, CopyOptions options, Set<String> targetKeys, List<Tuple2<BeanPropertyInfo,BeanPropertyInfo>> mapping)
abstract void	copyBeanToMap(S source, Map<String,Object> target)
void	copyBeanToMap(S source, Map<String,Object> target, CopyOptions options)
<K,V> void	copyBeanToMap(S source, Type targetType, Map<K,V> target, BiFunction<Type,Object,Object> converter)
<K,V> void	copyBeanToMap(S source, Type targetType, Map<K,V> target, CopyOptions options)
protected abstract void	copyBeanToMapByConverter(Object source, Map target, BiFunction<Type,Object,Object> converter, JavaType keyType, JavaType valueType)
protected abstract <K,V> void	copyBeanToMapByOptions(S source, Map<K,V> target, CopyOptions options, JavaType keyType, JavaType valueType)
protected void	copyBeanToMapWithKeyByOptions(Map target, CopyOptions options, JavaType keyType, JavaType valueType, String sourceKey, Object sourceValue)
abstract void	copyMapToBean(Map<String,Object> source, S target)
abstract void	copyMapToBean(Map<String,Object> source, S target, BiFunction<Type,Object,Object> converter)
void	copyMapToBean(Map<String,Object> source, S target, CopyOptions options)
protected abstract void	copyMapToBeanWithCamelToUnderlineKeys(Map<String,Object> source, Object target, CopyOptions options, Set<String> targetKeys)
protected abstract void	copyMapToBeanWithCapitalizeKeys(Map<String,Object> source, Object target, CopyOptions options, Set<String> targetKeys)
protected abstract void	copyMapToBeanWithCustomKeys(Map<String,Object> source, Object target, CopyOptions options, Set<String> targetKeys, Map<String,String> keyMapping)
protected abstract void	copyMapToBeanWithSameKeys(Map<String,Object> source, Object target, CopyOptions options, Set<String> targetKeys)
protected abstract void	copyMapToBeanWithUnderlineToCamelKeys(Map<String,Object> source, Object target, CopyOptions options, Set<String> targetKeys)
static <T> BeanCopier<T>	create(Class<T> type)
static <T> BeanCopier<T>	get(Class<T> type)
protected Type	getPropertyGenericType(String propertyName)
protected Class<?>	getPropertyType(String propertyName)
protected abstract void	initTypeFields()
protected void	resolveCopyError(String propertyName, Throwable e)
protected void	resolveCopyError(String propertyName, Throwable e, CopyOptions options)

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

FIELD_PREFIX_TYPE

public static final String FIELD_PREFIX_TYPE

另请参阅:

常量字段值

FIELD_PREFIX_CLASS

public static final String FIELD_PREFIX_CLASS

另请参阅:

常量字段值

sourceType

protected Class<S> sourceType

properties

protected Map<String,BeanPropertyInfo> properties

构造器详细资料

BeanCopier

protected BeanCopier()

方法详细资料

initTypeFields

protected abstract void initTypeFields()

copyBeanToMap

public abstract void copyBeanToMap(@Nonnull
                                   S source,
                                   @Nonnull
                                   Map<String,Object> target)

copyBeanToMap

public final <K,V> void copyBeanToMap(@Nonnull
                                      S source,
                                      @Nonnull
                                      Type targetType,
                                      @Nonnull
                                      Map<K,V> target,
                                      BiFunction<Type,Object,Object> converter)

copyBeanToMapByConverter

protected abstract void copyBeanToMapByConverter(@Nonnull
                                                 Object source,
                                                 @Nonnull
                                                 Map target,
                                                 BiFunction<Type,Object,Object> converter,
                                                 @Nonnull
                                                 JavaType keyType,
                                                 @Nonnull
                                                 JavaType valueType)

copyMapToBean

public abstract void copyMapToBean(@Nonnull
                                   Map<String,Object> source,
                                   @Nonnull
                                   S target)

copyMapToBean

public abstract void copyMapToBean(@Nonnull
                                   Map<String,Object> source,
                                   @Nonnull
                                   S target,
                                   BiFunction<Type,Object,Object> converter)

copyBeanToBean

public final <T> void copyBeanToBean(@Nonnull
                                     S source,
                                     @Nonnull
                                     T target)

copyBeanToBean

public final <T> void copyBeanToBean(@Nonnull
                                     S source,
                                     Class<T> type,
                                     @Nonnull
                                     T target)

copyBeanToBeanBySameType

protected abstract void copyBeanToBeanBySameType(@Nonnull
                                                 S source,
                                                 @Nonnull
                                                 S target)

copyBeanToMap

public final void copyBeanToMap(@Nonnull
                                S source,
                                @Nonnull
                                Map<String,Object> target,
                                @Nonnull
                                CopyOptions options)

copyBeanToMap

public final <K,V> void copyBeanToMap(@Nonnull
                                      S source,
                                      @Nonnull
                                      Type targetType,
                                      @Nonnull
                                      Map<K,V> target,
                                      @Nonnull
                                      CopyOptions options)

copyBeanToMapByOptions

protected abstract <K,V> void copyBeanToMapByOptions(@Nonnull
                                                     S source,
                                                     @Nonnull
                                                     Map<K,V> target,
                                                     @Nonnull
                                                     CopyOptions options,
                                                     @Nonnull
                                                     JavaType keyType,
                                                     @Nonnull
                                                     JavaType valueType)

copyBeanToMapWithKeyByOptions

protected final void copyBeanToMapWithKeyByOptions(@Nonnull
                                                   Map target,
                                                   @Nonnull
                                                   CopyOptions options,
                                                   @Nonnull
                                                   JavaType keyType,
                                                   @Nonnull
                                                   JavaType valueType,
                                                   String sourceKey,
                                                   Object sourceValue)

copyMapToBean

public final void copyMapToBean(@Nonnull
                                Map<String,Object> source,
                                @Nonnull
                                S target,
                                @Nonnull
                                CopyOptions options)

copyMapToBeanWithCustomKeys

protected abstract void copyMapToBeanWithCustomKeys(@Nonnull
                                                    Map<String,Object> source,
                                                    @Nonnull
                                                    Object target,
                                                    @Nonnull
                                                    CopyOptions options,
                                                    @Nonnull
                                                    Set<String> targetKeys,
                                                    @Nonnull
                                                    Map<String,String> keyMapping)

copyMapToBeanWithSameKeys

protected abstract void copyMapToBeanWithSameKeys(@Nonnull
                                                  Map<String,Object> source,
                                                  @Nonnull
                                                  Object target,
                                                  @Nonnull
                                                  CopyOptions options,
                                                  @Nonnull
                                                  Set<String> targetKeys)

copyMapToBeanWithCapitalizeKeys

protected abstract void copyMapToBeanWithCapitalizeKeys(@Nonnull
                                                        Map<String,Object> source,
                                                        @Nonnull
                                                        Object target,
                                                        @Nonnull
                                                        CopyOptions options,
                                                        @Nonnull
                                                        Set<String> targetKeys)

copyMapToBeanWithUnderlineToCamelKeys

protected abstract void copyMapToBeanWithUnderlineToCamelKeys(@Nonnull
                                                              Map<String,Object> source,
                                                              @Nonnull
                                                              Object target,
                                                              @Nonnull
                                                              CopyOptions options,
                                                              @Nonnull
                                                              Set<String> targetKeys)

copyMapToBeanWithCamelToUnderlineKeys

protected abstract void copyMapToBeanWithCamelToUnderlineKeys(@Nonnull
                                                              Map<String,Object> source,
                                                              @Nonnull
                                                              Object target,
                                                              @Nonnull
                                                              CopyOptions options,
                                                              @Nonnull
                                                              Set<String> targetKeys)

copyBeanToBean

public final <T> void copyBeanToBean(@Nonnull
                                     S source,
                                     @Nonnull
                                     T target,
                                     @Nonnull
                                     CopyOptions options)

copyBeanToBean

public final <T> void copyBeanToBean(@Nonnull
                                     S source,
                                     @Nonnull
                                     Class<T> targetType,
                                     @Nonnull
                                     T target,
                                     @Nonnull
                                     CopyOptions options)

copyBeanToBeanWithDynamicKeyMappings

protected final <T> void copyBeanToBeanWithDynamicKeyMappings(@Nonnull
                                                              BeanAccess<S> sourceBeanAccess,
                                                              @Nonnull
                                                              S source,
                                                              @Nonnull
                                                              BeanAccess<T> targetBeanAccess,
                                                              @Nonnull
                                                              T target,
                                                              @Nonnull
                                                              CopyOptions options,
                                                              @Nonnull
                                                              Set<String> targetKeys,
                                                              @Nonnull
                                                              List<Tuple2<BeanPropertyInfo,BeanPropertyInfo>> mapping)

copyBeanToBeanWithDynamicKeyMapping

protected final <T> void copyBeanToBeanWithDynamicKeyMapping(@Nonnull
                                                             BeanAccess<T> targetBeanAccess,
                                                             @Nonnull
                                                             T target,
                                                             @Nonnull
                                                             String sourceKey,
                                                             @Nonnull
                                                             String targetKey,
                                                             @Nonnull
                                                             Supplier<Object> valueSupplier,
                                                             @Nonnull
                                                             CopyOptions options,
                                                             @Nonnull
                                                             Set<String> targetKeys)

resolveCopyError

protected final void resolveCopyError(String propertyName,
                                      Throwable e)

resolveCopyError

protected final void resolveCopyError(@Nonnull
                                      String propertyName,
                                      @Nonnull
                                      Throwable e,
                                      @Nonnull
                                      CopyOptions options)

getPropertyGenericType

protected final Type getPropertyGenericType(@Nonnull
                                            String propertyName)

getPropertyType

protected final Class<?> getPropertyType(@Nonnull
                                         String propertyName)

convert

protected final Object convert(@Nonnull
                               Type type,
                               Object value,
                               BiFunction<Type,Object,Object> converter)

get

public static <T> BeanCopier<T> get(@Nonnull
                                    Class<T> type)

create

public static <T> BeanCopier<T> create(@Nonnull
                                       Class<T> type)