使用 Eclipse 開發 OSGi Bundle 應用：從服務定義到 Equinox 部署實戰

OSGi 核心架構速覽

OSGi（Open Services Gateway Initiative）定義動態模組化的 Java 服務平台，四大核心層級：

• Execution Environment：執行環境（如 J2SE-1.4、CDC-1.0）
• Modules：模組層，每個 Bundle 擁有獨立 ClassLoader，實現強隔離
• Life Cycle：生命週期層，提供安裝、啟動、停止、更新、解除安裝 API
• Service Registry：服務註冊表，發布/發現/綁定動態服務模型

Bundle 六大狀態：INSTALLED → RESOLVED → STARTING → ACTIVE / STOPPING → RESOLVED / UNINSTALLED

Equinox：Eclipse 的 OSGi 參考實作

Equinox 實作 OSGi R4 核心框架與標準服務。Eclipse 3.2 本身即建構於 Equinox 之上，是開發 Bundle 的最佳 IDE。

實戰：開發兩個協作 Bundle

Bundle 1：example（服務提供者）

1. 建立 Plug-in Project：選擇 Equinox 為目標平台，勾選產生 BundleActivator
2. 定義服務介面（example.service.NameService）：

   public interface NameService {
       boolean checkName(String name);
   }

3. 實作並註冊服務（Activator.start()）：

   public void start(BundleContext context) {
       Properties props = new Properties();
       props.put("ClassRoom", "ClassOne");
       context.registerService(NameService.class.getName(), new NameImpl(), props);
   }
   
   static class NameImpl implements NameService {
       String[] names = {"Marry","John","David","Rachel","Ross"};
       public boolean checkName(String name) {
           for (String n : names) if (n.equals(name)) return true;
           return false;
       }
   }

4. 配置 MANIFEST.MF：

   Bundle-Activator: example.osgi.Activator
   Export-Package: example.service
   Import-Package: org.osgi.framework;version="1.3.0"

   Export-Package 讓其他 Bundle 可見服務介面。

Bundle 2：exampleClient（服務消費者）

public void start(BundleContext context) {
    ServiceReference[] refs = context.getServiceReferences(
        NameService.class.getName(), "(ClassRoom=*)");
    if (refs != null) {
        NameService svc = (NameService) context.getService(refs[0]);
        // 互動式查詢姓名...
        context.ungetService(refs[0]);
    }
}

部署與驗證

1. 右鍵專案 → Export → Deployable plug-ins and fragments → 輸出 JAR
2. 啟動 Equinox 控制台：java -jar org.eclipse.osgi_3.2.0.jar -console
3. 控制台命令驗證：

   osgi> ss          # 列出 Bundle 狀態
   osgi> install file:exampleClient.jar
   osgi> start <bundle_id>
   osgi> stop <bundle_id>
   osgi> close

圖示說明

結語

OSGi 提供動態模組化、服務導向的企業級應用基礎。Eclipse/Equinox 讓 Bundle 開發、部署、除錯一體化。掌握 BundleActivator、BundleContext、服務註冊/發現、MANIFEST.MF 配置，即可構建可熱插拔的模組化系統。