org.apache.derby.impl.store.raw.data

Class LoggableActions

java.lang.Object

org.apache.derby.impl.store.raw.data.LoggableActions

All Implemented Interfaces:

PageActions

public class LoggableActions
extends java.lang.Object
implements PageActions

Constructor Summary

Constructors

Constructor and Description
LoggableActions()

Method Summary

Modifier and Type	Method and Description
void	actionCopyRows(RawTransaction t, org.apache.derby.impl.store.raw.data.BasePage destPage, org.apache.derby.impl.store.raw.data.BasePage srcPage, int srcSlot, int numRows, int destSlot, int[] recordIds) Copy num_rows from srcPage into deestpage.
void	actionDelete(RawTransaction t, org.apache.derby.impl.store.raw.data.BasePage page, int slot, int recordId, boolean delete, LogicalUndo undo) Set the Delete status of the record at the given slot.
void	actionInitPage(RawTransaction t, org.apache.derby.impl.store.raw.data.BasePage page, int initFlag, int pageFormatId, long pageOffset) Initialize the page due to allocation.
int	actionInsert(RawTransaction t, org.apache.derby.impl.store.raw.data.BasePage page, int slot, int recordId, java.lang.Object[] row, FormatableBitSet validColumns, LogicalUndo undo, byte insertFlag, int startColumn, boolean isLongColumn, int realStartColumn, DynamicByteArrayOutputStream logBuffer, int realSpaceOnPage, int overflowThreshold) Insert record at the given slot with this recordId.
void	actionInvalidatePage(RawTransaction t, org.apache.derby.impl.store.raw.data.BasePage page) Invalidate the page due to deallocation.
void	actionPurge(RawTransaction t, org.apache.derby.impl.store.raw.data.BasePage page, int slot, int num_rows, int[] recordIds, boolean logData) Purge the record at the given slot.
void	actionShrinkReservedSpace(RawTransaction t, org.apache.derby.impl.store.raw.data.BasePage page, int slot, int recordId, int newValue, int oldValue) Shrink the reserved space to the new value.
int	actionUpdate(RawTransaction t, org.apache.derby.impl.store.raw.data.BasePage page, int slot, int recordId, java.lang.Object[] row, FormatableBitSet validColumns, int realStartColumn, DynamicByteArrayOutputStream logBuffer, int realSpaceOnPage, RecordHandle headRowHandle) Update record at the given slot with this row.
void	actionUpdateField(RawTransaction t, org.apache.derby.impl.store.raw.data.BasePage page, int slot, int recordId, int fieldId, java.lang.Object newValue, LogicalUndo undo) Update a field of the record at the given slot with this value.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LoggableActions

public LoggableActions()

Method Detail

actionDelete

public void actionDelete(RawTransaction t,
                         org.apache.derby.impl.store.raw.data.BasePage page,
                         int slot,
                         int recordId,
                         boolean delete,
                         LogicalUndo undo)
                  throws StandardException

Description copied from interface: PageActions

Set the Delete status of the record at the given slot.

Subclass that implements this method has to call BasePage.setDeleteStatus to update the delete status on the in-memory slot table.

MT - latched, page is latched when this methods is called.

Specified by:

actionDelete in interface PageActions

Parameters:

t - The transaction

page - the target page

slot - the slot number of the record

recordId - the recordID of the record

delete - set the delete status to this value

undo - logical undo logic if necessary

Throws:

StandardException - Standard Derby error policy

See Also:

Page.deleteAtSlot(int, boolean, org.apache.derby.iapi.store.access.conglomerate.LogicalUndo)

actionUpdate

public int actionUpdate(RawTransaction t,
                        org.apache.derby.impl.store.raw.data.BasePage page,
                        int slot,
                        int recordId,
                        java.lang.Object[] row,
                        FormatableBitSet validColumns,
                        int realStartColumn,
                        DynamicByteArrayOutputStream logBuffer,
                        int realSpaceOnPage,
                        RecordHandle headRowHandle)
                 throws StandardException

Description copied from interface: PageActions

Update record at the given slot with this row.

MT - latched, page is latched when this methods is called.

Specified by:

actionUpdate in interface PageActions

Parameters:

t - The transaction

page - the updated page

slot - the slot number of the record

recordId - the recordID of the record

row - The new storable row

validColumns - the columns that needs to be updated

realStartColumn - the first column that is updated

logBuffer - where to prepare the log record

realSpaceOnPage - ??

headRowHandle - the record handle of the head row

Returns:

the next column to update in the row or, -1 if the update has been completed.

Throws:

StandardException - Standard Derby error policy

See Also:

Page.updateAtSlot(int, java.lang.Object[], org.apache.derby.iapi.services.io.FormatableBitSet)

actionPurge

public void actionPurge(RawTransaction t,
                        org.apache.derby.impl.store.raw.data.BasePage page,
                        int slot,
                        int num_rows,
                        int[] recordIds,
                        boolean logData)
                 throws StandardException

Description copied from interface: PageActions

Purge the record at the given slot.

Subclass that implements this method has to remove the slot from the base page in-memory slot table (removeAndShiftDown).

MT - latched, page is latched when this methods is called.

Specified by:

actionPurge in interface PageActions

Parameters:

t - The transaction

slot - the starting slot number of the record

num_rows - how many rows to purge

recordIds - the recordIDs of the record (an array of num_rows)

Throws:

StandardException - Standard Derby error policy

See Also:

Page.purgeAtSlot(int, int, boolean)

actionUpdateField

public void actionUpdateField(RawTransaction t,
                              org.apache.derby.impl.store.raw.data.BasePage page,
                              int slot,
                              int recordId,
                              int fieldId,
                              java.lang.Object newValue,
                              LogicalUndo undo)
                       throws StandardException

Description copied from interface: PageActions

Update a field of the record at the given slot with this value.

MT - latched, page is latched when this methods is called.

Specified by:

actionUpdateField in interface PageActions

Parameters:

t - The transaction

slot - the slot number of the record

recordId - the recordID of the record

fieldId - the fieldId of the value

newValue - the new value for the field

undo - if logical undo may be necessary, a function pointer to the access code where the logical undo logic resides. Null if logical undo is not necessary.

Throws:

StandardException - Standard Derby error policy

See Also:

Page.updateFieldAtSlot(int, int, java.lang.Object, org.apache.derby.iapi.store.access.conglomerate.LogicalUndo)

actionInsert

public int actionInsert(RawTransaction t,
                        org.apache.derby.impl.store.raw.data.BasePage page,
                        int slot,
                        int recordId,
                        java.lang.Object[] row,
                        FormatableBitSet validColumns,
                        LogicalUndo undo,
                        byte insertFlag,
                        int startColumn,
                        boolean isLongColumn,
                        int realStartColumn,
                        DynamicByteArrayOutputStream logBuffer,
                        int realSpaceOnPage,
                        int overflowThreshold)
                 throws StandardException

Description copied from interface: PageActions

Insert record at the given slot with this recordId.

MT - latched, page is latched when this methods is called.

Specified by:

actionInsert in interface PageActions

Parameters:

t - The transaction

slot - the slot number of the record

recordId - the recordID of the record

row - The storable row

undo - if logical undo may be necessary, a function pointer to the access code where the logical undo logic resides. Null if logical undo is not necessary.

insertFlag - see Page value for insertFlag

Throws:

StandardException - Standard Derby error policy

See Also:

Page.insertAtSlot(int, java.lang.Object[], org.apache.derby.iapi.services.io.FormatableBitSet, org.apache.derby.iapi.store.access.conglomerate.LogicalUndo, byte, int)

actionCopyRows

public void actionCopyRows(RawTransaction t,
                           org.apache.derby.impl.store.raw.data.BasePage destPage,
                           org.apache.derby.impl.store.raw.data.BasePage srcPage,
                           int srcSlot,
                           int numRows,
                           int destSlot,
                           int[] recordIds)
                    throws StandardException

Description copied from interface: PageActions

Copy num_rows from srcPage into deestpage.

Longer descrption of routine.

Specified by:

actionCopyRows in interface PageActions

Parameters:

t - The transaction

destPage - the destination page

srcPage - the source page

srcSlot - starting slot # of destination page to copy to

numRows - the number of rows to be copied

destSlot - starting slot number of source page to copy from

recordIds - an array of record ids to use in the destination page

Throws:

StandardException - Standard Derby policy.

actionInvalidatePage

public void actionInvalidatePage(RawTransaction t,
                                 org.apache.derby.impl.store.raw.data.BasePage page)
                          throws StandardException

Description copied from interface: PageActions

Invalidate the page due to deallocation. Short one line description of routine.

Invalidate the page due to deallocation - this is the action on the page that is being deallocated as opposed to the action on the allocation page.

Specified by:

actionInvalidatePage in interface PageActions

Parameters:

t - The transaction

page - that page to be invalidated

Throws:

StandardException - Standard Derby policy.

actionInitPage

public void actionInitPage(RawTransaction t,
                           org.apache.derby.impl.store.raw.data.BasePage page,
                           int initFlag,
                           int pageFormatId,
                           long pageOffset)
                    throws StandardException

Description copied from interface: PageActions

Initialize the page due to allocation.

Initialize the page due to allocation - this page could be brand new or it could be being re-allocated.

Specified by:

actionInitPage in interface PageActions

Parameters:

t - The transaction

page - that page to be initialized

initFlag - flags set to values in BasePage.INIT_PAGE_* which indicates how the new page is to be initialized.

pageFormatId - The format Id of the page being initialized.

Throws:

StandardException - Standard Derby policy.

actionShrinkReservedSpace

public void actionShrinkReservedSpace(RawTransaction t,
                                      org.apache.derby.impl.store.raw.data.BasePage page,
                                      int slot,
                                      int recordId,
                                      int newValue,
                                      int oldValue)
                               throws StandardException

Description copied from interface: PageActions

Shrink the reserved space to the new value.

Shrink the reserved space to the new value. This action is not undoable.

Specified by:

actionShrinkReservedSpace in interface PageActions

Parameters:

t - The transaction

page - that page to be initialized

slot - the slot number of the record

recordId - the recordID of the record

newValue - the new reserved space value

Throws:

StandardException - Unexpected exception from the implementation