Module org.cojen.tupl

Package org.cojen.tupl

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 org.cojen.tupl.LockTimeoutException

ownerAttachment, timeout, timeoutNanos, unit

Methods inherited from class org.cojen.tupl.LockFailureException

isRecoverable

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 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