Web Services Addressing version interoperability

Web Services Addressing version interoperability

The Web Services Addressing (WS-Addressing) support in WebSphere Application Server can interoperate with various versions of the WS-Addressing specification.

Table 1. Supported set of WS-Addressing versions

Associated namespace Specification download location Details

http://www.w3.org/2005/08/addressing http://www.w3.org/2002/ws/addr/ W3C Candidate Recommendation (CR) versions of the WS-Addressing core and SOAP specifications.
These specifications are sometimes referred to collectively as the 2005/08 version of WS-Addressing.
http://www.w3.org/2006/05/addressing/wsdl http://www.w3.org/2002/ws/addr/ W3C Candidate Recommendation (CR) version of the WS-Addressing WSDL specification.
This is the default namespace used by WebSphere Application Server for the WSDL parts of the WS-Addressing specification, if you have fix pack V6.1.0.2 or later.
http://www.w3.org/2006/02/addressing/wsdl http://www.w3.org/2002/ws/addr/ W3C Last Call (LC) version of the WS-Addressing WSDL specification.
This is the default namespace used by WebSphere Application Server for the WSDL parts of the WS-Addressing specification, if you do not have fix pack V6.1.0.2 or later.
http://schemas.xmlsoap.org/ws/2004/08/addressing http://www.w3.org/Submission/ws-addressing/ W3C WS-A Submission
This specification is sometimes referred to as the 2004/08 specification. It combines the core, SOAP and WSDL aspects of WS-Addressing in a single specification.

This version of WAS interoperates with each of the WS-Addressing specifications that are defined in the previous table. This interoperability results in the following behavior:

Incoming Web service messages that contain WS-Addressing message addressing properties (MAPs) are appropriately bound to SOAP, and WS-Addressing SOAP elements appropriately deserialized to their WS-Addressing programming model representations according to the namespace in use.

WS-Addressing programming model artifacts are appropriately serialized into SOAP elements, and the MAPs are bound to SOAP according to the namespace in use.

Differing WS-Addressing semantics are adhered to, according to the WS-Addressing version currently in use.

Determining the WS-Addressing namespace of inbound messages

The WS-Addressing namespace of incoming Web service messages is the namespace of the first WS-Addressing [action] MAP that is found. The WebSphere Application Server runtime looks for an [action] MAP of the default namespace prior to searching for other namespaces on the inbound message, in an undefined order. The namespace of the WS-Addressing core specification in use is available to the target endpoint through the message context.

Determining the WS-Addressing namespace of outbound messages

WS-Addressing messages that are issued from this version of WAS adopt the namespace that is associated with the destination endpoint reference. If this namespace is unknown, the message adopts the default WS-Addressing namespace.
WAS provides a system programming interface (SPI) to change the namespace that is associated with an endpoint reference to any namespace in the supported set.

The WS-Addressing specification to use

Best practice: In most cases, use the default WS-Addressing specification that is supported by WAS. You do not need to perform any additional actions to use this specification. The following list gives examples of occasions where override the default namespace:

When interoperating with an endpoint that does not support the default namespace, for example, an earlier version of WAS.

When a namespace other than the default is required. For example, when implementing a specification that uses a level of WS-Addressing other than the default.

If you have fix pack V6.1.0.2 or later, use the W3C Last Call (LC) version of the WS-Addressing WSDL specification only when you are interoperating with WAS nodes that do not have fix pack V6.1.0.2 or later.bprac

Related concepts

Web Services Addressing support

Related tasks

Interoperating with Web Services Addressing endpoints that do not support the default specification supported by WAS

Associated namespace	Specification download location	Details
http://www.w3.org/2005/08/addressing	http://www.w3.org/2002/ws/addr/	W3C Candidate Recommendation (CR) versions of the WS-Addressing core and SOAP specifications. These specifications are sometimes referred to collectively as the 2005/08 version of WS-Addressing.
http://www.w3.org/2006/05/addressing/wsdl	http://www.w3.org/2002/ws/addr/	W3C Candidate Recommendation (CR) version of the WS-Addressing WSDL specification. This is the default namespace used by WebSphere Application Server for the WSDL parts of the WS-Addressing specification, if you have fix pack V6.1.0.2 or later.
http://www.w3.org/2006/02/addressing/wsdl	http://www.w3.org/2002/ws/addr/	W3C Last Call (LC) version of the WS-Addressing WSDL specification. This is the default namespace used by WebSphere Application Server for the WSDL parts of the WS-Addressing specification, if you do not have fix pack V6.1.0.2 or later.
http://schemas.xmlsoap.org/ws/2004/08/addressing	http://www.w3.org/Submission/ws-addressing/	W3C WS-A Submission This specification is sometimes referred to as the 2004/08 specification. It combines the core, SOAP and WSDL aspects of WS-Addressing in a single specification.