com.rabbitmq.client.impl.recovery

Class AutorecoveringConnection

java.lang.Object

com.rabbitmq.client.impl.recovery.AutorecoveringConnection

All Implemented Interfaces:

Connection, NetworkConnection, Recoverable, ShutdownNotifier

public class AutorecoveringConnection
extends java.lang.Object
implements Connection, Recoverable, NetworkConnection

Connection implementation that performs automatic recovery when connection shutdown is not initiated by the application (e.g. due to an I/O exception). Topology (exchanges, queues, bindings, and consumers) can be (and by default is) recovered as well, in this order:

1. Exchanges
2. Queues
3. Bindings (both queue and exchange-to-exchange)
4. Consumers

Since:

3.3.0

See Also:

Connection, Recoverable, ConnectionFactory.setAutomaticRecoveryEnabled(boolean), ConnectionFactory.setTopologyRecoveryEnabled(boolean)

Constructor Summary

Constructors

Constructor and Description
AutorecoveringConnection(ConnectionParams params, FrameHandlerFactory f, Address[] addrs)

Method Summary

Methods

Modifier and Type	Method and Description
void	abort() Abort this connection and all its channels with the AMQP.REPLY_SUCCESS close code and message 'OK'.
void	abort(int timeout) Abort this connection and all its channels with the AMQP.REPLY_SUCCESS close code and message 'OK'.
void	abort(int closeCode, java.lang.String closeMessage) Abort this connection and all its channels.
void	abort(int closeCode, java.lang.String closeMessage, int timeout) Abort this connection and all its channels.
void	addBlockedListener(BlockedListener listener) Add a BlockedListener.
void	addConsumerRecoveryListener(ConsumerRecoveryListener listener) Not part of the public API.
void	addQueueRecoveryListener(QueueRecoveryListener listener) Not part of the public API.
void	addRecoveryListener(RecoveryListener listener) Adds the recovery listener
void	addShutdownListener(ShutdownListener listener) Add shutdown listener.
void	clearBlockedListeners() Remove all BlockedListeners.
void	close() Close this connection and all its channels with the AMQP.REPLY_SUCCESS close code and message 'OK'.
void	close(int timeout) Close this connection and all its channels with the AMQP.REPLY_SUCCESS close code and message 'OK'.
void	close(int closeCode, java.lang.String closeMessage) Close this connection and all its channels.
void	close(int closeCode, java.lang.String closeMessage, int timeout) Close this connection and all its channels.
Channel	createChannel() Create a new channel, using an internally allocated channel number.
Channel	createChannel(int channelNumber) Create a new channel, using the specified channel number if possible.
java.net.InetAddress	getAddress() Retrieve the host.
int	getChannelMax() Get the negotiated maximum channel number.
java.util.Map<java.lang.String,java.lang.Object>	getClientProperties() Get a copy of the map of client properties sent to the server
ShutdownSignalException	getCloseReason() Get the shutdown reason object
ExceptionHandler	getExceptionHandler() Get the exception handler.
int	getFrameMax() Get the negotiated maximum frame size.
int	getHeartbeat() Get the negotiated heartbeat interval.
java.net.InetAddress	getLocalAddress() Retrieve the local host.
int	getLocalPort() Retrieve the local port number.
int	getPort() Retrieve the port number.
java.util.Map<java.lang.String,RecordedExchange>	getRecordedExchanges()
java.util.Map<java.lang.String,RecordedQueue>	getRecordedQueues()
java.util.Map<java.lang.String,java.lang.Object>	getServerProperties() Retrieve the server properties.
void	init() Private API.
boolean	isOpen() Determine whether the component is currently open.
void	notifyListeners() Protected API - notify the listeners attached to the component
boolean	removeBlockedListener(BlockedListener listener) Remove a BlockedListener.
void	removeConsumerRecoveryListener(ConsumerRecoveryListener listener)
void	removeQueueRecoveryListener(QueueRecoveryListener listener)
void	removeRecoveryListener(RecoveryListener listener) Removes the recovery listener
void	removeShutdownListener(ShutdownListener listener) Remove shutdown listener for the component.
protected boolean	shouldTriggerConnectionRecovery(ShutdownSignalException cause)
void	start()
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

AutorecoveringConnection

public AutorecoveringConnection(ConnectionParams params,
                        FrameHandlerFactory f,
                        Address[] addrs)

Method Detail

init

public void init()
          throws java.io.IOException,
                 java.util.concurrent.TimeoutException

Private API.

Throws:

java.io.IOException

java.util.concurrent.TimeoutException

See Also:

ConnectionFactory.newConnection(java.util.concurrent.ExecutorService)

start

public void start()
           throws java.io.IOException

Throws:

java.io.IOException

createChannel

public Channel createChannel()
                      throws java.io.IOException

Description copied from interface: Connection

Create a new channel, using an internally allocated channel number. If automatic connection recovery is enabled, the channel returned by this method will be Recoverable.

Specified by:

createChannel in interface Connection

Returns:

a new channel descriptor, or null if none is available

Throws:

java.io.IOException - if an I/O problem is encountered

See Also:

Connection.createChannel()

createChannel

public Channel createChannel(int channelNumber)
                      throws java.io.IOException

Description copied from interface: Connection

Create a new channel, using the specified channel number if possible.

Specified by:

createChannel in interface Connection

Parameters:

channelNumber - the channel number to allocate

Returns:

a new channel descriptor, or null if this channel number is already in use

Throws:

java.io.IOException - if an I/O problem is encountered

See Also:

Connection.createChannel(int)

getServerProperties

public java.util.Map<java.lang.String,java.lang.Object> getServerProperties()

Description copied from interface: Connection

Retrieve the server properties.

Specified by:

getServerProperties in interface Connection

Returns:

a map of the server properties. This typically includes the product name and version of the server.

See Also:

Connection.getServerProperties()

getClientProperties

public java.util.Map<java.lang.String,java.lang.Object> getClientProperties()

Description copied from interface: Connection

Get a copy of the map of client properties sent to the server

Specified by:

getClientProperties in interface Connection

Returns:

a copy of the map of client properties

See Also:

Connection.getClientProperties()

getFrameMax

public int getFrameMax()

Description copied from interface: Connection

Get the negotiated maximum frame size.

Specified by:

getFrameMax in interface Connection

Returns:

the maximum frame size, in octets; zero if unlimited

See Also:

Connection.getFrameMax()

getHeartbeat

public int getHeartbeat()

Description copied from interface: Connection

Get the negotiated heartbeat interval.

Specified by:

getHeartbeat in interface Connection

Returns:

the heartbeat interval, in seconds; zero if none

See Also:

Connection.getHeartbeat()

getChannelMax

public int getChannelMax()

Description copied from interface: Connection

Get the negotiated maximum channel number. Usable channel numbers range from 1 to this number, inclusive.

Specified by:

getChannelMax in interface Connection

Returns:

the maximum channel number permitted for this connection.

See Also:

Connection.getChannelMax()

isOpen

public boolean isOpen()

Description copied from interface: ShutdownNotifier

Determine whether the component is currently open. Will return false if we are currently closing. Checking this method should be only for information, because of the race conditions - state can change after the call. Instead just execute and try to catch ShutdownSignalException and IOException

Specified by:

isOpen in interface ShutdownNotifier

Returns:

true when component is open, false otherwise

See Also:

ShutdownNotifier.isOpen()

close

public void close()
           throws java.io.IOException

Description copied from interface: Connection

Close this connection and all its channels with the AMQP.REPLY_SUCCESS close code and message 'OK'. Waits for all the close operations to complete.

Specified by:

close in interface Connection

Throws:

java.io.IOException - if an I/O problem is encountered

See Also:

Connection.close()

close

public void close(int timeout)
           throws java.io.IOException

Description copied from interface: Connection

Close this connection and all its channels with the AMQP.REPLY_SUCCESS close code and message 'OK'. This method behaves in a similar way as Connection.close(), with the only difference that it waits with a provided timeout for all the close operations to complete. When timeout is reached the socket is forced to close.

Specified by:

close in interface Connection

Parameters:

timeout - timeout (in milliseconds) for completing all the close-related operations, use -1 for infinity

Throws:

java.io.IOException - if an I/O problem is encountered

See Also:

Connection.close(int)

close

public void close(int closeCode,
         java.lang.String closeMessage,
         int timeout)
           throws java.io.IOException

Description copied from interface: Connection

Close this connection and all its channels. Waits with the given timeout for all the close operations to complete. When timeout is reached the socket is forced to close.

Specified by:

close in interface Connection

Parameters:

closeCode - the close code (See under "Reply Codes" in the AMQP specification)

closeMessage - a message indicating the reason for closing the connection

timeout - timeout (in milliseconds) for completing all the close-related operations, use -1 for infinity

Throws:

java.io.IOException - if an I/O problem is encountered

See Also:

Connection.close(int, String, int)

abort

public void abort()

Description copied from interface: Connection

Abort this connection and all its channels with the AMQP.REPLY_SUCCESS close code and message 'OK'. Forces the connection to close. Any encountered exceptions in the close operations are silently discarded.

Specified by:

abort in interface Connection

See Also:

Connection.abort()

abort

public void abort(int closeCode,
         java.lang.String closeMessage,
         int timeout)

Description copied from interface: Connection

Abort this connection and all its channels. Forces the connection to close and waits with the given timeout for all the close operations to complete. When timeout is reached the socket is forced to close. Any encountered exceptions in the close operations are silently discarded.

Specified by:

abort in interface Connection

Parameters:

closeCode - the close code (See under "Reply Codes" in the AMQP specification)

closeMessage - a message indicating the reason for closing the connection

timeout - timeout (in milliseconds) for completing all the close-related operations, use -1 for infinity

See Also:

Connection.abort(int, String, int)

abort

public void abort(int closeCode,
         java.lang.String closeMessage)

Description copied from interface: Connection

Abort this connection and all its channels. Forces the connection to close and waits for all the close operations to complete. Any encountered exceptions in the close operations are silently discarded.

Specified by:

abort in interface Connection

Parameters:

closeCode - the close code (See under "Reply Codes" in the AMQP specification)

closeMessage - a message indicating the reason for closing the connection

See Also:

Connection.abort(int, String)

abort

public void abort(int timeout)

Description copied from interface: Connection

Abort this connection and all its channels with the AMQP.REPLY_SUCCESS close code and message 'OK'. This method behaves in a similar way as Connection.abort(), with the only difference that it waits with a provided timeout for all the close operations to complete. When timeout is reached the socket is forced to close.

Specified by:

abort in interface Connection

Parameters:

timeout - timeout (in milliseconds) for completing all the close-related operations, use -1 for infinity

See Also:

Connection.abort(int)

getCloseReason

public ShutdownSignalException getCloseReason()

Description copied from interface: ShutdownNotifier

Get the shutdown reason object

Specified by:

getCloseReason in interface ShutdownNotifier

Returns:

ShutdownSignalException if component is closed, null otherwise

See Also:

ShutdownNotifier.getCloseReason()

addBlockedListener

public void addBlockedListener(BlockedListener listener)

Description copied from interface: Connection

Add a BlockedListener.

Specified by:

addBlockedListener in interface Connection

Parameters:

listener - the listener to add

See Also:

ShutdownNotifier.addShutdownListener(com.rabbitmq.client.ShutdownListener)

removeBlockedListener

public boolean removeBlockedListener(BlockedListener listener)

Description copied from interface: Connection

Remove a BlockedListener.

Specified by:

removeBlockedListener in interface Connection

Parameters:

listener - the listener to remove

Returns:

true if the listener was found and removed, false otherwise

See Also:

Connection.removeBlockedListener(com.rabbitmq.client.BlockedListener)

clearBlockedListeners

public void clearBlockedListeners()

Description copied from interface: Connection

Remove all BlockedListeners.

Specified by:

clearBlockedListeners in interface Connection

See Also:

Connection.clearBlockedListeners()

close

public void close(int closeCode,
         java.lang.String closeMessage)
           throws java.io.IOException

Description copied from interface: Connection

Close this connection and all its channels. Waits for all the close operations to complete.

Specified by:

close in interface Connection

Parameters:

closeCode - the close code (See under "Reply Codes" in the AMQP specification)

closeMessage - a message indicating the reason for closing the connection

Throws:

java.io.IOException - if an I/O problem is encountered

See Also:

Connection.close(int, String)

addShutdownListener

public void addShutdownListener(ShutdownListener listener)

Description copied from interface: ShutdownNotifier

Add shutdown listener. If the component is already closed, handler is fired immediately

Specified by:

addShutdownListener in interface ShutdownNotifier

Parameters:

listener - ShutdownListener to the component

See Also:

ShutdownNotifier.addShutdownListener(com.rabbitmq.client.ShutdownListener)

removeShutdownListener

public void removeShutdownListener(ShutdownListener listener)

Description copied from interface: ShutdownNotifier

Remove shutdown listener for the component.

Specified by:

removeShutdownListener in interface ShutdownNotifier

Parameters:

listener - ShutdownListener to be removed

See Also:

ShutdownNotifier.removeShutdownListener(com.rabbitmq.client.ShutdownListener)

notifyListeners

public void notifyListeners()

Description copied from interface: ShutdownNotifier

Protected API - notify the listeners attached to the component

Specified by:

notifyListeners in interface ShutdownNotifier

See Also:

ShutdownNotifier.notifyListeners()

addRecoveryListener

public void addRecoveryListener(RecoveryListener listener)

Adds the recovery listener

Specified by:

addRecoveryListener in interface Recoverable

Parameters:

listener - RecoveryListener to execute after this connection recovers from network failure

removeRecoveryListener

public void removeRecoveryListener(RecoveryListener listener)

Removes the recovery listener

Specified by:

removeRecoveryListener in interface Recoverable

Parameters:

listener - RecoveryListener to remove

getExceptionHandler

public ExceptionHandler getExceptionHandler()

Description copied from interface: Connection

Get the exception handler.

Specified by:

getExceptionHandler in interface Connection

See Also:

AMQConnection.getExceptionHandler()

getPort

public int getPort()

Description copied from interface: Connection

Retrieve the port number.

Specified by:

getPort in interface Connection

Specified by:

getPort in interface NetworkConnection

Returns:

the port number of the peer we're connected to.

See Also:

Connection.getPort()

getAddress

public java.net.InetAddress getAddress()

Description copied from interface: Connection

Retrieve the host.

Specified by:

getAddress in interface Connection

Specified by:

getAddress in interface NetworkConnection

Returns:

the hostname of the peer we're connected to.

See Also:

Connection.getAddress()

getLocalAddress

public java.net.InetAddress getLocalAddress()

Description copied from interface: NetworkConnection

Retrieve the local host.

Specified by:

getLocalAddress in interface NetworkConnection

Returns:

client socket address

getLocalPort

public int getLocalPort()

Description copied from interface: NetworkConnection

Retrieve the local port number.

Specified by:

getLocalPort in interface NetworkConnection

Returns:

client socket port

shouldTriggerConnectionRecovery

protected boolean shouldTriggerConnectionRecovery(ShutdownSignalException cause)

addQueueRecoveryListener

public void addQueueRecoveryListener(QueueRecoveryListener listener)

Not part of the public API. Mean to be used by JVM RabbitMQ clients that build on top of the Java client and need to be notified when server-named queue name changes after recovery.

Parameters:

listener - listener that observes queue name changes after recovery

removeQueueRecoveryListener

public void removeQueueRecoveryListener(QueueRecoveryListener listener)

Parameters:

listener - listener to be removed

See Also:

addQueueRecoveryListener(com.rabbitmq.client.impl.recovery.QueueRecoveryListener)

addConsumerRecoveryListener

public void addConsumerRecoveryListener(ConsumerRecoveryListener listener)

Not part of the public API. Mean to be used by JVM RabbitMQ clients that build on top of the Java client and need to be notified when consumer tag changes after recovery.

Parameters:

listener - listener that observes consumer tag changes after recovery

removeConsumerRecoveryListener

public void removeConsumerRecoveryListener(ConsumerRecoveryListener listener)

Parameters:

listener - listener to be removed

See Also:

addConsumerRecoveryListener(ConsumerRecoveryListener)

getRecordedQueues

public java.util.Map<java.lang.String,RecordedQueue> getRecordedQueues()

getRecordedExchanges

public java.util.Map<java.lang.String,RecordedExchange> getRecordedExchanges()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object