01: /*
02: * Copyright (c) 1998-2008 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: *
23: * Free Software Foundation, Inc.
24: * 59 Temple Place, Suite 330
25: * Boston, MA 02111-1307 USA
26: *
27: * @author Scott Ferguson
28: */
29:
30: package javax.resource.spi;
31:
32: import javax.transaction.xa.XAException;
33: import javax.transaction.xa.Xid;
34:
35: /**
36: * Facilities made available by the application server to the resource.
37: */
38: public interface XATerminator {
39: /**
40: * Prepares a transaction.
41: */
42: public int prepare(Xid xid) throws XAException;
43:
44: /**
45: * Commits a transaction.
46: */
47: public void commit(Xid xid, boolean onePhase) throws XAException;
48:
49: /**
50: * Rolls back a transaction.
51: */
52: public void rollback(Xid xid) throws XAException;
53:
54: /**
55: * Forgets a heuristic transaction.
56: */
57: public void forget(Xid xid) throws XAException;
58:
59: /**
60: * Returns the prepared transaction branches.
61: */
62: public Xid[] recover(int flag) throws XAException;
63: }
|