All Downloads are FREE. Search and download functionalities are using the official Maven repository.
Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $
You can buy this project and download/modify it how often you want.
com.atomikos.icatch.imp.CompositeTransactionImp Maven / Gradle / Ivy
/**
* Copyright (C) 2000-2012 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.imp;
import java.util.Stack;
import com.atomikos.finitestates.FSMEnterEvent;
import com.atomikos.finitestates.FSMEnterListener;
import com.atomikos.icatch.CompositeCoordinator;
import com.atomikos.icatch.CompositeTerminator;
import com.atomikos.icatch.CompositeTransaction;
import com.atomikos.icatch.Extent;
import com.atomikos.icatch.HeurHazardException;
import com.atomikos.icatch.HeurMixedException;
import com.atomikos.icatch.HeurRollbackException;
import com.atomikos.icatch.Participant;
import com.atomikos.icatch.RecoveryCoordinator;
import com.atomikos.icatch.RollbackException;
import com.atomikos.icatch.SubTxAwareParticipant;
import com.atomikos.icatch.Synchronization;
import com.atomikos.icatch.SysException;
import com.atomikos.icatch.TransactionControl;
import com.atomikos.icatch.TxState;
import com.atomikos.logging.Logger;
import com.atomikos.logging.LoggerFactory;
/**
* A complete composite transaction implementation for use in the local VM.
*/
public class CompositeTransactionImp
extends AbstractCompositeTransaction implements
TransactionControl, FSMEnterListener
{
private static final Logger LOGGER = LoggerFactory.createLogger(CompositeTransactionImp.class);
protected CoordinatorImp coordinator = null;
protected TransactionServiceImp txservice;
protected Extent extent = null;
protected boolean noLocalAncestors;
private TransactionStateHandler stateHandler;
/**
* This constructor is kept for compatibility with the test classes.
*/
CompositeTransactionImp ( Stack lineage , String tid , boolean serial ,
CoordinatorImp coordinator )
{
this ( null , lineage , tid , serial , coordinator );
}
/**
* Constructor.
*
* @param txservice
* The Transaction Service this is for.
* @param lineage
* The ancestor information.
* @param tid
* The identifier for this one.
* @param serial
* If true, no parallel calls allowed.
* @param coordinator
* The coordinator to use.
* @exception IllegalStateException
* If coordinator no longer activatable.
*/
public CompositeTransactionImp ( TransactionServiceImp txservice ,
Stack lineage , String tid , boolean serial ,
CoordinatorImp coordinator ) throws IllegalStateException
{
super ( tid , lineage , serial );
this.coordinator = coordinator;
this.txservice = txservice;
this.extent = null;
this.noLocalAncestors = true;
this.stateHandler = new TxActiveStateHandler ( this );
coordinator.addFSMEnterListener ( this, TxState.TERMINATED );
}
synchronized void localSetTransactionStateHandler ( TransactionStateHandler handler )
{
stateHandler = handler;
}
synchronized void localTestAndSetTransactionStateHandler ( TransactionStateHandler expected , TransactionStateHandler newHandler )
{
if ( stateHandler != expected ) throw new IllegalStateException ( "State is no longer " + expected.getState() + " but " + newHandler.getState() );
localSetTransactionStateHandler( newHandler );
}
synchronized TransactionStateHandler localGetTransactionStateHandler()
{
return stateHandler;
}
boolean isLocalRoot ()
{
return noLocalAncestors;
}
TransactionServiceImp getTransactionService ()
{
return txservice;
}
CoordinatorImp getCoordinatorImp ()
{
return coordinator;
}
/**
* @see CompositeTransaction.
*/
public TransactionControl getTransactionControl ()
{
return this;
}
/**
* @see TransactionControl
*/
public int getLocalSubTxCount ()
{
return localGetTransactionStateHandler().getSubTransactionCount ();
}
/**
* @see TransactionControl.
*/
public synchronized void setSerial () throws IllegalStateException,
SysException
{
if ( !isRoot () ) throw new IllegalStateException ( "Not a root tx." );
serial_ = true;
}
/**
* @see TransactionControl.
*/
public CompositeTransaction createSubTransaction () throws SysException,
IllegalStateException
{
CompositeTransaction ret = localGetTransactionStateHandler().createSubTransaction ();
if(LOGGER.isInfoEnabled()){
LOGGER.logInfo("createSubTransaction(): created new SUBTRANSACTION "
+ ret.getTid () + " for existing transaction " + getTid ());
}
return ret;
}
/**
* @see CompositeTransaction
*/
public RecoveryCoordinator addParticipant ( Participant participant )
throws SysException, java.lang.IllegalStateException
{
RecoveryCoordinator ret = localGetTransactionStateHandler().addParticipant ( participant );
if(LOGGER.isInfoEnabled()){
LOGGER.logInfo("addParticipant ( " + participant + " ) for transaction "
+ getTid ());
}
return ret;
}
/**
* @see CompositeTransaction
*/
public void registerSynchronization ( Synchronization sync ) throws // RollbackException,
IllegalStateException, UnsupportedOperationException, SysException
{
localGetTransactionStateHandler().registerSynchronization ( sync );
if(LOGGER.isInfoEnabled()){
LOGGER.logInfo("registerSynchronization ( " + sync + " ) for transaction "
+ getTid ());
}
}
/**
* @see CompositeTransaction
*/
public void addSubTxAwareParticipant ( SubTxAwareParticipant subtxaware )
throws SysException, java.lang.IllegalStateException
{
localGetTransactionStateHandler().addSubTxAwareParticipant ( subtxaware );
}
/**
* @see TransactionControl.
*/
protected void doRollback () throws java.lang.IllegalStateException,
SysException
{
localGetTransactionStateHandler().rollbackWithStateCheck ();
if(LOGGER.isInfoEnabled()){
LOGGER.logInfo("rollback() done of transaction " + getTid ());
}
}
/**
* @see CompositeTransaction.
*/
public CompositeCoordinator getCompositeCoordinator () throws SysException
{
return coordinator;
}
/**
* @see CompositeTransaction.
*/
public boolean isLocal ()
{
return true;
}
/**
* @see TransactionControl.
*/
public CompositeTerminator getTerminator ()
{
return new CompositeTerminatorImp ( txservice, this, coordinator );
}
/**
* Successfully end the composite transaction. Marks it as inactive. Called
* by Terminator implementation only! NOTE: this does NOT commit the
* participants, but rather only marks the (sub)transaction as being
* ELIGIBLE FOR PREPARE IN 2PC.
*
* @exception IllegalStateException
* If no longer active.
* @exception SysException
* Unexpected failure.
*/
protected void doCommit () throws SysException,
java.lang.IllegalStateException, RollbackException
{
localGetTransactionStateHandler().commit ();
if(LOGGER.isInfoEnabled()){
LOGGER.logInfo("commit() done (by application) of transaction " + getTid ());
}
}
/**
* @see TransactionControl
*/
public long getTimeout ()
{
return coordinator.getTimeOut ();
}
/**
* @see TransactionControl.
*/
public synchronized Extent getExtent ()
{
if ( extent == null )
extent = new ExtentImp ();
return extent;
}
/**
* @see TransactionControl.
*/
public void setRollbackOnly ()
{
localGetTransactionStateHandler().setRollbackOnly ();
if(LOGGER.isInfoEnabled()){
LOGGER.logInfo("setRollbackOnly() called for transaction " + getTid ());
}
}
/**
* @see com.atomikos.icatch.CompositeTransaction#commit()
*/
public void commit () throws HeurRollbackException, HeurMixedException,
HeurHazardException, SysException, SecurityException,
RollbackException
{
getTerminator().commit();
}
/**
* @see com.atomikos.icatch.CompositeTransaction#rollback()
*/
public void rollback () throws IllegalStateException, SysException
{
getTerminator().rollback();
}
/**
* @see com.atomikos.finitestates.Stateful.
*/
public TxState getState ()
{
return localGetTransactionStateHandler().getState ();
}
/**
* @see com.atomikos.finitestates.FSMEnterListener#preEnter(com.atomikos.finitestates.FSMEnterEvent)
*/
public void entered ( FSMEnterEvent coordinatorTerminatedEvent )
{
if ( getState ().equals ( TxState.ACTIVE ) || getState ().equals ( TxState.MARKED_ABORT ) ) {
// our coordinator terminated and we did not -> coordinator must have seen a timeout/abort
try {
boolean recoverableWhileActive = false;
Boolean pref = coordinator.isRecoverableWhileActive();
if ( pref != null ) recoverableWhileActive = pref.booleanValue();
if ( !recoverableWhileActive && !( stateHandler instanceof TxTerminatedStateHandler ) ) {
// note: check for TxTerminatedStateHandler differentiates regular rollback from timeout/rollback !!!
setRollbackOnly(); // see case 27857: keep tx context for thread on timeout
} else {
rollback();
}
} catch ( Exception e ) {
e.printStackTrace();
// ignore but log
LOGGER.logDebug("Ignoring error during event callback",e);
}
}
}
}
