org.apache.cxf.transport

Interface Destination

All Superinterfaces:

Observable

All Known Subinterfaces:

MultiplexDestination

public interface Destination
extends Observable

A Destination is a transport-level endpoint capable of receiving unsolicited incoming messages from different peers.

Method Summary

Methods

Modifier and Type	Method and Description
EndpointReferenceType	getAddress()
Conduit	getBackChannel(Message inMessage, Message partialResponse, EndpointReferenceType address) Retreive a back-channel Conduit, which must be policy-compatible with the current Message and associated Destination.
MessageObserver	getMessageObserver()
void	shutdown() Shutdown the Destination, i.e.

Methods inherited from interface org.apache.cxf.transport.Observable

setMessageObserver

Method Detail

getAddress

EndpointReferenceType getAddress()

Returns:

the reference associated with this Destination

getBackChannel

Conduit getBackChannel(Message inMessage,
                     Message partialResponse,
                     EndpointReferenceType address)
                       throws IOException

Retreive a back-channel Conduit, which must be policy-compatible with the current Message and associated Destination. For example compatible Quality of Protection must be asserted on the back-channel. This would generally only be an issue if the back-channel is decoupled.

Parameters:

inMessage - the current message (null to indicate a disassociated back-channel.

partialResponse - in the decoupled case, this is expected to be the outbound Message to be sent over the in-built back-channel.

address - the backchannel address (null to indicate anonymous)

Returns:

a suitable Conduit

Throws:

IOException

shutdown

void shutdown()

Shutdown the Destination, i.e. stop accepting incoming messages.

getMessageObserver

MessageObserver getMessageObserver()