WSADDRESSING_DESTINATION_EPR is the name of the JAX-RPC Stub/DII Call property that may be set to
a WS-Addressing EndpointReference
in order to associate the Stub/DII Call object with a particular Endpoint.
Subsequent invocations of the Stub/DII Call object will use this EndpointReference
in order to generate the WS-Addressing [destination] and [reference parameters] Message
Addressing Properties (MAPs), in accordance with the WS-Addressing SOAP Binding Specification.
Setting the WSADDRESSING_DESTINATION_EPR property on a JAX-RPC Stub/DII Call object will cause the Stub's/DII Call
object's target endpoint address to be overridden by the EndpointReference's [address].
If the target endpoint address
should not be overridden by the EndpointReference's [address],
applications should use the
JAX-RPC interface to set the target endpoint address back to its initial value.
Setting the WSADDRESSING_DESTINATION_EPR property on an unconfigured DII Call object will automatically
configure the DII Call object according to the EndpointReference's [metadata]. In particular, the DII's
service and
port will be set to the WSADDRESSING_DESTINATION_EPR metadata's [ServiceName] and [EndpointName] respectively.
This provides a useful mechanism for configuring a DII Call Object based on an EndpointReference.
In the case of a Stub or configured DII Call object,
the WSADDRESSING_DESTINATION_EPR
EndpointReference's [metadata] must be unspecified or consistent with that of the Stub/DII Call object.
If there is a conflict between the [metadata] contained within the EndpointReference and the service or port information
of the Stub or DII Call object, a JAXRPCException will be thrown during the Stub/DII Call invocation to indicate that
it has been mis-configured.
- See Also:
- Constant Field Values