public class HeapController extends GenericConglomerateController implements ConglomerateController
open_conglom
LOCK_INS, LOCK_INS_PREVKEY, LOCK_READ, LOCK_UPD, LOCK_UPDATE_LOCKS, ROWISDUPLICATE
Constructor and Description |
---|
HeapController() |
Modifier and Type | Method and Description |
---|---|
private RecordHandle |
doInsert(DataValueDescriptor[] row)
Insert a new row into the heap.
|
OpenConglomerate |
getOpenConglomerate()
Public Methods of XXXX class:
|
protected void |
getRowPositionFromRowLocation(RowLocation row_loc,
RowPosition pos)
Protected concrete impl of abstract methods of
GenericConglomerateController class:
|
protected Page |
getUserPageNoWait(long pageno) |
protected Page |
getUserPageWait(long pageno) |
int |
insert(DataValueDescriptor[] row)
Public Methods of This class:
|
void |
insertAndFetchLocation(DataValueDescriptor[] row,
RowLocation templateRowLocation)
insert row and fetch it's row location in one operation.
|
protected long |
load(TransactionManager xact_manager,
Heap heap,
boolean createConglom,
RowLocationRetRowSource rowSource) |
boolean |
lockRow(long page_num,
int record_id,
int lock_operation,
boolean wait,
int lock_duration)
Lock the given record id/page num pair.
|
protected boolean |
lockRow(RecordHandle rh,
int lock_oper,
boolean wait,
int lock_duration) |
boolean |
lockRow(RowLocation loc,
int lock_operation,
boolean wait,
int lock_duration)
Lock the given row location.
|
protected boolean |
lockRowAtSlotNoWaitExclusive(RecordHandle rh) |
RowLocation |
newRowLocationTemplate()
Return a row location object of the correct type to be
used in calls to insertAndFetchLocation.
|
protected boolean |
purgeCommittedDeletes(Page page)
Check and purge committed deleted rows on a page.
|
protected void |
queueDeletePostCommitWork(RowPosition pos) |
protected void |
removePage(Page page) |
void |
unlockRowAfterRead(RowLocation loc,
boolean forUpdate,
boolean row_qualified)
UnLock the given row location.
|
close, closeForEndTransaction, delete, fetch, fetch, replace
checkConsistency, debugConglomerate, getEstimatedRowCount, getInternalTablePropertySet, getOpenConglom, getSpaceInfo, getTableProperties, init, isKeyed, isTableLocked, setEstimatedRowCount
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
checkConsistency, close, closeForEndTransaction, debugConglomerate, delete, fetch, fetch, getSpaceInfo, isKeyed, replace
getInternalTablePropertySet, getTableProperties
protected final void getRowPositionFromRowLocation(RowLocation row_loc, RowPosition pos) throws StandardException
getRowPositionFromRowLocation
in class GenericController
StandardException
protected void queueDeletePostCommitWork(RowPosition pos) throws StandardException
queueDeletePostCommitWork
in class GenericController
StandardException
protected final boolean purgeCommittedDeletes(Page page) throws StandardException
page
- A non-null, latched page must be passed in. If all
rows on page are purged, then page will be removed and
latch released.StandardException
- Standard exception policy.private RecordHandle doInsert(DataValueDescriptor[] row) throws StandardException
Overflow policy: The current heap access method implements an algorithm that optimizes for fetch efficiency vs. space efficiency. A row will not be over flowed unless it is bigger than a page. If it is bigger than a page then it's initial part will be placed on a page and then subsequent parts will be overflowed to other pages.
row
- The row to insert.StandardException
- Standard exception policy.protected long load(TransactionManager xact_manager, Heap heap, boolean createConglom, RowLocationRetRowSource rowSource) throws StandardException
StandardException
protected boolean lockRow(RecordHandle rh, int lock_oper, boolean wait, int lock_duration) throws StandardException
StandardException
protected Page getUserPageNoWait(long pageno) throws StandardException
StandardException
protected Page getUserPageWait(long pageno) throws StandardException
StandardException
protected boolean lockRowAtSlotNoWaitExclusive(RecordHandle rh) throws StandardException
StandardException
protected void removePage(Page page) throws StandardException
StandardException
public int insert(DataValueDescriptor[] row) throws StandardException
insert
in interface ConglomerateController
row
- The row to insert into the conglomerate. The stored
representations of the row's columns are copied into a new row
somewhere in the conglomerate.StandardException
- Standard exception policy.RowUtil
public void insertAndFetchLocation(DataValueDescriptor[] row, RowLocation templateRowLocation) throws StandardException
ConglomerateController
Insert a row into the conglomerate, and store its location in the provided destination row location. The row location must be of the correct type for this conglomerate (a new row location of the correct type can be obtained from newRowLocationTemplate()).
insertAndFetchLocation
in interface ConglomerateController
row
- The row to insert into the conglomerate. The
stored representations of the row's columns are
copied into a new row somewhere in the conglomerate.templateRowLocation
- The rowlocation to read the inserted row location
into.StandardException
- Standard exception policy.RowUtil
public boolean lockRow(RowLocation loc, int lock_operation, boolean wait, int lock_duration) throws StandardException
Should only be called by access.
This call can be made on a ConglomerateController that was opened for locking only.
RESOLVE (mikem) - move this call to ConglomerateManager so it is obvious that non-access clients should not call this.
lockRow
in interface ConglomerateController
loc
- The "RowLocation" which describes the exact row to lock.wait
- Should the lock call wait to be granted?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_UPD | LOCK_UPDATE_LOCKS) [lock scan for
update, will upgrade lock later if actual update
is take place]lock_duration
- If set to TransactionManager.LOCK_INSTANT_DURATION,
then lock will be released immediately after being
granted.StandardException
- Standard exception policy.public void unlockRowAfterRead(RowLocation loc, boolean forUpdate, boolean row_qualified) throws StandardException
Should only be called by access.
This call can be made on a ConglomerateController that was opened for locking only.
RESOLVE (mikem) - move this call to ConglomerateManager so it is obvious that non-access clients should not call this.
unlockRowAfterRead
in interface ConglomerateController
loc
- The "RowLocation" which describes the row to unlock.forUpdate
- Row was previously Locked the record for read or update.row_qualified
- Row was qualified and returned to the user.StandardException
- Standard exception policy.public boolean lockRow(long page_num, int record_id, int lock_operation, boolean wait, int lock_duration) throws StandardException
Should only be called by access, to lock "special" locks formed from the Recordhandle.* reserved constants for page specific locks.
This call can be made on a ConglomerateController that was opened for locking only.
RESOLVE (mikem) - move this call to ConglomerateManager so it is obvious that non-access clients should not call this.
lockRow
in interface ConglomerateController
page_num
- Page number of row to lock.record_id
- Record id of row on page_num to lock.lock_operation
- Desc of what to lock for, ie. update, insert ...wait
- Should the lock call wait to be granted?lock_duration
- If set to TransactionManager.LOCK_INSTANT_DURATION,
then lock will be released immediately after being
granted.StandardException
- Standard exception policy.public RowLocation newRowLocationTemplate() throws StandardException
ConglomerateController
newRowLocationTemplate
in interface ConglomerateController
newRowLocationTemplate
in class GenericController
StandardException
- Standard exception policy.public OpenConglomerate getOpenConglomerate()
Apache Derby V10.13 Internals - Copyright © 2004,2016 The Apache Software Foundation. All Rights Reserved.