KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > jboss > tm > integrity > TransactionIntegrity


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.integrity;
23
24 import org.jboss.tm.TransactionImpl;
25
26 /**
27  * A policy that checks a transaction before allowing a commit
28  *
29  * @author <a HREF="adrian@jboss.com">Adrian Brock</a>
30  * @version $Revision: 37459 $
31  */
32 public interface TransactionIntegrity
33 {
34    /**
35     * Checks whether a transaction can be committed.<p>
36     *
37     * The policy is allowed to wait, e.g. if there
38     * are other threads still associated with the transaction.<p>
39     *
40     * This method is invoked before any transaction synchronizations'
41     * beforeCompletions.<p>
42     *
43     * This policy should not invoke any methods that change the
44     * state of the transaction other than <code>setRollbackOnly()</code>
45     * to force a rollback or registering a transaction synchronization.
46     *
47     * @param transaction the transaction
48     * @throws SecurityException if a commit is not allowed from this context
49     */
50    void checkTransactionIntegrity(TransactionImpl transaction);
51 }
52
Popular Tags