From 780b92ada9afcf1d58085a83a0b9e6bc982203d1 Mon Sep 17 00:00:00 2001 From: Lorry Tar Creator Date: Tue, 17 Feb 2015 17:25:57 +0000 Subject: Imported from /home/lorry/working-area/delta_berkeleydb/db-6.1.23.tar.gz. --- docs/java/com/sleepycat/db/Transaction.html | 1161 +++++++++++++-------------- 1 file changed, 550 insertions(+), 611 deletions(-) (limited to 'docs/java/com/sleepycat/db/Transaction.html') diff --git a/docs/java/com/sleepycat/db/Transaction.html b/docs/java/com/sleepycat/db/Transaction.html index 767a0652..e5b8eaa0 100644 --- a/docs/java/com/sleepycat/db/Transaction.html +++ b/docs/java/com/sleepycat/db/Transaction.html @@ -1,107 +1,105 @@ - - - - - -Transaction (Oracle - Berkeley DB Java API) - - - - - - - - - - - - -
- - +//--> + + - - - - - - - - - - - - - - - - -
- - - - - - - - - - - - -
Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
-		 -Berkeley DB
version 5.3.21 -
- PREV CLASS  - NEXT CLASS - FRAMES   - NO FRAMES   -  - - - -
- SUMMARY: NESTED | FIELD | CONSTR | METHOD -DETAIL: FIELD | CONSTR | METHOD
- + + +
+ + +
+ + + - -
-

- -com.sleepycat.db -
-Class Transaction

-
-java.lang.Object
-  extended by com.sleepycat.db.Transaction
-
-
-
-
public class Transaction
extends Object
- - -

-The Transaction object is the handle for a transaction. Methods off the +

+
com.sleepycat.db
+

Class Transaction

+
+
+ +
+
    +
  • +
    +
    +
    public class Transaction
+extends java.lang.Object
    +
    The Transaction object is the handle for a transaction. Methods off the transaction handle are used to configure, abort and commit the transaction. Transaction handles are provided to other Berkeley DB methods in order to transactionally protect those operations. @@ -109,14 +107,14 @@ methods in order to transactionally protect those operations. Transaction handles are not free-threaded; transactions handles may be used by multiple threads, but only serially, that is, the application must serialize access to the handle. Once the -Transaction.abort, Transaction.commit or -Transaction.discard +Transaction.abort, Transaction.commit or +Transaction.discard methods are called, the handle may not be accessed again (except to retrieve the commit token), regardless of the success or failure of the method. In addition, parent transactions may not issue any Berkeley DB operations while they have active child transactions (child transactions that have -not yet been committed or aborted) except for Environment.beginTransaction, Transaction.abort and Transaction.commit. +not yet been committed or aborted) except for Environment.beginTransaction, Transaction.abort and Transaction.commit.

    To obtain a transaction with default attributes: 

    @@ -127,195 +125,166 @@ To customize the attributes of a transaction:
     TransactionConfig config = new TransactionConfig();
     config.setDirtyRead(true);
     Transaction txn = myEnvironment.beginTransaction(null, config);
-
    -

    - -

    -

    - -

    - +

    +
    • +
+
+
+
    +
  • - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    -Method Summary
    - voidabort() - -
    -          Cause an abnormal termination of the transaction.
    - voidcommit() - -
    -          End the transaction.
    - voidcommitNoSync() - -
    -          End the transaction, not committing synchronously.
    - voidcommitSync() - -
    -          End the transaction, committing synchronously.
    - voidcommitWriteNoSync() - -
    -          End the transaction, writing but not flushing the log.
    - voiddiscard() - -
    -          Free up all the per-process resources associated with the specified - Transaction handle, neither committing nor aborting the - transaction.
    - byte[]getCommitToken() - -
    -          Fetch the transaction's commit token.
    - intgetId() - -
    -          Return the transaction's unique ID.
    - StringgetName() - -
    -          Get the user visible name for the transaction.
    - intgetPriority() - -
    -          Get the transaction's deadlock priority.
    - voidprepare(byte[] gid) - -
    -          Initiate the beginning of a two-phase commit.
    - voidsetLockTimeout(long timeOut) - -
    -          Configure the lock request timeout value for the transaction.
    - voidsetName(String name) - -
    -          Set the user visible name for the transaction.
    - voidsetPriority(int priority) - -
    -          Set the deadlock priority for this transaction.
    - voidsetTxnTimeout(long timeOut) - -
    -          Configure the timeout value for the transaction lifetime.
    -  - - - - - - - -
    Methods inherited from class java.lang.Object
    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    -  -

    - +

      +
    • + + +

      Method Summary

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      Methods 
      Modifier and TypeMethod and Description
      voidabort() +
      Cause an abnormal termination of the transaction.
      +
      voidcommit() +
      End the transaction.
      +
      voidcommitNoSync() +
      End the transaction, not committing synchronously.
      +
      voidcommitSync() +
      End the transaction, committing synchronously.
      +
      voidcommitWriteNoSync() +
      End the transaction, writing but not flushing the log.
      +
      voiddiscard() +
      Free up all the per-process resources associated with the specified + Transaction handle, neither committing nor aborting the + transaction.
      +
      byte[]getCommitToken() +
      Fetch the transaction's commit token.
      +
      intgetId() +
      Return the transaction's unique ID.
      +
      java.lang.StringgetName() +
      Get the user visible name for the transaction.
      +
      intgetPriority() +
      Get the transaction's deadlock priority.
      +
      voidprepare(byte[] gid) +
      Initiate the beginning of a two-phase commit.
      +
      voidsetLockTimeout(long timeOut) +
      Configure the lock request timeout value for the transaction.
      +
      voidsetName(java.lang.String name) +
      Set the user visible name for the transaction.
      +
      voidsetPriority(int priority) +
      Set the deadlock priority for this transaction.
      +
      voidsetTxnTimeout(long timeOut) +
      Configure the timeout value for the transaction lifetime.
      +
      +
        +
      • + + +

        Methods inherited from class java.lang.Object

        +clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
        • +
      +
      • +
    +
    • +
+
+
+
    +
  • - - - - - - -
    -Method Detail
    - -

    -getCommitToken

    -
    -public byte[] getCommitToken()
-                      throws IllegalStateException
    -
    -
    Fetch the transaction's commit token. -

    - This operation can only be performed after this transaction has committed. -

    -

    - -
    Returns:
    The commit token generated at the commit time of this transaction. -

    -

    Throws: -
    DatabaseException - if a failure occurs -
    IllegalStateException
    -
    -
    -
    - -

    -abort

    -
    -public void abort()
-           throws DatabaseException
    -
    -
    Cause an abnormal termination of the transaction. +
      +
    • + + +

      Method Detail

      + + + +
        +
      • +

        getCommitToken

        +
        public byte[] getCommitToken()
+                      throws java.lang.IllegalStateException
        +
        Fetch the transaction's commit token. +

        + This operation can only be performed after this transaction has committed.

        +
        Returns:
        The commit token generated at the commit time of this transaction. +

        +
        Throws:
        +
        DatabaseException - if a failure occurs
        +
        java.lang.IllegalStateException
        +
        • +
      + + + +
        +
      • +

        abort

        +
        public void abort()
+           throws DatabaseException
        +
        Cause an abnormal termination of the transaction.

        The log is played backward, and any necessary undo operations are done. Before Transaction.abort returns, any locks held by the transaction will @@ -327,30 +296,27 @@ public void abort()

        All cursors opened within the transaction must be closed before the transaction is aborted. - This method closes all open Cursor handles. + This method closes all open Cursor handles. And if a close operation fails, the rest of the cursors are closed, and the database environment is set to the panic state.

        After Transaction.abort has been called, regardless of its return, the - Transaction handle may not be accessed again. -

        -

        -

        -

        - -
        Throws: -
        DatabaseException - if a failure occurs.
        -
        -
    -
    - -

    -commit

    -
    -public void commit()
-            throws DatabaseException
    -
    -
    End the transaction. If the environment is configured for synchronous + Transaction handle may not be accessed again. +

    +

+
Throws:
+
DatabaseException - if a failure occurs.
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ -
- - - - - - - - - - - - - - - - - - -
- - - - - - - - - - - - -
Overview  Package   Class  Use  Tree  Deprecated  Index  Help 
-		 -Berkeley DB
version 5.3.21 -
- PREV CLASS  - NEXT CLASS - FRAMES   - NO FRAMES   -  - - - -
- SUMMARY: NESTED | FIELD | CONSTR | METHOD -DETAIL: FIELD | CONSTR | METHOD
- + + +
+ + +
+ + + - -
-Copyright (c) 1996, 2012 Oracle and/or its affiliates. All rights reserved. - - +

Copyright (c) 1996, 2015 Oracle and/or its affiliates. All rights reserved.

+ + -- cgit v1.2.1