使用 Java Service Wrapper 將 Java 程式註冊為系統服務

工具簡介

Java Service Wrapper 提供跨平台（Windows、Linux、Unix）將 Java 應用程式安裝為系統服務/守護進程的能力。

三種整合方式

1. WrapperSimpleApp：最簡單、官方推薦。需修改程式啟動類，適合專案早期引入。JBoss 採用此方式。
2. WrapperStartStopApp：適用於啟動/停止邏輯分離於不同類（ClassA 啟動、ClassB 停止）的場景。
3. 實現 WrapperListener 接口（本文重點）：對程式碼侵入性最小，僅需啟動類實現 start(String[])、stop(String[])，配置靈活，適合已有專案整合。

第三種方式實作步驟

1. 實現 WrapperListener

public class MyService implements WrapperListener {
    public Integer start(String[] args) {
        // 初始化應用（如啟動 Spring 容器）
        return null; // 非零表示啟動失敗
    }
    public int stop(int code) {
        // 優雅關閉資源
        return code;
    }
    public void controlEvent(int event) { /* 處理服務控制事件 */ }
}

注意：start 需在 30 秒內完成，耗時操作請放入獨立執行緒；若拋出異常將導致服務啟動終止。

2. 配置 wrapper.conf

關鍵屬性說明：

3. 動態更新類路徑（RCP 專案實例）

專案具自動更新功能，插件版本變更會導致類路徑失效。解決方案：編寫管理類定期掃描最新插件路徑，重寫 wrapper.conf 中的 wrapper.java.classpath.*，確保服務重啟時載入最新版本。

Jetty 實戰參考

Jetty 同樣採用第三種方式，其 JettyServiceWrapperListener 實現了 start 調用 Main.main、stop 呼叫 Server.stop()，並透過 WrapperManager.start 啟動服務，可作為範本參考。