Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
  /*
   * 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, 2003, 2004,
  *
  * Arjuna Technologies Limited,
  * Newcastle upon Tyne,
  * Tyne and Wear,
  * UK.
  *
  * $Id: CoordinatorManager.java,v 1.4 2005/05/19 12:13:24 nmcl Exp $
  */
 
 package com.arjuna.mw.wscf.model.sagas.api;
 
 
 
The CoordinatorManager is the way in which services can enlist participants with the current coordinator.

Author(s):
Mark Little (mark.little@arjuna.com)
Version:
$Id: CoordinatorManager.java,v 1.4 2005/05/19 12:13:24 nmcl Exp $
Since:
1.0.
 
 
 public interface CoordinatorManager extends UserCoordinator
 {

    
Enrol the specified participant with the coordinator associated with the current thread.

Parameters:
act The participant.
Throws:
com.arjuna.mw.wsas.exceptions.NoActivityException Thrown if there is no activity associated with the current thread.
com.arjuna.mw.wsas.exceptions.WrongStateException Thrown if the coordinator is not in a state that allows participants to be enrolled.
com.arjuna.mw.wscf.exceptions.DuplicateParticipantException Thrown if the participant has already been enrolled and the coordination protocol does not support multiple entries.
com.arjuna.mw.wscf.exceptions.InvalidParticipantException Thrown if the participant is invalid.
com.arjuna.mw.wsas.exceptions.SystemException Thrown if any other error occurs.
 
 
Remove the specified participant from the coordinator associated with the current thread.

Parameters:
participantId The participant to remove.
Throws:
com.arjuna.mw.wsas.exceptions.NoActivityException Thrown if there is no activity associated with the current thread.
com.arjuna.mw.wsas.exceptions.WrongStateException Thrown if the coordinator is not in a state that allows participants to be removed.
com.arjuna.mw.wscf.exceptions.InvalidParticipantException Thrown if the participant is invalid.
com.arjuna.mw.wsas.exceptions.SystemException Thrown if any other error occurs.
 
 
     public void delistParticipant (String participantIdthrows NoActivityExceptionInvalidParticipantExceptionWrongStateExceptionSystemException;

    
The participant has completed its work and it ready to compensate if necessary.

Parameters:
participantId The participant.
Throws:
com.arjuna.mw.wsas.exceptions.NoActivityException Thrown if there is no activity associated with the current thread.
com.arjuna.mw.wsas.exceptions.WrongStateException Thrown if the coordinator is not in a state that allows participants to be removed.
com.arjuna.mw.wscf.exceptions.InvalidParticipantException Thrown if the participant is invalid.
com.arjuna.mw.wsas.exceptions.SystemException Thrown if any other error occurs.
A participant has faulted during normal execution or compensation. The saga will attempt to undo. The WS-T specification is a little vague here - we assume the entire transaction has to undo and a heuristic hazard needs to be logged.

Parameters:
participantId The participant.
Throws:
com.arjuna.mw.wsas.exceptions.NoActivityException Thrown if there is no activity associated with the current thread.
com.arjuna.mw.wscf.exceptions.InvalidParticipantException Thrown if the participant is invalid.
com.arjuna.mw.wsas.exceptions.SystemException Thrown if any other error occurs.
    public void participantFaulted (String participantIdthrows NoActivityExceptionInvalidParticipantExceptionSystemException;
    
    
A participant cannot complete during normal execution or compensation. The saga will attempt to undo. The WS-T specification is a little vague here - we assume the entire transaction has to undo.

Parameters:
participantId The participant.
Throws:
com.arjuna.mw.wsas.exceptions.NoActivityException Thrown if there is no activity associated with the current thread.
com.arjuna.mw.wscf.exceptions.InvalidParticipantException Thrown if the participant is invalid.
com.arjuna.mw.wsas.exceptions.SystemException Thrown if any other error occurs.
New to GrepCode? Check out our FAQ X