com.bigdata.ha.msg

Class HARootBlockRequest

java.lang.Object

com.bigdata.ha.msg.HARootBlockRequest

All Implemented Interfaces:

IHAMessage, IHARootBlockRequest, Serializable

public class HARootBlockRequest
extends Object
implements IHARootBlockRequest, Serializable

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
HARootBlockRequest(UUID storeUUID) Create a non-blocking request (this is the historical behavior).
HARootBlockRequest(UUID storeUUID, boolean isNonBlocking)

Method Summary

Methods

Modifier and Type	Method and Description
UUID	getStoreUUID() The UUID of the journal whose root block will be returned (optional, defaults to the current Journal).
boolean	isNonBlocking() When true the request should be non-blocking.

Methods inherited from class java.lang.Object

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

Constructor Detail

HARootBlockRequest

public HARootBlockRequest(UUID storeUUID)

Create a non-blocking request (this is the historical behavior).

Parameters:

storeUUID - The store UUID (optional).

HARootBlockRequest

public HARootBlockRequest(UUID storeUUID,
                  boolean isNonBlocking)

Parameters:

storeUUID - The store UUID (optional).

isNonBlocking - true iff the request should be non-blocking.

Method Detail

getStoreUUID

public UUID getStoreUUID()

Description copied from interface: IHARootBlockRequest

The UUID of the journal whose root block will be returned (optional, defaults to the current Journal).

Note: This parameter is intended for scale-out if there is a need to fetch the root block of a historical journal (versus the live journal).

Specified by:

getStoreUUID in interface IHARootBlockRequest

isNonBlocking

public boolean isNonBlocking()

Description copied from interface: IHARootBlockRequest

When true the request should be non-blocking. Otherwise the request should obtain the lock that guards the update of the root block in the commit protocol such that the caller can not observe a root block that has been updated but where the commit protocol is still in its critical section.

Note: The non-blocking form of the request is used in some context where the avoidence of a deadlock is necessary. The blocking form is used in some contexts where we need to await a specific commit point on the service (typically under test suite control).

Specified by:

isNonBlocking in interface IHARootBlockRequest