Class B2INoLocking
- java.lang.Object
-
- org.apache.derby.impl.store.access.btree.index.B2INoLocking
-
- All Implemented Interfaces:
BTreeLockingPolicy
- Direct Known Subclasses:
B2ITableLocking3
public class B2INoLocking extends java.lang.Object implements BTreeLockingPolicy
Secondary index locking policy that does no locking.This is used when the caller knows that logical locks are already obtained so need not be requested again. For instance when inserting a row into an index, a X row lock has already been obtained when the row was inserted into the base table, so there is no need to get another lock in the secondary index.
This class overrides all interfaces of BTreeLockingPolicy making them no-ops.
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
B2INoLocking()
B2INoLocking(Transaction rawtran, int lock_level, LockingPolicy locking_policy, ConglomerateController base_cc, OpenBTree open_btree)
Constructors for This class:
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
lockNonScanPreviousRow(LeafControlRow current_leaf, int current_slot, FetchDescriptor lock_fetch_desc, DataValueDescriptor[] lock_template, RowLocation lock_row_loc, OpenBTree open_btree, int lock_operation, int lock_duration)
Lock the row previous to the input row.boolean
lockNonScanRow(BTree btree, LeafControlRow current_leaf, LeafControlRow aux_leaf, DataValueDescriptor[] current_row, int lock_operation)
Lock the in memory row.boolean
lockNonScanRowOnPage(LeafControlRow current_leaf, int current_slot, FetchDescriptor lock_fetch_desc, DataValueDescriptor[] lock_template, RowLocation lock_row_loc, int lock_operation)
Lock the row at the given slot.boolean
lockScanCommittedDeletedRow(OpenBTree open_btree, LeafControlRow leaf, DataValueDescriptor[] template, FetchDescriptor lock_fetch_desc, int slot_no)
Lock a btree row to determine if it is a committed deleted row.boolean
lockScanRow(OpenBTree open_btree, BTreeRowPosition pos, FetchDescriptor lock_fetch_desc, DataValueDescriptor[] lock_template, RowLocation lock_row_loc, boolean previous_key_lock, boolean forUpdate, int lock_operation)
Lock a row as part of doing the scan.void
unlockScanRecordAfterRead(BTreeRowPosition pos, boolean forUpdate)
Release read lock on a row.
-
-
-
Constructor Detail
-
B2INoLocking
public B2INoLocking(Transaction rawtran, int lock_level, LockingPolicy locking_policy, ConglomerateController base_cc, OpenBTree open_btree)
Constructors for This class:
-
B2INoLocking
protected B2INoLocking()
-
-
Method Detail
-
lockScanCommittedDeletedRow
public boolean lockScanCommittedDeletedRow(OpenBTree open_btree, LeafControlRow leaf, DataValueDescriptor[] template, FetchDescriptor lock_fetch_desc, int slot_no) throws StandardException
Lock a btree row to determine if it is a committed deleted row.Request an exclusive lock on the row located at the given slot, NOWAIT. Return true if the lock is granted, otherwise false.
- Specified by:
lockScanCommittedDeletedRow
in interfaceBTreeLockingPolicy
- Parameters:
open_btree
- The conglomerate we are locking.leaf
- The leaf page with the row to lock.template
- A scratch area to use to read in RowLocation.slot_no
- The slot of row on "current_leaf"- Throws:
StandardException
- Standard exception policy.
-
lockScanRow
public boolean lockScanRow(OpenBTree open_btree, BTreeRowPosition pos, FetchDescriptor lock_fetch_desc, DataValueDescriptor[] lock_template, RowLocation lock_row_loc, boolean previous_key_lock, boolean forUpdate, int lock_operation) throws StandardException
Lock a row as part of doing the scan.Lock the row at the given slot (or the previous row if slot is 0).
If this routine returns true all locks were acquired while maintaining the latch on leaf. If this routine returns false, locks may or may not have been acquired, and the routine should be called again after the client has researched the tree to reget the latch on the appropriate page.
- Specified by:
lockScanRow
in interfaceBTreeLockingPolicy
- Parameters:
pos
- The position of the row to lock.open_btree
- The open_btree to associate latches with - used if routine has to scan backward.lock_template
- A scratch area to use to read in rows.previous_key_lock
- Is this a previous key lock call?forUpdate
- Is the scan for update or for read only.lock_operation
- For what operation are we requesting the lock, this should be one of the following 4 options: LOCK_READ [read lock], (LOCK_INS | LOCK_UPD) [ lock for insert], (LOCK_INSERT_PREVKEY | LOCK_UPD) [lock for previous key to insert], (LOCK_UPD) [lock for delete or replace]- Returns:
- Whether locks were acquired without releasing latch on leaf.
- Throws:
StandardException
- Standard exception policy.
-
unlockScanRecordAfterRead
public void unlockScanRecordAfterRead(BTreeRowPosition pos, boolean forUpdate) throws StandardException
Release read lock on a row.- Specified by:
unlockScanRecordAfterRead
in interfaceBTreeLockingPolicy
- Parameters:
forUpdate
- Is the scan for update or for read only.pos
- Data structure that defines the current position in the scan to be unlocked.- Throws:
StandardException
- Standard exception policy.
-
lockNonScanPreviousRow
public boolean lockNonScanPreviousRow(LeafControlRow current_leaf, int current_slot, FetchDescriptor lock_fetch_desc, DataValueDescriptor[] lock_template, RowLocation lock_row_loc, OpenBTree open_btree, int lock_operation, int lock_duration) throws StandardException
Lock the row previous to the input row.See BTree.lockPreviousRow() for more info.
- Specified by:
lockNonScanPreviousRow
in interfaceBTreeLockingPolicy
- Parameters:
current_leaf
- Latched current leaf where "current" key is.current_slot
- The slot of row on "current_leaf"lock_template
- Empty full template row, to read row into.open_btree
- The open_btree to associate latches with - used if routine has to scan backward.lock_operation
- For what operation are we requesting the lock, this should be one of the following 4 options: LOCK_READ [read lock], (LOCK_INS | LOCK_UPD) [ lock for insert], (LOCK_INSERT_PREVKEY | LOCK_UPD) [lock for previous key to insert], (LOCK_UPD) [lock for delete or replace]lock_duration
- For what duration should the lock be held, if INSTANT_DURATION, then the routine will guarantee that lock was acquired while holding the latch, but then immediately release the lock. If COMMIT_DURATION or MANUAL_DURATION then the lock be held when routine returns successfully.- Throws:
StandardException
- Standard exception policy.
-
lockNonScanRow
public boolean lockNonScanRow(BTree btree, LeafControlRow current_leaf, LeafControlRow aux_leaf, DataValueDescriptor[] current_row, int lock_operation) throws StandardException
Lock the in memory row.See BTree.lockRow() for more info.
- Specified by:
lockNonScanRow
in interfaceBTreeLockingPolicy
- Parameters:
btree
- The conglomerate we are locking.current_leaf
- If non-null, this leaf is unlatched if the routine has to wait on the lock.aux_leaf
- If non-null, this leaf is unlatched if the routine has to wait on the lock.current_row
- In memory, objectified "current" row.lock_operation
- For what operation are we requesting the lock, this should be one of the following 4 options: LOCK_READ [read lock], (LOCK_INS | LOCK_UPD) [ lock for insert], (LOCK_INSERT_PREVKEY | LOCK_UPD) [lock for previous key to insert], (LOCK_UPD) [lock for delete or replace]- Throws:
StandardException
- Standard exception policy.
-
lockNonScanRowOnPage
public boolean lockNonScanRowOnPage(LeafControlRow current_leaf, int current_slot, FetchDescriptor lock_fetch_desc, DataValueDescriptor[] lock_template, RowLocation lock_row_loc, int lock_operation) throws StandardException
Description copied from interface:BTreeLockingPolicy
Lock the row at the given slot.If this routine returns true all locks were acquired while maintaining the latch on leaf. If this routine returns false, locks may or may not have been acquired, and the routine should be called again after the client has researched the tree to reget the latch on the appropriate page.
- Specified by:
lockNonScanRowOnPage
in interfaceBTreeLockingPolicy
- Parameters:
current_leaf
- The control row of the current leaf to lock.current_slot
- The slot position of the row to lock.lock_template
- A scratch area to use to read in rows.lock_operation
- For what operation are we requesting the lock, this should be one of the following 4 options: LOCK_READ [read lock], (LOCK_INS | LOCK_UPD) [ lock for insert], (LOCK_INSERT_PREVKEY | LOCK_UPD) [lock for previous key to insert], (LOCK_UPD) [lock for delete or replace]- Returns:
- Whether locks were acquired without releasing latch on leaf.
- Throws:
StandardException
- Standard exception policy.
-
-