TxCompletionHandler


1   /*
2     * JBoss, Home of Professional Open Source
3     * Copyright 2005, JBoss Inc., and individual contributors as indicated
4     * by the @authors tag. See the copyright.txt in the distribution for a
5     * full listing of individual contributors.
6     *
7     * This is free software; you can redistribute it and/or modify it
8     * under the terms of the GNU Lesser General Public License as
9     * published by the Free Software Foundation; either version 2.1 of
10    * the License, or (at your option) any later version.
11    *
12    * This software is distributed in the hope that it will be useful,
13    * but WITHOUT ANY WARRANTY; without even the implied warranty of
14    * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15    * Lesser General Public License for more details.
16    *
17    * You should have received a copy of the GNU Lesser General Public
18    * License along with this software; if not, write to the Free
19    * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
20    * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
21    */
22  package org.jboss.tm.recovery;
23  
24  /**
25   * Interface of an object that should be invoked at transaction completion.
26   *
27   * @author <a HREF="mailto:bill@jboss.org">Bill Burke</a>
28   * @author <a HREF="mailto:reverbel@ime.usp.br">Francisco Reverbel</a>
29   * @version $Revision: 37459 $
30   */
31  public interface TxCompletionHandler
32  {
33     
34     /**
35      * Signals the end of the two-phase commit protocol for a committed 
36      * transaction. This method should invoked when the second phase of the 
37      * two-phase commit protocol completes successfully and no heuristic
38      * decisions were made. In the case of a heuristically committed transaction,
39      * this method should not be invoked at the end of the second phase of the
40      * two-phase commit protocol. Instead, the <code>handleTxCompletion</code> 
41      * call should be postponed until the heuristic outcome is forgotten.
42      *
43      * @param localTransactionId the local id of the completed transaction.
44      */
45     void handleTxCompletion(long localTransactionId);
46  }
47
A to Z: JavaDoc & Examples Daily Java News & Articles Open Source Projects Open Source Codes Free Computer Books Remove Frame
Popular Tags