**


《手册》第 10 页有关于

  1. Object


  1. clone


问题的描述 1
【推荐】慎用 Object 的 clone 方法来拷贝对象。
说明:对象 clone 方法默认是浅拷贝,若想实现深拷贝需覆写 clone 方法实现域对象的深度遍历式拷贝。

那么我们要思考几个问题:

  1. 什么是浅拷贝?
  2. 浅拷贝和深拷贝的区别是什么?
  3. 拷贝的目的是什么?
  4. 拷贝的使用场景是什么?
  5. 如何实现深拷贝?

网上也有很多介绍浅拷贝和深拷贝的文章,但文章质量参差不齐,有些文章读完仍然对概念得理解非常含糊。读完这些文章对拷贝的使用场景,对深拷贝的实现方式等都无法有全面和深刻的理解。
为此本节将带着大家系统地研究这上述问题,以便大家未来遇到类似问题时可以举一反三,灵活迁移。

**

**


我们先研究第 1 个问题:什么是拷贝?
维基百科对 “克隆” 的描述如下 2
克隆 (英语: Clone) 在广义上是指利用生物技术由无性生殖产生与原原个体有完全相同基因组之后代的过程。
在园艺学上,克隆指通过营养繁殖产生的单一植株的后代,很多植物都是通过克隆这样的无性繁殖方式从单一植株获得大量的子代个体。
在生物学上,是指选择性地复制出一段 DNA 序列(分子克隆)、细胞(细胞克隆)或个体(个体克隆)。
克隆一个生物体意味着创造一个与原先的生物体具有完全一样的遗传信息的新生物体。

计算机中的拷贝或克隆和上述概念很类似,可以类比理解。
对象的拷贝,就是根据原来的对象 “复制” 一份属性、状态一致的新的对象。

**


我们思考第 2 个问题:为什么需要拷贝呢?
我们来看下面的订单类和商品类。
订单类(

  1. Order


):

  1. @Data
  2. public class Order {
  3. private Long id;
  4. private String orderNo;
  5. private List<Item> itemList;
  6. }

商品类( Item` ):

  1. @Data
  2. public class Item {
  3. private Long id;
  4. private Long itemId;
  5. private String name;
  6. private String desc;
  7. // 省略其他
  8. }

如果我们查询得到 1 个订单对象,该对象包括 6 个商品对象。
如果我们还需要构造多个新的订单对象,属性和上述订单对象非常相似,只是订单号不同或者商品略有区别。
这时如果有一个 “复制” 方法,可以将订单复制一个副本,而且修改副本中的订单号和商品列表 (

  1. itemList


) 不影响原始对象,是不是很方便?
另外一个非常典型的场景是在多线程中。如果只用一个主线程,在主线程中修改订单号分别调用

  1. doSomeThing


函数,想分别打印 first 和 second 两个订单编号字符串。

  1. @Slf4j
  2. public class CloneDemo {
  3. public static void main(String[] args) {
  4. Order order = OrderMocker.mock();
  5. order.setOrderNo("first");
  6. doSomeThing(order);
  7. order.setOrderNo("second");
  8. doSomeThing(order);
  9. }
  10. private static void doSomeThing(Order order) {
  11. try {
  12. TimeUnit.SECONDS.sleep(1L);
  13. } catch (InterruptedException e) {
  14. e.printStackTrace();
  15. }
  16. System.out.println(order.getOrderNo());
  17. }
  18. }

运行程序后输出的结果的确是:

  1. first


  1. second



但在多线程环境中,如果我们不通过克隆构造新的对象,线程池中两个线程会公用同一个对象,后面对订单号的修改将影响到其它线程。

  1. @Slf4j
  2. public class CloneDemo {
  3. public static void main(String[] args) {
  4. ExecutorService executorService = Executors.newFixedThreadPool(5);
  5. Order order = OrderMocker.mock();
  6. order.setOrderNo("first");
  7. executorService.execute(() -> doSomeThing(order));
  8. order.setOrderNo("second");
  9. executorService.execute(() -> doSomeThing(order));
  10. }
  11. private static void doSomeThing(Order order) {
  12. try {
  13. TimeUnit.SECONDS.sleep(1L);
  14. } catch (InterruptedException e) {
  15. e.printStackTrace();
  16. }
  17. System.out.println(order.getOrderNo());
  18. }
  19. }

输出的结果是:

  1. second


  1. second



因此如果能够克隆一个新的对象,并且对新对象的修改不影响原始对象,就能实现我们期待的效果。

**


通过前言部分的介绍,我们知道

  1. Object


  1. clone


函数默认是浅拷贝。
按照惯例我们进入源码,看看是否能够得到我们想要的答案:

  1. /**
  2. * Creates and returns a copy of this object. The precise meaning
  3. * of "copy" may depend on the class of the object. The general
  4. * intent is that, for any object {@code x}, the expression:
  5. * <blockquote>
  6. * <pre>
  7. * x.clone() != x</pre></blockquote>
  8. * will be true, and that the expression:
  9. * <blockquote>
  10. * <pre>
  11. * x.clone().getClass() == x.getClass()</pre></blockquote>
  12. * will be {@code true}, but these are not absolute requirements.
  13. * While it is typically the case that:
  14. * <blockquote>
  15. * <pre>
  16. * x.clone().equals(x)</pre></blockquote>
  17. * will be {@code true}, this is not an absolute requirement.
  18. * <p>
  19. * By convention, the returned object should be obtained by calling
  20. * {@code super.clone}. If a class and all of its superclasses (except
  21. * {@code Object}) obey this convention, it will be the case that
  22. * {@code x.clone().getClass() == x.getClass()}.
  23. * <p>
  24. * By convention, the object returned by this method should be independent
  25. * of this object (which is being cloned). To achieve this independence,
  26. * it may be necessary to modify one or more fields of the object returned
  27. * by {@code super.clone} before returning it. Typically, this means
  28. * copying any mutable objects that comprise the internal "deep structure"
  29. * of the object being cloned and replacing the references to these
  30. * objects with references to the copies. If a class contains only
  31. * primitive fields or references to immutable objects, then it is usually
  32. * the case that no fields in the object returned by {@code super.clone}
  33. * need to be modified.
  34. * <p>
  35. * The method {@code clone} for class {@code Object} performs a
  36. * specific cloning operation. First, if the class of this object does
  37. * not implement the interface {@code Cloneable}, then a
  38. * {@code CloneNotSupportedException} is thrown. Note that all arrays
  39. * are considered to implement the interface {@code Cloneable} and that
  40. * the return type of the {@code clone} method of an array type {@code T[]}
  41. * is {@code T[]} where T is any reference or primitive type.
  42. * Otherwise, this method creates a new instance of the class of this
  43. * object and initializes all its fields with exactly the contents of
  44. * the corresponding fields of this object, as if by assignment; the
  45. * contents of the fields are not themselves cloned. Thus, this method
  46. * performs a "shallow copy" of this object, not a "deep copy" operation.
  47. * <p>
  48. * The class {@code Object} does not itself implement the interface
  49. * {@code Cloneable}, so calling the {@code clone} method on an object
  50. * whose class is {@code Object} will result in throwing an
  51. * exception at run time.
  52. *
  53. * @return a clone of this instance.
  54. * @throws CloneNotSupportedException if the object's class does not
  55. * support the {@code Cloneable} interface. Subclasses
  56. * that override the {@code clone} method can also
  57. * throw this exception to indicate that an instance cannot
  58. * be cloned.
  59. * @see java.lang.Cloneable
  60. */
  61. protected native Object clone() throws CloneNotSupportedException;

该函数给出了非常详尽的介绍。下面给出一些要点的翻译:
该方法是创建对象的副本。这就意味着 “副本” 依赖于该对象的类型。
对于任何对象而言,一般来说下面的表达式成立:x.clone() != x
的结果为 true。x.clone().getClass() == x.getClass()

的结果为 true 。
但是这些也不是强制的要求。x.clone().equals(x) 的结果也是 true

。这也不是强制要求。
按照惯例,返回对象应该通过调用

  1. super.clone


函数来构造。如果一个类和它的所有父类(除了

  1. Object


)都遵循这个约定,那么

  1. x.clone().getClass() == x.getClass()


将成立。
按照惯例,返回的对象应该和原始对象是独立的。
为了实现这种独立性,后续应该在调用

  1. super.clone


得到拷贝对象并返回之前,应该对内部深层次的可变对象创建副本并指向克隆对象的对应属性的引用。
如果一个类只包含基本类型的属性或者指向不可变对象的引用,这种情况下,

  1. super.clone


返回的对象不需要被修改。
如果调用

  1. clone


函数的类没有实现

  1. Cloneable


接口将会抛出

  1. CloneNotSupportedException



注意所有的数组对象都默认实现了

  1. Cloneable


接口。
该函数会创建该类的新实例,并初始化所有属性对象。属性对象本身并不会自动调用

  1. clone



因此此方法实现的是浅拷贝而不是深拷贝。

因此我们可以了解到,浅拷贝将返回该类的新的实例,该实例的引用类型对象共享。
深拷贝也会返回该类的新的实例,但是该实例的引用类型属性也是拷贝的新对象。
如果用一句话来描述,浅拷贝和深拷贝的主要区别在于对于引用类型是否共享。
04 学习浅拷贝和深拷贝的正确方法 - 图1
为了更好地理解浅拷贝,我们给出一个示例:
改造订单对象:

  1. @Data
  2. public class Order implements Cloneable {
  3. private Long id;
  4. private String orderNo;
  5. private List<Item> itemList;
  6. @Override
  7. public Order clone() {
  8. try {
  9. return (Order)super.clone();
  10. } catch (CloneNotSupportedException ignore) {
  11. // 不会调到这里
  12. }
  13. return null;
  14. }
  15. }

通过

  1. Object


类的

  1. clone


函数的注释我们了解到:如果调用

  1. clone


函数的类没有实现

  1. Cloneable


接口将会抛出

  1. CloneNotSupportedException



因此要实现

  1. Cloneable


接口。
重写

  1. clone


函数是为了供外部使用,因此定义为

  1. public



返回值类型定义为客户端直接需要的对象类型(本类)。
这体现了《Effective Java》的 Item 11 中所提到的 3
Never make the client do anything the library can do for the client.
不要让客户端去做任何类库可以替它完成的事。

我们为上述浅拷贝编写测试代码:

  1. public class OrderMocker {
  2. public static Order mock() {
  3. Order order = new Order();
  4. order.setId(1L);
  5. order.setOrderNo("abcdefg");
  6. List<Item> items = new ArrayList<>();
  7. Item item = new Item();
  8. item.setId(0L);
  9. item.setItemId(0L);
  10. item.setName("《阿里巴巴Java开发手册》详解慕课专栏");
  11. item.setDesc("精品推荐");
  12. items.add(item);
  13. order.setItemList(items);
  14. return order;
  15. }
  16. }
  1. @Test
  2. public void shallowClone() {
  3. Order order = OrderMocker.mock();
  4. Order cloneOrder = order.clone();
  5. assertFalse(order == cloneOrder);
  6. assertTrue(order.getItemList() == cloneOrder.getItemList());
  7. }

该单元测试可以通过,从而证实了

  1. clone


函数的注释,证实了浅拷贝的表现。
即浅拷贝后,原对象的订单列表和克隆对象的订单列表地址相同。
因此如果使用浅拷贝,修改拷贝订单的商品列表,那么原始订单对象的商品列表也会受到影响。
为了更形象地理解浅拷贝和深拷贝的概念,我们以文件夹进行类比:
浅拷贝:同一个文件夹的两个快捷方式,虽然是两个不同的快捷方式,但是指向的文件夹是同一个,不管是通过哪个快捷方式进入,对该文件夹下的文件修改,相互影响。
深拷贝:我们复制某个文件夹(含里面的内容)在另外一个目录进行粘贴,就可得到具有相同内容的新目录,对新文件夹修改不影响原始文件夹。

**


虽然浅拷贝能够实现拷贝的功能,但是浅拷贝的引用类型成员变量是共享的,修改极可能导致相互影响。
业务开发中使用深拷贝更多一些,那么实现深拷贝有哪些方式呢?

**


  1. @Data
  2. public class Order implements Cloneable {
  3. private Long id;
  4. private String orderNo;
  5. private List<Item> itemList;
  6. @Override
  7. public Order clone() {
  8. try {
  9. Order order = (Order) super.clone();
  10. if (id != null) {
  11. order.id = new Long(id);
  12. }
  13. if (orderNo != null) {
  14. order.orderNo = new String(orderNo);
  15. }
  16. if (itemList != null) {
  17. List<Item> items = new ArrayList<>();
  18. for (Item each : itemList) {
  19. Item item = new Item();
  20. Long id = each.getId();
  21. if(id != null){
  22. item.setId(new Long(id));
  23. }
  24. Long itemId = each.getItemId();
  25. if(itemId != null){
  26. item.setItemId(new Long(itemId));
  27. }
  28. String name = each.getName();
  29. if(name != null){
  30. item.setName(new String(name));
  31. }
  32. String desc = each.getDesc();
  33. if(desc != null){
  34. item.setDesc(new String(desc));
  35. }
  36. items.add(item);
  37. }
  38. order.setItemList(items);
  39. }
  40. return order;
  41. } catch (CloneNotSupportedException ignore) {
  42. }
  43. return null;
  44. }
  45. }

深拷贝也调用

  1. super.clone


是为了支撑

  1. x.clone().getClass() == x.getClass()



写好代码后,通过调用

  1. Order


类的

  1. clone


函数即可实现深拷贝。
由于克隆的对象和内部的引用类型的属性全部都是依据原始对象新建的对象,因此如果修改拷贝对象的商品列表,原始订单对象的商品列表并不会受到影响。
通过下面的单元测试来验证:

  1. @Test
  2. public void deepClone() {
  3. Order order = OrderMocker.mock();
  4. Order cloneOrder = (Order) order.clone();
  5. assertFalse(order == cloneOrder);
  6. assertFalse(order.getItemList() == cloneOrder.getItemList());
  7. }

该单测可顺利通过。

**


前面章节我们讲到了序列化和反序列化的知识,讲到了序列化的主要使用场景包括深拷贝。
序列化通过将原始对象转化为字节流,再从字节流重建新的 Java 对象,因此原始对象和反序列化后的对象修改互不影响。
因此可以使用之前讲到的序列化和反序列化方式来实现深拷贝。

**


如果我们不想为了深拷贝这一项功能就依赖新的 jar 包,可以在自己项目中借助对象输入和输出流编写拷贝工具函数。
示例代码如下:

  1. /**
  2. * JDK序列化方式深拷贝
  3. */
  4. public static <T> T deepClone(T origin) throws IOException, ClassNotFoundException {
  5. ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
  6. try (ObjectOutputStream objectOutputStream = new ObjectOutputStream(outputStream);) {
  7. objectOutputStream.writeObject(origin);
  8. objectOutputStream.flush();
  9. }
  10. byte[] bytes = outputStream.toByteArray();
  11. try (ByteArrayInputStream inputStream = new ByteArrayInputStream(bytes);) {
  12. return JdkSerialUtil.readObject(inputStream);
  13. }
  14. }

我们可通过调试查看克隆对象和原始对象。
从下图中我们可以清晰地看到,通过此方法克隆得到的新的对象是一个全新的对象。
04 学习浅拷贝和深拷贝的正确方法 - 图2
需要注意的是:正如前面章节所讲,Java 序列化需要实现

  1. Serializable


接口,而且效率不是特别高。

**


我们可以利用项目中引用的常见工具包的工具类实现深拷贝,避免重复造轮子。
可以使用 commons-lang3 (3.7 版本)的序列化工具类:

  1. org.apache.commons.lang3.SerializationUtils#clone



用法非常简单:

  1. @Test
  2. public void serialUtil() {
  3. Order order = OrderMocker.mock();
  4. // 使用方式
  5. Order cloneOrder = SerializationUtils.clone(order);
  6. assertFalse(order == cloneOrder);
  7. assertFalse(order.getItemList() == cloneOrder.getItemList());
  8. }

前面反复提到过,我们学习知识不仅要知其然,而且要知其所以然。
那么它是如何实现深拷贝的呢?
按照惯例我们打开源码:

  1. /**
  2. * <p>Deep clone an {@code Object} using serialization.</p>
  3. *
  4. * <p>This is many times slower than writing clone methods by hand
  5. * on all objects in your object graph. However, for complex object
  6. * graphs, or for those that don't support deep cloning this can
  7. * be a simple alternative implementation. Of course all the objects
  8. * must be {@code Serializable}.</p>
  9. *
  10. * @param <T> the type of the object involved
  11. * @param object the {@code Serializable} object to clone
  12. * @return the cloned object
  13. * @throws SerializationException (runtime) if the serialization fails
  14. */
  15. public static <T extends Serializable> T clone(final T object) {
  16. if (object == null) {
  17. return null;
  18. }
  19. final byte[] objectData = serialize(object);
  20. final ByteArrayInputStream bais = new ByteArrayInputStream(objectData);
  21. try (ClassLoaderAwareObjectInputStream in = new ClassLoaderAwareObjectInputStream(bais,
  22. object.getClass().getClassLoader())) {
  23. /*
  24. * when we serialize and deserialize an object,
  25. * it is reasonable to assume the deserialized object
  26. * is of the same type as the original serialized object
  27. */
  28. @SuppressWarnings("unchecked") // see above
  29. final T readObject = (T) in.readObject();
  30. return readObject;
  31. } catch (final ClassNotFoundException ex) {
  32. throw new SerializationException("ClassNotFoundException while reading cloned object data", ex);
  33. } catch (final IOException ex) {
  34. throw new SerializationException("IOException while reading or closing cloned object data", ex);
  35. }
  36. }

通过其返回值的泛型描述

  1. <T extends Serializable>


可以断定参数对象需要实现序列化接口。
该函数注释也给出了性能说明,该深拷贝方法性能不如直接手动写

  1. clone


方法效率高。
大家可以进到该方法的子函数中查看更多细节。
通过源码的分析我们发现,该克隆函数本质上也是通过 Java 序列化和反序列化方式实现。

**


我们还可以通过 JSON 序列化方式实现深拷贝。
下面我们利用 Google 的 Gson 库(2.8.5 版本),实现基于 JSON 的深拷贝:
首先我们将深拷贝方法封装到拷贝工具类中:

  1. /**
  2. * Gson方式实现深拷贝
  3. */
  4. public static <T> T deepCloneByGson(T origin, Class<T> clazz) {
  5. Gson gson = new Gson();
  6. return gson.fromJson(gson.toJson(origin), clazz);
  7. }

使用时直接调用封装的工具方法即可:

  1. @Test
  2. public void withGson() {
  3. Order order = OrderMocker.mock();
  4. // gson序列化方式
  5. Order cloneOrder = CloneUtil.deepCloneByGson(order, Order.class);
  6. assertFalse(order == cloneOrder);
  7. assertFalse(order.getItemList() == cloneOrder.getItemList());
  8. }

使用 JSON 序列化方式实现深拷贝的好处是,性能比 Java 序列化方式更好,更重要的是不要求序列化对象以及成员属性(嵌套)都要实现序列化接口。
我们也可以使用前面讲到的 Hessian 和 Kryo 序列化来实现,请大家自行封装。
上面通过 Gson 实现的深拷贝工具方法封装,再次体现了 “不要让客户端去做任何类库可以替它完成的事” 的原则。
这点也和《重构 - 改善既有代码的设计》 第一版 10.13 封装向下转型的重构方案一致。
最后,建议不管采取哪种或者哪几种深拷贝方式,都尽量将其封装到项目的克隆工具类中,方便复用。

**


本节重点讲述了浅拷贝和深拷贝的概念,它们的主要区别,以及浅拷贝和深拷贝的实现方式。
下一节将讲述开发常用既熟悉又陌生的几种分层领域模型,讲述它们之间的区别和实际开发中的使用。

**


请自定义一个类,编写代码分别实现浅拷贝和深拷贝。

**


  1. 阿里巴巴与 Java 社区开发者.《 Java 开发手册 1.5.0》华山版. 2019. 10 ↩︎
  2. 克隆 - 维基百科 ↩︎
  3. [美] Joshua Bloch.《Effective Java : Second Edition》.2008 ↩︎