Java Collections 互操作性完全指南：新舊 API 無縫銜接與設計規範

Collections Framework 設計之初即以「完全互操作性」為核心目標，確保新集合介面與舊有 Vector、Hashtable、陣列、Enumeration 雙向無縫轉換。本文詳細說明相容性轉換技巧與 API 設計黃金法則。

向上相容：舊 API → 新集合

陣列轉 List

Foo[] result = oldMethod(arg);
newMethod(Arrays.asList(result)); // 陣列視圖為 List

Vector/Hashtable 直接使用

JDK 1.2 已改造實現對應介面，零成本轉換：

Vector<String> v = oldMethod(arg);
newMethod(v); // Vector 即 List

Hashtable<String, String> h = oldMethod(arg);
newMethod(h); // Hashtable 即 Map

Enumeration 轉集合

Enumeration<String> e = oldMethod(arg);
List<String> list = new ArrayList<>();
while (e.hasMoreElements())
    list.add(e.nextElement());
newMethod(list);

向下相容：新集合 → 舊 API

集合轉陣列

Collection<String> c = newMethod();
oldMethod(c.toArray()); // Object[]

// 指定型別陣列
oldMethod(c.toArray(new String[0])); // String[]

集合轉 Vector/Hashtable

Collection<String> c = newMethod();
oldMethod(new Vector<>(c)); // 標準建構子

Map<String, String> m = newMethod();
oldMethod(new Hashtable<>(m));

集合轉 Enumeration

Collection<String> c = newMethod();
oldMethod(Collections.enumeration(c)); // 靜態工廠方法

API 設計鐵律：做個好公民

輸入參數：越抽象越好

• **宣告介面型別**，絕不使用具體實現類（ArrayList、HashMap 等）
• **最不特化原則**：能用 Collection 別用 List/Set；需有序/唯一性保證時才用 List/Set
• 演算法多要求 List，因依賴有序性
• **嚴禁**定義專屬集合類並要求輸入——將喪失框架所有優勢

返回值：越具體越好

• 可返回任意實現/擴展集合介面的型別
• **最特化適用原則**：確定返回 SortedMap 時宣告 SortedMap 而非 Map，賦予呼叫端更豐富功能
• 輸入仍應接受通用介面（如接受 Collection 但返回 ImageList 實現 List）
• **嚴禁**返回專屬集合類——同樣喪失框架優勢

舊有 API 改造策略

1. 優先讓舊集合類實現標準介面
2. 若衝突，編寫 適配器類 包裝舊物件實現標準介面
3. 新增接受標準介面的多載方法，與舊方法共存
4. 或提供建構子/靜態工廠：new LegacyCollection(standardCollection)

遵循這些規範，你的 API 將與整個 Java 生態系統無縫協作，充分發揮 Collections Framework 的網絡效應。