Web Services Addressing APIs
WAS provides interfaces at the application programming level to enable application developers, including developers of Web Services Resource Framework applications, to create references to, and to target, Web service resource instances. If you are a system programmer, you can use these interfaces with the Web Services Addressing (WS-Addressing) system programming interfaces.
The programming interfaces in this topic are described in more detail in the WS-Addressing API documentation. The application programming interfaces are contained in the com.ibm.websphere.wsaddressing package and are summarized in the following diagram.
These interfaces provide the following features:
- A mechanism to create a com.ibm.websphere.EndpointReference instance to represent a WS-Addressing endpoint reference using the com.ibm.websphere.EndpointReferenceManager.createEndpointReference interface.
- A method, com.ibm.websphere.EndpointReference.setReferenceParameter, to enable the association of reference parameters with an EndpointReference instance.
- An interface to enable a client to configure its Stub or Call object based on an EndpointReference instance. All invocations on the Stub or Call object are subsequently targeted at the endpoint that is represented by the EndpointReference instance. To achieve this behavior, set the com.ibm.websphere.wsaddressing.WSAConstants.WSADDRESSING_DESTINATION_EPR property on the Stub or Call object to the appropriate EndpointReference instance.
- A mechanism to acquire individual reference parameters that are associated with the incoming message context, to correlate the message to a specific resource instance through the com.ibm.websphere.EndpointReferenceManager.getReferenceParameterFromMessageContext interface.
Related concepts
Web Services Addressing support
Web Services Resource Framework support
Related tasks
Creating stateful Web services using the Web Services Resource Framework
Developing Applications that use Web Services Addressing
Related Reference
Web Services Addressing SPI
Example: Creating a Web service that uses the Web Services Addressing API to access a generic Web service resource instance
Related information
Reference: Generated API documentation