Class B2INoLocking
- All Implemented Interfaces:
BTreeLockingPolicy
- Direct Known Subclasses:
B2ITableLocking3
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
ConstructorsModifierConstructorDescriptionprotected
B2INoLocking
(Transaction rawtran, int lock_level, LockingPolicy locking_policy, ConglomerateController base_cc, OpenBTree open_btree) Constructors for This class: -
Method Summary
Modifier and TypeMethodDescriptionboolean
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 Details
-
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 Details
-
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:
open_btree
- The open_btree to associate latches with - used if routine has to scan backward.pos
- The position of the row to lock.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:
pos
- Data structure that defines the current position in the scan to be unlocked.forUpdate
- Is the scan for update or for read only.- 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.
-