Class InsertOperation
- java.lang.Object
-
- org.apache.derby.impl.store.raw.data.PageBasicOperation
-
- org.apache.derby.impl.store.raw.data.LogicalPageOperation
-
- org.apache.derby.impl.store.raw.data.InsertOperation
-
- All Implemented Interfaces:
java.io.Externalizable,java.io.Serializable,Formatable,TypedFormat,Loggable,LogicalUndoable,RePreparable,Undoable
public final class InsertOperation extends LogicalPageOperation
Represents an insert of a record onto a page.- 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), Serialized Form
Format ID LOGOP_INSERT the formatId is written by FormatIdOutputStream when this object is written out by writeObject Purpose insert a row onto a page Upgrade Disk Layout LogicalPageOperation the superclass doMeSlot(CompressedInt) which slot to operate on insertFlat(byte) to undo with purge or with delete OptionalData The after image of the row to be inserted.
-
-
Field Summary
Fields Modifier and Type Field Description protected intdoMeSlotprotected byteinsertFlagprotected ByteArraypreparedLogprotected intstartColumnnext column that need to be inserted.-
Fields inherited from class org.apache.derby.impl.store.raw.data.LogicalPageOperation
recordId, undo
-
Fields inherited from class org.apache.derby.impl.store.raw.data.PageBasicOperation
containerHdl, foundHere, page
-
Fields inherited from interface org.apache.derby.iapi.store.raw.Loggable
ABORT, BI_LOG, CHECKSUM, COMMIT, COMPENSATION, FILE_RESOURCE, FIRST, LAST, PREPARE, RAWSTORE, XA_NEEDLOCK
-
-
Constructor Summary
Constructors Constructor Description InsertOperation()InsertOperation(RawTransaction t, 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)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voiddoMe(Transaction xact, LogInstant instant, LimitObjectInput in)Apply the change indicated by this operation and optional data.intgetNextStartColumn()ByteArraygetPreparedLog()the default for optional data is set to null.intgetTypeFormatId()Return my format identifier.voidreadExternal(java.io.ObjectInput in)Read this invoidrestoreLoggedRow(java.lang.Object[] row, LimitObjectInput in)Restore the row stored in the optional data of the log record.voidrestoreMe(Transaction xact, BasePage undoPage, LogInstant CLRinstant, LimitObjectInput in)restore the before image of the pagejava.lang.StringtoString()DEBUG: Print self.voidundoMe(Transaction xact, BasePage undoPage, int undoRecordId, LogInstant CLRInstant, LimitObjectInput in)Undo the insert by simply marking the just inserted record as deleted.voidwriteExternal(java.io.ObjectOutput out)Write this out.private voidwriteOptionalDataToBuffer(RawTransaction t, DynamicByteArrayOutputStream logBuffer, java.lang.Object[] row, FormatableBitSet validColumns, boolean isLongColumn, int realStartColumn, int realSpaceOnPage, int overflowThreshold)Writes out the row that is to be inserted as the optional data.-
Methods inherited from class org.apache.derby.impl.store.raw.data.LogicalPageOperation
generateUndo, getContainer, getRecordHandle, reclaimPrepareLocks, resetRecordHandle
-
Methods inherited from class org.apache.derby.impl.store.raw.data.PageBasicOperation
findpage, getPage, getPageForRedoRecovery, getPageId, getPageVersion, group, needsRedo, releaseResource, resetPageNumber
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface org.apache.derby.iapi.store.raw.Loggable
group, needsRedo, releaseResource
-
-
-
-
Field Detail
-
doMeSlot
protected int doMeSlot
-
insertFlag
protected byte insertFlag
-
startColumn
protected transient int startColumn
next column that need to be inserted.
-
preparedLog
protected transient ByteArray preparedLog
-
-
Constructor Detail
-
InsertOperation
InsertOperation(RawTransaction t, 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
- Throws:
StandardException
-
InsertOperation
public InsertOperation()
-
-
Method Detail
-
writeExternal
public void writeExternal(java.io.ObjectOutput out) throws java.io.IOExceptionWrite this out.- Specified by:
writeExternalin interfacejava.io.Externalizable- Overrides:
writeExternalin classLogicalPageOperation- Throws:
java.io.IOException- error writing to log stream
-
readExternal
public void readExternal(java.io.ObjectInput in) throws java.io.IOException, java.lang.ClassNotFoundExceptionRead this in- Specified by:
readExternalin interfacejava.io.Externalizable- Overrides:
readExternalin classLogicalPageOperation- Throws:
java.io.IOException- error reading from log streamjava.lang.ClassNotFoundException- log stream corrupted
-
getTypeFormatId
public int getTypeFormatId()
Return my format identifier.- Returns:
- The identifier. (A UUID stuffed in an array of 16 bytes).
-
doMe
public void doMe(Transaction xact, LogInstant instant, LimitObjectInput in) throws StandardException, java.io.IOException
Description copied from interface:LoggableApply the change indicated by this operation and optional data. If this method fail, the system will be shut down because the log record has already been written to disk. Moreover, the log record will be replayed during recovery and this doMe method will be called on the same page again, so if it fails again, recovery will fail and the database cannot be started. So it is very important to make sure that every resource you need, such as disk space, has been acquired before the logAndDo method is called!
This method cannot acquire any resource (like latching of a page) since it is called underneath the logging system, ie., the log record has already been written to the log stream.The available() method of in indicates how much data can be read, i.e. how much was originally written.
- Parameters:
xact- the Transactioninstant- the log instant of this operationin- optional data- Throws:
java.io.IOException- Can be thrown by any of the methods of ObjectInput.StandardException- Standard Derby policy.- See Also:
Loggable.doMe(org.apache.derby.iapi.store.raw.Transaction, org.apache.derby.iapi.store.raw.log.LogInstant, org.apache.derby.iapi.services.io.LimitObjectInput)
-
undoMe
public void undoMe(Transaction xact, BasePage undoPage, int undoRecordId, LogInstant CLRInstant, LimitObjectInput in) throws StandardException, java.io.IOException
Undo the insert by simply marking the just inserted record as deleted. All logical undo logic has already been taken care of by generateUndo.- Specified by:
undoMein classLogicalPageOperation- Parameters:
xact- the Transaction doing the rollbackundoPage- the page to rollback changes onundoRecordId- the recordId to rollback changes onCLRInstant- the log instant of this (PageUndo) operationin- optional data for the rollback operation- Throws:
java.io.IOException- Can be thrown by any of the methods of ObjectInput.StandardException- Standard Derby policy.- See Also:
LogicalPageOperation.undoMe(org.apache.derby.iapi.store.raw.Transaction, org.apache.derby.impl.store.raw.data.BasePage, int, org.apache.derby.iapi.store.raw.log.LogInstant, org.apache.derby.iapi.services.io.LimitObjectInput)
-
restoreLoggedRow
public void restoreLoggedRow(java.lang.Object[] row, LimitObjectInput in) throws StandardException, java.io.IOExceptionRestore the row stored in the optional data of the log record.- Parameters:
row- an IN/OUT parameter, caller passed in the row with the correct column number and type, the log operation will restore the row with the optional data stored in the log record.- Throws:
java.io.IOException- error reading from log streamStandardException- Standard Derby error policy- See Also:
LogicalUndo
-
restoreMe
public void restoreMe(Transaction xact, BasePage undoPage, LogInstant CLRinstant, LimitObjectInput in) throws StandardException, java.io.IOException
restore the before image of the page- Specified by:
restoreMein classPageBasicOperation- Parameters:
xact- the Transaction doing the rollbackundoPage- the page to rollback changes onCLRinstant- the log instant of this (PageUndo) operationin- optional data for the rollback operation- Throws:
StandardException- Standard Derby Error Policyjava.io.IOException- problem reading the complete log record from the input stream
-
getPreparedLog
public ByteArray getPreparedLog()
Description copied from class:PageBasicOperationthe default for optional data is set to null. If an operation has optional data, the operation need to prepare the optional data for this method. WARNING: If a log operation extends this class, and the operation has optional data, it MUST overwrite this method to return a ByteArray that contains the optional data.- Specified by:
getPreparedLogin interfaceLoggable- Overrides:
getPreparedLogin classPageBasicOperation
-
getNextStartColumn
public int getNextStartColumn()
-
writeOptionalDataToBuffer
private void writeOptionalDataToBuffer(RawTransaction t, DynamicByteArrayOutputStream logBuffer, java.lang.Object[] row, FormatableBitSet validColumns, boolean isLongColumn, int realStartColumn, int realSpaceOnPage, int overflowThreshold) throws StandardException, java.io.IOException
Writes out the row that is to be inserted as the optional data.- Throws:
java.io.IOException- Can be thrown by any of the methods of ObjectOutputStandardException- Standard Derby policy.
-
toString
public java.lang.String toString()
DEBUG: Print self.- Overrides:
toStringin classPageBasicOperation
-
-