实现对 JAX-WS Web Service 客户机的扩展
WebSphere® Application Server 对使用 Java™ API for XML-based Web Service (JAX-WS) 编程模型的 Web Service 客户机提供扩展。
关于此任务
可以使用 JAX-WS 客户机编程模型的以下扩展来定制 Web Service。
过程
- 在“分发”或“代理”对象的请求上下文上设置 JAXWS_OUTBOUND_SOAP_HEADERS 和 JAXWS_INBOUND_SOAP_HEADERS 属性,以使
JAX-WS Web Service 客户机客户机发送或检索隐式 SOAP 头。 隐式 SOAP 头是 WSDL 文件中未显式定义的 SOAP 头。隐式 SOAP 头文件符合以下描述:
- 在 WSDL 文件中声明为绑定中的 SOAP 头,但消息定义未由 portType 在 WSDL 文件中引用的消息部件。
- 未包含在 WSDL 文件中的元素。
处理程序和服务端点可以通过使用带附件的 SOAP API for Java (SAAJ) 数据模型来处理隐式或显式 SOAP 头。
要了解如何修改客户机代码以发送或检索传输头,请参阅有关使用 JAX-WS 发送隐式 SOAP 头或使用 JAX-WS 接收隐式 SOAP 头的信息。
- 设置 REQUEST_TRANSPORT_PROPERTIES 和 RESPONSE_TRANSPORT_PROPERTIES 属性以使 Web Service 客户机可以发送或检索传输头。
在 BindingProvider 实例上设置属性。
通过修改客户机代码以发送或检索传输头,您可以在服务器的出局请求或入局响应的传输头中发送或接收特定的信息。对于使用 HTTP 传输方法的请求或响应,将在 HTTP 头中发送或检索信息。类似地,对于使用 Java 消息服务 (JMS) 传输的请求或响应,将在 JMS 消息属性中发送或检索信息。
要了解如何修改客户机代码以发送或检索传输头,请参阅有关使用 JAX-WS 发送传输头或使用 JAX-WS 检索传输头的信息。
要了解如何使 Web Service 客户机发送或检索传输头,请参阅传输头属性最佳实践的信息。
子主题
示例:使用 JAX-WS 属性来编辑 JAX-WS 处理程序中的 SOAP 头
WebSphere Application Server 向 Java API for XML-Based Web Services (JAX-WS) 和 Web Services for Java Platform, Enterprise Edition (Java EE) 客户机编程模型提供扩展,其中包括 jaxws.binding.soap.headers.outbound 和 jaxws.binding.soap.headers.inbound 属性。此示例显示如何使用这两个属性来编辑 JAX-WS 处理程序中的 SOAP 头。使用 JAX-WS 发送隐式 SOAP 头
可以使现有的 Java API for XML-Based Web Services (JAX-WS) Web Service 客户机在隐式 SOAP 头中发送值。通过修改客户机代码来发送隐式 SOAP 头,可以在出局 web service 请求中发送特定信息。使用 JAX-WS 接收隐式 SOAP 头
可以使现有的 Java API for XML-Based Web Services (JAX-WS) Web Service 客户机从隐式 SOAP 头接收值。通过修改客户机代码来接收隐式 SOAP 头,可以在入局 web service 响应中接收特定信息。传输头属性最佳实践
您可以在 Java API for XML-based RPC (JAX-RPC) 客户机存根、Call 实例或 Java API for XML-Based Web services (JAX-WS) BindingProvider 的 RequestContext 实例上设置 REQUEST_TRANSPORT_PROPERTIES 属性和 RESPONSE_TRANSPORT_PROPERTIES 属性,以使 Web Service 客户机可以发送或检索传输头。使用 JAX-WS 发送传输头
您可以启用现有的 Java API for XML-Based Web Services (JAX-WS) Web Service 客户机以使用传输头来发送应用程序定义的信息以及 Web Service 请求。此外,您可以启用 JAX-WS Web Service 端点以使用传输头来发送应用程序定义的信息以及 Web Service 响应消息。使用 JAX-WS 检索传输头
可以使 Java API for XML-Based Web Services (JAX-WS) Web Service 客户机从传输头检索值。对于使用 HTTP 的请求,从 HTTP 响应消息中找到的 HTTP 头检索传输头。对于使用 Java 消息服务 (JMS) 的请求,将从 JMS 响应消息上找到的 JMS 消息属性检索传输头。
相关概念:


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_extendpmjaxws
文件名:twbs_extendpmjaxws.html