可在 Liberty SPI 中使用 REST 处理程序框架以公开新的 REST 端点。
关于此任务
REST 处理程序框架供 Liberty 扩展程序在公开新的 REST 端点时使用。可在一个 OSGi 组件或一组组件中公开 REST 端点。
过程
- 创建 OSGi 组件,该组件在侦听附加至 /ibm/api 并实现 com.ibm.wsspi.rest.handler.RESTHandler 接口的子根时注册自身;例如:
@Component(service = { RESTHandler.class },
configurationPolicy = ConfigurationPolicy.IGNORE,
immediate = true,
property = { "service.vendor=IBM",
RESTHandler.PROPERTY_REST_HANDLER_ROOT + "=/myTest/abc" })
public class RESTHANDLERTest1 implements RESTHandler {
...
- 将该组件打包至作为已扩展用户功能部件的一部分的 OSGi 捆绑软件。
- 确保您的功能部件包括 OSGi 子系统内容:
com.ibm.websphere.appserver.restHandler-1.0; type="osgi.subsystem.feature"
- 在 server.xml 文件中配置 SSL 证书。
- 在 server.xml 文件中将用户或组配置到管理员角色。
注: 如果 OSGi 属性 com.ibm.wsspi.rest.handler.RESTHandler.PROPERTY_REST_HANDLER_CUSTOM_SECURITY
在 REST 处理程序定义中设置为 true,那么非管理员用户可以访问 REST 端点。
- 启动您的功能部件。
启动该功能部件会启动 REST 处理程序框架并注册您的 OSGi 组件。该功能部件启动后,您可调用 https://<host>:<https_port>/ibm/api/myTest/abc。