Class DeadlockException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.io.IOException

org.cojen.tupl.DatabaseException

org.cojen.tupl.LockFailureException

org.cojen.tupl.LockTimeoutException

org.cojen.tupl.DeadlockException

All Implemented Interfaces:

Serializable

public class DeadlockException
extends LockTimeoutException

Thrown when a lock request by a transaction timed out due to a deadlock, or a trivial deadlock was quickly detected. Deadlocks can be prevented by locking records in a consistent order. Cases of "self deadlock" when using multiple transactions in one thread are not detected, and a regular timeout exception is thrown instead.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
DeadlockException(long nanosTimeout)
DeadlockException(long nanosTimeout, Object attachment, boolean guilty)
DeadlockException(long nanosTimeout, Object attachment, boolean guilty, Set<DeadlockInfo> set)

Method Summary

Modifier and Type	Method	Description
Set<DeadlockInfo>	deadlockSet()
String	getMessage()
boolean	isGuilty()
String	shortMessage()

Methods inherited from class LockTimeoutException

ownerAttachment, timeout, timeoutNanos, unit

Modifier and Type	Method	Description
Object	ownerAttachment()	Returns the object which was attached to the current lock owner shortly after the timeout occurred.
long	timeout()
long	timeoutNanos()
TimeUnit	unit()

Methods inherited from class LockFailureException

isRecoverable

Modifier and Type	Method	Description
boolean	isRecoverable()	Returns false if database should be closed as a result of this exception.

Methods inherited from class Throwable

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

Methods inherited from class Object

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

Constructor Details

DeadlockException

public DeadlockException(long nanosTimeout)

Parameters:

nanosTimeout - negative is interpreted as infinite wait

DeadlockException

public DeadlockException(long nanosTimeout,
 Object attachment,
 boolean guilty)

Parameters:

nanosTimeout - negative is interpreted as infinite wait

DeadlockException

public DeadlockException(long nanosTimeout,
 Object attachment,
 boolean guilty,
 Set<DeadlockInfo> set)

Parameters:

nanosTimeout - negative is interpreted as infinite wait

Method Details

isGuilty

public boolean isGuilty()

Returns:

true if caller helped caused the deadlock; false if caller might be innocent

deadlockSet

public Set<DeadlockInfo> deadlockSet()

Returns:

the set of lock requests which were in a deadlock

getMessage

public String getMessage()

Overrides:

getMessage in class LockTimeoutException

shortMessage

public String shortMessage()

Returns:

message without deadlock set info