The Web Services Addressing (WS-Addressing) system programming interface (SPI) extends the application programming interface to enable you to create and reason about the contents of endpoint references and other WS-Addressing artifacts, and to set or retrieve WS-Addressing message addressing properties (MAPs) on or from Web service messages.
The programming interfaces in this topic are described in more detail in the WS-Addressing SPI documentation.
The SPI extends the WS-Addressing com.ibm.websphere.wsaddressing.EndpointReference API to provide a number of additional methods through the com.ibm.wsspi.wsaddressing.EndpointReference interface. You can cast instances of com.ibm.websphere.wsaddressing.EndpointReference to com.ibm.wsspi.wsaddressing.EndpointReference to access this additional functionality.
Similarly, the SPI com.ibm.wsspi.wsaddressing.EndpointReferenceManager extends the functionality that is provided in the com.ibm.websphere.wsaddressing.EndpointReferenceManager API.
Setting WS-Addressing message addressing properties on outbound messages
Property name (of type String) | Java type of property value | Abstract WS-Addressing MAP name or names, using the notational convention of the W3C XML Information Set | Default value |
---|---|---|---|
WSADDRESSING_DESTINATION_EPR | com.ibm.websphere.wsaddressing.EndpointReference | [destination] URI |
Not set Note that this property comes from the API. |
WSADDRESSING_FROM_EPR | com.ibm.websphere.wsaddressing.EndpointReference | [source endpoint] | Not set |
WSADDRESSING_REPLYTO_EPR | com.ibm.websphere.wsaddressing.EndpointReference | [reply endpoint] | Not set, unless the message is a one-way message with no reply |
WSADDRESSING_FAULTTO_EPR | com.ibm.websphere.wsaddressing.EndpointReference | [fault endpoint] | Not set |
WSADDRESSING_RELATIONSHIP_SET | java.util.Set containing instances of com.ibm.wsspi.wsaddressing.Relationship | [relationship] | Not set |
WSADDRESSING_MESSAGE_ID | com.ibm.wsspi.wsaddressing.AttributedURI | [message id] | Generated and set to a unique value |
WSADDRESSING_ACTION | com.ibm.wsspi.wsaddressing.AttributedURI | [action] | Generated and set, according to the WS-Addressing specification |
WSADDRESSING_OUTBOUND_NAMESPACE | String | none | The WS-Addressing namespace of the WSADDRESSING_DESTINATION_EPR property, if specified, otherwise the default namespace |
Retrieving WS-Addressing message addressing properties from inbound messages
Message context property name (of type String) | Java type of property value | Abstract WS-Addressing MAP name, using the notational convention of the W3C XML Information Set |
---|---|---|
WSADDRESSING_INBOUND_TO | com.ibm.wsspi.wsaddressing.AttributedURI | [destination] |
No specific property. Use the EndpointReferenceManager.getReferenceParameter(QName name) method to obtain the associated MAP. | Any type | [reference parameters]* |
WSADDRESSING_INBOUND_FROM_EPR | com.ibm.websphere.wsaddressing.EndpointReference | [source endpoint] |
WSADDRESSING_INBOUND_REPLYTO_EPR | com.ibm.websphere.wsaddressing.EndpointReference | [reply endpoint] |
WSADDRESSING_INBOUND_FAULTTO_EPR | com.ibm.websphere.wsaddressing.EndpointReference | [fault endpoint] |
WSADDRESSING_INBOUND_RELATIONSHIP | java.util.Set containing instances of com.ibm.wsspi.wsaddressing.Relationship | [relationship] |
WSADDRESSING_INBOUND_MESSAGE_ID | com.ibm.wsspi.wsaddressing.AttributedURI | [message id] |
WSADDRESSING_INBOUND_ACTION | com.ibm.wsspi.wsaddressing.AttributedURI | [action] |
WSADDRESSING_INBOUND_NAMESPACE | String | The WS-Addressing namespace of the incoming message |