01: /*
02: * $Id: Transaction.java,v 1.9 2004/08/27 03:21:20 ahimanikya Exp $
03: * =======================================================================
04: * Copyright (c) 2002-2004 Axion Development Team. All rights reserved.
05: *
06: * Redistribution and use in source and binary forms, with or without
07: * modification, are permitted provided that the following conditions
08: * are met:
09: *
10: * 1. Redistributions of source code must retain the above
11: * copyright notice, this list of conditions and the following
12: * disclaimer.
13: *
14: * 2. Redistributions in binary form must reproduce the above copyright
15: * notice, this list of conditions and the following disclaimer in
16: * the documentation and/or other materials provided with the
17: * distribution.
18: *
19: * 3. The names "Tigris", "Axion", nor the names of its contributors may
20: * not be used to endorse or promote products derived from this
21: * software without specific prior written permission.
22: *
23: * 4. Products derived from this software may not be called "Axion", nor
24: * may "Tigris" or "Axion" appear in their names without specific prior
25: * written permission.
26: *
27: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
28: * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
29: * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
30: * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
31: * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
32: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
33: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
34: * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
35: * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
36: * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
37: * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
38: * =======================================================================
39: */
40:
41: package org.axiondb;
42:
43: import java.util.Set;
44:
45: /**
46: * A database transaction.
47: *
48: * @version $Revision: 1.9 $ $Date: 2004/08/27 03:21:20 $
49: * @author Rodney Waldhoff
50: */
51: public interface Transaction extends Database, Transactable {
52:
53: /** Aborted. */
54: public static final int STATE_ABORTED = 2;
55:
56: /** Applied. */
57: public static final int STATE_APPLIED = 3;
58:
59: /** Committed, but not yet applied. */
60: public static final int STATE_COMMITTED = 1;
61:
62: /** Open (neither committed nor aborted yet). */
63: public static final int STATE_OPEN = 0;
64:
65: /**
66: * Return a {@link Set}of {@link Table}s that have been modified thus far in this
67: * transaction.
68: */
69: Set getModifiedTables();
70:
71: /**
72: * Get the {@link Database}upon which I am open (i.e., the state to which we will
73: * return to if I am rolled back. Note that this may be another
74: * <code>Transaction</code>.
75: */
76: Database getOpenOnTransaction();
77:
78: /**
79: * Return a {@link Set}of {@link Table}s that have been read thus far in this
80: * transaction.
81: */
82: Set getReadTables();
83:
84: /**
85: * Return my current transaction state. Returns one of {@link #STATE_OPEN},
86: * {@link #STATE_COMMITTED},{@link #STATE_ABORTED},{@link #STATE_APPLIED}.
87: */
88: int getState();
89: }
|