|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.atomikos.jms.JtaQueueConnectionFactory
public class JtaQueueConnectionFactory
Copyright © 2002, Atomikos. All rights reserved. A queue connection factory that couples JMS queue sends/receives to JTA transactions. Use this class only if you need to do explicit resource registration with the transaction service (i.e., when the underlying vendor-specific XAResource implementation is not fully compliant with the JTA/XA specifications, or if you want to force recovery at TM startup time). In all other cases, the QueueConnectionFactoryBean class is preferred over this one.
Use this class if you want to make queue send/receive operations within the scope of a JTA transaction. This class requires explicit resource registration with the transaction service: you need to explicitly call getTransactionalResource() and register the result with the UserTransactionService:
XAQueueConnectionFactory xafactory = ... //vendor-specific code
JtaQueueConnectionFactory factory =
new JtaQueueConnectionFactory ( xafactory );
com.atomikos.datasource.TransactionalResource resource = factory.getTransactionalResource();
com.atomikos.icatch.UserTransactionService uts = new com.atomikos.icatch.UserTransactionServiceImp();
uts.registerResource ( resource );
Constructor Summary | |
---|---|
JtaQueueConnectionFactory(String resourceName,
XAQueueConnectionFactory factory)
Create a new instance with a given JMS vendor-supplied xa connection factory. |
|
JtaQueueConnectionFactory(String resourceName,
XAQueueConnectionFactory qFactory,
XidFactory xFactory)
Create a new instance with a given JMS vendor-supplied xa connection factory, and a specific XidFactory. |
Method Summary | |
---|---|
Connection |
createConnection()
Creates a default connection. |
Connection |
createConnection(String userName,
String password)
Creates a connection for a given user and password. |
QueueConnection |
createQueueConnection()
Creates a default connection. |
QueueConnection |
createQueueConnection(String user,
String pw)
Creates a connection for a given user and password. |
Reference |
getReference()
|
JmsTransactionalResource |
getTransactionalResource()
Gets the transactional resource created during initialization. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public JtaQueueConnectionFactory(String resourceName, XAQueueConnectionFactory factory)
resourceName
- The unique name for the transactional resource that will be
created.factory
- The JMS vendor-supplied xa connection factory.public JtaQueueConnectionFactory(String resourceName, XAQueueConnectionFactory qFactory, XidFactory xFactory)
resourceName
- The unique name for the transactional resource that will be
created.qFactory
- The JMS vendor-supplied xa connection factory.xFactory
- The XidFactory.Method Detail |
---|
public JmsTransactionalResource getTransactionalResource()
public QueueConnection createQueueConnection() throws JMSException
createQueueConnection
in interface QueueConnectionFactory
JMSException
public QueueConnection createQueueConnection(String user, String pw) throws JMSException
createQueueConnection
in interface QueueConnectionFactory
user
- The user name.pw
- The password.
JMSException
public Reference getReference() throws NamingException
getReference
in interface Referenceable
NamingException
Referenceable
public Connection createConnection() throws JMSException
createConnection
in interface ConnectionFactory
JMSException
public Connection createConnection(String userName, String password) throws JMSException
createConnection
in interface ConnectionFactory
userName
- The user name.password
- The password.
JMSException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |