Package org.hibernate.dialect.lock

Interface LockingStrategy

All Known Implementing Classes:

AbstractSelectLockingStrategy, OptimisticForceIncrementLockingStrategy, OptimisticLockingStrategy, PessimisticForceIncrementLockingStrategy, PessimisticReadSelectLockingStrategy, PessimisticReadUpdateLockingStrategy, PessimisticWriteSelectLockingStrategy, PessimisticWriteUpdateLockingStrategy, SelectLockingStrategy, UpdateLockingStrategy

public interface LockingStrategy

A strategy abstraction for how locks are obtained in the underlying database.

All built-in implementations assume the underlying database supports at least read-committed transaction isolation, and that the JDBC connection was obtained with at least this isolation level.

Since:

3.2

See Also:

• Dialect.getLockingStrategy(org.hibernate.persister.entity.EntityPersister, org.hibernate.LockMode)
• JdbcSettings.ISOLATION

Method Summary

Modifier and Type	Method	Description
default void	lock(Object id, Object version, Object object, int timeout, SharedSessionContractImplementor session)	Acquire an appropriate type of lock on the underlying data that will endure until the end of the current transaction.
default void	lock(Object id, Object version, Object object, int timeout, EventSource session)	Deprecated. Use lock(Object, Object, Object, int, SharedSessionContractImplementor)

Method Details

lock

@Deprecated(since="7")
default void lock(Object id,
 Object version,
 Object object,
 int timeout,
 EventSource session)
           throws StaleObjectStateException,
LockingStrategyException

Deprecated.

Use lock(Object, Object, Object, int, SharedSessionContractImplementor)

Acquire an appropriate type of lock on the underlying data that will endure until the end of the current transaction.

Parameters:

id - The id of the row to be locked

version - The current version (or null if not versioned)

object - The object logically being locked (currently not used)

timeout - timeout in milliseconds, 0 = no wait, -1 = wait indefinitely

session - The session from which the lock request originated

Throws:

StaleObjectStateException - Indicates an inability to locate the database row as part of acquiring the requested lock.

LockingStrategyException - Indicates a failure in the lock attempt

lock

default void lock(Object id,
 Object version,
 Object object,
 int timeout,
 SharedSessionContractImplementor session)
           throws StaleObjectStateException,
LockingStrategyException

Acquire an appropriate type of lock on the underlying data that will endure until the end of the current transaction.

Parameters:

id - The id of the row to be locked

version - The current version (or null if not versioned)

object - The object logically being locked (currently not used)

timeout - timeout in milliseconds, 0 = no wait, -1 = wait indefinitely

session - The session from which the lock request originated

Throws:

StaleObjectStateException - Indicates an inability to locate the database row as part of acquiring the requested lock.

LockingStrategyException - Indicates a failure in the lock attempt