A filter on the transport layer. More...

#include <src/main/activemq/transport/TransportFilter.h>

Inheritance diagram for activemq::transport::TransportFilter:

Public Member Functions
	TransportFilter (const Pointer< Transport > next)
	Constructor.
virtual	~TransportFilter ()
void	start ()
	Starts the Transport, the send methods of a Transport will throw an exception if used before the Transport is started.
void	stop ()
	Stops the Transport.
void	close ()
	Closes this object and deallocates the appropriate resources.
virtual void	onCommand (const Pointer< Command > command)
	Event handler for the receipt of a command.
virtual void	onException (const decaf::lang::Exception &ex)
	Event handler for an exception from a command transport.
virtual void	transportInterrupted ()
	The transport has suffered an interruption from which it hopes to recover.
virtual void	transportResumed ()
	The transport has resumed after an interruption.
virtual void	oneway (const Pointer< Command > command)
	Sends a one-way command.
virtual Pointer< FutureResponse >	asyncRequest (const Pointer< Command > command, const Pointer< ResponseCallback > responseCallback)
	Sends a commands asynchronously, returning a FutureResponse object that the caller can use to check to find out the response from the broker.
virtual Pointer< Response >	request (const Pointer< Command > command)
	Sends the given command to the broker and then waits for the response.
virtual Pointer< Response >	request (const Pointer< Command > command, unsigned int timeout)
	Sends the given command to the broker and then waits for the response.
virtual void	setTransportListener (TransportListener *listener)
	Sets the observer of asynchronous events from this transport.
virtual TransportListener *	getTransportListener () const
	Gets the observer of asynchronous events from this transport.
virtual Pointer < wireformat::WireFormat >	getWireFormat () const
	Gets the WireFormat instance that is in use by this transport.
virtual void	setWireFormat (const Pointer< wireformat::WireFormat > wireFormat)
	Sets the WireFormat instance to use.
virtual Transport *	narrow (const std::type_info &typeId)
	Narrows down a Chain of Transports to a specific Transport to allow a higher level transport to skip intermediate Transports in certain circumstances.
virtual bool	isFaultTolerant () const
	Is this Transport fault tolerant, meaning that it will reconnect to a broker on disconnect.
virtual bool	isConnected () const
	Is the Transport Connected to its Broker.
virtual bool	isReconnectSupported () const
virtual bool	isUpdateURIsSupported () const
virtual bool	isClosed () const
	Has the Transport been shutdown and no longer usable.
virtual std::string	getRemoteAddress () const
virtual void	reconnect (const decaf::net::URI &uri)
	reconnect to another location
virtual void	updateURIs (bool rebalance, const decaf::util::List< decaf::net::URI > &uris)
	Updates the set of URIs the Transport can connect to.
Public Member Functions inherited from activemq::transport::Transport
virtual	~Transport ()
Public Member Functions inherited from decaf::io::Closeable
virtual	~Closeable ()
Public Member Functions inherited from activemq::transport::TransportListener
virtual	~TransportListener ()

Protected Member Functions
void	checkClosed () const
	Throws an IOException if this filter chain has already been closed.
virtual void	beforeNextIsStarted ()
	Subclasses can override this method to do their own startup work.
virtual void	afterNextIsStarted ()
	Subclasses can override this method to do their own post startup work.
virtual void	beforeNextIsStopped ()
	Subclasses can override this method to do their own pre-stop work.
virtual void	afterNextIsStopped ()
	Subclasses can override this method to do their own stop work.
virtual void	doClose ()
	Subclasses can override this method to do their own close work.

Protected Attributes
Pointer< Transport >	next
	The transport that this filter wraps around.
TransportListener *	listener
	Listener of this transport.

Detailed Description

A filter on the transport layer.

Transport filters implement the Transport interface and optionally delegate calls to another Transport object.

Since: 1.0

Constructor & Destructor Documentation

activemq::transport::TransportFilter::TransportFilter ( const Pointer< Transport > next )

Constructor.

Parameters

next	- the next Transport in the chain

virtual activemq::transport::TransportFilter::~TransportFilter ( )

virtual

Member Function Documentation

virtual void activemq::transport::TransportFilter::afterNextIsStarted ( )

inlineprotectedvirtual

Subclasses can override this method to do their own post startup work.

This method will always be called after the doStart() method and the next transport's own start() methods have been successfully run.

Reimplemented in activemq::transport::inactivity::InactivityMonitor, and activemq::wireformat::openwire::OpenWireFormatNegotiator.

virtual void activemq::transport::TransportFilter::afterNextIsStopped ( )

inlineprotectedvirtual

Subclasses can override this method to do their own stop work.

This method is always called after all the next transports have been stopped to prevent this transport for destroying resources needed by the lower level transports.

Reimplemented in activemq::transport::tcp::TcpTransport, and activemq::wireformat::openwire::OpenWireFormatNegotiator.

virtual Pointer<FutureResponse> activemq::transport::TransportFilter::asyncRequest	(	const Pointer< Command >	command,
		const Pointer< ResponseCallback >	responseCallback
	)

inlinevirtual

Sends a commands asynchronously, returning a FutureResponse object that the caller can use to check to find out the response from the broker.

Parameters

command	The Command object that is to sent out.
responseCallback	A callback object that will be notified once a response to the command is received.

Returns: A FutureResponse instance that can be queried for the Response to the Command.

Exceptions

IOException	if an exception occurs during the read of the command.
UnsupportedOperationException	if this method is not implemented by this transport.

Implements activemq::transport::Transport.

Reimplemented in activemq::transport::correlator::ResponseCorrelator.

virtual void activemq::transport::TransportFilter::beforeNextIsStarted ( )

inlineprotectedvirtual

Subclasses can override this method to do their own startup work.

This method will always be called before the next transport in the chain is called in order to allow this transport a chance to initialize required resources.

Reimplemented in activemq::transport::tcp::TcpTransport.

virtual void activemq::transport::TransportFilter::beforeNextIsStopped ( )

inlineprotectedvirtual

Subclasses can override this method to do their own pre-stop work.

This method will always be called before the next transport's own stop() method or this filter's own doStop() method is called.

Reimplemented in activemq::transport::inactivity::InactivityMonitor.

void activemq::transport::TransportFilter::checkClosed ( ) const

protected

Throws an IOException if this filter chain has already been closed.

void activemq::transport::TransportFilter::close ( )

virtual

Closes this object and deallocates the appropriate resources.

The object is generally no longer usable after calling close.

Exceptions

IOException if an error occurs while closing.

Implements decaf::io::Closeable.

virtual void activemq::transport::TransportFilter::doClose ( )

inlineprotectedvirtual

Subclasses can override this method to do their own close work.

This method is always called after all the next transports have been closed to prevent this transport for destroying resources needed by the lower level transports.

Reimplemented in activemq::transport::tcp::TcpTransport, activemq::transport::correlator::ResponseCorrelator, and activemq::transport::inactivity::InactivityMonitor.

virtual std::string activemq::transport::TransportFilter::getRemoteAddress ( ) const

inlinevirtual

Returns: the remote address for this connection

Implements activemq::transport::Transport.

virtual TransportListener* activemq::transport::TransportFilter::getTransportListener ( ) const

inlinevirtual

Gets the observer of asynchronous events from this transport.

Returns: the listener of transport events.

Implements activemq::transport::Transport.

virtual Pointer<wireformat::WireFormat> activemq::transport::TransportFilter::getWireFormat ( ) const

virtual

Gets the WireFormat instance that is in use by this transport.

In the case of nested transport this method delegates down to the lowest level transport that actually maintains a WireFormat info instance.

Returns: The WireFormat the object used to encode / decode commands.

Implements activemq::transport::Transport.

virtual bool activemq::transport::TransportFilter::isClosed ( ) const

virtual

Has the Transport been shutdown and no longer usable.

Returns: true if the Transport

Implements activemq::transport::Transport.

virtual bool activemq::transport::TransportFilter::isConnected ( ) const

inlinevirtual

Is the Transport Connected to its Broker.

Returns: true if a connection has been made.

Implements activemq::transport::Transport.

Reimplemented in activemq::transport::tcp::TcpTransport.

virtual bool activemq::transport::TransportFilter::isFaultTolerant ( ) const

inlinevirtual

Is this Transport fault tolerant, meaning that it will reconnect to a broker on disconnect.

Returns: true if the Transport is fault tolerant.

Implements activemq::transport::Transport.

Reimplemented in activemq::transport::tcp::TcpTransport.

virtual bool activemq::transport::TransportFilter::isReconnectSupported ( ) const

inlinevirtual

Returns: true if reconnect is supported.

Implements activemq::transport::Transport.

virtual bool activemq::transport::TransportFilter::isUpdateURIsSupported ( ) const

inlinevirtual

Returns: true if updating uris is supported.

Implements activemq::transport::Transport.

virtual Transport* activemq::transport::TransportFilter::narrow ( const std::type_info & typeId )

virtual

Narrows down a Chain of Transports to a specific Transport to allow a higher level transport to skip intermediate Transports in certain circumstances.

Parameters

typeId - The type_info of the Object we are searching for.

Returns: the requested Object. or NULL if its not in this chain.

Implements activemq::transport::Transport.

virtual void activemq::transport::TransportFilter::onCommand ( const Pointer< Command > command )

virtual

Event handler for the receipt of a command.

Parameters

command - the received command object.

Implements activemq::transport::TransportListener.

Reimplemented in activemq::transport::correlator::ResponseCorrelator, activemq::wireformat::openwire::OpenWireFormatNegotiator, activemq::transport::inactivity::InactivityMonitor, and activemq::transport::logging::LoggingTransport.

virtual void activemq::transport::TransportFilter::oneway ( const Pointer< Command > command )

inlinevirtual

Sends a one-way command.

Does not wait for any response from the broker.

Parameters

command The command to be sent.

Exceptions

IOException	if an exception occurs during writing of the command.
UnsupportedOperationException	if this method is not implemented by this transport.

Implements activemq::transport::Transport.

Reimplemented in activemq::wireformat::openwire::OpenWireFormatNegotiator, activemq::transport::inactivity::InactivityMonitor, activemq::transport::correlator::ResponseCorrelator, and activemq::transport::logging::LoggingTransport.

virtual void activemq::transport::TransportFilter::onException ( const decaf::lang::Exception & ex )

virtual

Event handler for an exception from a command transport.

Parameters

ex	The exception to handle.

Implements activemq::transport::TransportListener.

Reimplemented in activemq::transport::correlator::ResponseCorrelator, activemq::wireformat::openwire::OpenWireFormatNegotiator, and activemq::transport::inactivity::InactivityMonitor.

virtual void activemq::transport::TransportFilter::reconnect ( const decaf::net::URI & uri )

virtual

reconnect to another location

Parameters

uri	The new URI to connect this Transport to.

Exceptions

IOException on failure or if reconnect is not supported.

Implements activemq::transport::Transport.

virtual Pointer<Response> activemq::transport::TransportFilter::request ( const Pointer< Command > command )

inlinevirtual

Sends the given command to the broker and then waits for the response.

Parameters

command the command to be sent.

Returns: the response from the broker.

Exceptions

IOException	if an exception occurs during the read of the command.
UnsupportedOperationException	if this method is not implemented by this transport.

Implements activemq::transport::Transport.

Reimplemented in activemq::wireformat::openwire::OpenWireFormatNegotiator, activemq::transport::correlator::ResponseCorrelator, and activemq::transport::logging::LoggingTransport.

virtual Pointer<Response> activemq::transport::TransportFilter::request	(	const Pointer< Command >	command,
		unsigned int	timeout
	)

inlinevirtual

Sends the given command to the broker and then waits for the response.

Parameters

command	The command to be sent.
timeout	The time to wait for this response.

Returns: the response from the broker.

Exceptions

IOException	if an exception occurs during the read of the command.
UnsupportedOperationException	if this method is not implemented by this transport.

Implements activemq::transport::Transport.

Reimplemented in activemq::wireformat::openwire::OpenWireFormatNegotiator, activemq::transport::correlator::ResponseCorrelator, and activemq::transport::logging::LoggingTransport.

virtual void activemq::transport::TransportFilter::setTransportListener ( TransportListener * listener )

inlinevirtual

Sets the observer of asynchronous events from this transport.

Parameters

listener the listener of transport events.

Implements activemq::transport::Transport.

virtual void activemq::transport::TransportFilter::setWireFormat ( const Pointer< wireformat::WireFormat > wireFormat )

virtual

Sets the WireFormat instance to use.

Parameters

wireFormat The WireFormat the object used to encode / decode commands.

Implements activemq::transport::Transport.

void activemq::transport::TransportFilter::start ( )

virtual

Starts the Transport, the send methods of a Transport will throw an exception if used before the Transport is started.

Exceptions

IOException if and error occurs while starting the Transport.

Implements activemq::transport::Transport.

void activemq::transport::TransportFilter::stop ( )

virtual

Stops the Transport.

Exceptions

IOException if an error occurs while stopping the transport.

Implements activemq::transport::Transport.

virtual void activemq::transport::TransportFilter::transportInterrupted ( )

virtual

The transport has suffered an interruption from which it hopes to recover.

Implements activemq::transport::TransportListener.

virtual void activemq::transport::TransportFilter::transportResumed ( )

virtual

The transport has resumed after an interruption.

Implements activemq::transport::TransportListener.

virtual void activemq::transport::TransportFilter::updateURIs	(	bool	rebalance,
		const decaf::util::List< decaf::net::URI > &	uris
	)

inlinevirtual

Updates the set of URIs the Transport can connect to.

If the Transport doesn't support updating its URIs then an IOException is thrown.

Parameters

rebalance	Indicates if a forced reconnection should be performed as a result of the update.
uris	The new list of URIs that can be used for connection.

Exceptions

IOException if an error occurs or updates aren't supported.

Implements activemq::transport::Transport.

Field Documentation

TransportListener* activemq::transport::TransportFilter::listener

protected

Listener of this transport.

Pointer<Transport> activemq::transport::TransportFilter::next

protected

The transport that this filter wraps around.

The documentation for this class was generated from the following file:

src/main/activemq/transport/TransportFilter.h

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Field Documentation