01: /*
02: * Copyright (c) 1998-2003 Caucho Technology -- all rights reserved
03: *
04: * This file is part of Resin(R) Open Source
05: *
06: * Each copy or derived work must preserve the copyright notice and this
07: * notice unmodified.
08: *
09: * Resin Open Source is free software; you can redistribute it and/or modify
10: * it under the terms of the GNU General Public License as published by
11: * the Free Software Foundation; either version 2 of the License, or
12: * (at your option) any later version.
13: *
14: * Resin Open Source is distributed in the hope that it will be useful,
15: * but WITHOUT ANY WARRANTY; without even the implied warranty of
16: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE, or any warranty
17: * of NON-INFRINGEMENT. See the GNU General Public License for more
18: * details.
19: *
20: * You should have received a copy of the GNU General Public License
21: * along with Resin Open Source; if not, write to the
22: * Free SoftwareFoundation, Inc.
23: * 59 Temple Place, Suite 330
24: * Boston, MA 02111-1307 USA
25: *
26: * @author Scott Ferguson
27: */
28:
29: package javax.transaction;
30:
31: import javax.transaction.xa.XAResource;
32:
33: /**
34: * The transaction interface. Transactions are normally
35: * associated with a single thread.
36: */
37: public interface Transaction {
38: public final static int TMSUCCESS = 0x04000000;
39: public final static int TMSUSPEND = 0x02000000;
40: public final static int TMFAIL = 0x20000000;
41:
42: /**
43: * Returns the transaction's status.
44: */
45: public int getStatus() throws SystemException;
46:
47: /**
48: * Enlists a resource with the transaction.
49: */
50: public boolean enlistResource(XAResource xaRes)
51: throws IllegalStateException, RollbackException,
52: SystemException;
53:
54: /**
55: * Delists a resource from the transaction.
56: */
57: public boolean delistResource(XAResource xaRes, int flag)
58: throws IllegalStateException, SystemException;
59:
60: /**
61: * Registers a synchronization.
62: */
63: public void registerSynchronization(Synchronization sync)
64: throws IllegalStateException, RollbackException,
65: SystemException;
66:
67: /**
68: * Marks the transaction as rollback only.
69: */
70: public void setRollbackOnly() throws IllegalStateException,
71: SystemException;
72:
73: /**
74: * Commits the transaction.
75: */
76: public void commit() throws IllegalStateException,
77: RollbackException, HeuristicMixedException,
78: HeuristicRollbackException, SecurityException,
79: SystemException;
80:
81: /**
82: * Rolls the transaction back.
83: */
84: public void rollback() throws IllegalStateException,
85: SystemException;
86: }
|