Top Description Fields Constructors Methods
org.hibernate.dialect.lock

public Class OptimisticLockingStrategy

extends Object
implements LockingStrategy
Class Inheritance
All Implemented Interfaces
org.hibernate.dialect.lock.LockingStrategy
Imports
java.io.Serializable, org.hibernate.*, org.hibernate.event.EventSource, org.hibernate.action.EntityVerifyVersionProcess, org.hibernate.engine.SessionImplementor, .EntityEntry, org.hibernate.persister.entity.Lockable, org.slf4j.Logger, .LoggerFactory
An optimistic locking strategy that verifies that the version hasn't changed (prior to transaction commit).

This strategy is valid for LockMode.OPTIMISTIC

Author
Scott Marlow
Since
3.5

Field Summary

Modifier and TypeField and Description
private final Lockable
lockable

private final LockMode
lockMode

private static final Logger
log

Constructor Summary

AccessConstructor and Description
public
OptimisticLockingStrategy(Lockable
The metadata for the entity to be locked.
lockable, LockMode
Indictates the type of lock to be acquired.
lockMode)

Construct locking strategy.

Method Summary

Modifier and TypeMethod and Description
protected LockMode
getLockMode()

public void
lock(Serializable
The id of the row to be locked
id, Object
The current version (or null if not versioned)
version, Object
The object logically being locked (currently not used)
object, int
timeout in milliseconds, 0 = no wait, -1 = wait indefinitely
timeout, SessionImplementor
The session from which the lock request originated
session)

Implements org.hibernate.dialect.lock.LockingStrategy.lock.

Acquire an appropriate type of lock on the underlying data that will endure until the end of the current transaction.
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

lockableback to summary
private final Lockable lockable
lockModeback to summary
private final LockMode lockMode
logback to summary
private static final Logger log

Constructor Detail

OptimisticLockingStrategyback to summary
public OptimisticLockingStrategy(Lockable lockable, LockMode lockMode)

Construct locking strategy.

Parameters
lockable:Lockable

The metadata for the entity to be locked.

lockMode:LockMode

Indictates the type of lock to be acquired.

Method Detail

getLockModeback to summary
protected LockMode getLockMode()
lockback to summary
public void lock(Serializable id, Object version, Object object, int timeout, SessionImplementor session) throws StaleObjectStateException, JDBCException

Implements org.hibernate.dialect.lock.LockingStrategy.lock.

Doc from org.hibernate.dialect.lock.LockingStrategy.lock.

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

Parameters
id:Serializable

The id of the row to be locked

version:Object

The current version (or null if not versioned)

object:Object

The object logically being locked (currently not used)

timeout:int

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

session:SessionImplementor

The session from which the lock request originated

Exceptions
StaleObjectStateException:
Indicates an optimistic lock failure as part of acquiring the requested database lock.
JDBCException:
Indicates errors from the JDBC driver.
See Also
org.hibernate.dialect.lock.LockingStrategy#lock