parReg.tx

Class PrViewUtil

java.lang.Object

tx.TxUtil

tx.TxViewUtil

parReg.tx.PrViewUtil

public class PrViewUtil
extends TxViewUtil

A class to contain methods useful for ParReg View transactions tests. It provides methods for creating and populating colocated regions. Registering functions (for function execution) and doing random operations on colocated entries as part of a transaction.

Field Summary

Fields inherited from class tx.TxUtil

createCallbackPrefix, destroyCallbackPrefix, invalidateCallbackPrefix, isBridgeClient, isSerialExecution, maxKeys, memberIdString, modValInitializer, NO_REPLICATION, NO_REPLICATION_RESTRICTION, randomValues, regionDestroyCallbackPrefix, regionInvalidateCallbackPrefix, suspendResume, txState, txUtilInstance, updateCallbackPrefix

Constructor Summary

Constructors

Constructor and Description
PrViewUtil()

Method Summary

Modifier and Type	Method and Description
void	createClientRegions()
void	createColocatedRegions()
static OpList	doOperations(boolean allowGetOperations) Do random operations on random regions using the hydra parameter TxPrms.operations as the list of available operations and TxPrms.numOps - the number of operations to execute in a single tx
OpList	doOperations(Vector operations, int numOperationsToDo, boolean allowGetOperations) Do random operations on random regions.
protected void	dumpLocalKeys()
protected List	executeGetAllMembersInDS()
Operation	getEntryWithPreviousKey(com.gemstone.gemfire.cache.Region aRegion) Gets a value in aRegion with a random key (local to the tx vm) that was previously used in the test.
protected KeySetResult	getKeySet(com.gemstone.gemfire.cache.Region aRegion, com.gemstone.gemfire.distributed.DistributedMember targetDM)
protected KeySetResult	getKeySet(com.gemstone.gemfire.cache.Region aRegion, com.gemstone.gemfire.distributed.DistributedMember targetDM, com.gemstone.gemfire.distributed.DistributedMember excludeDM)
Object	getNewKey(com.gemstone.gemfire.cache.Region aRegion) Gets a new (never before seen) key.
Object	getRandomKey(com.gemstone.gemfire.cache.Region aRegion, Object excludeKey) Get a random key from the given region, excluding the key specified by excludeKey.
static Object	getValueForKey(com.gemstone.gemfire.cache.Region aRegion, String key)
static void	HydraTask_createClientRegions()
static void	HydraTask_createColocatedRegions() Create the cache and Region.
static void	HydraTask_dumpLocalKeys() Debug method to see what keys are on each VM at start of test
static void	HydraTask_populateRegions()
protected void	initializeKeySet(boolean useLocalKeySet) Initialize remote keySet.
void	populateRegions()
protected void	registerFunctions()
protected void	updateKeySet(Operation op) Update (per region) keySet Region specific keySets are maintained through each invocation of doOperations().

Methods inherited from class tx.TxViewUtil

containsKey, getValueInVM, getValueInVM, HydraTask_createRegionForest

Methods inherited from class tx.TxUtil

clearDestroyedRegions, closeCache, containsKeyExisting, containsValueExisting, containsValueForKeyExisting, createAllDestroyedRegions, createDestroyedRegionsFromBB, createEntries, createEntry, createPartitionedRegions, createRegion, createRegionHierarchy, createRegionWithPath, destroyEntry, destroyRegion, dispAllKeys, doNonrepeatableReadOperations, doOperations, doOperations, doRepeatableReadOperations, getAll, getEntry, getEntryWithExistingKey, getEntryWithNewKey, getNewValue, getRandomKey, getRandomRegion, getRandomRegion, getRandomRegionNoReplication, getRegionConfigFromBB, getRegionConfigMap, getRoundRobinNumber, getSubregions, getWithExistingKey, HydraTask_createPartitionedRegions, HydraTask_doOperations, HydraTask_startBridgeServer, HydraTask_stopBridgeServer, initialize, inTxThreadWithTxInProgress, inTxVm, invalEntry, invalRegion, isHierReplicated, logExecutionNumber, logRoundRobinNumber, putAll, putEntry, recordDestroyedRegion, recordRegionConfigInBB, removeEntry, StartTask_initialize, summarizeRegionHier, supportsConcurrentMapOps, updateEntry

Methods inherited from class java.lang.Object

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

Constructor Detail

PrViewUtil

public PrViewUtil()

Method Detail

HydraTask_createColocatedRegions

public static void HydraTask_createColocatedRegions()

Create the cache and Region.

createColocatedRegions

public void createColocatedRegions()

HydraTask_createClientRegions

public static void HydraTask_createClientRegions()

createClientRegions

public void createClientRegions()

HydraTask_populateRegions

public static void HydraTask_populateRegions()

populateRegions

public void populateRegions()

Overrides:

populateRegions in class TxUtil

HydraTask_dumpLocalKeys

public static void HydraTask_dumpLocalKeys()

Debug method to see what keys are on each VM at start of test

dumpLocalKeys

protected void dumpLocalKeys()

registerFunctions

protected void registerFunctions()

doOperations

public static OpList doOperations(boolean allowGetOperations)

Do random operations on random regions using the hydra parameter TxPrms.operations as the list of available operations and TxPrms.numOps - the number of operations to execute in a single tx

Parameters:

allowGetOperations - - to prevent proxy clients from attempting gets (since they have no storage this always invokes the loader and oldValue is always reported as null).

doOperations

public OpList doOperations(Vector operations,
                           int numOperationsToDo,
                           boolean allowGetOperations)

Do random operations on random regions.

Overrides:

doOperations in class TxUtil

Parameters:

operations - - a Vector of operations to choose from.

numOperationsToDo - - the number of operations to execute.

allowGetOperations - - if false, replace entry-get ops with entry-create

updateKeySet

protected void updateKeySet(Operation op)

Update (per region) keySet Region specific keySets are maintained through each invocation of doOperations(). They are initialized at the beginning, but keys need to be removed on entryDestroy and added on entryCreate. We don't have a test hook to look at the TxState (vs. committed state).

initializeKeySet

protected void initializeKeySet(boolean useLocalKeySet)

Initialize remote keySet. Writes a KeySetResult (with DistributedMember and keySet) to PrTxBB. getRandomKey() relies upon this (to select colocated entries on a single remote VM). getNewKey() also relies on this (so it can determine the correct hashCode required for a new entry on the remote VM).

getKeySet

protected KeySetResult getKeySet(com.gemstone.gemfire.cache.Region aRegion,
                                 com.gemstone.gemfire.distributed.DistributedMember targetDM)

getKeySet

protected KeySetResult getKeySet(com.gemstone.gemfire.cache.Region aRegion,
                                 com.gemstone.gemfire.distributed.DistributedMember targetDM,
                                 com.gemstone.gemfire.distributed.DistributedMember excludeDM)

executeGetAllMembersInDS

protected List executeGetAllMembersInDS()

getValueForKey

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

getRandomKey

public Object getRandomKey(com.gemstone.gemfire.cache.Region aRegion,
                           Object excludeKey)

Get a random key from the given region, excluding the key specified by excludeKey. If no keys qualify in the region, return null.

Overrides:

getRandomKey in class TxViewUtil

Parameters:

aRegion - - The region to get the key from.

excludeKey - - The region to get the key from.

getEntryWithPreviousKey

public Operation getEntryWithPreviousKey(com.gemstone.gemfire.cache.Region aRegion)

Gets a value in aRegion with a random key (local to the tx vm) that was previously used in the test.

Overrides:

getEntryWithPreviousKey in class TxUtil

Parameters:

aRegion - The region to get from.

Returns:

An instance of Operation describing the get operation.

getNewKey

public Object getNewKey(com.gemstone.gemfire.cache.Region aRegion)

Gets a new (never before seen) key. Invoked by createEntry and getEntryWithNewKey (TxUtil)

Overrides:

getNewKey in class TxUtil

Returns:

the next key (with hashCode) for the target VM