From dd1ba9ad320e297f1acf1027604a368f1ddbde6c Mon Sep 17 00:00:00 2001 From: Constantin Date: Mon, 14 Jun 2010 11:27:05 +0200 Subject: changed build system of java/ folder from makefile to ant (big compilation time improvement) --- java/org/odmg/Transaction.java | 165 ----------------------------------------- 1 file changed, 165 deletions(-) delete mode 100644 java/org/odmg/Transaction.java (limited to 'java/org/odmg/Transaction.java') diff --git a/java/org/odmg/Transaction.java b/java/org/odmg/Transaction.java deleted file mode 100644 index 9cfb2b8..0000000 --- a/java/org/odmg/Transaction.java +++ /dev/null @@ -1,165 +0,0 @@ -/* -* This file is part of rasdaman community. -* -* Rasdaman community is free software: you can redistribute it and/or modify -* it under the terms of the GNU General Public License as published by -* the Free Software Foundation, either version 3 of the License, or -* (at your option) any later version. -* -* Rasdaman community is distributed in the hope that it will be useful, -* but WITHOUT ANY WARRANTY; without even the implied warranty of -* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -* GNU General Public License for more details. -* -* You should have received a copy of the GNU General Public License -* along with rasdaman community. If not, see . -* -* Copyright 2003, 2004, 2005, 2006, 2007, 2008, 2009 Peter Baumann / -rasdaman GmbH. -* -* For more information please see -* or contact Peter Baumann via . -*/ -package org.odmg; - -/** -* This interfaces provides the operations necessary to perform database transactions. -* All access, creation, and modification of persistent objects and their fields -* must be done within a transaction. Before performing any database operations, -* a thread must explicitly create a transaction object or associate itself with -* an existing transaction object (by calling join), -* and that transaction must be open (through a call to begin). -* All subsequent operations by the thread, including reads, writes, and lock -* acquisitions, are done under the thread’s current transaction. -*

-* A thread may only operate on its current transaction. For example, -* a TransactionNotInProgressException is thrown if a thread attempts -* to begin, commit, checkpoint, or abort a transaction prior to joining itself -* to that transaction. -*

-* A transaction is either open or closed. A transaction is open if a call -* has been made to begin, but no call has been made to commit or -* abort. Once commit or abort is called, -* the transaction is closed. The method isOpen can be called to -* determine the state of the transaction. -*

-* Read locks are implicitly obtained on objects as they are accessed. -* Write locks are implicitly obtained as objects are modified. -* Transaction objects are transient, they cannot be stored in the database. -* @author David Jordan (as Java Editor of the Object Data Management Group) -* @version ODMG 3.0 -* @see TransactionNotInProgressException -*/ - -public interface Transaction { -/** -* Attach the caller's thread to this Transaction and detach the thread -* from any former Transaction the thread may have been associated with, -*
not yet available in rasdaman.
-*/ - public void join(); - -/** -* Detach the caller's thread from this Transaction, but do not attach -* the thread to another Transaction, -*
not yet available in rasdaman.
-*/ - public void leave(); - -/** -* Start a transaction. -* Calling begin multiple times on the same transaction object, -* without an intervening call to commit or abort, -* causes the exception TransactionInProgressException to be thrown -* on the second and subsequent calls. Operations executed before a transaction -* has been opened, or before reopening after a transaction is aborted or committed, -* have undefined results; -* these may throw a TransactionNotInProgressException exception. -*/ - public void begin(); - -/** -* Determine whether the transaction is open or not. -* A transaction is open if a call has been made to begin, -* but a subsequent call to either commit or abort -* has not been made. -* @return True if the transaction is open, otherwise false. -*/ - public boolean isOpen(); - -/** -* Commit and close the transaction. -* Calling commit commits to the database all persistent object -* modifications within the transaction and releases any locks held by the transaction. -* A persistent object modification is an update of any field of an existing -* persistent object, or an update or creation of a new named object in the database. -* If a persistent object modification results in a reference from an existing -* persistent object to a transient object, the transient object is moved to the -* database, and all references to it updated accordingly. Note that the act of -* moving a transient object to the database may create still more persistent -* references to transient objects, so its referents must be examined and moved as well. -* This process continues until the database contains no references to transient objects, -* a condition that is guaranteed as part of transaction commit. -* Committing a transaction does not remove from memory transient objects created -* during the transaction -*/ - public void commit(); - -/** -* Abort and close the transaction. -* Calling abort abandons all persistent object modifications and releases the -* associated locks. -* Aborting a transaction does not restore the state of modified transient objects -*/ - public void abort(); - -/** -* Commit the transaction, but reopen the transaction, retaining all locks. -* Calling checkpoint commits persistent object modifications made -* within the transaction since the last checkpoint to the database. -* The transaction retains all locks it held on those objects at the time the -* checkpoint was invoked. -*/ - public void checkpoint(); - -/** -* Read lock mode. -*/ - public static final int READ = 1; - -/** -* Upgrade lock mode. -*/ - public static final int UPGRADE = 2; - -/** -* Write lock mode. -*/ - public static final int WRITE = 4; - -/** -* Upgrade the lock on the given object to the given lock mode, -*
not yet available in rasdaman.
-* The call has no effect if the object's current lock is already at or above -* that level of lock mode. -* @param obj The object to acquire a lock on. -* @param lockMode The lock mode to acquire. The lock modes are READ, -* UPGRADE, and WRITE. -* @exception LockNotGrantedException Is thrown if the given lock mode could not be acquired. -*/ - public void lock(Object obj, int lockMode) - throws LockNotGrantedException; -/** -* Upgrade the lock on the given object to the given lock mode, -*
not yet available in rasdaman.
-* Method tryLock is the same as lock except it returns -* a boolean indicating whether the lock was granted instead of generating an exception. -* @param obj The object to acquire a lock on. -* @param lockMode The lock mode to acquire. The lock modes are READ, -* UPGRADE, and WRITE. -* @return True if the lock has been acquired, otherwise false. -*/ - public boolean tryLock(Object obj, int lockMode); - -} - -- cgit