WebSphere Application Server Version 6.1 Feature Pack for Web Services
             Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

             Personalize the table of contents and search results

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 class, com.ibm.websphere.EndpointReferenceCoverter, for converting EndpointReference instances into either W3CEndpointReference or SubmissionEndpointReferences, for use in JAX-WS applications.
  • 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 BindingProvider request context, or Stub or Call object, based on an EndpointReference instance. All invocations on the BindingProvider, 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 BindingProvider request context, or 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
Additional Application Programming Interfaces
Reference topic    

Terms of Use | Feedback

Last updated: Nov 25, 2008 2:35:59 AM CST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.wsfep.multiplatform.doc/info/ae/ae/rwbs_wsa_api.html