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 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.