Examples of com.atomikos.jms.AtomikosConnectionFactoryBean

• com.atomikos.jms.AtomikosConnectionFactoryBean
  tomikos.com/Publications/ReliableJmsWithTransactions">http://www.atomikos.com/Publications/ReliableJmsWithTransactions). In order to use the JTA/XA mode, make sure that the following conditions hold:

  1. The localTransactionMode is set to false (default), and
  2. Sessions are created in transacted mode, i.e.:
     Transaction tx = ...; //start a JTA transaction
... AtomikosConnectionFactoryBean cf = ...; //create or retrieve a connection factory instance
...
Connection c = cf.createConnection();
Session s = c.createSession ( true , 0 ); //note the value of the transacted flag!
...//perform regular JMS sends or receives
...
tx.commit(); //commit JTA transaction to make all JMS operations take effect, or rollback to cancel everything


  The advantage of this class over using a vendor-specific XAConnectionFactory is that this class takes care of all JTA/XA-related calls towards the driver underneath. In other words, it hides the complexities of JTA/XA at the driver level.

  Local JMS transactions

  This class can be used to demarcate transactions yourself, on the JMS session object (as opposed to using a JTA/XA transaction).
  WARNING: as per JMS specification, this mode is only safe if you access no other back-end system like JDBC.
  In order to enable this mode, make sure that the following conditions hold:

  1. The localTransactionMode is set to true, and
  2. Sessions are created in transacted mode, i.e.:
     AtomikosConnectionFactoryBean cf = ...; //create or retrieve a connection factory instance
...
Connection c = cf.createConnection();
Session s = c.createSession ( true , 0 ); //note the value of the transacted flag!
...//perform regular JMS sends or receives
...
s.commit();//commit on session to make all effects permanent, rollback to cancel

  Note: this mode requires support from your JMS vendor's XAConnectionFactory implementation. Check your vendor documentation first!

  Non-transacted JMS

  This class can be used for sending and receiving in non-transacted mode.
  WARNING: as per JMS specification, this mode gives hardly any guarantees in terms of consistency after failures.
  To enable this mode, make sure to create the session as follows:
  AtomikosConnectionFactoryBean cf = ...; //create or retrieve a connection factory instance
...
Connection c = cf.createConnection();
Session s = c.createSession ( false , ... ); //note the value of the transacted flag!
Note: this mode requires support from your JMS vendor's XAConnectionFactory implementation. Check your vendor documentation first!

Related Classes of com.atomikos.jms.AtomikosConnectionFactoryBean