3.4. 配置 Web 服务子系统
JBossWS 组件处理 Web 服务端点的处理,并通过 webservices
子系统提供给 JBoss EAP。子系统支持配置发布的端点地址和端点处理程序链。
服务器域和单机配置文件中提供了默认的 Web 服务子系统
。它包含几个预定义的端点和客户端配置。
<subsystem xmlns="urn:jboss:domain:webservices:2.0"> <wsdl-host>${jboss.bind.address:127.0.0.1}</wsdl-host> <endpoint-config name="Standard-Endpoint-Config"/> <endpoint-config name="Recording-Endpoint-Config"> <pre-handler-chain name="recording-handlers" protocol-bindings="##SOAP11_HTTP ##SOAP11_HTTP_MTOM ##SOAP12_HTTP ##SOAP12_HTTP_MTOM"> <handler name="RecordingHandler" class="org.jboss.ws.common.invocation.RecordingServerHandler"/> </pre-handler-chain> </endpoint-config> <client-config name="Standard-Client-Config"/> </subsystem>
3.4.1. 端点配置
JBossWS 支持预定义以及与端点实施关联的额外设置配置数据。预定义的端点配置可用于 JAX-WS 客户端和 JAX-WS 端点设置。端点配置可以包括 JAX-WS 处理程序和键/值属性声明。此功能提供了一种便捷的方式,可将处理程序添加到 Web 服务端点和设置控制 JBossWS 和 Apache CXF 内部的键/值属性。
您可以通过 webservices
子系统定义指定的端点配置数据集合。每一端点配置在子系统内必须具有唯一的名称。然后,可以使用 org.jboss.ws.api.annotation.EndpointConfig
注释将端点配置分配给部署的应用中的 JAX-WS 实施。有关分配端点配置的更多信息,请参阅分配配置。
默认 JBoss EAP 配置中有两个预定义的端点配置:
-
standard-Endpoint-Config
是用于没有显式分配的端点配置的端点配置。 -
Record-Endpoint-Config
是一个自定义端点配置示例,其中包含一个记录处理程序。
添加端点配置
您可以使用管理 CLI 添加新端点配置。
/subsystem=webservices/endpoint-config=My-Endpoint-Config:add
配置端点配置
您可以使用管理 CLI 为端点配置添加键/值属性声明。
/subsystem=webservices/endpoint-config=Standard-Endpoint-Config/property=PROPERTY_NAME:add(value=PROPERTY_VALUE)
删除端点配置
您可以使用管理 CLI 删除端点配置。
/subsystem=webservices/endpoint-config=My-Endpoint-Config:remove