アプリケーションへの Liberty プロファイル・サーバーの組み込み
Liberty プロファイルで提供されるシステム・プログラミング・インターフェース (SPI) を使用して、 アプリケーションで Liberty プロファイル・サーバーの構成、制御、およびモニターを行うことができます。
このタスクについて
Liberty プロファイルでは、Liberty プロファイル・サーバーの始動または停止を行うために、次の SPI を提供しています。
- 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 および環境は、呼び出し元によって管理されるものと想定されます。