Web Services Addressing APIs

WebSphere Application Server 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

Related tasks

Related Reference

Related information

Reference topic