org.apache.cxf.transport
Class AbstractDestination

java.lang.Object
  org.apache.cxf.transport.AbstractObservable
      org.apache.cxf.transport.AbstractDestination

All Implemented Interfaces:

org.apache.cxf.transport.Destination, org.apache.cxf.transport.DestinationWithEndpoint, org.apache.cxf.transport.Observable

Direct Known Subclasses:

AbstractMultiplexDestination

public abstract class AbstractDestination
extends AbstractObservable
implements org.apache.cxf.transport.Destination, org.apache.cxf.transport.DestinationWithEndpoint

Abstract base class factoring out common Destination logic, allowing non-decoupled transports to be written without any regard for the decoupled back-channel or partial response logic.

Nested Class Summary

protected class

AbstractDestination.AbstractBackChannelConduit Backchannel conduit.

Field Summary

protected org.apache.cxf.Bus	bus
protected org.apache.cxf.service.model.EndpointInfo	endpointInfo
protected org.apache.cxf.ws.addressing.EndpointReferenceType	reference

Fields inherited from class org.apache.cxf.transport.AbstractObservable

incomingObserver

Constructor Summary

AbstractDestination(org.apache.cxf.Bus b, org.apache.cxf.ws.addressing.EndpointReferenceType ref, org.apache.cxf.service.model.EndpointInfo ei)

AbstractDestination(org.apache.cxf.ws.addressing.EndpointReferenceType ref, org.apache.cxf.service.model.EndpointInfo ei)

Method Summary

org.apache.cxf.ws.addressing.EndpointReferenceType	getAddress()
org.apache.cxf.transport.Conduit	getBackChannel(org.apache.cxf.message.Message inMessage, org.apache.cxf.message.Message partialResponse, org.apache.cxf.ws.addressing.EndpointReferenceType address) Retreive a back-channel Conduit, which must be policy-compatible with the current Message and associated Destination.
org.apache.cxf.service.model.EndpointInfo	getEndpointInfo()
protected abstract org.apache.cxf.transport.Conduit	getInbuiltBackChannel(org.apache.cxf.message.Message inMessage)
void	shutdown() Shutdown the Destination, i.e.

Methods inherited from class org.apache.cxf.transport.AbstractObservable

activate, deactivate, getLogger, getMessageObserver, getTargetReference, getTargetReference, setMessageObserver

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

getMessageObserver

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

setMessageObserver

Field Detail

reference

protected final org.apache.cxf.ws.addressing.EndpointReferenceType reference

endpointInfo

protected final org.apache.cxf.service.model.EndpointInfo endpointInfo

bus

protected final org.apache.cxf.Bus bus

Constructor Detail

AbstractDestination

public AbstractDestination(org.apache.cxf.ws.addressing.EndpointReferenceType ref,
                           org.apache.cxf.service.model.EndpointInfo ei)

AbstractDestination

public AbstractDestination(org.apache.cxf.Bus b,
                           org.apache.cxf.ws.addressing.EndpointReferenceType ref,
                           org.apache.cxf.service.model.EndpointInfo ei)

Method Detail

getAddress

public org.apache.cxf.ws.addressing.EndpointReferenceType getAddress()

Specified by:

getAddress in interface org.apache.cxf.transport.Destination

Returns:

the reference associated with this Destination

getBackChannel

public org.apache.cxf.transport.Conduit getBackChannel(org.apache.cxf.message.Message inMessage,
                                                       org.apache.cxf.message.Message partialResponse,
                                                       org.apache.cxf.ws.addressing.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.

Specified by:

getBackChannel in interface org.apache.cxf.transport.Destination

Parameters:

inMessage - the current inbound 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

public void shutdown()

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

Specified by:

shutdown in interface org.apache.cxf.transport.Destination

getInbuiltBackChannel

protected abstract org.apache.cxf.transport.Conduit getInbuiltBackChannel(org.apache.cxf.message.Message inMessage)

Parameters:

inMessage - the incoming message

Returns:

the inbuilt backchannel

getEndpointInfo

public org.apache.cxf.service.model.EndpointInfo getEndpointInfo()

Specified by:

getEndpointInfo in interface org.apache.cxf.transport.DestinationWithEndpoint