將 Liberty 伺服器內嵌在應用程式中
您可以利用 Liberty 所提供的「系統程式設計介面 (SPI)」,在您的應用程式中配置、控制及監視 Liberty 伺服器。
關於這項作業
Liberty 提供下列 SPI 來啟動或停止 Liberty 伺服器:
- com.ibm.wsspi.kernel.embeddable.Server
- com.ibm.wsspi.kernel.embeddable.ServerBuilder
此外,您可以建立自己的類別來實作 com.ibm.wsspi.kernel.embeddable.ServerEventListener 介面,以便在伺服器啟動中、已啟動或已停止時,收到非同步通知。
註: 如果要在您的應用程式中建立內嵌伺服器的實例,您必須執行下列步驟:
- 在類別路徑中併入 ws-server.jar 檔案。 ws-server.jar 檔位於 Liberty 安裝架構的 ${wlp.install.dir}/bin/tools 目錄中。
- 指定目標伺服器的名稱。目標伺服器必須存在。
- 選用項目:使用 -javaagent JVM 選項來配置 ws-javaagent.jar 檔案。ws-javaagent.jar 檔位於 Liberty 安裝架構的 ${wlp.install.dir}/bin/tools 目錄中。系統會建議您配置 ws-javaagent.jar 檔,但您不一定要這麼做,除非您使用的伺服器功能(例如:監視或追蹤)需要這個檔案。如果您聯絡 IBM® 支援中心,您可能需要提供追蹤資料,若是如此,您必須使用 ws-javaagent.jar 檔案來啟動伺服器,即使您平常不使用該檔案,也要這麼做。
註: 在內嵌的環境中:
- 不會檢查環境變數,也不會讀取 jvm.options 和 server.env 檔。
- 假設 JVM 和環境的管理是由呼叫端進行管理。