/*
* 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.
*/
package com.arjuna.wst11.messaging.engines;
import com.arjuna.webservices.SoapFault;
import com.arjuna.webservices.logging.WSTLogger;
import com.arjuna.webservices.util.TransportTimer;
import com.arjuna.webservices11.wsaddr.AddressingHelper;
import org.jboss.ws.api.addressing.MAP;
import com.arjuna.webservices11.wsarj.ArjunaContext;
import com.arjuna.webservices11.wsarj.InstanceIdentifier;
import com.arjuna.webservices11.wsba.ParticipantCompletionCoordinatorInboundEvents;
import com.arjuna.webservices11.wsba.State;
import com.arjuna.webservices11.wsba.processors.ParticipantCompletionCoordinatorProcessor;
import com.arjuna.webservices11.wsba.client.ParticipantCompletionParticipantClient;
import com.arjuna.wsc11.messaging.MessageId;
import com.arjuna.wst11.BAParticipantManager;
import org.oasis_open.docs.ws_tx.wsba._2006._06.ExceptionType;
import org.oasis_open.docs.ws_tx.wsba._2006._06.NotificationType;
import org.oasis_open.docs.ws_tx.wsba._2006._06.StatusType;
import javax.xml.namespace.QName;
import javax.xml.ws.wsaddressing.W3CEndpointReference;
/**
* The participant completion coordinator state engine
* @author kevin
*/
public class ParticipantCompletionCoordinatorEngine implements ParticipantCompletionCoordinatorInboundEvents
{
/**
* The coordinator id.
*/
private final String id ;
/**
* The instance identifier.
*/
private final InstanceIdentifier instanceIdentifier ;
/**
* The participant endpoint reference.
*/
private final W3CEndpointReference participant ;
/**
* The associated coordinator
*/
private BAParticipantManager coordinator ;
/**
* The current state.
*/
private State state ;
/**
* The failure state which preceded state ended during close/cancel or null if no failure occurred.
*/
private State failureState;
/**
* The flag indicating that this coordinator has been recovered from the log.
*/
private boolean recovered ;
/**
* Construct the initial engine for the coordinator.
* @param id The coordinator id.
* @param participant The participant endpoint reference.
*/
public ParticipantCompletionCoordinatorEngine(final String id, final W3CEndpointReference participant)
{
this(id, participant, State.STATE_ACTIVE, false) ;
}
/**
* Construct the engine for the coordinator in a specified state and register it.
* @param id The coordinator id.
* @param participant The participant endpoint reference.
* @param state The initial state.
*/
public ParticipantCompletionCoordinatorEngine(final String id, final W3CEndpointReference participant,
final State state, final boolean recovered)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + " constructor. Id: " + id + ", participant: " + participant
+ ", state: " + state + ", recovered: " + recovered);
}
this.id = id ;
this.instanceIdentifier = new InstanceIdentifier(id) ;
this.participant = participant ;
this.state = state ;
this.failureState = null;
this.recovered = recovered;
// unrecovered participants are always activated
// we only need to reactivate recovered participants which were successfully COMPLETED or which began
// CLOSING. any others will only have been saved because of a heuristic outcome. we can safely drop
// them since we implement presumed abort.
if (!recovered || state == State.STATE_COMPLETED || state == State.STATE_CLOSING) {
ParticipantCompletionCoordinatorProcessor.getProcessor().activateCoordinator(this, id) ;
}
}
/**
* Set the coordinator
* @param coordinator
*/
public void setCoordinator(final BAParticipantManager coordinator)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".setCoordinator");
}
this.coordinator = coordinator ;
}
/**
* Handle the cancelled event.
* @param cancelled The cancelled notification.
* @param map The addressing context.
* @param arjunaContext The arjuna context.
*
* Active -> Active (invalid state)
* Canceling -> Ended
* Completed -> Completed (invalid state)
* Closing -> Closing (invalid state)
* Compensating -> Compensating (invalid state)
* Failing-Active -> Failing-Active (invalid state)
* Failing-Canceling -> Failing-Canceling (invalid state)
* Failing-Compensating -> Failing-Compensating (invalid state)
* NotCompleting -> NotCompleting (invalid state)
* Exiting -> Exiting (invalid state)
* Ended -> Ended
*/
public void cancelled(final NotificationType cancelled, final MAP map, final ArjunaContext arjunaContext)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".cancelled");
}
final State current ;
synchronized(this)
{
current = state ;
if (current == State.STATE_CANCELING)
{
ended() ;
}
}
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".cancelled. State: " + current);
}
}
/**
* Handle the closed event.
* @param closed The closed notification.
* @param map The addressing context.
* @param arjunaContext The arjuna context.
*
* Active -> Active (invalid state)
* Canceling -> Canceling (invalid state)
* Completed -> Completed (invalid state)
* Closing -> Ended
* Compensating -> Compensating (invalid state)
* Failing-Active -> Failing-Active (invalid state)
* Failing-Canceling -> Failing-Canceling (invalid state)
* Failing-Compensating -> Failing-Compensating (invalid state)
* NotCompleting -> NotCompleting (invalid state)
* Exiting -> Exiting (invalid state)
* Ended -> Ended
*/
public void closed(final NotificationType closed, final MAP map, final ArjunaContext arjunaContext)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".closed");
}
final State current ;
synchronized(this)
{
current = state ;
if (current == State.STATE_CLOSING)
{
ended() ;
}
}
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".closed. State: " + current);
}
}
/**
* Handle the compensated event.
* @param compensated The compensated notification.
* @param map The addressing context.
* @param arjunaContext The arjuna context.
*
* Active -> Active (invalid state)
* Canceling -> Canceling (invalid state)
* Completed -> Completed (invalid state)
* Closing -> Closing (invalid state)
* Compensating -> Ended
* Failing-Active -> Failing-Active (invalid state)
* Failing-Canceling -> Failing-Canceling (invalid state)
* Failing-Compensating -> Failing-Compensating (invalid state)
* NotCompleting -> NotCompleting (invalid state)
* Exiting -> Exiting (invalid state)
* Ended -> Ended
*/
public void compensated(final NotificationType compensated, final MAP map, final ArjunaContext arjunaContext)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".compensated");
}
final State current ;
synchronized(this)
{
current = state ;
if (current == State.STATE_COMPENSATING)
{
ended() ;
}
}
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".compensated. State: " + current);
}
}
/**
* Handle the completed event.
* @param completed The completed notification.
* @param map The addressing context.
* @param arjunaContext The arjuna context.
*
* Active -> Completed
* Canceling -> Completed
* Completed -> Completed
* Closing -> Closing (resend Close)
* Compensating -> (resend Compensate)
* Failing-Active -> Failing-Active (invalid state)
* Failing-Canceling -> Failing-Canceling (invalid state)
* Failing-Compensating -> Failing-Compensating
* NotCompleting -> NotCompleting (invalid state)
* Exiting -> Exiting (invalid state)
* Ended -> Ended
*/
public void completed(final NotificationType completed, final MAP map,
final ArjunaContext arjunaContext)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".completed");
}
final State current ;
synchronized(this)
{
current = state ;
if (current == State.STATE_ACTIVE || current == State.STATE_CANCELING)
{
changeState(State.STATE_COMPLETED) ;
}
}
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".completed. State: " + current);
}
if (current == State.STATE_ACTIVE)
{
executeCompleted() ;
}
else if (current == State.STATE_CLOSING)
{
sendClose() ;
}
else if ((current == State.STATE_CANCELING) || (current == State.STATE_COMPENSATING))
{
sendCompensate() ;
}
}
/**
* Handle the exit event.
* @param exit The exit notification.
* @param map The addressing context.
* @param arjunaContext The arjuna context.
*
* Active -> Exiting
* Canceling -> Exiting
* Completed -> Completed (invalid state)
* Closing -> Closing (invalid state)
* Compensating -> Compensating (invalid state)
* Failing-Active -> Failing-Active (invalid state)
* Failing-Canceling -> Failing-Canceling (invalid state)
* Failing-Compensating -> Failing-Compensating (invalid state)
* NotCompleting -> NotCompleting (invalid state)
* Exiting -> Exiting
* Ended -> Ended (resend Exited)
*/
public void exit(final NotificationType exit, final MAP map, final ArjunaContext arjunaContext)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".exit");
}
final State current ;
synchronized(this)
{
current = state ;
if ((current == State.STATE_ACTIVE) || (current == State.STATE_CANCELING))
{
changeState(State.STATE_EXITING) ;
}
}
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".exit. State: " + current);
}
if ((current == State.STATE_ACTIVE) || (current == State.STATE_CANCELING))
{
executeExit() ;
}
else if (current == State.STATE_ENDED)
{
sendExited() ;
}
}
/**
* Handle the fail event.
* @param fail The fail exception.
* @param map The addressing context.
* @param arjunaContext The arjuna context.
*
* Active -> Failing-Active
* Canceling -> Failing-Canceling
* Completed -> Completed (invalid state)
* Closing -> Closing (invalid state)
* Compensating -> Failing-Compensating
* Failing-Active -> Failing-Active
* Failing-Canceling -> Failing-Canceling
* Failing-Compensating -> Failing-Compensating
* NotCompleting -> NotCompleting (invalid state)
* Exiting -> Exiting (invalid state)
* Ended -> Ended (resend Failed)
*
* In fact we only execute the transition to FAILING_ACTIVE and in this case we send a message to the
* coordinator by calling executeFail. This propagates the failure back thorugh the activityy hierarchy
* to the relevant participant and also marks the acivity as ABORT_ONLY.
*
* In the other failure cases we do not change to a FAILING_XXX state but instead go straight to ENDED
* and save the failing state in a field failureState. In these cases there will be a coordinator
* close/cancel/compensate thread waiting on the change to state FAILING_XXX. The change to FAILING_XXX
* will wake it up and, if the state is still FAILING_XXX, return a fault to the coordinator, However,
* the failing thread also sends a failed response and then call ended. This means the state might be
* transitioned to ENDED before the coordinator thread is scheduled. So, we have to avoid this race by
* going straight to ENDED and saving a failureState which the coordinator thread can check.
*
* The failureState also avoids another race condition for these (non-ACTIVE) cases. It means we don't have
* to send a message to the coordinator to notify the failure. We would need to do this after the state
* change as we need to exclude threads handling resent messages. However, the waiting coordinator thread
* is woken by the state change and so it might complete and remove the activity before the message is sent
* causing a NoSuchActivity exception in this thread. Settign the failureState ensures that the failure is
* detected cleanly by any waiting coordinator thread.
*
* Fortuitously, this also avoids problems during recovery. During recovery we have no link to our
* coordinator available since there is no activity hierarchy in the current context. So, communicating
* failures via the failureState is the only way to ensure that the recovreed coordinator sees a failure.
* There is a further wrinkle here too. If a recovered coordinator times out waiting for a response we need
* to leave the engine in place when we ditch the recovered coordinator and then reestablish a link to it
* next time we recreate the coordinator. We cannot afford to miss a failure during this interval but the]
* engine must transition to ENDED after handling the failure. Saving the failure state ensures that the
* next time the coordinator calls cancel, compensate or close it receives a fault indicating a failure
* rather than just detecting that the pariticpant has ended.
*/
public void fail(final ExceptionType fail, final MAP map,
final ArjunaContext arjunaContext)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".fail");
}
final State current ;
synchronized(this)
{
current = state ;
if (current == State.STATE_ACTIVE)
{
changeState(State.STATE_FAILING_ACTIVE) ;
}
else if (current == State.STATE_CANCELING)
{
failureState = State.STATE_FAILING_CANCELING;
ended();
}
else if (current == State.STATE_COMPENSATING)
{
failureState = State.STATE_FAILING_COMPENSATING;
ended();
}
}
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".fail. State: " + current);
}
if (current == State.STATE_ACTIVE)
{
executeFail(fail.getExceptionIdentifier()) ;
}
else if ((current == State.STATE_CANCELING) || (current == State.STATE_COMPENSATING) ||
(current == State.STATE_ENDED))
{
sendFailed() ;
}
}
/**
* Handle the cannot complete event.
* @param cannotComplete The cannotComplete exception.
* @param map The addressing context.
* @param arjunaContext The arjuna context.
*
* Active -> NotCompleting
* Canceling -> NotCompleting
* Completed -> Completed (invalid state)
* Closing -> Closing (invalid state)
* Compensating -> Compensating (invalid state)
* Failing-Active -> Failing-Active (invalid state)
* Failing-Canceling -> Failing-Canceling (invalid state)
* Failing-Compensating -> Failing-Compensating (invalid state)
* NotCompleting -> NotCompleting
* Exiting -> Exiting (invalid state)
* Ended -> Ended (resend NotCompleted)
*/
public void cannotComplete(final NotificationType cannotComplete, final MAP map,
final ArjunaContext arjunaContext)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".cannotComplete");
}
final State current ;
synchronized(this)
{
current = state ;
if ((current == State.STATE_ACTIVE) || (state == State.STATE_CANCELING))
{
changeState(State.STATE_NOT_COMPLETING) ;
}
}
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".cannotComplete. State: " + current);
}
if ((current == State.STATE_ACTIVE) || (current == State.STATE_CANCELING))
{
executeCannotComplete() ;
}
else if (current == State.STATE_ENDED)
{
sendNotCompleted() ;
}
}
/**
* Handle the getStatus event.
* @param getStatus The getStatus notification.
* @param map The addressing context.
* @param arjunaContext The arjuna context.
*/
public void getStatus(final NotificationType getStatus, final MAP map, final ArjunaContext arjunaContext)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".getStatus");
}
final State current ;
synchronized(this)
{
current = state ;
}
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".getStatus. State: " + current);
}
sendStatus(current) ;
}
/**
* Handle the status event.
* @param status The status.
* @param map The addressing context.
* @param arjunaContext The arjuna context.
*/
public void status(final StatusType status, final MAP map, final ArjunaContext arjunaContext)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".status");
}
// TODO - is this correct?
final State current ;
synchronized(this)
{
current = state ;
}
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".status. State: " + current);
}
sendStatus(current) ;
}
/**
* Handle the get status event.
* @return The state.
*/
public synchronized State getStatus()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".getStatus. State: " + state);
}
return state ;
}
/**
* Handle the cancel event.
* @return The state.
*
* Active -> Canceling
* Canceling -> Canceling
* Completed -> Completed (invalid state)
* Closing -> Closing (invalid state)
* Compensating -> Compensating (invalid state)
* Failing-Active -> Failing-Active (invalid state)
* Failing-Canceling -> Failing-Canceling (invalid state)
* Failing-Compensating -> Failing-Compensating (invalid state)
* NotCompleting -> NotCompleting (invalid state)
* Exiting -> Exiting (invalid state)
* Ended -> Ended (invalid state)
*/
public State cancel()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".cancel");
}
State current ;
synchronized(this)
{
current = state ;
if (current == State.STATE_ACTIVE)
{
changeState(State.STATE_CANCELING) ;
}
}
if ((current == State.STATE_ACTIVE) || (current == State.STATE_CANCELING))
{
sendCancel() ;
current = waitForState(State.STATE_CANCELING, TransportTimer.getTransportTimeout()) ;
}
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".cancel. State: " + current);
}
// if we reached ended via a failure then make sure we return the failure state so that the coordinator
// sees the failure
if (current == State.STATE_ENDED && failureState != null) {
return failureState;
}
return current ;
}
/**
* Handle the compensate event.
* @return The state.
*
* Active -> Active (invalid state)
* Canceling -> Canceling (invalid state)
* Completed -> Compensating
* Closing -> Closing (invalid state)
* Compensating -> Compensating
* Failing-Active -> Failing-Active (invalid state)
* Failing-Canceling -> Failing-Canceling (invalid state)
* Failing-Compensating -> Failing-Compensating (invalid state)
* NotCompleting -> NotCompleting (invalid state)
* Exiting -> Exiting (invalid state)
* Ended -> Ended (invalid state)
*/
public State compensate()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".compensate");
}
State current ;
synchronized(this)
{
current = state ;
if (current == State.STATE_COMPLETED)
{
changeState(State.STATE_COMPENSATING) ;
}
}
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".compensate. State: " + current);
}
if ((current == State.STATE_COMPLETED) || (current == State.STATE_COMPENSATING))
{
sendCompensate() ;
waitForState(State.STATE_COMPENSATING, TransportTimer.getTransportTimeout()) ;
}
synchronized(this) {
if (state != State.STATE_COMPENSATING) {
// if this is a recovered participant then ended will not have
// deactivated the entry so that this (recovery) thread can
// detect it and update its log entry. so we need to deactivate
// the entry here.
if (recovered) {
ParticipantCompletionCoordinatorProcessor.getProcessor().deactivateCoordinator(this) ;
}
if (state == State.STATE_ENDED && failureState != null) {
return failureState;
}
return state;
} else {
// timeout -- leave participant in place as this TX will get retried later
return State.STATE_COMPENSATING;
}
}
}
/**
* Handle the close event.
* @return The state.
*
* Active -> Active (invalid state)
* Canceling -> Canceling (invalid state)
* Completed -> Closing
* Closing -> Closing
* Compensating -> Compensating (invalid state)
* Failing-Active -> Failing-Active (invalid state)
* Failing-Canceling -> Failing-Canceling (invalid state)
* Failing-Compensating -> Failing-Compensating (invalid state)
* NotCompleting -> NotCompleting (invalid state)
* Exiting -> Exiting (invalid state)
* Ended -> Ended (invalid state)
*/
public State close()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".close");
}
State current ;
synchronized(this)
{
current = state ;
if (current == State.STATE_COMPLETED)
{
changeState(State.STATE_CLOSING) ;
}
}
if ((current == State.STATE_COMPLETED) || (current == State.STATE_CLOSING))
{
sendClose() ;
waitForState(State.STATE_CLOSING, TransportTimer.getTransportTimeout()) ;
}
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".close. State: " + current);
}
synchronized(this) {
if (state != State.STATE_CLOSING) {
// if this is a recovered participant then ended will not have
// deactivated the entry so that this (recovery) thread can
// detect it and update its log entry. so we need to deactivate
// the entry here.
if (recovered) {
ParticipantCompletionCoordinatorProcessor.getProcessor().deactivateCoordinator(this) ;
}
if (state == State.STATE_ENDED && failureState != null) {
return failureState;
}
return state;
} else {
// timeout -- leave participant in place as this TX will get retried later
return State.STATE_CLOSING;
}
}
}
/**
* Handle the soap fault event.
* @param soapFault The soap fault.
* @param map The addressing context.
* @param arjunaContext The arjuna context.
*/
public void soapFault(final SoapFault soapFault, final MAP map, final ArjunaContext arjunaContext)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".soapFault");
}
ended() ;
try
{
// TODO - we cannot do this with JaxWS. need to log something
}
catch (final Throwable th) {} // ignore
}
/**
* Send the close message.
*
*/
private void sendClose()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".sendClose. Participant: " + participant + ", instance identifier: "
+ instanceIdentifier);
}
final MAP map = createContext() ;
try
{
ParticipantCompletionParticipantClient.getClient().sendClose(participant, map, instanceIdentifier) ;
}
catch (final Throwable th)
{
if (WSTLogger.logger.isTraceEnabled())
{
WSTLogger.logger.tracev("Unexpected exception while sending Close", th) ;
}
}
}
/**
* Send the compensate message.
*
*/
private void sendCompensate()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".sendCompensate. Participant: " + participant
+ ", instance identifier: " + instanceIdentifier);
}
final MAP map = createContext() ;
try
{
ParticipantCompletionParticipantClient.getClient().sendCompensate(participant, map, instanceIdentifier) ;
}
catch (final Throwable th)
{
if (WSTLogger.logger.isTraceEnabled())
{
WSTLogger.logger.tracev("Unexpected exception while sending Compensate", th) ;
}
}
}
/**
* Send the cancel message.
*
*/
private void sendCancel()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".sendCancel. Participant: " + participant
+ ", instance identifier: " + instanceIdentifier);
}
final MAP map = createContext() ;
try
{
ParticipantCompletionParticipantClient.getClient().sendCancel(participant, map, instanceIdentifier) ;
}
catch (final Throwable th)
{
if (WSTLogger.logger.isTraceEnabled())
{
WSTLogger.logger.tracev("Unexpected exception while sending Cancel", th) ;
}
}
}
/**
* Send the exited message.
*
*/
private void sendExited()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".sendExited. Participant: " + participant
+ ", instance identifier: " + instanceIdentifier);
}
final MAP map = createContext() ;
try
{
ParticipantCompletionParticipantClient.getClient().sendExited(participant, map, instanceIdentifier) ;
}
catch (final Throwable th)
{
if (WSTLogger.logger.isTraceEnabled())
{
WSTLogger.logger.tracev("Unexpected exception while sending Exited", th) ;
}
}
}
/**
* Send the faulted message.
*
*/
private void sendFailed()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".sendFailed. Participant: " + participant
+ ", instance identifier: " + instanceIdentifier);
}
final MAP map = createContext() ;
try
{
ParticipantCompletionParticipantClient.getClient().sendFailed(participant, map, instanceIdentifier) ;
}
catch (final Throwable th)
{
if (WSTLogger.logger.isTraceEnabled())
{
WSTLogger.logger.tracev("Unexpected exception while sending Faulted", th) ;
}
}
}
/**
* Send the not completed message.
*
*/
private void sendNotCompleted()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".sendNotCompleted. Participant: " + participant
+ ", instance identifier: " + instanceIdentifier);
}
final MAP map = createContext() ;
try
{
ParticipantCompletionParticipantClient.getClient().sendNotCompleted(participant, map, instanceIdentifier) ;
}
catch (final Throwable th)
{
if (WSTLogger.logger.isTraceEnabled())
{
WSTLogger.logger.tracev("Unexpected exception while sending NotCompleted", th) ;
}
}
}
/**
* Send the status message.
* @param state The state.
*
*/
private void sendStatus(final State state)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".sendStatus. Participant: " + participant
+ ", instance identifier: " + instanceIdentifier);
}
final MAP map = createContext() ;
try
{
ParticipantCompletionParticipantClient.getClient().sendStatus(participant, map, instanceIdentifier, state.getValue()) ;
}
catch (final Throwable th)
{
if (WSTLogger.logger.isTraceEnabled())
{
WSTLogger.logger.tracev("Unexpected exception while sending Status", th) ;
}
}
}
/**
* Get the coordinator id.
* @return The coordinator id.
*/
public String getId()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".getId. Id: " + id);
}
return id ;
}
/**
* Get the participant endpoint reference
* @return The participant endpoint reference
*/
public W3CEndpointReference getParticipant()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".getParticipant. Participant: " + participant);
}
return participant ;
}
/**
* Get the associated coordinator.
* @return The associated coordinator.
*/
public BAParticipantManager getCoordinator()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".getCoordinator. Coordinator: " + coordinator);
}
return coordinator;
}
/**
* check whether this participant's details have been recovered from the log
* @return true if the participant is recovered otherwise false
*/
public boolean isRecovered()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".isRecovered. Recovered: " + recovered);
}
return recovered;
}
/**
* Change the state and notify any listeners.
* @param state The new state.
*/
private synchronized void changeState(final State state)
{
if (this.state != state)
{
this.state = state ;
notifyAll() ;
}
}
/**
* Wait for the state to change from the specified state.
* @param origState The original state.
* @param delay The maximum time to wait for (in milliseconds).
* @return The current state.
*/
private State waitForState(final State origState, final long delay)
{
final long end = System.currentTimeMillis() + delay ;
synchronized(this)
{
while(state == origState)
{
final long remaining = end - System.currentTimeMillis() ;
if (remaining <= 0)
{
break ;
}
try
{
wait(remaining) ;
}
catch (final InterruptedException ie) {} // ignore
}
return state ;
}
}
/**
* Execute the completed transition.
*
*/
private void executeCompleted()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".executeCompleted");
}
try
{
coordinator.completed() ;
}
catch (final Throwable th)
{
if (WSTLogger.logger.isTraceEnabled())
{
WSTLogger.logger.tracev("Unexpected exception from coordinator completed", th) ;
}
}
}
/**
* Execute the exit transition.
*
*/
private void executeExit()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".executeExit");
}
try
{
coordinator.exit() ;
}
catch (final Throwable th)
{
if (WSTLogger.logger.isTraceEnabled())
{
WSTLogger.logger.tracev("Unexpected exception from coordinator exit", th) ;
}
return ;
}
sendExited() ;
ended() ;
}
/**
* Executing the fail transition.
*
* @throws com.arjuna.webservices.SoapFault for SOAP errors.
* @throws java.io.IOException for transport errors.
*
*/
private void executeFail(QName fail)
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".executeFail");
}
try
{
coordinator.fail(fail) ;
}
catch (final Throwable th)
{
if (WSTLogger.logger.isTraceEnabled())
{
WSTLogger.logger.tracev("Unexpected exception from coordinator fault", th) ;
}
return ;
}
sendFailed() ;
ended() ;
}
/**
* Executing the cannot complete transition.
*
* @throws SoapFault for SOAP errors.
*
*/
private void executeCannotComplete()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".executeCannotComplete");
}
try
{
coordinator.cannotComplete() ;
}
catch (final Throwable th)
{
if (WSTLogger.logger.isTraceEnabled())
{
WSTLogger.logger.tracev("Unexpected exception from coordinator error", th) ;
}
return ;
}
sendNotCompleted() ;
ended() ;
}
/**
* End the current coordinator.
*/
private void ended()
{
if (WSTLogger.logger.isTraceEnabled()) {
WSTLogger.logger.trace(getClass() + ".ended");
}
changeState(State.STATE_ENDED) ;
// participants which have not been recovered from the log can be deactivated now.
// participants which have been recovered are left for the recovery thread to deactivate.
// this is because the recovery thread may have timed out waiting for a response to
// a close/cancel message and gone on to complete its scan and suspend. the next scan
// will detect this activated participant and note that it has completed. if a crash
// happens in between the recovery thread can safely recreate and reactivate the
// participant and resend the commit since the commit/committed exchange is idempotent.
if (!recovered) {
ParticipantCompletionCoordinatorProcessor.getProcessor().deactivateCoordinator(this) ;
}
}
/**
* Create a context for the outgoing message.
* @return The addressing context.
*/
private MAP createContext()
{
final String messageId = MessageId.getMessageId() ;
return AddressingHelper.createNotificationContext(messageId);
}
}