com.arjuna.ats.internal.arjuna.abstractrecords

Class ActivationRecord

java.lang.Object

com.arjuna.ats.arjuna.StateManager

com.arjuna.ats.arjuna.coordinator.AbstractRecord

com.arjuna.ats.internal.arjuna.abstractrecords.ActivationRecord

Direct Known Subclasses:

CadaverActivationRecord

public class ActivationRecord
extends AbstractRecord

Field Summary

Fields inherited from class com.arjuna.ats.arjuna.StateManager

modifyingActions, objectModel, objectUid, usingActions

Constructor Summary

Constructors

Constructor and Description
ActivationRecord()
ActivationRecord(int st, StateManager sm, BasicAction action)

Method Summary

Modifier and Type	Method and Description
void	alter(AbstractRecord a) Alter the current record with the one presented.
void	merge(AbstractRecord a) Merge the current record with the one presented.
int	nestedAbort() nestedAbort causes the reset_state function of the object to be invoked passing it the saved ObjectStatus.
int	nestedCommit() nestedCommit does nothing since the passing of the state up to the parent action is handled by the record list merging system.
int	nestedPrepare() A prepare for a nested transaction has occurred.
void	print(PrintWriter strm) Write information about this specific instance to the specified stream.
boolean	restore_state(InputObjectState os, int v) Saving of ActivationRecords is only undertaken during the Prepare phase of the top level 2PC.
boolean	save_state(OutputObjectState os, ObjectType v)
void	setValue(Object v)
boolean	shouldAdd(AbstractRecord a) Should we add the record presented to the intentions list?
boolean	shouldAlter(AbstractRecord a) Should we alter the current record with the one presented?
boolean	shouldMerge(AbstractRecord a) Should we merge the current record with the one presented?
boolean	shouldReplace(AbstractRecord a) Should we replace the record presented with the current record?
int	topLevelAbort() topLevelAbort for Activation records is exactly like a nested abort.
int	topLevelCommit() A commit of a top-level transaction has occurred.
int	topLevelPrepare() A prepare for a top-level transaction has occurred.
String	type() Re-implementation of abstract methods inherited from base class.
int	typeIs()
Object	value() If this abstract record caused a heuristic then it should return an object which implements HeuristicInformation

Methods inherited from class com.arjuna.ats.arjuna.coordinator.AbstractRecord

create, doSave, equals, forgetHeuristic, getNext, getPrevious, getTypeOfObject, greaterThan, lessThan, nestedCleanup, nestedOnePhaseCommit, order, propagateOnAbort, propagateOnCommit, replace, save_state, setNext, setPrevious, topLevelCleanup, topLevelOnePhaseCommit

Methods inherited from class com.arjuna.ats.arjuna.StateManager

activate, activate, cleanup, createLists, deactivate, deactivate, deactivate, destroy, disable, forgetAction, get_uid, getMutex, getObjectModel, getStore, getStoreRoot, loadObjectState, lockMutex, modified, objectType, packHeader, persist, rememberAction, setStatus, setupStore, setupStore, setupStore, status, terminate, tryLockMutex, unlockMutex, unpackHeader

Methods inherited from class java.lang.Object

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

Constructor Detail

ActivationRecord

public ActivationRecord(int st,
                        StateManager sm,
                        BasicAction action)

ActivationRecord

public ActivationRecord()

Method Detail

typeIs

public int typeIs()

Specified by:

typeIs in class AbstractRecord

Returns:

RecordType value.

value

public Object value()

Description copied from class: AbstractRecord

If this abstract record caused a heuristic then it should return an object which implements HeuristicInformation

Specified by:

value in class AbstractRecord

Returns:

Object to be used to order.

setValue

public void setValue(Object v)

Specified by:

setValue in class AbstractRecord

nestedAbort

public int nestedAbort()

nestedAbort causes the reset_state function of the object to be invoked passing it the saved ObjectStatus.

Specified by:

nestedAbort in class AbstractRecord

Returns:

TwoPhaseOutcome to indicate success/failure.

See Also:

TwoPhaseOutcome

nestedCommit

public int nestedCommit()

nestedCommit does nothing since the passing of the state up to the parent action is handled by the record list merging system. In fact since nested_prepare returns PREPARE_READONLY this function should never actually be called.

Specified by:

nestedCommit in class AbstractRecord

Returns:

TwoPhaseOutcome to indicate success/failure.

See Also:

TwoPhaseOutcome

nestedPrepare

public int nestedPrepare()

Description copied from class: AbstractRecord

A prepare for a nested transaction has occurred.

Specified by:

nestedPrepare in class AbstractRecord

Returns:

TwoPhaseOutcome to indicate success/failure.

See Also:

TwoPhaseOutcome

topLevelAbort

public int topLevelAbort()

topLevelAbort for Activation records is exactly like a nested abort.

Specified by:

topLevelAbort in class AbstractRecord

Returns:

TwoPhaseOutcome to indicate success/failure.

See Also:

TwoPhaseOutcome

topLevelCommit

public int topLevelCommit()

Description copied from class: AbstractRecord

A commit of a top-level transaction has occurred.

Specified by:

topLevelCommit in class AbstractRecord

Returns:

TwoPhaseOutcome to indicate success/failure.

See Also:

TwoPhaseOutcome

topLevelPrepare

public int topLevelPrepare()

Description copied from class: AbstractRecord

A prepare for a top-level transaction has occurred.

Specified by:

topLevelPrepare in class AbstractRecord

Returns:

TwoPhaseOutcome to indicate success/failure.

See Also:

TwoPhaseOutcome

restore_state

public boolean restore_state(InputObjectState os,
                             int v)

Saving of ActivationRecords is only undertaken during the Prepare phase of the top level 2PC.

Overrides:

restore_state in class AbstractRecord

Returns:

true if successful, false otherwise.

save_state

public boolean save_state(OutputObjectState os,
                          ObjectType v)

print

public void print(PrintWriter strm)

Description copied from class: AbstractRecord

Write information about this specific instance to the specified stream.

Overrides:

print in class AbstractRecord

Parameters:

strm - the stream on which to output.

type

public String type()

Description copied from class: AbstractRecord

Re-implementation of abstract methods inherited from base class.

Overrides:

type in class AbstractRecord

merge

public void merge(AbstractRecord a)

Description copied from class: AbstractRecord

Merge the current record with the one presented.

Specified by:

merge in class AbstractRecord

Parameters:

a - the record with which to merge.

alter

public void alter(AbstractRecord a)

Description copied from class: AbstractRecord

Alter the current record with the one presented.

Specified by:

alter in class AbstractRecord

Parameters:

a - the record with which to alter.

shouldAdd

public boolean shouldAdd(AbstractRecord a)

Description copied from class: AbstractRecord

Should we add the record presented to the intentions list?

Specified by:

shouldAdd in class AbstractRecord

Parameters:

a - The record to try to add.

Returns:

true if the record should be added, false otherwise.

shouldAlter

public boolean shouldAlter(AbstractRecord a)

Description copied from class: AbstractRecord

Should we alter the current record with the one presented?

Specified by:

shouldAlter in class AbstractRecord

Parameters:

a - The record to try to alter.

Returns:

true if the record should be altered, false otherwise.

shouldMerge

public boolean shouldMerge(AbstractRecord a)

Description copied from class: AbstractRecord

Should we merge the current record with the one presented?

Specified by:

shouldMerge in class AbstractRecord

Parameters:

a - The record to try to merge.

Returns:

true if the record should be merged, false otherwise.

shouldReplace

public boolean shouldReplace(AbstractRecord a)

Description copied from class: AbstractRecord

Should we replace the record presented with the current record?

Specified by:

shouldReplace in class AbstractRecord

Parameters:

a - The record to try to replace.

Returns:

true if the record should be replaced, false otherwise.