Class 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.

    • 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 interface BTreeLockingPolicy
        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 interface BTreeLockingPolicy
        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.
      • 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 interface BTreeLockingPolicy
        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 interface BTreeLockingPolicy
        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 interface BTreeLockingPolicy
        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.