+

Search Tips   |   Advanced Search

Create endpoint references 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 using the standard JAX-WS 2.1 API.

This task is a subtask of Create a JAX-WS Web service application that uses Web Services Addressing. Perform this task if we 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:

We 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 Create endpoint references using the JAX-WS 2.1 Web Services Addressing API for instructions.

Endpoint references that are created using this API contain metadata that complies with the WS-Addressing 1.0 Metadata specification. This behavior is not a requirement of the JAX-WS 2.1 specification, so endpoint references created using vendor software might contain metadata that complies with a different specification. This difference could cause problems if we are interoperating with an application created using vendor software.

 

 

Results

You created an endpoint reference for use by the application.

 

Next steps

  1. If required, convert the endpoint reference to an instance of the com.ibm.websphere.wsaddressing.EndpointReference class, using the createIBMEndpointReference method. For example, on a client we might want to set the FaultTo message addressing property for outbound messages. We cannot set this property using the JAX-WS 2.1 API, so 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 Create a JAX-WS Web service application that uses Web Services Addressing.

 

Related concepts


Web Services Addressing: firewalls and intermediary nodes
IBM proprietary Web Services Addressing SPIs

 

Related tasks


Create endpoint references using the JAX-WS 2.1 Web Services Addressing API
Create a JAX-WS Web service application that uses Web Services Addressing

 

Related information


Additional Application Programming Interfaces (APIs)