Web Service 寻址 API

此产品在应用程序编程级别上提供了接口,以使应用程序开发者(包括 Web Services Resource Framework 应用程序的开发者)能够创建对 Web Service 资源实例的引用以及将 Web Service 资源实例作为目标。如果您是系统程序员,那么可以将其中一些接口与 Web Service 寻址 (WS-Addressing) 系统编程接口配合使用。

JAX-WS 2.1 API

此产品中的标准 JAX-WS 2.1 API 包含在 javax.xml.ws.wsaddressing 包中。请参阅 JAX-WS 2.1 API 文档,以了解有关这些 API 的更多信息。

此产品中的标准 JAX-WS 2.1 API 的实现也包含 com.ibm.websphere.wsaddressing.jaxws21 包中的应用程序编程接口。本信息中心中的生成 API 文档中详细描述了这些 API。这些 API 允许您使用特定类实现以下目标:
  • 要代表符合 2004/08 WS-Addressing 规范的端点,请使用 com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReference 类。
  • 要创建 SubmissionEndpointReference 实例以在 Web Service(并非生成端点引用的 Web Service)中代表 2004/08 端点,请使用 com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReferenceBuilder 类。
  • 要将使用 IBM 专有 WS-Addressing API 创建的 EndpointReference 实例转换为 W3CEndpointReference 或 SubmissionEndpointReference 实例,请使用 com.ibm.websphere.wsaddressing.jaxws21.EndpointReferenceCoverter 类。此类也可以用来反向转换 EndpointReference 实例。
  • 要在客户机上启用 WS-Addressing,请使用 com.ibm.websphere.wsaddressing.jaxws21.SubmissionAddressingFeature 类以及注释 @SubmissionAddressing,以在服务器上启用 WS-Addressing。

IBM 专有 WS-Addressing API

这些应用程序编程接口包含在 com.ibm.websphere.wsaddressing 包中,并在下图中作了总结。此图也显示 JAX-WS 2.1 API 中的以下类:com.ibm.websphere.wsaddressing.jaxws21.EndpointReferenceConverter、javax.xml.ws.wsaddressing.W3CEndpointReference 以及 com.ibm.websphere.wsaddressing.jaxws21.SubmissionEndpointReference。
Java 类 EndpointReferenceManager 包含两个方法:createEndpointReference 和 getReferenceParameterFromMessageContext。此类使用另外三个类:EndpointReference(包含方法
setReferenceParameter)、WSAConstants(包含常量 WSADDRESSING_DESTINATION_EPR)和 ReferenceParameterCreationException。WSAConstants 和
ReferenceParameterCreationException 都进一步使用类 EndpointReferenceCreationException。
这些接口提供了下列功能部件:
  • 使用 com.ibm.websphere.wsaddressing.EndpointReferenceManager.createEndpointReference 接口来创建 com.ibm.websphere.wsaddressing.EndpointReference 实例以代表 WS-Addressing 端点引用的机制。
  • 不推荐使用的功能部件 不推荐使用的功能部件: 不推荐的类 com.ibm.websphere.wsaddressing.EndpointReferenceCoverter,用于将 EndpointReference 实例转换为不推荐的类 com.ibm.websphere.wsaddressing.W3CEndpointReference 或 com.ibm.websphere.wsaddressing.SubmissionEndpointReferences,以在 JAX-WS 应用程序中使用。

    不推荐这些类,有利于 com.ibm.websphere.wsaddressing.jaxws21 和 javax.xml.ws.wsaddressing.jaxws21 包中所包含的同名 JAX-WS 2.1 类(EndpointReferenceConverter、SubmissionEndpointReference 以及 W3CEndpointReference),如图中所示。

    depfeat
  • 方法 com.ibm.websphere.wsaddressing.EndpointReference.setReferenceParameter,使您能够将引用参数与 EndpointReference 实例相关联。
  • 使客户机能够根据 EndpointReference 实例配置其 BindingProvider 请求上下文、Stub 或 Call 对象的接口。对 BindingProvider、Stub 或 Call 对象的所有调用随后都以 EndpointReference 实例所代表的端点为目标。要实现此行为,请将 BindingProvider 请求上下文、Stub 或 Call 对象的 com.ibm.websphere.wsaddressing.WSAConstants.WSADDRESSING_DESTINATION_EPR 属性设为适当的 EndpointReference 实例。
  • 用于获取与入局消息上下文相关联的各个引用参数,以通过 com.ibm.websphere.EndpointReferenceManager.getReferenceParameterFromMessageContext 接口使该消息与特定资源实例相关的机制。

指示主题类型的图标 概念主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cwbs_wsa_api
文件名:cwbs_wsa_api.html