com.atomikos.icatch.jta.J2eeUserTransaction Maven / Gradle / Ivy
/**
* Copyright (C) 2000-2010 Atomikos
*
* This code ("Atomikos TransactionsEssentials"), by itself,
* is being distributed under the
* Apache License, Version 2.0 ("License"), a copy of which may be found at
* http://www.atomikos.com/licenses/apache-license-2.0.txt .
* You may not use this file except in compliance with the License.
*
* While the License grants certain patent license rights,
* those patent license rights only extend to the use of
* Atomikos TransactionsEssentials by itself.
*
* This code (Atomikos TransactionsEssentials) contains certain interfaces
* in package (namespace) com.atomikos.icatch
* (including com.atomikos.icatch.Participant) which, if implemented, may
* infringe one or more patents held by Atomikos.
* It should be appreciated that you may NOT implement such interfaces;
* licensing to implement these interfaces must be obtained separately from Atomikos.
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
*/
package com.atomikos.icatch.jta;
import java.io.Serializable;
import javax.naming.NamingException;
import javax.naming.Reference;
import javax.naming.Referenceable;
import javax.transaction.NotSupportedException;
import javax.transaction.SystemException;
import javax.transaction.TransactionManager;
import javax.transaction.UserTransaction;
import com.atomikos.util.SerializableObjectFactory;
/**
*
*
* A J2EE UserTransaction implementation. J2EE applications can use instances of
* this class to delimit transactions. Note: J2EE applications should NOT use
* the default UserTransactionImp in order to avoid that the transaction service
* is started twice in different locations. Instances can be bound in JNDI (if
* the application server allows this).
*/
public class J2eeUserTransaction implements UserTransaction, Serializable,
Referenceable
{
private static final long serialVersionUID = -7656447860674832182L;
private transient TransactionManager txmgr_;
public J2eeUserTransaction ()
{
}
/**
* Referenceable mechanism requires later setup of txmgr_, otherwise binding
* into JNDI already requires that TM is running.
*/
private void checkSetup ()
{
// REMOVED FOLLOWING IF CHECK: DON'T CACHE THE TXMGR TO MAKE INSTANCES
// RESILIENT TO RESTART IN TOMCAT. OTHERWISE, CLIENT APPS SEE THEIR
// USERTX REFERENCES INVALIDATED AND THIS IS INTOLERABLE
// if ( txmgr_ == null ) {
// txmgr_ = TransactionManagerImp.getTransactionManager();
txmgr_ = TransactionManagerImp.getTransactionManager ();
if ( txmgr_ == null )
throw new RuntimeException ( "Transaction Service Not Running?" );
// }
}
/**
* @see javax.transaction.UserTransaction
*/
public void begin () throws NotSupportedException, SystemException
{
checkSetup ();
txmgr_.begin ();
}
/**
* @see javax.transaction.UserTransaction
*/
public void commit () throws javax.transaction.RollbackException,
javax.transaction.HeuristicMixedException,
javax.transaction.HeuristicRollbackException,
javax.transaction.SystemException, java.lang.IllegalStateException,
java.lang.SecurityException
{
checkSetup ();
txmgr_.commit ();
}
/**
* @see javax.transaction.UserTransaction
*/
public void rollback () throws IllegalStateException, SystemException,
SecurityException
{
checkSetup ();
txmgr_.rollback ();
}
/**
* @see javax.transaction.UserTransaction
*/
public void setRollbackOnly () throws IllegalStateException,
SystemException
{
checkSetup ();
txmgr_.setRollbackOnly ();
}
/**
* @see javax.transaction.UserTransaction
*/
public int getStatus () throws SystemException
{
checkSetup ();
return txmgr_.getStatus ();
}
/**
* @see javax.transaction.UserTransaction
*/
public void setTransactionTimeout ( int seconds ) throws SystemException
{
checkSetup ();
txmgr_.setTransactionTimeout ( seconds );
}
//
//
// IMPLEMENTATION OF REFERENCEABLE
//
//
public Reference getReference () throws NamingException
{
return SerializableObjectFactory.createReference ( this );
}
}