Java Clone 技術深度解析：從淺複製到 N 層深度複製遞歸實作

基礎知識：Cloneable 與 Object.clone()

• 實作 Cloneable 介面 (標記介面，無方法) 才能呼叫 clone()
• Object.clone() 為 protected native，需覆寫為 public 才可外部呼叫
• 未實作 Cloneable 拋出 CloneNotSupportedException

標準實作範本

public class CloneableObj implements Cloneable {
    private String name;
    private int score;

    @Override
    public Object clone() throws CloneNotSupportedException {
        CloneableObj result = (CloneableObj) super.clone(); // 淺複製
        // 可在此自訂欄位處理
        result.name = "New Name";
        result.score = 90;
        return result;
    }
}

淺複製 vs 深複製

進階：N 層深度複製 (Deep Clone with Depth Control)

目標：支援指定複製深度 (如 depth=2 只複製前兩層)，容器類型 (List/Map) 始終深度複製。

核心遞歸演算法

public Object deepClone(Object obj, int depth) {
    Object result = obj;

    // 1. 檢查複製條件：非 null、實作 Cloneable、非基本型別/不可變類型/String/Transient/不可存取
    if (!isCloneable(obj)) return result;

    // 2. 執行複製 (可插入自訂複製策略)
    result = doClone(obj);

    // 3. 取得需遞歸處理的欄位 (可插入欄位掃描策略：反射/Getter/註解)
    Field[] fields = getCloneableFields(obj);

    for (Field field : fields) {
        Object fieldValue = field.get(obj);
        Object clonedValue;

        if (depth <= 1) {
            // 僅複製容器類型
            if (isContainer(fieldValue)) {
                clonedValue = deepClone(fieldValue, 1);
            } else continue;
        } else {
            clonedValue = deepClone(fieldValue, depth - 1);
        }

        // 4. 將複製結果寫回目標物件
        field.set(result, clonedValue);
    }
    return result;
}

關鍵判斷邏輯

• isCloneable()：排除 primitive、String、Enum、不可變類、transient 欄位、未實作 Cloneable、!field.isAccessible()
• isContainer()：Collection、Map、陣列等容器類型需深度複製
• doClone()：預設呼叫 super.clone()，可替換為序列化/建構子/工廠等策略
• getCloneableFields()：反射掃描 private 欄位需 setAccessible(true)

特殊場景：部分深度複製 (指定路徑複製)

需求：物件圖 A→B→C→...→X，僅需深度複製 X 節點，其餘保持引用共享。

解法：在 doClone() 或欄位遍歷中引入「複製路徑規則引擎」 (如正則匹配欄位路徑、註解標記)，動態決定該欄位是深複製、淺複製或共用引用。

效能與替代方案比較

最佳實務建議

1. 優先使用不可變物件 避免複製需求
2. 領域模型手寫 clone()，工具類提供通用 deepClone(obj, depth)
3. 防禦性複製：Getter 回傳集合/可變物件時回傳副本
4. 文件化複製語意：Javadoc 標註是淺/深/指定深度
5. 單元測試驗證：修改副本不影響原物件、修改原物件不影響副本

Clone 是雙面刃，善用可簡化物件圖構建，濫用則引入隱性 Bug。建立團隊統一複製策略，比單獨掌握技術細節更重要。