在应用程序中嵌入 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 和环境。