org.apache.qpid.client

Class AMQConnectionFactory

java.lang.Object

org.apache.qpid.client.AMQConnectionFactory

All Implemented Interfaces:

Serializable, javax.jms.ConnectionFactory, javax.jms.QueueConnectionFactory, javax.jms.TopicConnectionFactory, javax.jms.XAConnectionFactory, javax.jms.XAQueueConnectionFactory, javax.jms.XATopicConnectionFactory, Referenceable, ObjectFactory

public class AMQConnectionFactory
extends Object
implements javax.jms.ConnectionFactory, javax.jms.QueueConnectionFactory, javax.jms.TopicConnectionFactory, ObjectFactory, Referenceable, javax.jms.XATopicConnectionFactory, javax.jms.XAQueueConnectionFactory, javax.jms.XAConnectionFactory, Serializable

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	NO_URL_CONFIGURED

Constructor Summary

Constructors

Constructor and Description
AMQConnectionFactory()
AMQConnectionFactory(ConnectionURL url)
AMQConnectionFactory(String url)

Method Summary

Methods

Modifier and Type	Method and Description
AMQConnection	createConnection()
AMQConnection	createConnection(String userName, String password)
AMQConnection	createConnection(String userName, String password, String id)
javax.jms.QueueConnection	createQueueConnection()
javax.jms.QueueConnection	createQueueConnection(String username, String password)
javax.jms.TopicConnection	createTopicConnection()
javax.jms.TopicConnection	createTopicConnection(String username, String password)
javax.jms.XAConnection	createXAConnection() Creates a XAConnection with the default user identity.
javax.jms.XAConnection	createXAConnection(String username, String password) Creates a XAConnection with the specified user identity.
javax.jms.XAQueueConnection	createXAQueueConnection() Creates a XAQueueConnection with the default user identity.
javax.jms.XAQueueConnection	createXAQueueConnection(String username, String password) Creates a XAQueueConnection with the specified user identity.
javax.jms.XATopicConnection	createXATopicConnection() Creates a XATopicConnection with the default user identity.
javax.jms.XATopicConnection	createXATopicConnection(String username, String password) Creates a XATopicConnection with the specified user identity.
boolean	equals(Object o)
ConnectionURL	getConnectionURL()
String	getConnectionURLString()
Object	getObjectInstance(Object obj, Name name, Context ctx, Hashtable env) Deprecated. Use ObjectFactory instead
Reference	getReference()
static String	getUniqueClientID()
String	getVirtualPath()
int	hashCode()
void	setConnectionURLString(String url)
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

NO_URL_CONFIGURED

protected static final String NO_URL_CONFIGURED

See Also:

Constant Field Values

Constructor Detail

AMQConnectionFactory

public AMQConnectionFactory()

AMQConnectionFactory

public AMQConnectionFactory(String url)
                     throws URLSyntaxException

Throws:

URLSyntaxException

AMQConnectionFactory

public AMQConnectionFactory(ConnectionURL url)

Method Detail

getVirtualPath

public final String getVirtualPath()

Returns:

the virtualPath of the connection details.

getUniqueClientID

public static String getUniqueClientID()

createConnection

public AMQConnection createConnection()
                               throws javax.jms.JMSException

Specified by:

createConnection in interface javax.jms.ConnectionFactory

Throws:

javax.jms.JMSException

createConnection

public AMQConnection createConnection(String userName,
                             String password)
                               throws javax.jms.JMSException

Specified by:

createConnection in interface javax.jms.ConnectionFactory

Throws:

javax.jms.JMSException

createConnection

public AMQConnection createConnection(String userName,
                             String password,
                             String id)
                               throws javax.jms.JMSException

Throws:

javax.jms.JMSException

createQueueConnection

public javax.jms.QueueConnection createQueueConnection()
                                                throws javax.jms.JMSException

Specified by:

createQueueConnection in interface javax.jms.QueueConnectionFactory

Throws:

javax.jms.JMSException

createQueueConnection

public javax.jms.QueueConnection createQueueConnection(String username,
                                              String password)
                                                throws javax.jms.JMSException

Specified by:

createQueueConnection in interface javax.jms.QueueConnectionFactory

Throws:

javax.jms.JMSException

createTopicConnection

public javax.jms.TopicConnection createTopicConnection()
                                                throws javax.jms.JMSException

Specified by:

createTopicConnection in interface javax.jms.TopicConnectionFactory

Throws:

javax.jms.JMSException

createTopicConnection

public javax.jms.TopicConnection createTopicConnection(String username,
                                              String password)
                                                throws javax.jms.JMSException

Specified by:

createTopicConnection in interface javax.jms.TopicConnectionFactory

Throws:

javax.jms.JMSException

getConnectionURL

public ConnectionURL getConnectionURL()

getConnectionURLString

public String getConnectionURLString()

setConnectionURLString

public final void setConnectionURLString(String url)
                                  throws URLSyntaxException

Throws:

URLSyntaxException

getObjectInstance

@Deprecated
public Object getObjectInstance(Object obj,
                                  Name name,
                                  Context ctx,
                                  Hashtable env)
                         throws Exception

Deprecated. Use ObjectFactory instead

JNDI interface to create objects from References.

Specified by:

getObjectInstance in interface ObjectFactory

Parameters:

obj - The Reference from JNDI

name -

ctx -

env -

Returns:

AMQConnection,AMQTopic,AMQQueue, or AMQConnectionFactory.

Throws:

Exception

getReference

public Reference getReference()
                       throws NamingException

Specified by:

getReference in interface Referenceable

Throws:

NamingException

createXAConnection

public javax.jms.XAConnection createXAConnection()
                                          throws javax.jms.JMSException

Creates a XAConnection with the default user identity.

The XAConnection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Specified by:

createXAConnection in interface javax.jms.XAConnectionFactory

Returns:

A newly created XAConnection

Throws:

javax.jms.JMSException - If creating the XAConnection fails due to some internal error.

javax.jms.JMSSecurityException - If client authentication fails due to an invalid user name or password.

createXAConnection

public javax.jms.XAConnection createXAConnection(String username,
                                        String password)
                                          throws javax.jms.JMSException

Creates a XAConnection with the specified user identity.

The XAConnection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Specified by:

createXAConnection in interface javax.jms.XAConnectionFactory

Parameters:

username - the caller's user name

password - the caller's password

Returns:

A newly created XAConnection.

Throws:

javax.jms.JMSException - If creating the XAConnection fails due to some internal error.

javax.jms.JMSSecurityException - If client authentication fails due to an invalid user name or password.

createXATopicConnection

public javax.jms.XATopicConnection createXATopicConnection()
                                                    throws javax.jms.JMSException

Creates a XATopicConnection with the default user identity.

The XATopicConnection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Specified by:

createXATopicConnection in interface javax.jms.XATopicConnectionFactory

Returns:

A newly created XATopicConnection

Throws:

javax.jms.JMSException - If creating the XATopicConnection fails due to some internal error.

javax.jms.JMSSecurityException - If client authentication fails due to an invalid user name or password.

createXATopicConnection

public javax.jms.XATopicConnection createXATopicConnection(String username,
                                                  String password)
                                                    throws javax.jms.JMSException

Creates a XATopicConnection with the specified user identity.

The XATopicConnection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Specified by:

createXATopicConnection in interface javax.jms.XATopicConnectionFactory

Parameters:

username - the caller's user name

password - the caller's password

Returns:

A newly created XATopicConnection.

Throws:

javax.jms.JMSException - If creating the XATopicConnection fails due to some internal error.

javax.jms.JMSSecurityException - If client authentication fails due to an invalid user name or password.

createXAQueueConnection

public javax.jms.XAQueueConnection createXAQueueConnection()
                                                    throws javax.jms.JMSException

Creates a XAQueueConnection with the default user identity.

The XAQueueConnection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Specified by:

createXAQueueConnection in interface javax.jms.XAQueueConnectionFactory

Returns:

A newly created XAQueueConnection

Throws:

javax.jms.JMSException - If creating the XAQueueConnection fails due to some internal error.

javax.jms.JMSSecurityException - If client authentication fails due to an invalid user name or password.

createXAQueueConnection

public javax.jms.XAQueueConnection createXAQueueConnection(String username,
                                                  String password)
                                                    throws javax.jms.JMSException

Creates a XAQueueConnection with the specified user identity.

The XAQueueConnection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Specified by:

createXAQueueConnection in interface javax.jms.XAQueueConnectionFactory

Parameters:

username - the caller's user name

password - the caller's password

Returns:

A newly created XAQueueConnection.

Throws:

javax.jms.JMSException - If creating the XAQueueConnection fails due to some internal error.

javax.jms.JMSSecurityException - If client authentication fails due to an invalid user name or password.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object