net.reini.rabbitmq.cdi

Class CdiConnectionFactory

java.lang.Object

com.rabbitmq.client.ConnectionFactory

net.reini.rabbitmq.cdi.CdiConnectionFactory

All Implemented Interfaces:

java.lang.Cloneable

@Singleton
public class CdiConnectionFactory
extends com.rabbitmq.client.ConnectionFactory

A single connection factory provides ONE SINGLE connection to a RabbitMQ message broker via TCP.

It is recommended by the RabbitMQ documentation (v2.7) to use one single connection within a client and to use one channel for every client thread.

Field Summary

Fields

Modifier and Type	Field and Description
static int	CONNECTION_ESTABLISH_INTERVAL_IN_MS
static int	CONNECTION_HEARTBEAT_IN_SEC
static int	CONNECTION_TIMEOUT_IN_MS

Fields inherited from class com.rabbitmq.client.ConnectionFactory

DEFAULT_AMQP_OVER_SSL_PORT, DEFAULT_AMQP_PORT, DEFAULT_CHANNEL_MAX, DEFAULT_CONNECTION_TIMEOUT, DEFAULT_FRAME_MAX, DEFAULT_HEARTBEAT, DEFAULT_HOST, DEFAULT_PASS, DEFAULT_SHUTDOWN_TIMEOUT, DEFAULT_USER, DEFAULT_VHOST, USE_DEFAULT_PORT

Constructor Summary

Constructors

Constructor and Description
CdiConnectionFactory()

Method Summary

Modifier and Type	Method and Description
void	close() Closes the connection factory and interrupts all threads associated to it.
com.rabbitmq.client.Connection	newConnection() Gets a new connection from the factory.
void	registerListener(ConnectionListener connectionListener) Registers a connection listener at the factory which is notified about changes of connection states.
void	removeConnectionListener(ConnectionListener connectionListener) Removes a connection listener from the factory.

Methods inherited from class com.rabbitmq.client.ConnectionFactory

clone, createFrameHandlerFactory, getClientProperties, getConnectionTimeout, getExceptionHandler, getHost, getNetworkRecoveryInterval, getPassword, getPort, getRequestedChannelMax, getRequestedFrameMax, getRequestedHeartbeat, getSaslConfig, getShutdownTimeout, getSocketConfigurator, getSocketFactory, getThreadFactory, getUsername, getVirtualHost, isAutomaticRecoveryEnabled, isSSL, isTopologyRecoveryEnabled, newConnection, newConnection, newConnection, params, portOrDefault, setAutomaticRecoveryEnabled, setClientProperties, setConnectionTimeout, setExceptionHandler, setHost, setNetworkRecoveryInterval, setNetworkRecoveryInterval, setPassword, setPort, setRequestedChannelMax, setRequestedFrameMax, setRequestedHeartbeat, setSaslConfig, setSharedExecutor, setShutdownTimeout, setSocketConfigurator, setSocketFactory, setThreadFactory, setTopologyRecoveryEnabled, setUri, setUri, setUsername, setVirtualHost, useSslProtocol, useSslProtocol, useSslProtocol, useSslProtocol

Methods inherited from class java.lang.Object

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

Field Detail

CONNECTION_HEARTBEAT_IN_SEC

public static final int CONNECTION_HEARTBEAT_IN_SEC

See Also:

Constant Field Values

CONNECTION_TIMEOUT_IN_MS

public static final int CONNECTION_TIMEOUT_IN_MS

See Also:

Constant Field Values

CONNECTION_ESTABLISH_INTERVAL_IN_MS

public static final int CONNECTION_ESTABLISH_INTERVAL_IN_MS

See Also:

Constant Field Values

Constructor Detail

CdiConnectionFactory

public CdiConnectionFactory()

Method Detail

newConnection

public com.rabbitmq.client.Connection newConnection()
                                             throws java.io.IOException,
                                                    java.util.concurrent.TimeoutException

Gets a new connection from the factory. As this factory only provides one connection for every process, the connection is established on the first call of this method. Every subsequent call will return the same instance of the first established connection.

In case a connection is lost, the factory will try to reestablish a new connection.

Overrides:

newConnection in class com.rabbitmq.client.ConnectionFactory

Returns:

The connection

Throws:

java.io.IOException

java.util.concurrent.TimeoutException

close

@PreDestroy
public void close()

Closes the connection factory and interrupts all threads associated to it.

Note: Make sure to close the connection factory when not used any more as otherwise the connection may remain established and ghost threads may reside.

registerListener

public void registerListener(ConnectionListener connectionListener)

Registers a connection listener at the factory which is notified about changes of connection states.

Parameters:

connectionListener - The connection listener

removeConnectionListener

public void removeConnectionListener(ConnectionListener connectionListener)

Removes a connection listener from the factory.

Parameters:

connectionListener - The connection listener