Module org.cojen.tupl

Package org.cojen.tupl

Class LockTimeoutException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.io.IOException

org.cojen.tupl.DatabaseException

org.cojen.tupl.LockFailureException

org.cojen.tupl.LockTimeoutException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

DeadlockException

public class LockTimeoutException
extends LockFailureException

Thrown when a lock request by a transaction timed out. A default timeout is defined, which can be overridden by a transaction.

See Also:

• LockResult.TIMED_OUT_LOCK
• Serialized Form

Constructor Summary

Constructors

Constructor	Description
LockTimeoutException(long nanosTimeout)
LockTimeoutException(long nanosTimeout, Object attachment)

Method Summary

Modifier and Type	Method	Description
String	getMessage()
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 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

LockTimeoutException

public LockTimeoutException(long nanosTimeout)

Parameters:

nanosTimeout - negative is interpreted as infinite wait

LockTimeoutException

public LockTimeoutException(long nanosTimeout,
 Object attachment)

Parameters:

nanosTimeout - negative is interpreted as infinite wait

Method Details

timeoutNanos

public long timeoutNanos()

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

timeout

public long timeout()

ownerAttachment

public Object ownerAttachment()

Returns the object which was attached to the current lock owner shortly after the timeout occurred. If an exclusive lock request failed because any shared locks were held, only the first discovered attachment is provided.

unit

public TimeUnit unit()