Class ContainerUndoOperation

java.lang.Object

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

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

All Implemented Interfaces:

Externalizable, Serializable, Formatable, TypedFormat, Compensation, Loggable

public class ContainerUndoOperation
extends ContainerBasicOperation
implements Compensation

A Container undo operation rolls back the change of a Container operation

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private ContainerOperation	undoOp

Fields inherited from class ContainerBasicOperation

containerHdl, containerId

Fields inherited from interface Loggable

ABORT, BI_LOG, CHECKSUM, COMMIT, COMPENSATION, FILE_RESOURCE, FIRST, LAST, PREPARE, RAWSTORE, XA_NEEDLOCK

Constructor Summary

Constructors

Constructor	Description
ContainerUndoOperation()
ContainerUndoOperation(RawContainerHandle hdl, ContainerOperation op)	Set up a Container undo operation during run time rollback

Method Summary

Modifier and Type	Method	Description
final void	doMe(Transaction xact, LogInstant instant, LimitObjectInput in)	Apply the undo operation, in this implementation of the RawStore, it can only call the undoMe method of undoOp
int	getTypeFormatId()	Return my format identifier.
int	group()	A space operation is a RAWSTORE log record
void	readExternal(ObjectInput in)
void	releaseResource(Transaction xact)	Release any resource that was acquired for doMe for rollback or recovery redo.
void	setUndoOp(Undoable op)	Set up a Container undo operation during recovery redo.
void	writeExternal(ObjectOutput out)

Methods inherited from class ContainerBasicOperation

findContainer, findContainerForRedoRecovery, getPreparedLog, needsRedo, toString

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface Loggable

getPreparedLog, needsRedo

Field Details

undoOp

private transient ContainerOperation undoOp

Constructor Details

ContainerUndoOperation

public ContainerUndoOperation(RawContainerHandle hdl,
 ContainerOperation op)
                       throws StandardException

Set up a Container undo operation during run time rollback

Throws:

StandardException - container Handle is not active

ContainerUndoOperation

public ContainerUndoOperation()

Method Details

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Overrides:

writeExternal in class ContainerBasicOperation

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Overrides:

readExternal in class ContainerBasicOperation

Throws:

IOException - cannot read log record from log stream

ClassNotFoundException - cannot read ByteArray object

getTypeFormatId

public int getTypeFormatId()

Return my format identifier.

Specified by:

getTypeFormatId in interface TypedFormat

Returns:

The identifier. (A UUID stuffed in an array of 16 bytes).

setUndoOp

public void setUndoOp(Undoable op)

Set up a Container undo operation during recovery redo.

Specified by:

setUndoOp in interface Compensation

Parameters:

op - the Undoable operation

See Also:

• Loggable.needsRedo(Transaction)

doMe

public final void doMe(Transaction xact,
 LogInstant instant,
 LimitObjectInput in)
                throws StandardException,
IOException

Apply the undo operation, in this implementation of the RawStore, it can only call the undoMe method of undoOp

Specified by:

doMe in interface Loggable

Parameters:

xact - the Transaction that is doing the rollback

instant - the log instant of this compenstaion operation

in - optional data

Throws:

IOException - Can be thrown by any of the methods of ObjectInput.

StandardException - Standard Derby error policy.

See Also:

• ContainerOperation.generateUndo(Transaction, LimitObjectInput)

releaseResource

public void releaseResource(Transaction xact)

Description copied from interface: Loggable

Release any resource that was acquired for doMe for rollback or recovery redo. This resource is acquired in either generateUndo (if this is a compensation operation during run time rollback or recovery rollback) or in needsRedo (if this is during recovery redo). The run time transaction context should have all the resource already acquird for run time roll forward, so there is no need to releaseResource during run time roll forward. This method must be safe to be called multiple times.

Specified by:

releaseResource in interface Loggable

Overrides:

releaseResource in class ContainerBasicOperation

group

public int group()

Description copied from class: ContainerBasicOperation

A space operation is a RAWSTORE log record

Specified by:

group in interface Loggable

Overrides:

group in class ContainerBasicOperation