org.jboss.resource.adapter.jms

Class JmsConnectionFactoryImpl

java.lang.Object

org.jboss.resource.adapter.jms.JmsConnectionFactoryImpl

All Implemented Interfaces:

Serializable, ConnectionFactory, QueueConnectionFactory, TopicConnectionFactory, Referenceable, JmsConnectionFactory

public class JmsConnectionFactoryImpl
extends Object
implements JmsConnectionFactory, Referenceable

The the connection factory implementation for the JMS RA.

This object will be the QueueConnectionFactory or TopicConnectionFactory which clients will use to create connections.

Author:

Peter Antman., Jason Dillon, Adrian Brock

See Also:

Serialized Form

Field Summary

Fields inherited from interface org.jboss.resource.adapter.jms.JmsConnectionFactory

AGNOSTIC, QUEUE, TOPIC

Constructor Summary

Constructors

Constructor and Description
JmsConnectionFactoryImpl(ManagedConnectionFactory mcf, ConnectionManager cm)

Method Summary

Methods

Modifier and Type	Method and Description
Connection	createConnection() Creates a connection with the default user identity.
Connection	createConnection(String userName, String password) Creates a connection with the specified user identity.
QueueConnection	createQueueConnection() Creates a queue connection with the default user identity.
QueueConnection	createQueueConnection(String userName, String password) Creates a queue connection with the specified user identity.
TopicConnection	createTopicConnection() Creates a topic connection with the default user identity.
TopicConnection	createTopicConnection(String userName, String password) Creates a topic connection with the specified user identity.
Reference	getReference()
void	setReference(Reference reference) Sets the Reference instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

JmsConnectionFactoryImpl

public JmsConnectionFactoryImpl(ManagedConnectionFactory mcf,
                        ConnectionManager cm)

Method Detail

setReference

public void setReference(Reference reference)

Description copied from interface: Referenceable

Sets the Reference instance. This method is called by the deployment code to set the Reference that can be later returned by the getReference method (as defined in the javax.naming.Referenceable interface).

Parameters:

reference - A Reference instance

See Also:

Referenceable.getReference()

getReference

public Reference getReference()

Specified by:

getReference in interface Referenceable

createQueueConnection

public QueueConnection createQueueConnection()
                                      throws JMSException

Description copied from interface: QueueConnectionFactory

Creates a queue connection with the default user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called. .

Specified by:

createQueueConnection in interface QueueConnectionFactory

Returns:

a newly created queue connection

Throws:

JMSException - if the JMS provider fails to create the queue connection due to some internal error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.

createQueueConnection

public QueueConnection createQueueConnection(String userName,
                                    String password)
                                      throws JMSException

Description copied from interface: QueueConnectionFactory

Creates a queue connection with the specified user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Specified by:

createQueueConnection in interface QueueConnectionFactory

Parameters:

userName - the caller's user name

password - the caller's password

Returns:

a newly created queue connection

Throws:

JMSException - if the JMS provider fails to create the queue connection due to some internal error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.

createTopicConnection

public TopicConnection createTopicConnection()
                                      throws JMSException

Description copied from interface: TopicConnectionFactory

Creates a topic connection with the default user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Specified by:

createTopicConnection in interface TopicConnectionFactory

Returns:

a newly created topic connection

Throws:

JMSException - if the JMS provider fails to create a topic connection due to some internal error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.

createTopicConnection

public TopicConnection createTopicConnection(String userName,
                                    String password)
                                      throws JMSException

Description copied from interface: TopicConnectionFactory

Creates a topic connection with the specified user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Specified by:

createTopicConnection in interface TopicConnectionFactory

Parameters:

userName - the caller's user name

password - the caller's password

Returns:

a newly created topic connection

Throws:

JMSException - if the JMS provider fails to create a topic connection due to some internal error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.

createConnection

public Connection createConnection()
                            throws JMSException

Description copied from interface: ConnectionFactory

Creates a connection with the default user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Specified by:

createConnection in interface ConnectionFactory

Returns:

a newly created connection

Throws:

JMSException - if the JMS provider fails to create the connection due to some internal error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.

createConnection

public Connection createConnection(String userName,
                          String password)
                            throws JMSException

Description copied from interface: ConnectionFactory

Creates a connection with the specified user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Specified by:

createConnection in interface ConnectionFactory

Parameters:

userName - the caller's user name

password - the caller's password

Returns:

a newly created connection

Throws:

JMSException - if the JMS provider fails to create the connection due to some internal error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.