com.bigdata.ha.msg

Interface IHA2PhasePrepareMessage

All Superinterfaces:

IHA2PhaseCommitProtocolMessage, IHAMessage, Serializable

All Known Implementing Classes:

HA2PhasePrepareMessage

public interface IHA2PhasePrepareMessage
extends IHA2PhaseCommitProtocolMessage

Message used by the HACommitGlue interface to indicate that the recipient should save a reference to the caller's root block, flush writes to the backing channel and acknowledge "yes" if ready to commit. If the node can not prepare for any reason, then it must return "no".

Author:

Bryan Thompson

Method Summary

Methods

Modifier and Type	Method and Description
IHANotifyReleaseTimeResponse	getConsensusReleaseTime() The consensus release time from the GATHER.
IRootBlockView	getRootBlock() The new root block.
long	getTimeout() How long to wait for the other services to prepare.
TimeUnit	getUnit() The unit for the timeout.
boolean	isGatherService() true iff the service was recognized as being joined with the met quorum at the time that the GATHER message was prepared.
boolean	isJoinedService() true iff the service was recognized as being joined with the met quorum at the time that the PREPARE message was prepared.
boolean	isRootBlock0() true if this is rootBlock0 for the leader.
boolean	voteNo() When true, always vote note.

Method Detail

getConsensusReleaseTime

IHANotifyReleaseTimeResponse getConsensusReleaseTime()

The consensus release time from the GATHER.

isGatherService

boolean isGatherService()

true iff the service was recognized as being joined with the met quorum at the time that the GATHER message was prepared.

Note: This is used to support atomic decisions about whether or not a service was joined with the met quorum at the time that the leader decided to update the consensus release time. Services that are in the pipeline and resynchronizing were either joined or not for the purposes of a given 2-phase GATHER operation based on this flag.

isJoinedService

boolean isJoinedService()

true iff the service was recognized as being joined with the met quorum at the time that the PREPARE message was prepared.

Note: This is used to support atomic decisions about whether or not a service was joined with the met quorum at the time that the leader decided to commit. Services that are in the pipeline and resynchronizing will either be joined or not for the purposes of a given 2-phase commit based on this flag.

Note: A better name for this flag would be isPrepareService().

isRootBlock0

boolean isRootBlock0()

true if this is rootBlock0 for the leader.

getRootBlock

IRootBlockView getRootBlock()

The new root block.

getTimeout

long getTimeout()

How long to wait for the other services to prepare.

getUnit

TimeUnit getUnit()

The unit for the timeout.

voteNo

boolean voteNo()

When true, always vote note.

Note: This is for unit tests only.