com.rabbitmq.client

Class ConnectionFactory

java.lang.Object

com.rabbitmq.client.ConnectionFactory

All Implemented Interfaces:

java.lang.Cloneable

public class ConnectionFactory
extends java.lang.Object
implements java.lang.Cloneable

Convenience "factory" class to facilitate opening a Connection to an AMQP broker.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_AMQP_OVER_SSL_PORT The default port to use for AMQP connections when using SSL
static int	DEFAULT_AMQP_PORT The default port to use for AMQP connections when not using SSL
static int	DEFAULT_CHANNEL_MAX Default value for the desired maximum channel number; zero for unlimited
static int	DEFAULT_CONNECTION_TIMEOUT The default connection timeout (wait indefinitely until connection established or error occurs)
static int	DEFAULT_FRAME_MAX Default value for the desired maximum frame size; zero for unlimited
static int	DEFAULT_HEARTBEAT Default value for desired heartbeat interval; zero for none
static java.lang.String	DEFAULT_HOST The default host to connect to
static java.lang.String	DEFAULT_PASS Default password
static java.lang.String	DEFAULT_SSL_PROTOCOL The default SSL protocol (currently "SSLv3").
static java.lang.String	DEFAULT_USER Default user name
static java.lang.String	DEFAULT_VHOST Default virtual host
static int	USE_DEFAULT_PORT A constant that when passed as a port number causes the connection to use the default port

Constructor Summary

Constructors

Constructor and Description
ConnectionFactory() Instantiate a ConnectionFactory with a default set of parameters.

Method Summary

Methods

Modifier and Type	Method and Description
ConnectionFactory	clone()
protected void	configureSocket(java.net.Socket socket) Provides a hook to insert custom configuration of the sockets used to connect to an AMQP server before they connect.
protected FrameHandler	createFrameHandler(Address addr)
protected FrameHandler	createFrameHandler(java.net.Socket sock)
java.util.Map<java.lang.String,java.lang.Object>	getClientProperties() Retrieve the currently-configured table of client properties that will be sent to the server during connection startup.
int	getConnectionTimeout() Retrieve the connection timeout.
java.lang.String	getHost()
java.lang.String	getPassword() Retrieve the password.
int	getPort()
int	getRequestedChannelMax() Retrieve the requested maximum channel number
int	getRequestedFrameMax() Retrieve the requested maximum frame size
int	getRequestedHeartbeat() Retrieve the requested heartbeat interval.
SaslConfig	getSaslConfig() Gets the sasl config to use when authenticating
javax.net.SocketFactory	getSocketFactory() Retrieve the socket factory used to make connections with.
java.lang.String	getUsername() Retrieve the user name.
java.lang.String	getVirtualHost() Retrieve the virtual host.
boolean	isSSL()
Connection	newConnection() Create a new broker connection
Connection	newConnection(Address[] addrs) Create a new broker connection
void	setClientProperties(java.util.Map<java.lang.String,java.lang.Object> clientProperties) Replace the table of client properties that will be sent to the server during subsequent connection startups.
void	setConnectionTimeout(int connectionTimeout) Set the connection timeout.
void	setHost(java.lang.String host)
void	setPassword(java.lang.String password) Set the password.
void	setPort(int port) Set the target port.
void	setRequestedChannelMax(int requestedChannelMax) Set the requested maximum channel number
void	setRequestedFrameMax(int requestedFrameMax) Set the requested maximum frame size
void	setRequestedHeartbeat(int requestedHeartbeat) Set the requested heartbeat.
void	setSaslConfig(SaslConfig saslConfig) Sets the sasl config to use when authenticating
void	setSocketFactory(javax.net.SocketFactory factory) Set the socket factory used to make connections with.
void	setUsername(java.lang.String username) Set the user name.
void	setVirtualHost(java.lang.String virtualHost) Set the virtual host.
void	useSslProtocol() Convenience method for setting up a SSL socket factory, using the DEFAULT_SSL_PROTOCOL and a trusting TrustManager.
void	useSslProtocol(javax.net.ssl.SSLContext context) Convenience method for setting up an SSL socket factory.
void	useSslProtocol(java.lang.String protocol) Convenience method for setting up a SSL socket factory, using the DEFAULT_SSL_PROTOCOL and a trusting TrustManager.
void	useSslProtocol(java.lang.String protocol, javax.net.ssl.TrustManager trustManager) Convenience method for setting up an SSL socket factory.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_USER

public static final java.lang.String DEFAULT_USER

Default user name

See Also:

Constant Field Values

DEFAULT_PASS

public static final java.lang.String DEFAULT_PASS

Default password

See Also:

Constant Field Values

DEFAULT_VHOST

public static final java.lang.String DEFAULT_VHOST

Default virtual host

See Also:

Constant Field Values

DEFAULT_CHANNEL_MAX

public static final int DEFAULT_CHANNEL_MAX

Default value for the desired maximum channel number; zero for unlimited

See Also:

Constant Field Values

DEFAULT_FRAME_MAX

public static final int DEFAULT_FRAME_MAX

Default value for the desired maximum frame size; zero for unlimited

See Also:

Constant Field Values

DEFAULT_HEARTBEAT

public static final int DEFAULT_HEARTBEAT

Default value for desired heartbeat interval; zero for none

See Also:

Constant Field Values

DEFAULT_HOST

public static final java.lang.String DEFAULT_HOST

The default host to connect to

See Also:

Constant Field Values

USE_DEFAULT_PORT

public static final int USE_DEFAULT_PORT

A constant that when passed as a port number causes the connection to use the default port

See Also:

Constant Field Values

DEFAULT_AMQP_PORT

public static final int DEFAULT_AMQP_PORT

The default port to use for AMQP connections when not using SSL

See Also:

Constant Field Values

DEFAULT_AMQP_OVER_SSL_PORT

public static final int DEFAULT_AMQP_OVER_SSL_PORT

The default port to use for AMQP connections when using SSL

See Also:

Constant Field Values

DEFAULT_CONNECTION_TIMEOUT

public static final int DEFAULT_CONNECTION_TIMEOUT

The default connection timeout (wait indefinitely until connection established or error occurs)

See Also:

Constant Field Values

DEFAULT_SSL_PROTOCOL

public static final java.lang.String DEFAULT_SSL_PROTOCOL

The default SSL protocol (currently "SSLv3").

See Also:

Constant Field Values

Constructor Detail

ConnectionFactory

public ConnectionFactory()

Instantiate a ConnectionFactory with a default set of parameters.

Method Detail

getHost

public java.lang.String getHost()

Returns:

the default host to use for connections

setHost

public void setHost(java.lang.String host)

Parameters:

host - the default host to use for connections

getPort

public int getPort()

Returns:

the default port to use for connections

setPort

public void setPort(int port)

Set the target port.

Parameters:

port - the default port to use for connections

getUsername

public java.lang.String getUsername()

Retrieve the user name.

Returns:

the AMQP user name to use when connecting to the broker

setUsername

public void setUsername(java.lang.String username)

Set the user name.

Parameters:

username - the AMQP user name to use when connecting to the broker

getPassword

public java.lang.String getPassword()

Retrieve the password.

Returns:

the password to use when connecting to the broker

setPassword

public void setPassword(java.lang.String password)

Set the password.

Parameters:

password - the password to use when connecting to the broker

getVirtualHost

public java.lang.String getVirtualHost()

Retrieve the virtual host.

Returns:

the virtual host to use when connecting to the broker

setVirtualHost

public void setVirtualHost(java.lang.String virtualHost)

Set the virtual host.

Parameters:

virtualHost - the virtual host to use when connecting to the broker

getRequestedChannelMax

public int getRequestedChannelMax()

Retrieve the requested maximum channel number

Returns:

the initially requested maximum channel number; zero for unlimited

setRequestedChannelMax

public void setRequestedChannelMax(int requestedChannelMax)

Set the requested maximum channel number

Parameters:

requestedChannelMax - initially requested maximum channel number; zero for unlimited

getRequestedFrameMax

public int getRequestedFrameMax()

Retrieve the requested maximum frame size

Returns:

the initially requested maximum frame size, in octets; zero for unlimited

setRequestedFrameMax

public void setRequestedFrameMax(int requestedFrameMax)

Set the requested maximum frame size

Parameters:

requestedFrameMax - initially requested maximum frame size, in octets; zero for unlimited

getRequestedHeartbeat

public int getRequestedHeartbeat()

Retrieve the requested heartbeat interval.

Returns:

the initially requested heartbeat interval, in seconds; zero for none

setConnectionTimeout

public void setConnectionTimeout(int connectionTimeout)

Set the connection timeout.

Parameters:

connectionTimeout - connection establishment timeout in milliseconds; zero for infinite

getConnectionTimeout

public int getConnectionTimeout()

Retrieve the connection timeout.

Returns:

the connection timeout, in milliseconds; zero for infinite

setRequestedHeartbeat

public void setRequestedHeartbeat(int requestedHeartbeat)

Set the requested heartbeat.

Parameters:

requestedHeartbeat - the initially requested heartbeat interval, in seconds; zero for none

getClientProperties

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

Retrieve the currently-configured table of client properties that will be sent to the server during connection startup. Clients may add, delete, and alter keys in this table. Such changes will take effect when the next new connection is started using this factory.

Returns:

the map of client properties

See Also:

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

setClientProperties

public void setClientProperties(java.util.Map<java.lang.String,java.lang.Object> clientProperties)

Replace the table of client properties that will be sent to the server during subsequent connection startups.

Parameters:

clientProperties - the map of extra client properties

See Also:

getClientProperties()

getSaslConfig

public SaslConfig getSaslConfig()

Gets the sasl config to use when authenticating

Returns:

See Also:

SaslConfig

setSaslConfig

public void setSaslConfig(SaslConfig saslConfig)

Sets the sasl config to use when authenticating

Parameters:

saslConfig -

See Also:

SaslConfig

getSocketFactory

public javax.net.SocketFactory getSocketFactory()

Retrieve the socket factory used to make connections with.

setSocketFactory

public void setSocketFactory(javax.net.SocketFactory factory)

Set the socket factory used to make connections with. Can be used to enable SSL connections by passing in a javax.net.ssl.SSLSocketFactory instance.

See Also:

useSslProtocol()

isSSL

public boolean isSSL()

useSslProtocol

public void useSslProtocol()
                    throws java.security.NoSuchAlgorithmException,
                           java.security.KeyManagementException

Convenience method for setting up a SSL socket factory, using the DEFAULT_SSL_PROTOCOL and a trusting TrustManager.

Throws:

java.security.NoSuchAlgorithmException

java.security.KeyManagementException

useSslProtocol

public void useSslProtocol(java.lang.String protocol)
                    throws java.security.NoSuchAlgorithmException,
                           java.security.KeyManagementException

Convenience method for setting up a SSL socket factory, using the DEFAULT_SSL_PROTOCOL and a trusting TrustManager.

Throws:

java.security.NoSuchAlgorithmException

java.security.KeyManagementException

useSslProtocol

public void useSslProtocol(java.lang.String protocol,
                  javax.net.ssl.TrustManager trustManager)
                    throws java.security.NoSuchAlgorithmException,
                           java.security.KeyManagementException

Convenience method for setting up an SSL socket factory. Pass in the SSL protocol to use, e.g. "TLS" or "SSLv3".

Parameters:

protocol - SSL protocol to use.

Throws:

java.security.NoSuchAlgorithmException

java.security.KeyManagementException

useSslProtocol

public void useSslProtocol(javax.net.ssl.SSLContext context)

Convenience method for setting up an SSL socket factory. Pass in an initialized SSLContext.

Parameters:

context - An initialized SSLContext

createFrameHandler

protected FrameHandler createFrameHandler(Address addr)
                                   throws java.io.IOException

Throws:

java.io.IOException

createFrameHandler

protected FrameHandler createFrameHandler(java.net.Socket sock)
                                   throws java.io.IOException

Throws:

java.io.IOException

configureSocket

protected void configureSocket(java.net.Socket socket)
                        throws java.io.IOException

Provides a hook to insert custom configuration of the sockets used to connect to an AMQP server before they connect. The default behaviour of this method is to disable Nagle's algorithm to get more consistently low latency. However it may be overridden freely and there is no requirement to retain this behaviour.

Parameters:

socket - The socket that is to be used for the Connection

Throws:

java.io.IOException

newConnection

public Connection newConnection(Address[] addrs)
                         throws java.io.IOException

Create a new broker connection

Parameters:

addrs - an array of known broker addresses (hostname/port pairs) to try in order

Returns:

an interface to the connection

Throws:

java.io.IOException - if it encounters a problem

newConnection

public Connection newConnection()
                         throws java.io.IOException

Create a new broker connection

Returns:

an interface to the connection

Throws:

java.io.IOException - if it encounters a problem

clone

public ConnectionFactory clone()

Overrides:

clone in class java.lang.Object