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: BusinessAgreementWithParticipantCompletionParticipant.java,v 1.1.2.1 2004/05/26 10:02:33 nmcl Exp $
  */
 
 package com.arjuna.wst;
 
 {

    
The transaction has completed successfully. The participant previously informed the coordinator that it was ready to complete.
 
 
     public void close () throws WrongStateExceptionSystemException;

    
The transaction has cancelled, and the participant should undo any work. The participant cannot have informed the coordinator that it has completed.
 
 
     public void cancel () throws FaultedExceptionWrongStateExceptionSystemException;

    
The transaction has cancelled. The participant previously informed the coordinator that it had finished work but could compensate later if required, so it is now requested to do so.

Throws:
FaultedException if the participant was unable to perform the required compensation action because of an unrecoverable error. The coordinator is notified of this fault and as a result will stop resending compensation requests.
SystemException if the participant was unable to perform the required compensation action because of a transient fault. The coordinator is not notified of this fault so it will retry the compensate request after a suitable timeout.
 
 
     public void compensate () throws FaultedExceptionWrongStateExceptionSystemException;

    

Returns:
the status value.
 
 
     public String status () throws SystemException;

    
If the participant enquires as to the status of the transaction it was registered with and that transaction is no longer available (has rolled back) then this operation will be invoked by the coordination service. This has been deprecated since the correct action when a GetStatus request fails is either to cancel or compensate the participant or to call error. GetStatus is only dispatched while the participant is completed so cancel will never be appropriate. compensate is called when the participant is unknown to the coordinator (it responds to the GetStatus request with an InvalidState fault). This will only happen if the coordinator crashed after the participant completed but before the client requested a close/cancel. error is called if any other fault response is received. So there is no other circumstance in which it would be appropriate for unknown to be called.
 
 
     @Deprecated
     public void unknown () throws SystemException;

    
If the participant enquired as to the status of the transaction it was registered with and an unrecoverable error occurs then this operation will be invoked.
 
 
     public void error () throws SystemException;
New to GrepCode? Check out our FAQ X