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()
{
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);
}
}