io.permazen.kv

Class RetryTransactionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.permazen.kv.KVException

io.permazen.kv.KVDatabaseException

io.permazen.kv.KVTransactionException

io.permazen.kv.RetryTransactionException

All Implemented Interfaces:

Serializable, Cloneable

Direct Known Subclasses:

TransactionConflictException

public class RetryTransactionException
extends KVTransactionException

Exception thrown when an attempt to access a KVTransaction results in a conflict or other condition requiring that the transaction be retried.

Note: although it is usually the case, a RetryTransactionException does not necessarily mean that the transaction failed. In some situations (e.g., involving failed network communication) it may not be possible to determine whether a transaction succeeded or not, and this situation is indicated by throwing a RetryTransactionException. Whether and how often such a "false negative" can occur is a function of the KVDatabase implementation being used; ideally, all transactions are idempotent and therefore correct in either case.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
RetryTransactionException(KVTransaction kvt)
RetryTransactionException(KVTransaction kvt, String message)
RetryTransactionException(KVTransaction kvt, String message, Throwable cause)
RetryTransactionException(KVTransaction kvt, Throwable cause)

Method Summary

Modifier and Type	Method and Description
RetryTransactionException	duplicate() Create a duplicate of this exception, with the current thread's stack frames prepended.

Methods inherited from class io.permazen.kv.KVTransactionException

getTransaction

Methods inherited from class io.permazen.kv.KVDatabaseException

getStore

Methods inherited from class io.permazen.kv.KVException

clone, rethrow

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

RetryTransactionException

public RetryTransactionException(KVTransaction kvt)

RetryTransactionException

public RetryTransactionException(KVTransaction kvt,
                                 Throwable cause)

RetryTransactionException

public RetryTransactionException(KVTransaction kvt,
                                 String message)

RetryTransactionException

public RetryTransactionException(KVTransaction kvt,
                                 String message,
                                 Throwable cause)

Method Detail

duplicate

public RetryTransactionException duplicate()

Description copied from class: KVException

Create a duplicate of this exception, with the current thread's stack frames prepended.

This allows the "same" exception to be thrown multiple times from different locations with different outer stack frames. The KVException.clone() method is used to copy this instance.

Overrides:

duplicate in class KVTransactionException

Returns:

duplicate of this exception with the current thread's stack frame context

See Also:

ThrowableUtil.prependCurrentStackTrace(java.lang.Throwable)