tx

Class ViewTest

java.lang.Object

tx.ViewTest

Direct Known Subclasses:

BridgeViewTest, FDViewTest, ParRegViewTest, SerialViewTest

public class ViewTest
extends Object

A test to validate what different threads/VMs see in terms of transactional state (when a tx is in progress) as well as non-tx operations.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	checkEventCounters
protected boolean	initializeTxInfo
protected com.gemstone.gemfire.cache.InterestPolicy	interestPolicy
protected boolean	isBridgeClient
protected boolean	isProxy
protected boolean	isScopeLocal
protected boolean	isSerialExecution
static Object	killSyncObject
protected Integer	myVmPid
protected GsRandom	rng
protected com.gemstone.gemfire.internal.cache.TXStateInterface	txContext
protected boolean	txInProgress
protected static ViewTest	viewTest

Constructor Summary

Constructors

Constructor and Description
ViewTest()

Method Summary

Modifier and Type	Method and Description
protected void	adjustOldValue(Operation op, OpList opList)
protected void	beginTx()
protected void	checkCommittedState()
protected void	checkEventCounters() Check CacheListener Event Counters
protected void	checkTxEventCounters(Blackboard bb) Check Transaction Listener (or Writer) Event Counters
protected void	checkWriterCounters() Check CacheWriter Event Counters
protected void	executeTx()
protected void	finishTx()
static Object	getValueInVM(com.gemstone.gemfire.cache.Region aRegion, Object key) Call getValueInVM on the given region.
static void	HydraCloseTask_validateTxConsistency() Hydra CLOSETASK to verify that either all or no VMs received the distribution of a transaction (even though the tx vm was killed mid-way through the operation.
static void	HydraCloseTask_verifyResourcesReleased() Hydra CLOSETASK to ensure that we can access the same entries that were accessed in the original transaction (to ensure all locking resources were released).
static void	HydraTask_checkCommittedState()
static void	HydraTask_executeTx()
static void	HydraTask_initialize()
static void	HydraTask_killCommittor() kill the VM if we are the transactional thread and a commit is in Progress (see TxBB.commitInProgress)
static void	HydraTask_waitForDist() Task for threads whose sole purpose is to wait for commit distribution Basically sleeping ...
void	incrementEventCounters(OpList txOpList, int counterType)
void	initialize()
void	setupCommitTestCallbacks(String commitStatePrm)
protected boolean	updatesVisible() Depending on the commitStateTrigger (the point at which the committing VM was killed), should we be able to see the tx updates?
protected void	validateAllStates(boolean isTxVisible)
protected void	validateCacheClosed(boolean isVisible)
protected void	validateCombinedOpsAfterCommit()
protected void	validateCombinedOpsAfterRollback()
protected void	validateCommittedState(boolean txCommitted)
protected boolean	validateNonTxOps()
protected void	validateState(OpList opList, boolean isVisible)
protected void	validateState(OpList opList, boolean isVisible, String txAction)
protected void	validateTxConsistency()
protected boolean	validateTxOps(boolean isTxVisible)
protected boolean	validateTxOps(boolean isTxVisible, String txAction)
protected void	verifyCallbackInvocation(int numVmsWithTxListener)
protected void	verifyResourcesReleased() Hydra CLOSETASK to verify that resources (e.g.

Methods inherited from class java.lang.Object

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

Field Detail

viewTest

protected static ViewTest viewTest

isSerialExecution

protected boolean isSerialExecution

rng

protected GsRandom rng

txInProgress

protected boolean txInProgress

myVmPid

protected Integer myVmPid

isScopeLocal

protected boolean isScopeLocal

isBridgeClient

protected boolean isBridgeClient

isProxy

protected boolean isProxy

interestPolicy

protected com.gemstone.gemfire.cache.InterestPolicy interestPolicy

initializeTxInfo

protected boolean initializeTxInfo

checkEventCounters

protected boolean checkEventCounters

killSyncObject

public static Object killSyncObject

txContext

protected com.gemstone.gemfire.internal.cache.TXStateInterface txContext

Constructor Detail

ViewTest

public ViewTest()

Method Detail

HydraTask_initialize

public static void HydraTask_initialize()

initialize

public void initialize()

HydraTask_executeTx

public static void HydraTask_executeTx()

executeTx

protected void executeTx()

beginTx

protected void beginTx()

finishTx

protected void finishTx()

verifyCallbackInvocation

protected void verifyCallbackInvocation(int numVmsWithTxListener)

validateCommittedState

protected void validateCommittedState(boolean txCommitted)

validateCombinedOpsAfterCommit

protected void validateCombinedOpsAfterCommit()

validateCombinedOpsAfterRollback

protected void validateCombinedOpsAfterRollback()

HydraTask_checkCommittedState

public static void HydraTask_checkCommittedState()

checkCommittedState

protected void checkCommittedState()

validateAllStates

protected void validateAllStates(boolean isTxVisible)

validateNonTxOps

protected boolean validateNonTxOps()

validateTxOps

protected boolean validateTxOps(boolean isTxVisible)

validateTxOps

protected boolean validateTxOps(boolean isTxVisible,
                                String txAction)

validateState

protected void validateState(OpList opList,
                             boolean isVisible)

validateState

protected void validateState(OpList opList,
                             boolean isVisible,
                             String txAction)

validateCacheClosed

protected void validateCacheClosed(boolean isVisible)

adjustOldValue

protected void adjustOldValue(Operation op,
                              OpList opList)

incrementEventCounters

public void incrementEventCounters(OpList txOpList,
                                   int counterType)

checkWriterCounters

protected void checkWriterCounters()

Check CacheWriter Event Counters

checkEventCounters

protected void checkEventCounters()

Check CacheListener Event Counters

checkTxEventCounters

protected void checkTxEventCounters(Blackboard bb)

Check Transaction Listener (or Writer) Event Counters

Parameters:

- - the blackboard to verify agains (TxEventCountersBB vs. TxWriterCountersBB)

setupCommitTestCallbacks

public void setupCommitTestCallbacks(String commitStatePrm)

HydraTask_killCommittor

public static void HydraTask_killCommittor()
                                    throws ClientVmNotFoundException

kill the VM if we are the transactional thread and a commit is in Progress (see TxBB.commitInProgress)

Throws:

ClientVmNotFoundException

HydraTask_waitForDist

public static void HydraTask_waitForDist()

Task for threads whose sole purpose is to wait for commit distribution Basically sleeping ...

HydraCloseTask_verifyResourcesReleased

public static void HydraCloseTask_verifyResourcesReleased()

Hydra CLOSETASK to ensure that we can access the same entries that were accessed in the original transaction (to ensure all locking resources were released).

verifyResourcesReleased

protected void verifyResourcesReleased()

Hydra CLOSETASK to verify that resources (e.g. locks) have been released after a client which was committing a transaction is killed. This cannot be invoked in the case of the distributed commit succeeding as we likely can't execute the exact operation again. Either check this case, or provide functions to randomly create these operations with a given Region & Key.

HydraCloseTask_validateTxConsistency

public static void HydraCloseTask_validateTxConsistency()

Hydra CLOSETASK to verify that either all or no VMs received the distribution of a transaction (even though the tx vm was killed mid-way through the operation. Either everyone has all the updates or no one does!

validateTxConsistency

protected void validateTxConsistency()

updatesVisible

protected boolean updatesVisible()

Depending on the commitStateTrigger (the point at which the committing VM was killed), should we be able to see the tx updates?

getValueInVM

public static Object getValueInVM(com.gemstone.gemfire.cache.Region aRegion,
                                  Object key)

Call getValueInVM on the given region.

Parameters:

aRegion - - The region to use for the call.

key - - The key to use for the call.