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。

这些接口提供了下列功能部件:
- 使用 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 接口使该消息与特定资源实例相关的机制。