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: /**
32: * The app server transaction interface. Transactions are normally
33: * associated with a single thread.
34: */
35: public interface TransactionManager {
36: /**
37: * Sets the transaction's timeout.
38: */
39: public void setTransactionTimeout(int seconds)
40: throws SystemException;
41:
42: /**
43: * Returns the current transaction.
44: */
45: public Transaction getTransaction() throws SystemException;
46:
47: /**
48: * Gets the transaction's status
49: */
50: public int getStatus() throws SystemException;
51:
52: /**
53: * Start the transaction.
54: */
55: public void begin() throws NotSupportedException, SystemException;
56:
57: /**
58: * Suspends the transaction.
59: */
60: public Transaction suspend() throws SystemException;
61:
62: /**
63: * Resume a transaction.
64: */
65: public void resume(Transaction transaction)
66: throws IllegalStateException, InvalidTransactionException,
67: SystemException;
68:
69: /**
70: * Marks the transaction as rollback only.
71: */
72: public void setRollbackOnly() throws IllegalStateException,
73: SystemException;
74:
75: /**
76: * Commits the transaction
77: */
78: public void commit() throws IllegalStateException,
79: RollbackException, HeuristicMixedException,
80: HeuristicRollbackException, SecurityException,
81: SystemException;
82:
83: /**
84: * Rolls the transaction back
85: */
86: public void rollback() throws IllegalStateException,
87: SecurityException, SystemException;
88: }
|