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 int
doMeSlot
protected byte
insertFlag
protected ByteArray
preparedLog
protected int
startColumn
next 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 void
doMe(Transaction xact, LogInstant instant, LimitObjectInput in)
Apply the change indicated by this operation and optional data.int
getNextStartColumn()
ByteArray
getPreparedLog()
the default for optional data is set to null.int
getTypeFormatId()
Return my format identifier.void
readExternal(java.io.ObjectInput in)
Read this invoid
restoreLoggedRow(java.lang.Object[] row, LimitObjectInput in)
Restore the row stored in the optional data of the log record.void
restoreMe(Transaction xact, BasePage undoPage, LogInstant CLRinstant, LimitObjectInput in)
restore the before image of the pagejava.lang.String
toString()
DEBUG: Print self.void
undoMe(Transaction xact, BasePage undoPage, int undoRecordId, LogInstant CLRInstant, LimitObjectInput in)
Undo the insert by simply marking the just inserted record as deleted.void
writeExternal(java.io.ObjectOutput out)
Write this out.private void
writeOptionalDataToBuffer(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.IOException
Write this out.- Specified by:
writeExternal
in interfacejava.io.Externalizable
- Overrides:
writeExternal
in classLogicalPageOperation
- Throws:
java.io.IOException
- error writing to log stream
-
readExternal
public void readExternal(java.io.ObjectInput in) throws java.io.IOException, java.lang.ClassNotFoundException
Read this in- Specified by:
readExternal
in interfacejava.io.Externalizable
- Overrides:
readExternal
in 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:Loggable
Apply 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:
undoMe
in 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.IOException
Restore 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:
restoreMe
in 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:PageBasicOperation
the 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:
getPreparedLog
in interfaceLoggable
- Overrides:
getPreparedLog
in 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:
toString
in classPageBasicOperation
-
-