NetBeans 插件開發入門：從模組專案到視窗元件的完整實作

前言：NetBeans 平台的模組化哲學

NetBeans IDE 本身即建構於 NetBeans Platform 之上，核心僅提供視窗系統、檔案系統、設定管理等基礎服務，所有功能（編輯器、專案管理、版控、伺服器整合）均以模組形式插入。開發者可輕鬆擴充 IDE，甚至以平台為基座打造獨立應用（如 ERP、科學儀器控制台）。

核心術語

Module（模組）

一組 Java 類別，透過 manifest.mf 宣告模組資訊，layer.xml 向 System Filesystem 註冊選單、工具列、視窗等 UI 元素。

System Filesystem

虛擬檔案系統，彙總所有模組的 layer.xml，構建 IDE 的選單、工具欄、選項對話框等結構。

NetBeans API

模組開發可呼叫的公開介面與類別，分類明確（編輯器 API、視窗系統 API、專案 API 等）。

Module Suite（模組套件）

多個相依模組的部署單元，可自訂啟動畫面、排除不需的平台功能。

實戰：建立第一個模組 —「Start Page」視窗元件

1. 建立獨立模組專案

• File → New Project → NetBeans Modules → Module Project
• 專案名：nbmodule-demo，勾選 Standalone Module。
• Code Name Base：org.mymodule.nbmoduledemo，顯示名稱：nb-module-demo。
• 保持預設 layer.xml 與本地化 Bundle。

2. 新增 Window Component（視窗元件）

• 右鍵模組專案 → New → Window Component。
• Window Position：editor（作為編輯區標籤頁顯示）。
• 勾選 Open on Application Start。
• Class Name Prefix：AppUIMain，可選圖示。

3. 使用 Matisse GUI 建設計畫介面

• 切換 AppUIMainTopComponent.java 至 Design 模式。
• 從調色盤拖入 Label、Combo Box、Button。
• 調整佈局與屬性，儲存。

4. 安裝並驗證

• 右鍵模組專案 → Install/Reload in Target Platform。
• 新 NetBeans 實例啟動，編輯區出現 AppUIMain 標籤頁，介面即為設計畫面。

進階擴展方向

• 在 layer.xml 註冊選單項目、工具列按鈕、快捷鍵。
• 實作 TopComponent 生命週期方法（componentOpened/Closed）處理資料載入/儲存。
• 使用 Lookup 機制實現模組間鬆耦合通訊。
• 打包為 .nbm 檔案，透過 Tools → Plugins 發布安裝。

結語

NetBeans 模組開發以「聲明式註冊 + 標準 API」降低擴展門檻。幾分鐘內即可為 IDE 新增視窗、選單、工具列，或打造基於平台的專屬應用。掌握 layer.xml、TopComponent、Lookup 三大核心，即可暢遊豐富的擴展生態。