Class BeanCopier

java.lang.Object
com.sure.tool.bean.BeanCopier

public final class BeanCopier extends Object
属性拷贝门面:在 BeanUtil 之上提供选项化与链式 API。

与 BeanUtil.copyProperties(Object, T, String...) 的差异:

Since:
1.18.0
  • Method Details

    • copy

      public static <T> T copy(Object source, Class<T> targetClass)
      拷贝为新目标对象(默认浅拷贝)。
      Type Parameters:
      T - 目标类型
      Parameters:
      source - 源对象
      targetClass - 目标类型(需有无参构造器)
      Returns:
      新目标对象
      Throws:
      CopyException - 目标实例化失败、属性只读或类型转换失败
    • copy

      public static <T> T copy(Object source, Class<T> targetClass, CopyOption... options)
      拷贝为新目标对象。
      Type Parameters:
      T - 目标类型
      Parameters:
      source - 源对象
      targetClass - 目标类型(需有无参构造器)
      options - 拷贝选项
      Returns:
      新目标对象
      Throws:
      CopyException - 目标实例化失败、属性只读或类型转换失败
    • copy

      public static void copy(Object source, Object target)
      拷贝到已有目标对象。
      Parameters:
      source - 源对象
      target - 目标对象
      Throws:
      CopyException - 属性只读或类型转换失败
    • copy

      public static void copy(Object source, Object target, CopyOption... options)
      拷贝到已有目标对象。
      Parameters:
      source - 源对象
      target - 目标对象
      options - 拷贝选项
      Throws:
      CopyException - 属性只读或类型转换失败
    • deepCopy

      public static <T> T deepCopy(Object source, Class<T> targetClass)
      深拷贝为新目标对象(等价于 copy(source, targetClass, CopyOption.DEEP))。
      Type Parameters:
      T - 目标类型
      Parameters:
      source - 源对象
      targetClass - 目标类型
      Returns:
      深拷贝后的新目标对象
    • toBean

      public static <T> T toBean(Map<String,?> map, Class<T> beanClass)
      Map 转 Bean(带类型转换,支持枚举 String 转换)。
      Type Parameters:
      T - Bean 类型
      Parameters:
      map - Map(key 为属性名)
      beanClass - Bean 类型
      Returns:
      Bean 实例
      Throws:
      CopyException - 目标实例化失败或属性转换失败
    • toMap

      public static Map<String,Object> toMap(Object bean)
      Bean 转 Map(含 null 值)。
      Parameters:
      bean - Bean 对象
      Returns:
      Map(key 为属性名)
    • of

      public static BeanCopier.Copier of(Object source)
      链式拷贝入口。
      Parameters:
      source - 源对象
      Returns:
      链式拷贝器