Class UpdateOperation
- java.lang.Object
-
- org.apache.derby.impl.store.raw.data.PageBasicOperation
-
- org.apache.derby.impl.store.raw.data.PhysicalPageOperation
-
- org.apache.derby.impl.store.raw.data.UpdateOperation
-
- All Implemented Interfaces:
java.io.Externalizable
,java.io.Serializable
,Formatable
,TypedFormat
,Loggable
,RePreparable
,Undoable
public final class UpdateOperation extends PhysicalPageOperation
Represents the update of a particular row on a page.- See Also:
- Serialized Form
Format ID LOGOP_UPDATE the formatId is written by FormatIdOutputStream when this object is written out by writeObject Purpose update a record on the page Upgrade Disk Layout PhysicalPageOperation the super class doMeSlot(CompressedInt) the slot the updated record is in recordId(CompressedInt) the recordId of the updated record OptionalData The new image of the record (length included), follow by the old image of the record (length included)
-
-
Field Summary
Fields Modifier and Type Field Description protected int
doMeSlot
protected int
nextColumn
protected ByteArray
preparedLog
protected int
recordId
-
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 UpdateOperation()
UpdateOperation(RawTransaction t, BasePage page, int slot, int recordId, java.lang.Object[] row, FormatableBitSet validColumns, int realStartColumn, DynamicByteArrayOutputStream logBuffer, int realSpaceOnPage, RecordHandle headRowHandle)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
doMe(Transaction xact, LogInstant instant, LimitObjectInput in)
Store the new record directly over the old record, the implementation of storeRecord is responsible for removing any old data.int
getNextStartColumn()
Return the last column of the row this operation loggedByteArray
getPreparedLog()
the default for optional data is set to null.private RecordHandle
getRecordHandle()
return RecordHandle of the update row.int
getTypeFormatId()
Return my format identifier.void
readExternal(java.io.ObjectInput in)
Read this invoid
reclaimPrepareLocks(Transaction t, LockingPolicy locking_policy)
reclaim locks associated with the changes in this log record.void
restoreMe(Transaction xact, BasePage undoPage, LogInstant CLRInstant, LimitObjectInput in)
restore the before image of the pagejava.lang.String
toString()
void
undoMe(Transaction xact, BasePage undoPage, LogInstant CLRInstant, LimitObjectInput in)
Store the old record directly over the new record, the implementation of storeRecord is responsible for removing any new data.void
writeExternal(java.io.ObjectOutput out)
private void
writeOptionalDataToBuffer(RawTransaction t, DynamicByteArrayOutputStream logBuffer, java.lang.Object[] row, FormatableBitSet validColumns, int realStartColumn, int realSpaceOnPage, RecordHandle headRowHandle)
Write out the changed colums of new record (from the row) followed by changed columns of the old record (from the page).-
Methods inherited from class org.apache.derby.impl.store.raw.data.PhysicalPageOperation
generateUndo
-
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
-
recordId
protected int recordId
-
nextColumn
protected transient int nextColumn
-
preparedLog
protected transient ByteArray preparedLog
-
-
Constructor Detail
-
UpdateOperation
UpdateOperation(RawTransaction t, BasePage page, int slot, int recordId, java.lang.Object[] row, FormatableBitSet validColumns, int realStartColumn, DynamicByteArrayOutputStream logBuffer, int realSpaceOnPage, RecordHandle headRowHandle) throws StandardException
- Throws:
StandardException
-
UpdateOperation
public UpdateOperation()
-
-
Method Detail
-
writeExternal
public void writeExternal(java.io.ObjectOutput out) throws java.io.IOException
- Specified by:
writeExternal
in interfacejava.io.Externalizable
- Overrides:
writeExternal
in classPageBasicOperation
- Throws:
java.io.IOException
-
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 classPageBasicOperation
- 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).
-
getNextStartColumn
public int getNextStartColumn()
Return the last column of the row this operation logged
-
doMe
public void doMe(Transaction xact, LogInstant instant, LimitObjectInput in) throws StandardException, java.io.IOException
Store the new record directly over the old record, the implementation of storeRecord is responsible for removing any old data.- Parameters:
xact
- the Transactioninstant
- the log instant of this operationin
- optional data- Throws:
StandardException
- Thrown by methods I calljava.io.IOException
- Thrown by methods I call- See Also:
BasePage.storeRecord(org.apache.derby.iapi.store.raw.log.LogInstant, int, boolean, java.io.ObjectInput)
,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, LogInstant CLRInstant, LimitObjectInput in) throws StandardException, java.io.IOException
Store the old record directly over the new record, the implementation of storeRecord is responsible for removing any new data.- Specified by:
undoMe
in classPhysicalPageOperation
- 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
- Thrown by methods I calljava.io.IOException
- Thrown by methods I call- See Also:
BasePage.storeRecord(org.apache.derby.iapi.store.raw.log.LogInstant, int, boolean, java.io.ObjectInput)
,PhysicalPageOperation.undoMe(org.apache.derby.iapi.store.raw.Transaction, org.apache.derby.impl.store.raw.data.BasePage, org.apache.derby.iapi.store.raw.log.LogInstant, org.apache.derby.iapi.services.io.LimitObjectInput)
-
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
-
writeOptionalDataToBuffer
private void writeOptionalDataToBuffer(RawTransaction t, DynamicByteArrayOutputStream logBuffer, java.lang.Object[] row, FormatableBitSet validColumns, int realStartColumn, int realSpaceOnPage, RecordHandle headRowHandle) throws StandardException, java.io.IOException
Write out the changed colums of new record (from the row) followed by changed columns of the old record (from the page).- Throws:
StandardException
- Thrown by methods I calljava.io.IOException
- Thrown by methods I call
-
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
-
getRecordHandle
private RecordHandle getRecordHandle()
return RecordHandle of the update row.Return the RecordHandle that should be locked when updating the row in this UpdateOperation.
-
reclaimPrepareLocks
public void reclaimPrepareLocks(Transaction t, LockingPolicy locking_policy) throws StandardException
reclaim locks associated with the changes in this log record.- Specified by:
reclaimPrepareLocks
in interfaceRePreparable
- Overrides:
reclaimPrepareLocks
in classPageBasicOperation
- Parameters:
locking_policy
- The locking policy to use to claim the locks.- Throws:
StandardException
- Standard exception policy.
-
toString
public java.lang.String toString()
- Overrides:
toString
in classPageBasicOperation
-
-