RandInterestPolicyTest (GemFire XD Java API Documentation)

java.lang.Object
- hct.RandInterestPolicyTest

Direct Known Subclasses:: RandInterestPolicyTest

public class RandInterestPolicyTest
extends Object

Field Summary

Fields
Modifier and Type	Field and Description
`protected com.gemstone.gemfire.cache.Region`	`aRegion`
`protected int`	`concurrentLeaderTid`
`protected static String`	`createCallbackPrefix`
`protected static String`	`destroyCallbackPrefix`
`protected Set`	`destroyedKeys`
`protected static int`	`ENTRY_ADD_OPERATION`
`protected static int`	`ENTRY_DESTROY_OPERATION`
`protected static int`	`ENTRY_GET_NEW_OPERATION`
`protected static int`	`ENTRY_GET_OPERATION`
`protected static int`	`ENTRY_INVALIDATE_OPERATION`
`protected static int`	`ENTRY_LOCAL_DESTROY_OPERATION`
`protected static int`	`ENTRY_LOCAL_INVALIDATE_OPERATION`
`protected static int`	`ENTRY_UPDATE_OPERATION`
`static int`	`EQUAL`
`static int`	`EQUIVALENT`
`protected static String`	`getCallbackPrefix`
`protected static String`	`invalidateCallbackPrefix`
`protected boolean`	`isSerialExecution`
`protected int`	`lowerThreshold`
`protected long`	`minTaskGranularityMS`
`protected long`	`minTaskGranularitySec`
`protected int`	`numOpsPerTask`
`HydraThreadLocal`	`ownKeysIndex`
`protected static int`	`PUT_IF_ABSENT_OPERATION`
`protected RandomValues`	`randomValues`
`protected static String`	`REGION_NAME`
`protected static String`	`regionDestroyCallbackPrefix`
`protected static String`	`regionInvalidateCallbackPrefix`
`protected Map`	`regionSnapshot`
`protected static MethodCoordinator`	`registerInterestCoordinator`
`protected static int`	`REMOVE_OPERATION`
`protected static int`	`REPLACE_OPERATION`
`protected int`	`secondsToRun`
`protected long`	`taskStartTime`
`protected static RandInterestPolicyTest`	`testInstance`
`protected int`	`totalNumThreadsInTest`
`protected static String`	`updateCallbackPrefix`
`protected int`	`upperThreshold`
`protected boolean`	`useOwnKeys`

Constructor Summary

Constructors
Constructor and Description

RandInterestPolicyTest()

Constructors
Constructor and Description
`RandInterestPolicyTest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected Object`	`addEntry(com.gemstone.gemfire.cache.Region aRegion)` Add a new entry to the given region.
`protected void`	`checkForLastIteration()` Check if we have run for the desired length of time.
`protected static void`	`closeAndOpenRegion()` Close the region to prepare for the next registerInterest.
`protected void`	`concVerify()`
`protected void`	`createRegion()` Create the local scope region for bridge clients.
`protected void`	`destroyEntry(com.gemstone.gemfire.cache.Region aRegion, boolean isLocalDestroy)` Destroy an entry in the given region.
`protected void`	`doConcOpsAndVerify(boolean registerWithEmptyRegion)` Do random operations and verification for concurrent tests.
`protected void`	`doEntryOperations(com.gemstone.gemfire.cache.Region aRegion)` Do random entry operations on the given region ending either with minTaskGranularityMS or numOpsPerTask.
`protected void`	`doRROpsAndVerify()` Do random operations and verification for serial round robin test.
`protected Object`	`getExistingKey(com.gemstone.gemfire.cache.Region aRegion)` Return a random key currently in the given region.
`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
`protected void`	`getNewKey(com.gemstone.gemfire.cache.Region aRegion)` Get a new key int the given region.
`protected int`	`getOperation(Long whichPrm)` Get a random operation using the given hydra parameter.
`protected Object`	`getRecentKey(com.gemstone.gemfire.cache.Region aRegion, int recentHistory)` Return a random recently used key.
`protected BaseValueHolder`	`getUpdateObject(com.gemstone.gemfire.cache.Region aRegion, String key)` Return an object to be used to update the given key.
`protected BaseValueHolder`	`getValueForKey(Object key)` Return a value for the given key
`static void`	`HydraTask_doConcOpsAndVerify()` Hydra task method for concurrent tests with verification.
`static void`	`HydraTask_doEntryOps()` Hydra task method to do random entry operations.
`static void`	`HydraTask_doRROpsAndVerify()` Hydra task method for serial round robin tests.
`static void`	`HydraTask_initBridgeServer()` Initializes the test region in the cache server VM
`static void`	`HydraTask_initialize()` Creates and initializes the singleton instance of RandInterestPolicyTest in this VM.
`protected void`	`initializeInstance()` Initialize this test instance
`protected void`	`invalidateEntry(com.gemstone.gemfire.cache.Region aRegion, boolean isLocalInvalidate)` Invalidate an entry in the given region.
`protected static void`	`logExecutionNumber()` Log the execution number of this serial task.
`protected Object`	`putIfAbsent(com.gemstone.gemfire.cache.Region aRegion)` Add a new entry to the given region via putIfAbsent
`protected static void`	`registerInterest()` Register interest with ALL_KEYS, and policy KEYS_VALUES
`protected void`	`remove(com.gemstone.gemfire.cache.Region aRegion)` Remove an entry from the given region.
`protected void`	`replace(com.gemstone.gemfire.cache.Region aRegion)` Replace an existing entry in the given region.
`protected void`	`updateEntry(com.gemstone.gemfire.cache.Region aRegion)` Update an existing entry in the given region.
`protected static void`	`verifyContainsKey(com.gemstone.gemfire.cache.Region aRegion, Object key, boolean expected)` Verify containsKey for the given region and key.
`protected static void`	`verifyContainsValueForKey(com.gemstone.gemfire.cache.Region aRegion, Object key, boolean expected)` Verify containsValueForKey for the given region and key.
`protected void`	`verifyFromSnapshot()` Verify this thread's view of the keys and values in the region by reading the region snapshot and destroyed keys from the blackboad.
`protected static void`	`verifyMyValue(com.gemstone.gemfire.cache.Region aRegion, Object key, Object expectedValue, Object valueToCheck, int compareStrategy)` Verify that the given object is an instance of ValueHolder with expectedValue as the myValue field.
`protected static void`	`verifySize(com.gemstone.gemfire.cache.Region aRegion, int expectedSize)` Verify that the size of the given region is expectedSize.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - testInstance
```
protected static RandInterestPolicyTest testInstance
```
  - ENTRY_ADD_OPERATION
```
protected static final int ENTRY_ADD_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_DESTROY_OPERATION
```
protected static final int ENTRY_DESTROY_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_INVALIDATE_OPERATION
```
protected static final int ENTRY_INVALIDATE_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_LOCAL_DESTROY_OPERATION
```
protected static final int ENTRY_LOCAL_DESTROY_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_LOCAL_INVALIDATE_OPERATION
```
protected static final int ENTRY_LOCAL_INVALIDATE_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_UPDATE_OPERATION
```
protected static final int ENTRY_UPDATE_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_GET_OPERATION
```
protected static final int ENTRY_GET_OPERATION
```
    See Also:
    
    Constant Field Values
  - ENTRY_GET_NEW_OPERATION
```
protected static final int ENTRY_GET_NEW_OPERATION
```
    See Also:
    
    Constant Field Values
  - PUT_IF_ABSENT_OPERATION
```
protected static final int PUT_IF_ABSENT_OPERATION
```
    See Also:
    
    Constant Field Values
  - REMOVE_OPERATION
```
protected static final int REMOVE_OPERATION
```
    See Also:
    
    Constant Field Values
  - REPLACE_OPERATION
```
protected static final int REPLACE_OPERATION
```
    See Also:
    
    Constant Field Values
  - REGION_NAME
```
protected static final String REGION_NAME
```
    See Also:
    
    Constant Field Values
  - minTaskGranularitySec
```
protected long minTaskGranularitySec
```
  - minTaskGranularityMS
```
protected long minTaskGranularityMS
```
  - numOpsPerTask
```
protected int numOpsPerTask
```
  - isSerialExecution
```
protected boolean isSerialExecution
```
  - totalNumThreadsInTest
```
protected int totalNumThreadsInTest
```
  - randomValues
```
protected RandomValues randomValues
```
  - aRegion
```
protected com.gemstone.gemfire.cache.Region aRegion
```
  - upperThreshold
```
protected int upperThreshold
```
  - lowerThreshold
```
protected int lowerThreshold
```
  - concurrentLeaderTid
```
protected int concurrentLeaderTid
```
  - secondsToRun
```
protected int secondsToRun
```
  - taskStartTime
```
protected volatile long taskStartTime
```
  - regionSnapshot
```
protected Map regionSnapshot
```
  - destroyedKeys
```
protected Set destroyedKeys
```
  - useOwnKeys
```
protected boolean useOwnKeys
```
  - registerInterestCoordinator
```
protected static volatile MethodCoordinator registerInterestCoordinator
```
  - ownKeysIndex
```
public HydraThreadLocal ownKeysIndex
```
  - getCallbackPrefix
```
protected static final String getCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - createCallbackPrefix
```
protected static final String createCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - updateCallbackPrefix
```
protected static final String updateCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - invalidateCallbackPrefix
```
protected static final String invalidateCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - destroyCallbackPrefix
```
protected static final String destroyCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - regionInvalidateCallbackPrefix
```
protected static final String regionInvalidateCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - regionDestroyCallbackPrefix
```
protected static final String regionDestroyCallbackPrefix
```
    See Also:
    
    Constant Field Values
  - EQUAL
```
public static int EQUAL
```
  - EQUIVALENT
```
public static int EQUIVALENT
```
- Constructor Detail
  - RandInterestPolicyTest
```
public RandInterestPolicyTest()
```
- Method Detail
  - HydraTask_initialize
```
public static void HydraTask_initialize()
```
    Creates and initializes the singleton instance of RandInterestPolicyTest in this VM.
  - HydraTask_initBridgeServer
```
public static void HydraTask_initBridgeServer()
```
    Initializes the test region in the cache server VM
  - initializeInstance
```
protected void initializeInstance()
```
    Initialize this test instance
  - createRegion
```
protected void createRegion()
```
    Create the local scope region for bridge clients.
  - HydraTask_doRROpsAndVerify
```
public static void HydraTask_doRROpsAndVerify()
```
    Hydra task method for serial round robin tests.
  - HydraTask_doConcOpsAndVerify
```
public static void HydraTask_doConcOpsAndVerify()
```
    Hydra task method for concurrent tests with verification. Register interest occurs on a non-empty region.
  - HydraTask_doEntryOps
```
public static void HydraTask_doEntryOps()
```
    Hydra task method to do random entry operations.
  - doRROpsAndVerify
```
protected void doRROpsAndVerify()
```
    Do random operations and verification for serial round robin test. If this is the first task in the round, then do a random operation and record it to the blackboard. If this is not the first in the round, then verify this client's view of the operation done by the first thread in the round. If this is the last thread in the round, then do the verification and become the new first thread in the round by doing a random operation. Thus, a different thread in each round will do the random entry opertion. To summarize, the first thread in the round does this: execute ops record region state to blackboard close and reopen region The middle threads in the round do this: (these threads start from a region of size 0, no interest registered) register interest in all keys verify the state of the region against the blackboard close and reopen region The last thread in the round does this: (this thread start from a region of size 0, no interest registered) register interest in all keys verify the state of the region against the blackboard execute ops record region state to blackboard close and reopen region
  - doConcOpsAndVerify
```
protected void doConcOpsAndVerify(boolean registerWithEmptyRegion)
```
    Do random operations and verification for concurrent tests.
  - doEntryOperations
```
protected void doEntryOperations(com.gemstone.gemfire.cache.Region aRegion)
```
    Do random entry operations on the given region ending either with minTaskGranularityMS or numOpsPerTask. Uses HctPrms.entryOperations to determine the operations to execute.
  - addEntry
```
protected Object addEntry(com.gemstone.gemfire.cache.Region aRegion)
```
    Add a new entry to the given region.
    
    Parameters:
    
    aRegion - The region to use for adding a new entry.
  - invalidateEntry
```
protected void invalidateEntry(com.gemstone.gemfire.cache.Region aRegion,
                               boolean isLocalInvalidate)
```
    Invalidate an entry in the given region.
    
    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.
    
    Parameters:
    
    aRegion - The region to use for destroying an entry.
    
    isLocalDestroy - True if the destroy should be local, false otherwise.
  - putIfAbsent
```
protected Object putIfAbsent(com.gemstone.gemfire.cache.Region aRegion)
```
    Add a new entry to the given region via putIfAbsent
    
    Parameters:
    
    aRegion - The region to use for adding a new entry.
  - replace
```
protected void replace(com.gemstone.gemfire.cache.Region aRegion)
```
    Replace 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.
  - remove
```
protected void remove(com.gemstone.gemfire.cache.Region aRegion)
```
    Remove an entry from the given region.
    
    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.
    
    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.
    
    Parameters:
    
    aRegion - The region to use for getting an entry.
  - getNewKey
```
protected void getNewKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Get a new key int the given region.
    
    Parameters:
    
    aRegion - The region to use for getting an entry.
  - checkForLastIteration
```
protected void checkForLastIteration()
```
    Check if we have run for the desired length of time. We cannot use hydra's taskTimeSec parameter because of a small window of opportunity for the test to hang due to the test's "concurrent round robin" type of strategy. Here we set a blackboard counter if time is up and this is the last concurrent round.
  - getValueForKey
```
protected BaseValueHolder getValueForKey(Object key)
```
    Return a value for the given key
  - getNewKey
```
protected Object getNewKey()
```
    Return a new key
  - getRecentKey
```
protected Object getRecentKey(com.gemstone.gemfire.cache.Region aRegion,
                              int recentHistory)
```
    Return a random recently used key.
    
    Parameters:
    
    aRegion - The region to use for getting a recently used key.
    
    recentHistory - The number of most recently used keys to consider for returning.
  - getUpdateObject
```
protected BaseValueHolder getUpdateObject(com.gemstone.gemfire.cache.Region aRegion,
                                          String key)
```
    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()).
    
    Parameters:
    
    aRegion - The region which possible contains key.
    
    key - The key to get a new value for.
  - logExecutionNumber
```
protected static void logExecutionNumber()
```
    Log the execution number of this serial task.
  - getOperation
```
protected int getOperation(Long whichPrm)
```
    Get a random operation using the given hydra parameter.
    
    Parameters:
    
    whichPrm - A hydra parameter which specifies random operations.
  - verifyFromSnapshot
```
protected void verifyFromSnapshot()
```
    Verify this thread's view of the keys and values in the region by reading the region snapshot and destroyed keys from the blackboad.
  - concVerify
```
protected void concVerify()
```
  - verifySize
```
protected static void verifySize(com.gemstone.gemfire.cache.Region aRegion,
                                 int expectedSize)
```
    Verify that the size of the given region is expectedSize.
    
    Parameters:
    
    aRegion - The region to verify.
    
    expectedSize - The expected size of aRegion.
    
    Throws:
    
    TestException - if size() has the wrong value
  - getExistingKey
```
protected Object getExistingKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Return a random key currently in the given region.
    
    Parameters:
    
    aRegion - The region to use for getting an existing key.
  - verifyContainsKey
```
protected static void verifyContainsKey(com.gemstone.gemfire.cache.Region aRegion,
                                        Object key,
                                        boolean expected)
```
    Verify containsKey for the given region and key.
    
    Parameters:
    
    aRegion - The region to verify.
    
    key - The key in aRegion to verify.
    
    expected - The expected value of containsKey()
    
    Throws:
    
    TestException - if containsKey() has the wrong value
  - verifyContainsValueForKey
```
protected static void verifyContainsValueForKey(com.gemstone.gemfire.cache.Region aRegion,
                                                Object key,
                                                boolean expected)
```
    Verify containsValueForKey for the given region and key.
    
    Parameters:
    
    aRegion - The region to verify.
    
    key - The key in aRegion to verify.
    
    expected - The expected value of containsKey()
    
    Throws:
    
    TestException - if containsValueforKey() has the wrong value
  - verifyMyValue
```
protected static void verifyMyValue(com.gemstone.gemfire.cache.Region aRegion,
                                    Object key,
                                    Object expectedValue,
                                    Object valueToCheck,
                                    int compareStrategy)
```
    Verify that the given object is an instance of ValueHolder with expectedValue as the myValue field.
    
    Parameters:
    
    aRegion - The region to verify.
    
    key - The key in aRegion to verify.
    
    expectedValue - The expected myValue field of a ValueHolder in aRegion, or null if the expected value should be null.
    
    valuetoCheck - This is expected to be a ValueHolder, whose myValue field compares to expectedValue, according to comparStrategy
    
    compareStrategy - Whether the compare is equals or equivalent (for ValueHolders)
    
    Throws:
    
    TestException - if the result of a get on key does not have the expected value.
  - registerInterest
```
protected static void registerInterest()
```
    Register interest with ALL_KEYS, and policy KEYS_VALUES
  - closeAndOpenRegion
```
protected static void closeAndOpenRegion()
```
    Close the region to prepare for the next registerInterest. Reopens the region so it will exist for the next registerInterest or ops calls. When this is done, we have a newly initialized region with no keys and no keys registered.

Class RandInterestPolicyTest

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

testInstance

ENTRY_ADD_OPERATION

ENTRY_DESTROY_OPERATION

ENTRY_INVALIDATE_OPERATION

ENTRY_LOCAL_DESTROY_OPERATION

ENTRY_LOCAL_INVALIDATE_OPERATION

ENTRY_UPDATE_OPERATION

ENTRY_GET_OPERATION

ENTRY_GET_NEW_OPERATION

PUT_IF_ABSENT_OPERATION

REMOVE_OPERATION

REPLACE_OPERATION

REGION_NAME

minTaskGranularitySec

minTaskGranularityMS

numOpsPerTask

isSerialExecution

totalNumThreadsInTest

randomValues

aRegion

upperThreshold

lowerThreshold

concurrentLeaderTid

secondsToRun

taskStartTime

regionSnapshot

destroyedKeys

useOwnKeys

registerInterestCoordinator

ownKeysIndex

getCallbackPrefix

createCallbackPrefix

updateCallbackPrefix

invalidateCallbackPrefix

destroyCallbackPrefix

regionInvalidateCallbackPrefix

regionDestroyCallbackPrefix

EQUAL

EQUIVALENT

Constructor Detail

RandInterestPolicyTest

Method Detail

HydraTask_initialize

HydraTask_initBridgeServer

initializeInstance

createRegion

HydraTask_doRROpsAndVerify

HydraTask_doConcOpsAndVerify

HydraTask_doEntryOps

doRROpsAndVerify

doConcOpsAndVerify

doEntryOperations

addEntry

invalidateEntry

destroyEntry

putIfAbsent

replace

remove

updateEntry

getKey

getNewKey

checkForLastIteration

getValueForKey

getNewKey

getRecentKey

getUpdateObject

logExecutionNumber

getOperation

verifyFromSnapshot

concVerify

verifySize

getExistingKey

verifyContainsKey

verifyContainsValueForKey