parReg.tx

Class ColocatedTxTest

java.lang.Object

util.OperationsClient

parReg.tx.ColocatedTxTest

public class ColocatedTxTest
extends OperationsClient

A simple test class that supports executing entry operations on a PartitionRegion while using a colocated regions. For PartitionedRegion tx testing, the keySet is set by getLocal(Remote)KeySet. KeySet determined via function execution and PartitionedRegionHelper.getLocalDataSet to target entries in either a local or remote VMs). Tasks available (executed via FunctionExecution): - executeGetAllMembersInDS() - uses FunctionService.onMembers(ds) to get a list of (Serialized)DistributedMembers - getKeySet() - using FunctionService.onRegion() with PartitionedRegionHelper.getLocalDataSet to retrieve potential keySet for entry operations on members. If PrTxPrms-useLocalKeySet is true (default), it will return the keySet for the calling VM, otherwise, it will select a keySet for a remote VM.

Since:

6.1

See Also:

PrTxPrms-useLocalKeySet, PrTxPrms-numColocatedRegions

Field Summary

Fields

Modifier and Type	Field and Description
protected static ColocatedTxTest	testInstance

Fields inherited from class util.OperationsClient

createCallbackPrefix, destroyCallbackPrefix, distLockService, ENTRY_ADD_OPERATION, ENTRY_DESTROY_OPERATION, ENTRY_GET_NEW_OPERATION, ENTRY_GET_OPERATION, ENTRY_INVALIDATE_OPERATION, ENTRY_LOCAL_DESTROY_OPERATION, ENTRY_LOCAL_INVALIDATE_OPERATION, ENTRY_PUTALL_OPERATION, ENTRY_UPDATE_OPERATION, getCallbackPrefix, invalidateCallbackPrefix, LOCK_NAME, LOCK_SERVICE_NAME, lockOperations, lowerThreshold, minTaskGranularityMS, minTaskGranularitySec, numOpsPerTask, PUT_IF_ABSENT_OPERATION, randomValues, regionDestroyCallbackPrefix, regionInvalidateCallbackPrefix, REMOVE_OPERATION, REPLACE_OPERATION, updateCallbackPrefix, upperThreshold, useTransactions, VmIDStr

Constructor Summary

Constructors

Constructor and Description
ColocatedTxTest()

Method Summary

Modifier and Type	Method and Description
protected void	addEntry(com.gemstone.gemfire.cache.Region aRegion) Add a new entry to the given region.
protected void	destroyEntry(com.gemstone.gemfire.cache.Region aRegion, boolean isLocalDestroy) Destroy an entry in the given region.
protected void	destroyEntry(com.gemstone.gemfire.cache.Region aRegion, Object key, boolean isLocalDestroy) Destroy an entry in the given region.
protected void	doEntryOperations()
protected void	doEntryOperations(Object[] keySet) Do random entry operations on the a key in the given keySet across all colocated regions.
protected List	executeGetAllMembersInDS()
protected Object	getExistingKey(com.gemstone.gemfire.cache.Region aRegion) Return a random key currently in the given region.
protected List	getExistingKeys(com.gemstone.gemfire.cache.Region aRegion, int numKeysToGet)
protected List	getExistingKeys(com.gemstone.gemfire.cache.Region aRegion, Object[] keySet, int numKeysToGet)
protected void	getKey(com.gemstone.gemfire.cache.Region aRegion) Get an existing key in the given region if one is available, otherwise get a new key.
protected void	getKey(com.gemstone.gemfire.cache.Region aRegion, Object key) Get an existing key in the given region if one is available, otherwise get a new key.
protected KeySetResult	getKeySet(com.gemstone.gemfire.cache.Region aRegion)
protected void	getNewKey(com.gemstone.gemfire.cache.Region aRegion) Get a new key in the given region.
protected Object	getNewKeyForRegion(com.gemstone.gemfire.cache.Region aRegion) Return a new key, never before used in the test.
static void	HydraTask_doEntryOperations() Performs puts/gets on entries in TestRegion
static void	HydraTask_initialize() Create the cache and Region (for peers).
static void	HydraTask_initializeBridgeClient()
static void	HydraTask_initializeBridgeServer()
static void	HydraTask_populateRegions()
protected void	initialize()
protected void	initializeBridgeClient()
protected void	initializeBridgeServer()
protected void	invalidateEntry(com.gemstone.gemfire.cache.Region aRegion, boolean isLocalInvalidate) Invalidate an entry in the given region.
protected void	invalidateEntry(com.gemstone.gemfire.cache.Region aRegion, Object key, boolean isLocalInvalidate) Invalidate an entry in the given region.
protected void	populateRegions()
protected void	putAll(com.gemstone.gemfire.cache.Region r) putall a map to the given region.
protected void	putAll(com.gemstone.gemfire.cache.Region r, Object[] keySet)
protected void	putIfAbsent(com.gemstone.gemfire.cache.Region aRegion) Add a new entry to the given region using the ConcurrentMap putIfAbsent api
protected void	putIfAbsent(com.gemstone.gemfire.cache.Region aRegion, boolean logAddition) ConcurrentMap API testing
protected void	registerFunctions()
protected void	remove(com.gemstone.gemfire.cache.Region aRegion) Remove an entry in the given region using the ConcurrentMap remove method.
protected void	removeEntry(com.gemstone.gemfire.cache.Region aRegion, Object key) Destroy an entry in the given region using the ConcurrentMap remove API.
protected void	replace(com.gemstone.gemfire.cache.Region aRegion) Remove an existing entry in the given region.
protected void	replaceEntry(com.gemstone.gemfire.cache.Region aRegion, Object key) Replace an existing entry in the given region using the ConcurrentMap API.
protected void	updateEntry(com.gemstone.gemfire.cache.Region aRegion) Update an existing entry in the given region.
protected void	updateEntry(com.gemstone.gemfire.cache.Region aRegion, Object key) Update an existing entry in the given region.

Methods inherited from class util.OperationsClient

createLocatorTask, doEntryOperations, getNewKey, getOperation, getRecentKey, getUpdateObject, getValueForKey, initializeOperationsClient, remove, replace, startAndConnectLocatorTask, stopLocatorTask

Methods inherited from class java.lang.Object

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

Field Detail

testInstance

protected static ColocatedTxTest testInstance

Constructor Detail

ColocatedTxTest

public ColocatedTxTest()

Method Detail

HydraTask_initializeBridgeServer

public static void HydraTask_initializeBridgeServer()

initializeBridgeServer

protected void initializeBridgeServer()

HydraTask_initializeBridgeClient

public static void HydraTask_initializeBridgeClient()

initializeBridgeClient

protected void initializeBridgeClient()

HydraTask_initialize

public static void HydraTask_initialize()

Create the cache and Region (for peers). Check for forced disconnects (for gii tests)

initialize

protected void initialize()

HydraTask_populateRegions

public static void HydraTask_populateRegions()

populateRegions

protected void populateRegions()

registerFunctions

protected void registerFunctions()

HydraTask_doEntryOperations

public static void HydraTask_doEntryOperations()

Performs puts/gets on entries in TestRegion

doEntryOperations

protected void doEntryOperations()

getKeySet

protected KeySetResult getKeySet(com.gemstone.gemfire.cache.Region aRegion)

executeGetAllMembersInDS

protected List executeGetAllMembersInDS()

addEntry

protected void addEntry(com.gemstone.gemfire.cache.Region aRegion)

Add a new entry to the given region.

Overrides:

addEntry in class OperationsClient

Parameters:

aRegion - The region to use for adding a new entry.

putIfAbsent

protected void putIfAbsent(com.gemstone.gemfire.cache.Region aRegion)

Add a new entry to the given region using the ConcurrentMap putIfAbsent api

Parameters:

aRegion - The region to use for adding a new entry.

putIfAbsent

protected void putIfAbsent(com.gemstone.gemfire.cache.Region aRegion,
                           boolean logAddition)

Description copied from class: OperationsClient

ConcurrentMap API testing

Overrides:

putIfAbsent in class OperationsClient

invalidateEntry

protected void invalidateEntry(com.gemstone.gemfire.cache.Region aRegion,
                               boolean isLocalInvalidate)

Invalidate an entry in the given region.

Overrides:

invalidateEntry in class OperationsClient

Parameters:

aRegion - The region to use for invalidating an entry.

isLocalInvalidate - True if the invalidate should be local, false otherwise.

destroyEntry

protected void destroyEntry(com.gemstone.gemfire.cache.Region aRegion,
                            boolean isLocalDestroy)

Destroy an entry in the given region.

Overrides:

destroyEntry in class OperationsClient

Parameters:

aRegion - The region to use for destroying an entry.

isLocalDestroy - True if the destroy should be local, false otherwise.

remove

protected void remove(com.gemstone.gemfire.cache.Region aRegion)

Remove an entry in the given region using the ConcurrentMap remove method.

Overrides:

remove in class OperationsClient

Parameters:

aRegion - The region to use for removing an entry.

updateEntry

protected void updateEntry(com.gemstone.gemfire.cache.Region aRegion)

Update an existing entry in the given region. If there are no available keys in the region, then this is a noop.

Overrides:

updateEntry in class OperationsClient

Parameters:

aRegion - The region to use for updating an entry.

replace

protected void replace(com.gemstone.gemfire.cache.Region aRegion)

Remove an existing entry in the given region. If there are no available keys in the region, then this is a noop.

Overrides:

replace in class OperationsClient

Parameters:

aRegion - The region to use for updating an entry.

getKey

protected void getKey(com.gemstone.gemfire.cache.Region aRegion)

Get an existing key in the given region if one is available, otherwise get a new key.

Overrides:

getKey in class OperationsClient

Parameters:

aRegion - The region to use for getting an entry.

getNewKey

protected void getNewKey(com.gemstone.gemfire.cache.Region aRegion)

Get a new key in the given region.

Overrides:

getNewKey in class OperationsClient

Parameters:

aRegion - The region to use for getting an entry.

getExistingKeys

protected List getExistingKeys(com.gemstone.gemfire.cache.Region aRegion,
                               int numKeysToGet)

Overrides:

getExistingKeys in class OperationsClient

getExistingKey

protected Object getExistingKey(com.gemstone.gemfire.cache.Region aRegion)

Return a random key currently in the given region.

Overrides:

getExistingKey in class OperationsClient

Parameters:

aRegion - The region to use for getting an existing key

getNewKeyForRegion

protected Object getNewKeyForRegion(com.gemstone.gemfire.cache.Region aRegion)

Return a new key, never before used in the test. This must be on the same VM as the existing keySet

putAll

protected void putAll(com.gemstone.gemfire.cache.Region r)

putall a map to the given region. putAll when test is configured with sameKeyColocatedRegions = false (need to use keySets to create putAll map)

Overrides:

putAll in class OperationsClient

Parameters:

aRegion - The region to use for putall a map.

putAll

protected void putAll(com.gemstone.gemfire.cache.Region r,
                      Object[] keySet)

getExistingKeys

protected List getExistingKeys(com.gemstone.gemfire.cache.Region aRegion,
                               Object[] keySet,
                               int numKeysToGet)

doEntryOperations

protected void doEntryOperations(Object[] keySet)

Do random entry operations on the a key in the given keySet across all colocated regions. Note that addEntry and getNewKey() will create a new key in the same VM as the rest of the keySet. Note: All regions must be colocated at root level.

See Also:

- to target the same key across multiple colocated regions.

invalidateEntry

protected void invalidateEntry(com.gemstone.gemfire.cache.Region aRegion,
                               Object key,
                               boolean isLocalInvalidate)

Invalidate an entry in the given region.

Parameters:

aRegion - The region to use for invalidating an entry.

key - The key to invalidate

isLocalInvalidate - True if the invalidate should be local, false otherwise.

destroyEntry

protected void destroyEntry(com.gemstone.gemfire.cache.Region aRegion,
                            Object key,
                            boolean isLocalDestroy)

Destroy an entry in the given region.

Parameters:

aRegion - The region to use for destroying an entry.

isLocalDestroy - True if the destroy should be local, false otherwise.

removeEntry

protected void removeEntry(com.gemstone.gemfire.cache.Region aRegion,
                           Object key)

Destroy an entry in the given region using the ConcurrentMap remove API.

Parameters:

aRegion - The region to use for destroying an entry.

updateEntry

protected void updateEntry(com.gemstone.gemfire.cache.Region aRegion,
                           Object key)

Update an existing entry in the given region. If there are no available keys in the region, then this is a noop.

Parameters:

aRegion - The region to use for updating an entry.

replaceEntry

protected void replaceEntry(com.gemstone.gemfire.cache.Region aRegion,
                            Object key)

Replace an existing entry in the given region using the ConcurrentMap API. If there are no available keys in the region, then this is a noop.

Parameters:

aRegion - The region to use for updating an entry.

getKey

protected void getKey(com.gemstone.gemfire.cache.Region aRegion,
                      Object key)

Get an existing key in the given region if one is available, otherwise get a new key.

Parameters:

aRegion - The region to use for getting an entry.