package org.jboss.jbossts.xts.recovery.coordinator.ba;
import org.jboss.jbossts.xts.logging.XTSLogger;
import com.arjuna.ats.arjuna.common.Uid;
import com.arjuna.ats.arjuna.logging.FacilityCode;
import com.arjuna.ats.arjuna.coordinator.ActionStatus;
import com.arjuna.ats.arjuna.coordinator.RecordListIterator;
import com.arjuna.ats.arjuna.coordinator.AbstractRecord;
import com.arjuna.mwlabs.wscf.model.sagas.arjunacore.ACCoordinator;
import com.arjuna.mwlabs.wscf.model.sagas.arjunacore.ParticipantRecord;
import com.arjuna.common.util.logging.DebugLevel;
import com.arjuna.common.util.logging.VisibilityLevel;
import com.arjuna.mw.wsas.exceptions.SystemException;
import com.arjuna.mw.wscf.logging.wscfLogger;
/**
* This class is a plug-in module for the recovery manager.
* It is responsible for recovering failed WSBA ACCoordinator transactions.
*
* @message org.jboss.jbossts.xts.recovery.coordinator.ba.RecoverACCoordinator_1 [org.jboss.jbossts.xts.recovery.coordinator.ba.RecoverACCoordinator_1] - RecoverACCoordinator.replayPhase2 recovering {0} ActionStatus is {1}
* @message org.jboss.jbossts.xts.recovery.coordinator.ba.RecoverACCoordinator_2 [org.jboss.jbossts.xts.recovery.coordinator.ba.RecoverACCoordinator_2] - RecoverACCoordinator.replayPhase2: Unexpected status: {0}
* @message org.jboss.jbossts.xts.recovery.coordinator.ba.RecoverACCoordinator_3 [org.jboss.jbossts.xts.recovery.coordinator.ba.RecoverACCoordinator_3] - RecoverACCoordinator.replayPhase2( {0} ) finished
* @message org.jboss.jbossts.xts.recovery.coordinator.ba.RecoverACCoordinator_4 [org.jboss.jbossts.xts.recovery.coordinator.ba.RecoverACCoordinator_4] - RecoverACCoordinator.replayPhase2 transaction {0} not activated, unable to replay phase 2 commit
*/
public class RecoverACCoordinator extends ACCoordinator {
/**
* Re-creates/activates an AtomicAction for the specified
* transaction Uid.
*/
public RecoverACCoordinator( Uid rcvUid )
{
super( rcvUid ) ;
_activated = activate() ;
if (_activated) {
setRecoveryCoordinator();
}
}
/**
* provide the recovered participants with a handle on this coordinator so they can
* propagate events through to it.
*/
public void setRecoveryCoordinator()
{
if (preparedList != null)
{
RecordListIterator iter = new RecordListIterator(preparedList);
AbstractRecord absRec = iter.iterate();
while (absRec != null)
{
if (absRec instanceof ParticipantRecord)
{
ParticipantRecord pr = (ParticipantRecord) absRec;
}
absRec = iter.iterate();
}
}
}
/**
* Replays phase 2 of the commit protocol.
*/
public void replayPhase2()
{
final int status = status();
if (XTSLogger.arjLoggerI18N.debugAllowed())
{
XTSLogger.arjLoggerI18N.debug(DebugLevel.FUNCTIONS, VisibilityLevel.VIS_PUBLIC,
FacilityCode.FAC_CRASH_RECOVERY,
"org.jboss.jbossts.xts.recovery.coordinator.ba.RecoverACCoordinator_1",
new Object[]{get_uid(), ActionStatus.stringForm(status)});
}
if ( _activated )
{
// we only need to rerun phase2 if the action status is PREPARED, which happens
// when we crash between a successful complete beginning a close, or COMMITTING, which
// happens when we get a comms timeout from one of the participants after sending it a CLOSE
// message. in the former case all participant records will be listed in the prepared list.
// in the latter case the failed participant record(s) will have been reinstated in the
// prepared list and the participant stub engine reactivated, where necessary,
// under the call to activate() when this coordinator was created.
// we can also arrive here when the action status is ABORTING. This happens when we
// get a comms timeout from one of the participants after sending it a CANCEL message
// or if we get a comms timeout from one of the participants after sending it a COMPENSATE
// message.
if ((status == ActionStatus.PREPARED) ||
(status == ActionStatus.COMMITTING) ||
(status == ActionStatus.COMMITTED) ||
(status == ActionStatus.H_COMMIT) ||
(status == ActionStatus.H_MIXED) ||
(status == ActionStatus.H_HAZARD))
{
super.phase2Commit( _reportHeuristics ) ;
} else if ((status == ActionStatus.ABORTED) ||
(status == ActionStatus.H_ROLLBACK) ||
(status == ActionStatus.ABORTING) ||
(status == ActionStatus.ABORT_ONLY))
{
super.phase2Abort( _reportHeuristics ) ;
}
if (XTSLogger.arjLoggerI18N.debugAllowed())
{
XTSLogger.arjLoggerI18N.debug(DebugLevel.FUNCTIONS, VisibilityLevel.VIS_PUBLIC,
FacilityCode.FAC_CRASH_RECOVERY,
"org.jboss.jbossts.xts.recovery.coordinator.ba.RecoverACCoordinator_3",
new Object[]{get_uid()});
}
}
else
{
XTSLogger.arjLoggerI18N.warn("org.jboss.jbossts.xts.recovery.coordinator.ba.RecoverACCoordinator_4", new Object[]{get_uid()});
}
}
// Flag to indicate that this transaction has been re-activated
// successfully.
private boolean _activated = false ;
// whether heuristic reporting on phase 2 commit is enabled.
private boolean _reportHeuristics = true ;
}