Packages

c

com.couchbase.client.scala.transactions.error

TransactionCommitAmbiguousException

class TransactionCommitAmbiguousException extends TransactionFailedException

The transaction expired at the point of trying to commit it. It is ambiguous whether the transaction has committed or not.

This error is result of inevitable and unavoidable edge cases when working with unreliable networks. For example, consider an ordinary mutation being made over the network to any database. The mutation could succeed on the database-side, and then just before the result is returned to the client, the network connection drops. The client cannot receive the success result and will timeout - it is ambiguous to it whether the mutation succeeded or not.

The transactions layer will work to resolve the ambiguity up until the transaction expires, but if unable to resolve it in that time, it is forced to raise this error. The transaction may or may not have been successful, and error-handling of this is highly application-dependent.

The asynchronous cleanup process will try to complete the transaction: roll it back if it didn't commit, roll it forwards if it did.

Linear Supertypes
TransactionFailedException, CouchbaseException, RuntimeException, Exception, Throwable, Serializable, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. TransactionCommitAmbiguousException
  2. TransactionFailedException
  3. CouchbaseException
  4. RuntimeException
  5. Exception
  6. Throwable
  7. Serializable
  8. AnyRef
  9. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. Protected

Value Members

  1. final def addSuppressed(arg0: Throwable): Unit
    Definition Classes
    Throwable
  2. def context(): ErrorContext
    Definition Classes
    CouchbaseException
    Annotations
    @Uncommitted()
  3. def fillInStackTrace(): Throwable
    Definition Classes
    Throwable
  4. def getCause(): Throwable
    Definition Classes
    Throwable
  5. def getLocalizedMessage(): String
    Definition Classes
    Throwable
  6. final def getMessage(): String
    Definition Classes
    CouchbaseException → Throwable
  7. def getStackTrace(): Array[StackTraceElement]
    Definition Classes
    Throwable
  8. final def getSuppressed(): Array[Throwable]
    Definition Classes
    Throwable
  9. def initCause(arg0: Throwable): Throwable
    Definition Classes
    Throwable
  10. def logs(): Iterable[TransactionLogEvent]

    An in-memory log is built up during each transaction.

    An in-memory log is built up during each transaction. The application may want to write this to their own logs, for example upon transaction failure.

    Definition Classes
    TransactionFailedException
  11. def printStackTrace(arg0: PrintWriter): Unit
    Definition Classes
    Throwable
  12. def printStackTrace(arg0: PrintStream): Unit
    Definition Classes
    Throwable
  13. def printStackTrace(): Unit
    Definition Classes
    Throwable
  14. def setStackTrace(arg0: Array[StackTraceElement]): Unit
    Definition Classes
    Throwable
  15. def toString(): String
    Definition Classes
    Throwable → AnyRef → Any
  16. def transactionId(): String
    Definition Classes
    TransactionFailedException