Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> apache >> derby >> iapi >> store >> access >> [ conglomerate overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

org.apache.derby.iapi.store.access.conglomerate
Interface TransactionManager  

All Superinterfaces:

org.apache.derby.iapi.services.property.PersistentSet, org.apache.derby.iapi.store.access.TransactionController

---

public interface TransactionManager

extends org.apache.derby.iapi.store.access.TransactionController

The TransactionManager interface provides methods on the transaction needed by an access method implementer, but should not be visible to clients of a TransactionController.

---

Field Summary
static int	LOCK_COMMIT_DURATION           hold lock until end of transaction.
static int	LOCK_INSTANT_DURATION           release lock immediately after getting lock.
static int	LOCK_MANUAL_DURATION           Allow lock to be released manually prior to end transaction.
static int	MODE_NONE           Constant used for the lock_level argument to openConglomerate() and openScan() calls.

 

Fields inherited from interface org.apache.derby.iapi.store.access.TransactionController

IS_DEFAULT, IS_KEPT, IS_TEMPORARY, ISOLATION_NOLOCK, ISOLATION_READ_COMMITTED, ISOLATION_READ_COMMITTED_NOHOLDLOCK, ISOLATION_READ_UNCOMMITTED, ISOLATION_REPEATABLE_READ, ISOLATION_SERIALIZABLE, KEEP_LOCKS, MODE_RECORD, MODE_TABLE, OPEN_CONGLOMERATE, OPEN_CREATED_SORTS, OPEN_SCAN, OPEN_SORT, OPEN_TOTAL, OPENMODE_BASEROW_INSERT_LOCKED, OPENMODE_FOR_LOCK_ONLY, OPENMODE_FORUPDATE, OPENMODE_LOCK_NOWAIT, OPENMODE_SECONDARY_LOCKED, OPENMODE_USE_UPDATE_LOCKS, READONLY_TRANSACTION_INITIALIZATION, RELEASE_LOCKS

 

Method Summary
void	addPostCommitWork(org.apache.derby.iapi.services.daemon.Serviceable work)           Add to the list of post commit work.
void	closeMe(org.apache.derby.iapi.store.access.ConglomerateController conglom_control)           The ConglomerateController.close() method has been called on "conglom_control".
void	closeMe(ScanManager scan)           The ScanManager.close() method has been called on "scan".
void	closeMe(org.apache.derby.iapi.store.access.SortController sort_control)           The SortController.close() method has been called on "sort_control".
org.apache.derby.iapi.store.access.AccessFactory	getAccessManager()           Get reference to access factory which started this transaction.
TransactionManager	getInternalTransaction()           Get an Internal transaction.
org.apache.derby.iapi.store.raw.Transaction	getRawStoreXact()           Get the Transaction from the Transaction manager.
void	saveScanPositions(Conglomerate conglom, org.apache.derby.iapi.store.raw.Page page)           Do work necessary to maintain the current position in all the scans.

 

Methods inherited from interface org.apache.derby.iapi.store.access.TransactionController

abort, addColumnToConglomerate, anyoneBlocked, commit, commitNoSync, compressConglomerate, conglomerateExists, countOpens, createAndLoadConglomerate, createBackingStoreHashtableFromScan, createConglomerate, createSort, createXATransactionFromLocalTransaction, debugOpened, defragmentConglomerate, destroy, dropConglomerate, dropSort, fetchMaxOnBtree, findConglomid, findContainerid, getActiveStateTxIdString, getCacheStats, getContextManager, getDynamicCompiledConglomInfo, getFileHandler, getLockObject, getStaticCompiledConglomInfo, getTransactionIdString, getUserCreateConglomPropList, isGlobal, isIdle, isPristine, logAndDo, openCompiledConglomerate, openCompiledScan, openConglomerate, openGroupFetchScan, openScan, openSort, openSortCostController, openSortRowSource, openSortScan, openStoreCost, purgeConglomerate, recreateAndLoadConglomerate, releaseSavePoint, resetCacheStats, rollbackToSavePoint, setSavePoint, startNestedUserTransaction

 

Methods inherited from interface org.apache.derby.iapi.services.property.PersistentSet

getProperties, getProperty, getPropertyDefault, propertyDefaultIsVisible, setProperty, setPropertyDefault

 

Field Detail

MODE_NONE

public static final int MODE_NONE

Constant used for the lock_level argument to openConglomerate() and openScan() calls. Pass in MODE_NONE if you want no table or row locks. This is currently only supported from within access.

See Also:

Constant Field Values

---

LOCK_INSTANT_DURATION

public static final int LOCK_INSTANT_DURATION

release lock immediately after getting lock.

See Also:

Constant Field Values

---

LOCK_COMMIT_DURATION

public static final int LOCK_COMMIT_DURATION

hold lock until end of transaction.

See Also:

Constant Field Values

---

LOCK_MANUAL_DURATION

public static final int LOCK_MANUAL_DURATION

Allow lock to be released manually prior to end transaction.

See Also:

Constant Field Values

Method Detail

addPostCommitWork

public void addPostCommitWork(org.apache.derby.iapi.services.daemon.Serviceable work)

Add to the list of post commit work.

Add to the list of post commit work that may be processed after this transaction commits. If this transaction aborts, then the post commit work list will be thrown away. No post commit work will be taken out on a rollback to save point.

This routine simply delegates the work to the Rawstore transaction.

---

closeMe

public void closeMe(ScanManager scan)

The ScanManager.close() method has been called on "scan".

Take whatever cleanup action is appropriate to a closed scan. It is likely this routine will remove references to the scan object that it was maintaining for cleanup purposes.

---

closeMe

public void closeMe(org.apache.derby.iapi.store.access.ConglomerateController conglom_control)

The ConglomerateController.close() method has been called on "conglom_control".

Take whatever cleanup action is appropriate to a closed conglomerateController. It is likely this routine will remove references to the ConglomerateController object that it was maintaining for cleanup purposes.

---

closeMe

public void closeMe(org.apache.derby.iapi.store.access.SortController sort_control)

The SortController.close() method has been called on "sort_control".

Take whatever cleanup action is appropriate to a closed sortController. It is likely this routine will remove references to the SortController object that it was maintaining for cleanup purposes.

---

getAccessManager

public org.apache.derby.iapi.store.access.AccessFactory getAccessManager()

Get reference to access factory which started this transaction.

---

getInternalTransaction

public TransactionManager getInternalTransaction()
                                          throws org.apache.derby.iapi.error.StandardException

Get an Internal transaction.

Start an internal transaction. An internal transaction is a completely separate transaction from the current user transaction. All work done in the internal transaction must be physical (ie. it can be undone physically by the rawstore at the page level, rather than logically undone like btree insert/delete operations). The rawstore guarantee's that in the case of a system failure all open Internal transactions are first undone in reverse order, and then other transactions are undone in reverse order.

Internal transactions are meant to implement operations which, if interupted before completion will cause logical operations like tree searches to fail. This special undo order insures that the state of the tree is restored to a consistent state before any logical undo operation which may need to search the tree is performed.

---

getRawStoreXact

public org.apache.derby.iapi.store.raw.Transaction getRawStoreXact()
                                                            throws org.apache.derby.iapi.error.StandardException

Get the Transaction from the Transaction manager.

Access methods often need direct access to the "Transaction" - ie. the raw store transaction, so give access to it.

---

saveScanPositions

public void saveScanPositions(Conglomerate conglom,
                              org.apache.derby.iapi.store.raw.Page page)
                       throws org.apache.derby.iapi.error.StandardException

Do work necessary to maintain the current position in all the scans.

The latched page in the conglomerate "congomid" is changing, do whatever is necessary to maintain the current position of all the scans open in this transaction.

For some conglomerates this may be a no-op.

---

Overview  Package   Class  Use  Deprecated  Index
Home >> All >> org >> apache >> derby >> iapi >> store >> access >> [ conglomerate overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---