克隆对象的方法

cn.hutool.core.bean.BeanUtil

cn.hutool.core.bean.BeanUtil是Hutool工具库中提供的一个用于处理JavaBean相关操作的工具类，主要包括对象属性的拷贝、Bean与Map之间的转换等功能。以下是BeanUtil的一些主要方法和特性：

1. 对象转Map

beanToMap(Object bean, boolean isToUnderlineCase, boolean ignoreNullValue)：将对象转换为Map，可以指定是否将字段名转换为下划线命名法，以及是否忽略null值。

2. 对象转Map（自定义字段值）

beanToMap(Object bean, Map<String, Object> targetMap, boolean ignoreNullValue, Editor<String> keyEditor)：对象转Map，可通过实现Editor接口自定义字段值。

3. 对象属性拷贝

copyProperties(Object source, Object target, String... ignoreProperties)：复制Bean对象属性，可以指定忽略某些属性。

4. 对象属性拷贝（使用CopyOptions）

copyProperties(Object source, Object target, CopyOptions copyOptions)：复制Bean对象属性，使用CopyOptions可以自定义更多拷贝选项。

5. 属性忽略

能实现忽略属性相关操作。

6. List转换

copyToList(Collection<?> collection, Class<T> targetType)：复制集合中的Bean属性到新的 List 中。

7. Bean转换为另一个Bean

toBean(Object source, Class<T> targetType)：将一个Bean转换为另一个Bean类型。

8. Bean属性注入

fillBeanWithMap(Map<String, Object> map, Object bean)：使用Map填充Bean属性。

9. 内省Introspector

Hutool提供了对Java内省的封装，包括获取Bean字段描述数组、字段名和字段描述Map等。

BeanUtil的这些方法使得在处理JavaBean时更加方便和高效，尤其是在对象属性拷贝和转换时，无需手动编写大量的模板代码。通过BeanUtil，可以简化代码，提高开发效率，并减少因手动拷贝属性而导致的错误。

cn.hutool.core.bean.BeanUtil#copyToList(java.util.Collection<?>, java.lang.Class)

cn.hutool.core.bean.BeanUtil#copyToList 是Hutool工具库中的一个方法，它用于将一个JavaBean集合中的属性复制到另一个相同结构的JavaBean集合中。这个方法的具体介绍如下：

1. 功能描述

BeanUtil#copyToList方法接受两个参数：一个 Collection<?> 类型的源集合和一个 Class<T> 类型的目标类型。它将遍历源集合中的每个Bean，复制其属性到新创建的目标Bean实例中，并将这些新实例收集到一个新的List中返回。

2. 使用方法

// 不带额外参数的方法调用
List<TargetBean> targetList = BeanUtil.copyToList(sourceList, TargetBean.class);

// 带 CopyOptions 参数的方法调用
List<TargetBean> targetListWithOptions = BeanUtil.copyToList(sourceList, TargetBean.class, copyOptions);

该方法有两种重载形式，一种不接受任何额外的参数，另一种接受CopyOptions参数以提供更多的自定义拷贝选项。

3. 属性忽略

能实现忽略属性相关操作。

4. 性能和类型安全

此方法利用Hutool的BeanCopier机制，确保类型安全，并在内部处理属性名的匹配和拷贝，无需使用反射，从而提高性能。

5. 应用场景

当需要将一个对象列表转换为另一个类型的对象列表时，例如DTO转换、VO转换等场景，这个方法非常有用。

6. 代码示例

List<UserDTO> userDTOs = BeanUtil.copyToList(userList, UserDTO.class);

7. 注意事项

源集合中的每个对象和目标类型的属性必须匹配，否则拷贝可能会失败或丢失数据。

8. Hutool 版本要求

确保使用的Hutool版本支持BeanUtil#copyToList方法。

BeanUtil#copyToList 方法是 Hutool 提供的一个强大工具，可以简化集合拷贝的复杂性，提高开发效率。

cn.hutool.extra.cglib.CglibUtil#copy(java.lang.Object, java.lang.Class)

cn.hutool.extra.cglib.CglibUtil#copy是Hutool工具库中提供的一个方法，用于实现对象属性的拷贝。以下是关于这个方法的一些关键信息：

1. 功能描述

CglibUtil#copy方法用于拷贝Bean对象的属性到目标类型的对象中。此方法通过指定目标类型自动创建目标对象实例，然后拷贝属性。

2. 性能优势

Cglib的性能是目前公认的最好的，其时间主要耗费在BeanCopier创建上。Hutool根据传入的Class不同，缓存了BeanCopier对象，使性能达到最佳。

3. 使用方法

SampleBean bean = new SampleBean();
bean.setValue("Hello world");
OtherSampleBean otherBean = CglibUtil.copy(bean, OtherSampleBean.class);
// 值为"Hello world"
System.out.println(otherBean.getValue());

OtherSampleBean otherBean = new OtherSampleBean();
CglibUtil.copy(bean, otherBean);

CglibUtil.copy(bean, otherBean, new Converter() {
    @Override
    public Object convert(Object value, Class<?> targetClass, Object inject);
});

1. 可以直接拷贝源对象到目标对象，也可以拷贝到目标类的实例。
2. 如果目标对象已经存在，也可以直接传入目标对象进行属性拷贝。
3. 还可以通过自定义的`Converter`进行属性值的转换。

4. 静态方法

CglibUtil类中的copy方法是静态方法，可以直接通过类名调用，无需创建CglibUtil类的实例。

5. 泛型支持

方法支持泛型，可以指定目标对象的具体类型，使得代码更加灵活和安全。

6. 属性忽略

不能实现忽略属性相关操作。

7. API文档

Hutool提供了详细的API文档，其中包含了CglibUtil类和copy方法的详细描述和使用示例。

8. Maven依赖冲突

使用的时候需要确认项目中是否会出现Maven依赖冲突的问题，可以点进方法的源码看类上面有没有正常导包，可以通过加入【cglib】依赖依赖解决。

<dependency>
  <groupId>cglib</groupId>
  <artifactId>cglib</artifactId>
  <version>合适的版本号</version>
</dependency>

CglibUtil#copy方法因其高性能和易用性，成为Hutool工具库中处理对象拷贝的推荐方法之一。

cn.hutool.extra.cglib.CglibUtil#copyList(java.util.Collection, java.util.function.Supplier)

cn.hutool.extra.cglib.CglibUtil#copyList是Hutool工具库中的一个方法，它用于拷贝一个列表（Collection）中的对象到另一个相同结构的列表中，其中列表中的每个对象都会使用CGLib进行深拷贝。这个方法特别适合于需要对整个对象列表进行复制的场景，比如在多线程环境中或者需要保留原列表不变的情况下创建一个新的列表副本。

以下是CglibUtil#copyList方法的一些关键点：

1. 泛型方法

copyList方法是泛型的，允许你指定源列表和目标列表对象的具体类型。

2. 使用Supplier进行实例化

方法接受一个Supplier<T>接口实现，用于为目标列表中的每个元素创建新的实例。

3. 无参方法签名

public static <S, T> List<T> copyList(Collection<S> source, Supplier<T> target);

这个方法接受一个Collection<S>类型的源列表和一个Supplier<T>类型的目标对象构造器，返回一个 List<T>类型的新列表，其中包含了源列表中每个对象的深拷贝。

4. 属性忽略

不能实现忽略属性相关操作。

5. 示例代码

List<SourceBean> sourceList = //... 初始化源列表
List<TargetBean> targetList = CglibUtil.copyList(sourceList, TargetBean::new);

在这个示例中，SourceBean是源列表中的对象类型，TargetBean是目标列表中的对象类型，TargetBean::new是一个方法引用，用于创建TargetBean的新实例。

6. 性能优势

由于Hutool对CGLib进行了封装，并且缓存了BeanCopier对象，使得copyList方法在性能上有很好的表现，尤其是在频繁进行对象拷贝的场景下。

7. 灵活性

除了基本的拷贝功能，CglibUtil#copyList还允许自定义转换器（Converter）和回调（BiConsumer），以处理更复杂的拷贝场景。

这个方法是 Hutool 提供的高效对象拷贝解决方案的一部分，特别适合在需要高性能对象拷贝时使用。

8. Maven依赖冲突

使用的时候需要确认项目中是否会出现maven依赖冲突的问题，可以点进方法的源码看类上面有没有正常导包，可以通过加入【cglib】依赖依赖解决。

<dependency>
  <groupId>cglib</groupId>
  <artifactId>cglib</artifactId>
  <version>2.2</version>
</dependency>

org.apache.commons.lang3.SerializationUtils#clone

org.apache.commons.lang3.SerializationUtils#clone是Apache Commons Lang库提供的一个方法，用于创建一个对象的深拷贝。这个方法基于Java序列化机制来实现对象的克隆，因此要求被克隆的对象及其所有成员变量都必须实现java.io.Serializable接口。

以下是SerializationUtils.clone方法的一些关键点：

1. 深拷贝

SerializationUtils.clone方法创建的是对象的深拷贝，意味着不仅复制了对象本身，还复制了对象中所有非瞬态和非静态的成员变量。

2. 序列化要求

为了使用这个方法，对象及其所有成员变量都必须是可序列化的。如果对象或其任何成员变量没有实现Serializable接口，将会抛出NotSerializableException。

3. 性能

由于这个方法依赖于Java的序列化和反序列化机制，因此可能不如一些专门的克隆库性能高。序列化和反序列化过程相对较慢，尤其是在处理大型对象或复杂对象图时。

4. 线程安全

SerializationUtils.clone方法是线程安全的，可以在多线程环境中使用。

5. 使用简单

使用这个方法不需要编写复杂的克隆逻辑，只需调用一个方法即可完成对象的克隆。

6. 异常处理

使用SerializationUtils.clone方法时，需要准备好处理可能抛出的SerializationException，这包括NotSerializableException和其他与序列化相关的问题。

7. 示例代码：

import org.apache.commons.lang3.SerializationUtils;

public class Example {
    public static void main(String[] args) {
        MySerializableObject original = new MySerializableObject();
        MySerializableObject cloned = SerializationUtils.clone(original);
        // 现在 cloned 是 original 的深拷贝
    }
}

在实际应用中，如果对象结构简单且对性能要求不高，SerializationUtils.clone 方法可以作为一个快速且简单的深拷贝解决方案。然而，如果性能是一个关键因素，或者对象结构复杂，可能需要考虑其他更高效的克隆方法，如手动实现克隆逻辑或使用其他第三方库。

总结

方法	类库	功能描述	拷贝类型	备注
cn.hutool.core.bean.BeanUtil	Hutool Core Bean	提供了一系列方法，用于对象属性的拷贝。	浅拷贝	适用于简单的Bean 属性拷贝。
cn.hutool.core.bean.BeanUtil#copyToList(java.util.Collection<?>, java.lang.Class<T>)	Hutool Core Bean	将源集合中的每个对象复制到新的目标集合中，使用反射或BeanCopier 进行属性拷贝。	浅拷贝	适用于集合的拷贝，使用反射或BeanCopier 实现属性拷贝。
cn.hutool.extra.cglib.CglibUtil#copy(java.lang.Object, java.lang.Class<T>)	Hutool Extra Cglib	使用CGLib动态生成目标对象的子类，并复制属性。	浅拷贝	适用于不需要深拷贝的场景。
cn.hutool.extra.cglib.CglibUtil#copyList(java.util.Collection<S>, java.util.function.Supplier<T>)	Hutool Extra Cglib	将源集合中的每个对象复制到新的目标集合中，使用 CGLib创建目标对象实例。	浅拷贝	适用于集合的拷贝，创建目标集合的新实例。
org.apache.commons.lang3.SerializationUtils#clone	Apache Commons Lang3	基于序列化和反序列化实现对象的深拷贝。	深拷贝	要求对象及其所有成员变量实现Serializable接口。