net.reini.rabbitmq.cdi

Class ConnectionProducer

java.lang.Object

net.reini.rabbitmq.cdi.ConnectionProducer

@ApplicationScoped
public class ConnectionProducer
extends java.lang.Object

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

Constructor Summary

Constructors

Constructor and Description
ConnectionProducer()

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	getConnection(ConnectionConfig config) Gets a new connection from the factory.
void	registerConnectionListener(ConnectionConfig config, ConnectionListener listener) Registers a connection listener at the factory which is notified about changes of connection states.
void	removeConnectionListener(ConnectionConfig config, ConnectionListener listener) Removes a connection listener from the factory.

Methods inherited from class java.lang.Object

clone, 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

ConnectionProducer

public ConnectionProducer()

Method Detail

getConnection

public com.rabbitmq.client.Connection getConnection(ConnectionConfig config)
                                             throws java.io.IOException,
                                                    java.util.concurrent.TimeoutException,
                                                    java.security.NoSuchAlgorithmException

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.

Parameters:

config - the connection configuration

Returns:

The connection

Throws:

java.io.IOException - if the connection handling fails

java.util.concurrent.TimeoutException - if the connection could not be established within the timeout

java.security.NoSuchAlgorithmException - if the security context creation for secured connection fails

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.

registerConnectionListener

public void registerConnectionListener(ConnectionConfig config,
                                       ConnectionListener listener)

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

Parameters:

config - the connection configuration

listener - The connection listener

removeConnectionListener

public void removeConnectionListener(ConnectionConfig config,
                                     ConnectionListener listener)

Removes a connection listener from the factory.

Parameters:

config - the connection configuration

listener - The connection listener