org.apache.cxf.transport
Interface Destination

All Superinterfaces:

Observable

All Known Subinterfaces:

MultiplexDestination

All Known Implementing Classes:

AbstractDestination, AbstractHTTPDestination, AbstractMultiplexDestination, CorbaDestination, JAXWSHttpSpiDestination, JettyHTTPDestination, JMSDestination, LocalDestination, ServletDestination, SoapTcpDestination

public interface Destination
extends Observable

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

getAddress

EndpointReferenceType getAddress()

Returns:

the reference associated with this Destination

getBackChannel

Conduit getBackChannel(Message inMessage,
                       Message unused1,
                       EndpointReferenceType unused2)
                       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.

Parameters:

inMessage - the current message

unused1 - - will likely always be null

unused2 - - will likely always be null

Returns:

a suitable Conduit

Throws:

IOException

shutdown

void shutdown()

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

getMessageObserver

MessageObserver getMessageObserver()

Description copied from interface: Observable

Retrieves the message observer for incoming messages

Specified by:

getMessageObserver in interface Observable

Returns:

the MessageObserver for incoming messages