com.sleepycat.je

Class DeadlockException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.sleepycat.je.DatabaseException

com.sleepycat.je.OperationFailureException

com.sleepycat.je.LockConflictException

com.sleepycat.je.DeadlockException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

LockNotGrantedException

public class DeadlockException
extends LockConflictException

Thrown when a deadlock is detected. When this exception is thrown, JE detected a deadlock and chose one transaction (or non-transactional operation), the "victim", to invalidate in order to break the deadlock. Note that this is different than a lock timeout or TransactionTimeoutException, which occur for other reasons.

For more information on deadlock detection, see EnvironmentConfig.LOCK_DEADLOCK_DETECT. As described there, a DeadlockException is normally thrown when a random victim is selected; in this case the exception message will contain the string: This locker was chosen randomly as the victim. If the deadlock exception is thrown in a non-victim thread, due to live lock or an unresponsive thread, the message will contain the string: Unable to break deadlock using random victim selection within the timeout interval.

TODO: describe how to debug using info included with the exception.

Normally, applications should catch the base class LockConflictException rather than catching one of its subclasses. All lock conflicts are typically handled in the same way, which is normally to abort and retry the transaction. See LockConflictException for more information.

The Transaction handle is invalidated as a result of this exception.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DeadlockException(Locker locker, String message) For internal use only.

Method Summary

Modifier and Type	Method and Description
OperationFailureException	wrapSelf(String msg) For internal use only.

Methods inherited from class com.sleepycat.je.LockConflictException

getOwnerTxnIds, getTimeoutMillis, getWaiterTxnIds, setOwnerTxnIds, setTimeoutMillis, setWaiterTxnIds

Methods inherited from class com.sleepycat.je.OperationFailureException

isReplicaWrite

Methods inherited from class com.sleepycat.je.DatabaseException

addErrorMessage, addRethrownStackTrace, getMessage, getVersionHeader

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

Constructor Detail

DeadlockException

public DeadlockException(Locker locker,
                         String message)

For internal use only.

Method Detail

wrapSelf

public OperationFailureException wrapSelf(String msg)

For internal use only.

Specified by:

wrapSelf in class OperationFailureException