Eclipse 插件開發核心觀念：何時該建立自訂擴展點？

前言：從「會用」到「懂設計」的關鍵轉折

Eclipse 插件開發者對「擴展點」絕不陌生 —— `plugin.xml` 中滿是 `extension point` 與 `extension` 的宣告。但許多開發者經歷三階段：

1. 入門期：不懂機制，只會使用平台內建擴展點 (如 `org.eclipse.ui.views`)。
2. 成長期：覺得「好強大」，開始大量定義自己的擴展點，結果產生混亂的依賴網。
3. 成熟期：理解擴展點本質是模組邊界契約，只在真正需要「開放給第三方動態擴充」時才定義。

本文分享判斷「是否需要建立擴展點」的四個核心檢核點，助你避開過度設計陷阱。

四大自問自答：決定擴展點生死的關鍵

1. 需求面：外部真的有「二次開發」需求嗎？

打開需求文件，問自己：「客戶或下游團隊是否需要針對此模組進行二次開發，並註冊擴充功能？」

• 若答案為「否」或「未來極不可能」 → 不需要擴展點。內部介面 (`internal` 套件) + 介面隔離原則即可。
• 若答案為「是」 (如提供 SDK、平台化產品) → 進入下一項檢核。

2. 技術面：描述對象是「內部實作」還是「外部契約」？

擴展點描述的資訊必須對模組外部可見。若只是模組內部的策略實作類別、資料庫連線池設定、暫存策略等 —— 這些屬於「實作細節」，用 Java 介面 + 依賴注入 (DI) 解決即可，切勿暴露為擴展點。

3. 機制面：真的需要「動態掛載」嗎？Java 靜態註冊不夠用？

這是新手最常犯的錯誤：混淆「語言特性」與「平台機制」。

反例： 你有介面 `IPolicy`，實作 `PolicyA`、`PolicyB`，未來可能新增 `PolicyC`。管理類 `PolicyManager` 以靜態列表持有實例。

// 靜態註冊範例 — 完全足夠，無需擴展點
private PolicyManager() {
    policyList.add(new PolicyA());
    policyList.add(new PolicyB());
}
// 未來新增 PolicyC 時，修改此處重新編譯部署即可

擴展點的價值在於部署期/執行期動態發現與載入 (如 Dropins 目錄、使用者安裝額外插件)。若你的系統：

• 發布單元固定 (單一 WAR/JAR/安裝包)
• 無第三方插件生態
• 新增實作伴隨版本釋出

→ 老實用 Java 介面 + 靜態註冊/建構器注入，別濫用擴展點增加複雜度。

4. 架構面：你的模組是「基礎設施層」還是「上層業務功能」？

觀察 Eclipse 自身擴展點分佈：

• 基礎模組：`org.eclipse.core.runtime`、`resources`、`workbench` — 核心平台能力，必須開放擴充。
• 可二次開發的功能模組：JDT (Java Development Tools) — 大量開放擴展點讓廠商整合編譯器、重構工具、程式碼產生器。

鐵律： 若你的模組是最上層的業務功能 (如「訂單管理」、「報表產生」)，且確定沒有其他模組會依賴它 → 不可能存在擴展點。擴展點是給「被依賴者」準備的，葉子節點不需要。

正確設計範例：專案建構器的編譯器擴展點

假設你開發一個 IDE，支援自訂專案類型，需針對不同檔案類型調用對應編譯器：

• 定義介面 `IModelCompiler` (編譯器契約)。
• 建立擴展點 `compiler`，屬性：`fileExtension`、 `class` (實作 `IModelCompiler`)。
• 關鍵：你自己內建的編譯器也以擴展點方式註冊 (公平法則)，而非硬編碼在核心邏輯中。

此時，核心建構器邏輯只需：

IExtension[] extensions = Platform.getExtensionRegistry()
    .getExtensionPoint("com.myide.compiler")
    .getExtensions();
for (IExtension ext : extensions) {
    IModelCompiler compiler = (IModelCompiler) ext.createExecutableExtension("class");
    // 使用 compiler 編譯對應副檔名檔案
}

這才是擴展點的正統用法：核心流程固定，具體實作由外部動態貢獻。

總結決策流程圖

1. 需求是否要求外部可擴充？ → 否 → 停止，不用擴展點。
2. 描述對象是內部實作細節？ → 是 → 停止，用 Java 介面。
3. 是否需要部署後動態掛載 (非重新編譯主程式)？ → 否 → 停止，用靜態註冊/DI。
4. 模組是基礎設施或可被擴充的平台層？ → 否 → 停止，葉子節點不需擴展點。
5. 以上皆為「是」 → 建立擴展點，並嚴格定義 Schema (exsd) 確保契約穩定。

記住：擴展點是架構邊界的正式契約，一旦發布即難變更。寧可事後補充 (Eclipse 允許後續擴充)，不可預先過度設計。保持模組內聚、介面乾淨，才是良好插件架構的基石。