parReg.tx

Class CustomPartitionTest

java.lang.Object

util.OperationsClient

parReg.tx.CustomPartitionTest

Direct Known Subclasses:

PrTxCustomPartitionTest

public class CustomPartitionTest
extends OperationsClient

A simple test class that supports executing entry operations on a PartitionRegion while using a PartitionResolver: - callbackResolver (encodes a PidRoutingObject as CallbackArgument) - keyResolver (uses keys which are ModRoutingObjects) - PartitionResolver (ModPartitionResolver uses key to partition mod numVms) When using a callbackResolver, this test class also creates a routingRegion to map keys -> callbackArgs. When a new entry is added, the (key, callbackArg) mapping is saved in the routingRegion. This same callbackArg is retrieved and used as the callbackArg for any subsequent operations on key. In addition, with the CallbackResolver, a CallbackListener verifies that all events handled by the listener have CallbackArgs which route to the same RoutingObject (based on this VMs pid). Tasks available (executed via FunctionExecution): - ExecuteTx() - performs doEntryOperations as a tx (using FunctionService.onRegion()) CloseTasks available (which are executed via FunctionExecution) include: - GetAllMembersInDS (using FunctionService.onMembers()) - VerifyCustomPartitioningFunction (using FunctionService.onRegion())

Since:

6.1

See Also:

CallbackListener, ModRoutingObject, PidRoutingObject, ExecuteTx, VerifyCustomPartitioningFunction, GetAllMembersInDS

Field Summary

Fields

Modifier and Type	Field and Description
protected static CustomPartitionTest	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
CustomPartitionTest()

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	doEntryOperations()
protected void	executeGetAllMembersInDS(com.gemstone.gemfire.cache.execute.Function f)
protected void	executeTx(com.gemstone.gemfire.cache.Region aRegion, com.gemstone.gemfire.cache.execute.Function f)
protected void	executeVerifyCustomPartitioningFunction(com.gemstone.gemfire.internal.cache.PartitionedRegion pr, com.gemstone.gemfire.cache.execute.Function f)
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 Object	getNewKey() Return a new key, never before used in the test.
protected void	getNewKey(com.gemstone.gemfire.cache.Region aRegion) Get a new key in the given region.
protected BaseValueHolder	getUpdateObject(com.gemstone.gemfire.cache.Region aRegion, Object key) Return an object to be used to update the given key.
BaseValueHolder	getValueForKey(Object key) Return a value for the given key
static void	HydraTask_doEntryOperations() Performs puts/gets on entries in TestRegion
static void	HydraTask_executeGetAllMembersInDS() Execute GetAllMembersInDS method
static void	HydraTask_executeTx() Performs random tx operations via functionExecution on each member in DS
static void	HydraTask_executeVerifyCustomPartitioningFunction() Execute VerifyCustomPartitioningFunction on all PRs
static void	HydraTask_initialize() Create the cache and Region.
static void	HydraTask_populateRegions() Populate regions with entries.
protected void	initialize()
protected void	initializePrms()
protected void	invalidateEntry(com.gemstone.gemfire.cache.Region aRegion, boolean isLocalInvalidate) Invalidate an entry in the given region.
protected void	populateRegion(com.gemstone.gemfire.cache.Region aRegion)
protected void	putIfAbsent(com.gemstone.gemfire.cache.Region aRegion, boolean logAddition) Add a new entry to the given region using the ConcurrentMap putIfAbsent method.
protected void	registerFunctions()
protected void	remove(com.gemstone.gemfire.cache.Region aRegion) Destroy an entry in the given region using the ConcurrentMap remove method.
protected void	replace(com.gemstone.gemfire.cache.Region aRegion) Replace an existing entry in the given region using the ConcurrentMap replace method.
protected void	updateEntry(com.gemstone.gemfire.cache.Region aRegion) Update an existing entry in the given region.

Methods inherited from class util.OperationsClient

createLocatorTask, doEntryOperations, getExistingKey, getExistingKeys, getOperation, getRecentKey, initializeOperationsClient, putAll, 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 CustomPartitionTest testInstance

Constructor Detail

CustomPartitionTest

public CustomPartitionTest()

Method Detail

HydraTask_initialize

public static void HydraTask_initialize()

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

initialize

protected void initialize()

registerFunctions

protected void registerFunctions()

initializePrms

protected void initializePrms()

HydraTask_populateRegions

public static void HydraTask_populateRegions()

Populate regions with entries. The test relies on being able to find the routing information via hashCode, so we'll need some data in all VMs prior to the executeTx task (which does an onRegion(pr).withFilter(key)).

populateRegion

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

HydraTask_doEntryOperations

public static void HydraTask_doEntryOperations()

Performs puts/gets on entries in TestRegion

doEntryOperations

protected void doEntryOperations()

HydraTask_executeTx

public static void HydraTask_executeTx()

Performs random tx operations via functionExecution on each member in DS

executeTx

protected void executeTx(com.gemstone.gemfire.cache.Region aRegion,
                         com.gemstone.gemfire.cache.execute.Function f)

HydraTask_executeGetAllMembersInDS

public static void HydraTask_executeGetAllMembersInDS()

Execute GetAllMembersInDS method

executeGetAllMembersInDS

protected void executeGetAllMembersInDS(com.gemstone.gemfire.cache.execute.Function f)

HydraTask_executeVerifyCustomPartitioningFunction

public static void HydraTask_executeVerifyCustomPartitioningFunction()

Execute VerifyCustomPartitioningFunction on all PRs

executeVerifyCustomPartitioningFunction

protected void executeVerifyCustomPartitioningFunction(com.gemstone.gemfire.internal.cache.PartitionedRegion pr,
                                                       com.gemstone.gemfire.cache.execute.Function f)

getNewKey

protected Object getNewKey()

Description copied from class: OperationsClient

Return a new key, never before used in the test.

Overrides:

getNewKey in class OperationsClient

getValueForKey

public BaseValueHolder getValueForKey(Object key)

Description copied from class: OperationsClient

Return a value for the given key

Overrides:

getValueForKey in class OperationsClient

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,
                           boolean logAddition)

Add a new entry to the given region using the ConcurrentMap putIfAbsent method.

Overrides:

putIfAbsent in class OperationsClient

Parameters:

aRegion - The region to use for adding a new entry. Note: Cannot be used with CALLBACK_RESOLVER (callbacks not yet supported). A TestException will be thrown in this case.

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)

Destroy 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.

getUpdateObject

protected BaseValueHolder getUpdateObject(com.gemstone.gemfire.cache.Region aRegion,
                                          Object key)

Description copied from class: OperationsClient

Return an object to be used to update the given key. If the value for the key is a ValueHolder, then get an alternate value which is similar to it's previous value (see ValueHolder.getAlternateValueHolder()).

Overrides:

getUpdateObject in class OperationsClient

Parameters:

aRegion - The region which possible contains key.

key - The key to get a new value for.

replace

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

Replace an existing entry in the given region using the ConcurrentMap replace method. 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. ConcurrentMap methods currently do not support callbacks, so this operation may not be used for customResolverMethod.CALLBACK_RESOLVER. A TestException will be thrown in this case.

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.