Top Description Fields Constructors Methods
org.apache.derby.impl.store.raw.xact

public Class RowLocking2

extends RowLockingRR
Class Inheritance
Known Direct Subclasses
org.apache.derby.impl.store.raw.xact.RowLocking2nohold, org.apache.derby.impl.store.raw.xact.RowLocking1
Imports
org.apache.derby.iapi.services.locks.LockFactory, .C_LockFactory, org.apache.derby.shared.common.sanity.SanityManager, org.apache.derby.iapi.store.raw.ContainerHandle, .ContainerLock, .LockingPolicy, .RecordHandle, .RowLock, .Transaction, org.apache.derby.shared.common.error.StandardException

A locking policy that implements row level locking with isolation degree 2. The approach is to place all "write" container and row locks on the transaction group lock list. Locks on this group will last until end of transaction. All "read" container and row locks will be placed on a group list, key'd by the ContainerId of the lock. Locks on this list will either be released explicitly by the caller, or will be released as a group when the unlockContainer() call is made. Note that write operations extend from the RowLocking3 implementations.
See Also
org.apache.derby.iapi.store.raw.LockingPolicy

Field Summary

Modifier and TypeField and Description
private static final LockingPolicy

Constructor Summary

AccessConstructor and Description
protected

Method Summary

Modifier and TypeMethod and Description
public boolean

Returns:

true if the lock was obtained, false if it wasn't. False should only be returned if the waitForLock policy was set to "false," and the lock was unavailable.
lockContainer
(Transaction
Transaction to associate lock with.
t
,
ContainerHandle
Container to lock.
container
,
boolean
Should lock request wait until granted?
waitForLock
,
boolean
Should container be locked for update, or read?
forUpdate
)

Overrides org.apache.derby.impl.store.raw.xact.RowLocking3.lockContainer.

Implements org.apache.derby.iapi.store.raw.LockingPolicy.lockContainer.

Obtain container level intent lock.

public boolean

Returns:

true if the lock was granted, false if waitForLock was false and the lock could not be granted.
lockRecordForRead
(Transaction
The transaction to associate the lock with.
t
,
ContainerHandle
Open Container used to get record. Will be used to row locks by the container they belong to.
container_handle
,
RecordHandle
The record to be locked.
record
,
boolean
Should lock request wait until granted?
waitForLock
,
boolean
Whether to open for read or write access.
forUpdate
)

Overrides org.apache.derby.impl.store.raw.xact.RowLocking3.lockRecordForRead.

Implements org.apache.derby.iapi.store.raw.LockingPolicy.lockRecordForRead.

Obtain lock on record being read.

public void
unlockContainer(Transaction
The transaction to associate the lock with.
t
,
ContainerHandle
Container to unlock.
container_handle
)

Overrides org.apache.derby.impl.store.raw.xact.NoLocking.unlockContainer.

Implements org.apache.derby.iapi.store.raw.LockingPolicy.unlockContainer.

Unlock read locks.

public void
unlockRecordAfterRead(Transaction t, ContainerHandle container_handle, RecordHandle record, boolean forUpdate, boolean row_qualified)

Overrides org.apache.derby.impl.store.raw.xact.RowLockingRR.unlockRecordAfterRead.

Implements org.apache.derby.iapi.store.raw.LockingPolicy.unlockRecordAfterRead.

Unlock a record after it has been locked for read.

Inherited from org.apache.derby.impl.store.raw.xact.RowLockingRR:
getReadLockTypegetUpdateLockTypegetWriteLockType

Field Detail

NO_LOCKback to summary
private static final LockingPolicy NO_LOCK

Hides org.apache.derby.impl.store.raw.xact.RowLocking3.NO_LOCK.

Constructor Detail

RowLocking2back to summary
protected RowLocking2(LockFactory lf)

Method Detail

lockContainerback to summary
public boolean lockContainer(Transaction t, ContainerHandle container, boolean waitForLock, boolean forUpdate) throws StandardException

Overrides org.apache.derby.impl.store.raw.xact.RowLocking3.lockContainer.

Implements org.apache.derby.iapi.store.raw.LockingPolicy.lockContainer.

Obtain container level intent lock.

This implementation of row locking is 2 level, ie. table and row locking. It will interact correctly with tables opened with ContainerLocking3 locking mode.

Updater's will get table level IX locks, and X row locks.

Reader's will get table level IS locks, and S row locks.

Read locks are put in a separate "group" from the transaction, so that when the container is closed it can release these read locks.

Parameters
t:Transaction

Transaction to associate lock with.

container:ContainerHandle

Container to lock.

waitForLock:boolean

Should lock request wait until granted?

forUpdate:boolean

Should container be locked for update, or read?

Returns:boolean

true if the lock was obtained, false if it wasn't. False should only be returned if the waitForLock policy was set to "false," and the lock was unavailable.

Exceptions
StandardException:
Standard exception policy.
lockRecordForReadback to summary
public boolean lockRecordForRead(Transaction t, ContainerHandle container_handle, RecordHandle record, boolean waitForLock, boolean forUpdate) throws StandardException

Overrides org.apache.derby.impl.store.raw.xact.RowLocking3.lockRecordForRead.

Implements org.apache.derby.iapi.store.raw.LockingPolicy.lockRecordForRead.

Obtain lock on record being read.

Assumes that a table level IS has been acquired. Will acquire a Shared or Update lock on the row, depending on the "forUpdate" parameter.

Read lock will be placed on separate group from transaction.

Parameters
t:Transaction

The transaction to associate the lock with.

container_handle:ContainerHandle

Doc from org.apache.derby.iapi.store.raw.LockingPolicy.lockRecordForRead.

Open Container used to get record. Will be used to row locks by the container they belong to.

record:RecordHandle

The record to be locked.

waitForLock:boolean

Should lock request wait until granted?

forUpdate:boolean

Whether to open for read or write access.

Returns:boolean

true if the lock was granted, false if waitForLock was false and the lock could not be granted.

Exceptions
StandardException:
Standard exception policy.
unlockContainerback to summary
public void unlockContainer(Transaction t, ContainerHandle container_handle)

Overrides org.apache.derby.impl.store.raw.xact.NoLocking.unlockContainer.

Implements org.apache.derby.iapi.store.raw.LockingPolicy.unlockContainer.

Unlock read locks.

In Cursor stability release all read locks obtained. unlockContainer() will be called when the container is closed.

Parameters
t:Transaction

The transaction to associate the lock with.

container_handle:ContainerHandle

Container to unlock.

unlockRecordAfterReadback to summary
public void unlockRecordAfterRead(Transaction t, ContainerHandle container_handle, RecordHandle record, boolean forUpdate, boolean row_qualified) throws StandardException

Overrides org.apache.derby.impl.store.raw.xact.RowLockingRR.unlockRecordAfterRead.

Implements org.apache.derby.iapi.store.raw.LockingPolicy.unlockRecordAfterRead.

Doc from org.apache.derby.impl.store.raw.xact.RowLockingRR.unlockRecordAfterRead.

Unlock a record after it has been locked for read.

In repeatable read only unlock records which "did not qualify". For example in a query like "select * from foo where a = 1" on a table with no index it is only necessary to hold locks on rows where a=1, but in the process of finding those rows the system will get locks on other rows to verify they are committed before applying the qualifier. Those locks can be released under repeatable read isolation.

Exceptions
StandardException:
Standard exception policy.