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.
The Java class EndpointReferenceManager contains two methods: createEndpointReference and getReferenceParameterFromMessageContext. This class uses three other classes: EndpointReference (containing method setReferenceParameter), WSAConstants (containing constant WSADDRESSING_DESTINATION_EPR), and ReferenceParameterCreationException. WSAConstants and ReferenceParameterCreationException both use a further class, EndpointReferenceCreationException.
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.



Reference topic Reference topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 30, 2013 10:47:11 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-iseries&topic=rwbs_wsa_api
File name: rwbs_wsa_api.html