在 Eclipse 開發生態系統中，IAdaptable 是一個舉足輕重的介面。對於資深開發者而言，它如同異常處理與抽象類別般基礎且常用；但對初學者來說，卻常因其動態特性而感到困惑。本文將深入淺出地解析 IAdaptable 的本質、運作原理及其在 Eclipse 平台中的關鍵角色。
Java 是強型別語言，每個實例皆具備宣告型別（靜態型別）與執行時型別（動態型別）。若要呼叫特定類別的方法，該方法必須在宣告型別中可見。即便執行時實例為子類型，仍只能存取父類型定義的方法。例如：
List list = new ArrayList();
list.add("data"); // 正確，add 定義於 List 介面
list.ensureCapacity(4); // 編譯錯誤，ensureCapacity 僅存在於 ArrayList
若需呼叫子類別特有方法，必須進行強制型別轉換：
Object o = new ArrayList();
List list = (List) o; // 向上轉型安全
ArrayList arr = (ArrayList) list; // 向下轉型需 instanceof 檢查
然而，現實開發中常面臨類別未實現所需介面的情況：或許該介面僅在少數場景需要、或源自第三方庫、或在類別定義後才設計出來。此時傳統強制轉換無能為力，IAdaptable 應運而生。
IAdaptable 定義單一方法 getAdapter(Class adapter)，提供動態獲取介面實例的機制。對比傳統轉換：
// 傳統強制轉換
List list = (List) adaptable;
// IAdaptable 方式
IAdaptable adaptable = ...;
List list = (List) adaptable.getAdapter(java.util.List.class);
核心差異在於：getAdapter() 返回的是適配器實例（通常為包裝器或副本），而非原物件的直接引用。這意味著我們可以將 HashMap 適配為 List，即使兩者無繼承關係：
public Object getAdapter(Class clazz) {
if (clazz == java.util.List.class) {
List list = new ArrayList(this.size());
list.addAll(this.values());
return list; // 返回包含所有值的 List 副本
}
return null; // 不支援的型別返回 null
}
慣例上，不支援的型別返回 null 而非拋出異常，調用者務必檢查返回值。
若每新增一個適配型別都需修改類別原始碼，將嚴重違反開閉原則。Eclipse 透過 PlatformObject 抽象類別與 IAdapterManager 解決此問題：
PlatformObject 實作 IAdaptable，其 getAdapter() 委派給 IAdapterManager。IAdapterManager 可視為一個全域註冊表，維護「被適配類別 → 適配器工廠」的映射關係。Platform.getAdapterManager().registerAdapters(factory, adaptableClass) 註冊工廠，無需修改被適配類別即可擴展適配能力。以將 List<String> 適配為 XOM Node（XML 節點）為例：
getAdapterList() 宣告支援的目標型別，getAdapter() 執行實際轉換。Platform.getAdapterManager().registerAdapters(new NodeListFactory(), List.class); 通常在啟動器或 org.eclipse.core.runtime.adapters 擴展點完成。Node node = (Node) list.getAdapter(Node.class); 無感知底層適配細節。標準 JDK 類別（如 java.util.List）非 PlatformObject 子類，無法直接受益於平台適配機制。解決方案為建立包裝類別實作 IAdaptable，委派給 Platform.getAdapterManager()：
public class AdaptableList implements IAdaptable, List {
public Object getAdapter(Class adapter) {
return Platform.getAdapterManager().getAdapter(this, adapter);
}
private List delegate = new ArrayList();
// 委派所有 List 方法給 delegate...
}
IAdaptable 模式的精髓在於關注點分離：
IPropertySource）而非具體資料類別。掌握 IAdaptable，即掌握了 Eclipse 平台擴展性的核心鑰匙。
