Creating endpoint references by using the JAX-WS 2.1 Web Services Addressing API

Endpoint references are a primary concept of the Web Services Addressing (WS-Addressing) interoperability protocol, and provide a standard mechanism to encapsulate information about specific Web service endpoints. This product provides interfaces for you to create endpoint references by using the standard JAX-WS 2.1 API.

About this task

This task is a subtask of Creating a JAX-WS Web service application that uses Web Services Addressing.

Complete this task if you are writing an application that uses the standard JAX-WS 2.1 WS-Addressing API. Such applications require endpoint references to target Web service endpoints. The standard JAX-WS API is designed to create only simple endpoint references, and therefore has the following restrictions:
  • You cannot create highly available or workload managed endpoint references.
  • You cannot create endpoint references that represent stateful session beans.
  • You cannot use classes that are created by using the JAX-WS 2.1 API with the IBM proprietary WS-Addressing SPI.
You can overcome these restrictions by using the IBM proprietary WS-Addressing API to create the endpoint references and then converting them into standard JAX-WS 2.1 endpoint references that can be used by the rest of the application. Refer to Creating endpoint references by using the JAX-WS 2.1 Web Services Addressing API for instructions.
Note: Endpoint references that are created using this API contain metadata. This behavior is not a requirement of the JAX-WS 2.1 specification, so endpoint references created using vendor software might contain different metadata. This difference can cause problems if you are interoperating with an application created using vendor software.

Procedure

Results

You created an endpoint reference for use by your application.

What to do next

  1. If required, convert the endpoint reference to an instance of the com.ibm.websphere.wsaddressing.EndpointReference class, by using the createIBMEndpointReference method. For example, on a client you might want to set the FaultTo message addressing property for outbound messages. You cannot set this property by using the JAX-WS 2.1 API, so you must convert the endpoint reference representing the FaultTo endpoint to an instance of the com.ibm.websphere.wsaddressing.EndpointReference class, before setting it as a property on the BindingProvider object.
  2. Continue with Creating a JAX-WS Web service application that uses Web Services Addressing.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 5:30:17 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-iseries&topic=twbs_wsa_eprs_jaxws
File name: twbs_wsa_eprs_jaxws.html