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,
  *
  * Arjuna Technologies Limited,
  * Newcastle upon Tyne,
  * Tyne and Wear,
  * UK.
  *
  * $Id: Participant.java,v 1.3 2005/05/19 12:13:26 nmcl Exp $
  */
 
 package com.arjuna.mw.wscf.model.twophase.participants;
 
 
 
This is the interface that all two-phase aware participants must define.

Author(s):
Mark Little (mark.little@arjuna.com)
Version:
$Id: Participant.java,v 1.3 2005/05/19 12:13:26 nmcl Exp $
Since:
1.0.
 
 
 // TODO the nested transaction methods
 
 public interface Participant
 {

    
Prepare the participant for top-level.

Returns:
the vote.
Throws:
com.arjuna.mw.wscf.exceptions.InvalidParticipantException Thrown if the participant identity is invalid (e.g., refers to an unknown participant.)
com.arjuna.mw.wsas.exceptions.WrongStateException Thrown if the state of the participant is such that it cannot prepare.
com.arjuna.mw.wscf.model.twophase.exceptions.HeuristicHazardException Thrown if upon preparing, the participant finds that some of its enlisted participants have return statuses which mean it cannot determine what the result of issuing prepare to them has been.
com.arjuna.mw.wscf.model.twophase.exceptions.HeuristicMixedException Thrown if upon preparing, the participant finds that some of its enlisted participants have return statuses which mean some of them cancelled and some of them confirmed.
com.arjuna.mw.wsas.exceptions.SystemException Thrown if some other error occurred.
 
     
Confirm the participant at top-level.

Throws:
com.arjuna.mw.wscf.exceptions.InvalidParticipantException Thrown if the participant identity is invalid (e.g., refers to an unknown participant.)
com.arjuna.mw.wsas.exceptions.WrongStateException Thrown if the state of the participant is such that it cannot confirm.
com.arjuna.mw.wscf.model.twophase.exceptions.HeuristicHazardException Thrown if upon preparing, the participant finds that some of its enlisted participants have return statuses which mean it cannot determine what the result of issuing confirm to them has been.
com.arjuna.mw.wscf.model.twophase.exceptions.HeuristicMixedException Thrown if upon preparing, the participant finds that some of its enlisted participants have return statuses which mean some of them cancelled and some of them confirmed.
HeuristicRollbackException Thrown if the participant rolls back rather than commits.
com.arjuna.mw.wsas.exceptions.SystemException Thrown if some other error occurred.
 
 
Cancel the participant at top-level.

Throws:
com.arjuna.mw.wscf.exceptions.InvalidParticipantException Thrown if the participant identity is invalid (e.g., refers to an unknown participant.)
com.arjuna.mw.wsas.exceptions.WrongStateException Thrown if the state of the participant is such that it cannot cancel.
com.arjuna.mw.wscf.model.twophase.exceptions.HeuristicHazardException Thrown if upon preparing, the participant finds that some of its enlisted participants have return statuses which mean it cannot determine what the result of issuing cancel to them has been.
com.arjuna.mw.wscf.model.twophase.exceptions.HeuristicMixedException Thrown if upon preparing, the participant finds that some of its enlisted participants have return statuses which mean some of them cancelled and some of them confirmed.
HeuristicCommitException Thrown if the participant commits rather than rolls back.
com.arjuna.mw.wsas.exceptions.SystemException Thrown if some other error occurred.
Confirm the participant in a single phase.

Throws:
com.arjuna.mw.wscf.exceptions.InvalidParticipantException Thrown if the participant identity is invalid (e.g., refers to an unknown participant.)
com.arjuna.mw.wsas.exceptions.WrongStateException Thrown if the state of the participant is such that it cannot cancel.
com.arjuna.mw.wscf.model.twophase.exceptions.HeuristicHazardException Thrown if upon preparing, the participant finds that some of its enlisted participants have return statuses which mean it cannot determine what the result of issuing cancel to them has been.
com.arjuna.mw.wscf.model.twophase.exceptions.HeuristicMixedException Thrown if upon preparing, the participant finds that some of its enlisted participants have return statuses which mean some of them cancelled and some of them confirmed.
HeuristicRollbackException Thrown if the participant rolls back rather than commit.
com.arjuna.mw.wsas.exceptions.SystemException Thrown if some other error occurred.
Inform the participant that is can forget the heuristic result.

Throws:
com.arjuna.mw.wscf.exceptions.InvalidParticipantException Thrown if the participant identity is invalid.
com.arjuna.mw.wsas.exceptions.WrongStateException Thrown if the participant is in an invalid state.
com.arjuna.mw.wsas.exceptions.SystemException Thrown in the event of a general fault.
    public String id () throws SystemException;
    
    // recovery information
    
    public boolean save_state (OutputObjectState os);
    public boolean restore_state (InputObjectState os);
New to GrepCode? Check out our FAQ X