/*
* JBoss, Home of Professional Open Source
* Copyright 2006, Red Hat Middleware LLC, and individual contributors
* as indicated by the @author tags.
* See the copyright.txt in the distribution for a full listing
* of individual contributors.
* This copyrighted material is made available to anyone wishing to use,
* modify, copy, or redistribute it subject to the terms and conditions
* of the GNU Lesser General Public License, v. 2.1.
* This program is distributed in the hope that it will be useful, but WITHOUT A
* WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
* PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
* You should have received a copy of the GNU Lesser General Public License,
* v.2.1 along with this distribution; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
* MA 02110-1301, USA.
*
* (C) 2005-2006,
* @author JBoss Inc.
*/
/*
* Copyright (C) 2002,
*
* Hewlett-Packard Arjuna Labs,
* Newcastle upon Tyne,
* Tyne and Wear,
* UK.
*
* $Id: TransactionImple.java 2342 2006-03-30 13:06:17Z $
*/
package com.arjuna.ats.internal.jta.transaction.jts.subordinate;
import com.arjuna.ats.arjuna.coordinator.ActionStatus;
import com.arjuna.ats.arjuna.coordinator.TwoPhaseOutcome;
import com.arjuna.common.util.logging.*;
import com.arjuna.ats.internal.jta.transaction.jts.AtomicTransaction;
import com.arjuna.ats.jta.exceptions.InactiveTransactionException;
import com.arjuna.ats.jta.exceptions.InvalidTerminationStateException;
import com.arjuna.ats.jta.exceptions.UnexpectedConditionException;
import com.arjuna.ats.jta.logging.*;
import java.lang.IllegalStateException;
import javax.transaction.HeuristicCommitException;
import javax.transaction.HeuristicMixedException;
import javax.transaction.HeuristicRollbackException;
import javax.transaction.SystemException;
import javax.transaction.RollbackException;
/**
* @message com.arjuna.ats.internal.jta.transaction.jts.subordinate.invalidstate
* [com.arjuna.ats.internal.jta.transaction.jts.subordinate.invalidstate]
* Not allowed to terminate subordinate transaction directly.
*/
public class TransactionImple extends
com.arjuna.ats.internal.jta.transaction.jts.TransactionImple
{
/**
* Create a new transaction with the specified timeout.
*/
public TransactionImple (AtomicTransaction imported)
{
super(imported);
TransactionImple.putTransaction(this);
}
/**
* Overloads Object.equals()
*/
public boolean equals (Object obj)
{
if (jtaLogger.logger.isDebugEnabled())
{
jtaLogger.logger.debug(DebugLevel.FUNCTIONS, VisibilityLevel.VIS_PUBLIC, com.arjuna.ats.jta.logging.FacilityCode.FAC_JTA, "TransactionImple.equals");
}
if (obj == null)
return false;
if (obj == this)
return true;
if (obj instanceof TransactionImple)
{
return super.equals(obj);
}
return false;
}
/**
* This is a subordinate transaction, so any attempt to commit it or roll it
* back directly, should fail.
*/
public void commit () throws javax.transaction.RollbackException,
javax.transaction.HeuristicMixedException,
javax.transaction.HeuristicRollbackException,
java.lang.SecurityException, javax.transaction.SystemException,
java.lang.IllegalStateException
{
/*
* throw new IllegalStateException(
* jtaLogger.loggerI18N.getString("com.arjuna.ats.internal.jta.transaction.jts.subordinate.invalidstate"));
*/
throw new InvalidTerminationStateException();
}
/**
* This is a subordinate transaction, so any attempt to commit it or roll it
* back directly, should fail.
*/
public void rollback () throws java.lang.IllegalStateException,
java.lang.SecurityException, javax.transaction.SystemException
{
/*
* throw new IllegalStateException(
* jtaLogger.loggerI18N.getString("com.arjuna.ats.internal.jta.transaction.jts.subordinate.invalidstate"));
*/
throw new InvalidTerminationStateException();
}
/**
* Drive the subordinate transaction through the prepare phase. Any
* enlisted participants will also be prepared as a result.
*
* @return a TwoPhaseOutcome representing the result.
*
* @throws SystemException thrown if any error occurs.
*/
public int doPrepare ()
{
try
{
SubordinateAtomicTransaction subAct = (SubordinateAtomicTransaction) super._theTransaction;
if (!endSuspendedRMs())
{
try
{
_theTransaction.rollbackOnly();
}
catch (org.omg.CosTransactions.NoTransaction ex)
{
// shouldn't happen! ignore because prepare will fail next anyway.
}
}
int res = subAct.doPrepare();
switch (res)
{
case TwoPhaseOutcome.PREPARE_READONLY:
case TwoPhaseOutcome.PREPARE_NOTOK:
TransactionImple.removeTransaction(this);
break;
}
return res;
}
catch (ClassCastException ex)
{
return TwoPhaseOutcome.INVALID_TRANSACTION;
}
}
/**
* Drive the subordinate transaction to commit. It must have previously
* been prepared.
*
* @throws IllegalStateException thrown if the transaction has not been prepared
* or is unknown.
* @throws HeuristicMixedException thrown if a heuristic mixed outcome occurs
* (where some participants committed whilst others rolled back).
* @throws HeuristicRollbackException thrown if the transaction rolled back.
* @throws SystemException thrown if some other error occurs.
*/
public void doCommit () throws IllegalStateException,
HeuristicMixedException, HeuristicRollbackException, HeuristicCommitException,
SystemException
{
try
{
SubordinateAtomicTransaction subAct = (SubordinateAtomicTransaction) super._theTransaction;
int res = subAct.doCommit();
switch (res)
{
case ActionStatus.H_COMMIT:
throw new HeuristicCommitException();
case ActionStatus.COMMITTED:
case ActionStatus.COMMITTING:
break;
case ActionStatus.ABORTED:
case ActionStatus.ABORTING:
case ActionStatus.H_ROLLBACK:
throw new HeuristicRollbackException();
case ActionStatus.H_HAZARD:
case ActionStatus.H_MIXED:
throw new HeuristicMixedException();
case ActionStatus.INVALID:
throw new IllegalStateException();
default:
throw new HeuristicMixedException(); // not sure what happened,
// so err on the safe side!
}
}
catch (ClassCastException ex)
{
ex.printStackTrace();
throw new UnexpectedConditionException(ex.toString());
}
finally
{
TransactionImple.removeTransaction(this);
}
}
/**
* Drive the subordinate transaction to roll back. It need not have been previously
* prepared.
*
* @throws IllegalStateException thrown if the transaction is not known by the
* system or has been previously terminated.
* @throws HeuristicMixedException thrown if a heuristic mixed outcome occurs
* (can only happen if the transaction was previously prepared and then only if
* some participants commit whilst others roll back).
* @throws HeuristicCommitException thrown if the transaction commits (can only
* happen if it was previously prepared).
* @throws SystemException thrown if any other error occurs.
*/
public void doRollback () throws IllegalStateException,
HeuristicMixedException, HeuristicCommitException, HeuristicRollbackException, SystemException
{
try
{
SubordinateAtomicTransaction subAct = (SubordinateAtomicTransaction) super._theTransaction;
if (!endSuspendedRMs())
{
if (jtaLogger.loggerI18N.isWarnEnabled())
{
jtaLogger.loggerI18N.warn("com.arjuna.ats.internal.jta.transaction.arjunacore.endsuspendfailed1");
}
}
int res = subAct.doRollback();
switch (res)
{
case ActionStatus.ABORTED:
case ActionStatus.ABORTING:
break;
case ActionStatus.H_ROLLBACK:
throw new HeuristicRollbackException();
case ActionStatus.COMMITTED:
case ActionStatus.COMMITTING:
case ActionStatus.H_COMMIT:
throw new HeuristicCommitException();
case ActionStatus.H_HAZARD:
case ActionStatus.H_MIXED:
throw new HeuristicMixedException();
default:
throw new HeuristicMixedException();
}
}
catch (ClassCastException ex)
{
ex.printStackTrace();
throw new UnexpectedConditionException(ex.toString());
}
finally
{
TransactionImple.removeTransaction(this);
}
}
/**
* Drive the transaction to commit. It should not have been previously
* prepared and will be the only resource in the global transaction.
*
* @throws IllegalStateException if the transaction has already terminated
* @throws javax.transaction.HeuristicRollbackException thrown if the transaction
* rolls back.
*/
public void doOnePhaseCommit () throws IllegalStateException, javax.transaction.RollbackException,
javax.transaction.HeuristicMixedException, javax.transaction.SystemException
{
try
{
SubordinateAtomicTransaction subAct = (SubordinateAtomicTransaction) super._theTransaction;
if (!endSuspendedRMs())
{
try
{
_theTransaction.rollbackOnly();
}
catch (org.omg.CosTransactions.NoTransaction ex)
{
// shouldn't happen! ignore because commit will fail next anyway.
}
}
int status = subAct.doOnePhaseCommit(); // ActionStatus status = TwoPhaseOutcome
TransactionImple.removeTransaction(this);
switch (status)
{
case ActionStatus.COMMITTED:
case ActionStatus.H_COMMIT:
break;
case ActionStatus.ABORTED:
case ActionStatus.ABORTING:
throw new RollbackException();
case ActionStatus.H_ROLLBACK:
case ActionStatus.H_HAZARD:
case ActionStatus.H_MIXED:
default:
throw new javax.transaction.HeuristicMixedException();
case ActionStatus.INVALID:
throw new InvalidTerminationStateException();
}
}
catch (ClassCastException ex)
{
ex.printStackTrace();
throw new IllegalStateException();
}
}
/**
* Called to tell the transaction to forget any heuristics.
*
* @throws IllegalStateException thrown if the transaction cannot
* be found.
*/
public void doForget () throws IllegalStateException
{
try
{
SubordinateAtomicTransaction subAct = (SubordinateAtomicTransaction) super._theTransaction;
subAct.doForget();
}
catch (ClassCastException ex)
{
ex.printStackTrace();
throw new IllegalStateException();
}
}
public String toString ()
{
if (super._theTransaction == null)
return "TransactionImple < jts-subordinate, NoTransaction >";
else
{
return "TransactionImple < jts-subordinate, "
+ super._theTransaction.get_uid() + " >";
}
}
protected void commitAndDisassociate ()
throws javax.transaction.RollbackException,
javax.transaction.HeuristicMixedException,
javax.transaction.HeuristicRollbackException,
java.lang.SecurityException, javax.transaction.SystemException,
java.lang.IllegalStateException
{
/*
* throw new IllegalStateException(
* jtaLogger.loggerI18N.getString("com.arjuna.ats.internal.jta.transaction.jts.subordinate.invalidstate"));
*/
throw new InactiveTransactionException();
}
protected void rollbackAndDisassociate ()
throws java.lang.IllegalStateException,
java.lang.SecurityException, javax.transaction.SystemException
{
/*
* throw new IllegalStateException(
* jtaLogger.loggerI18N.getString("com.arjuna.ats.internal.jta.transaction.jts.subordinate.invalidstate"));
*/
throw new InactiveTransactionException();
}
}