AsyncMsgTest (GemFire XD Java API Documentation)

java.lang.Object
- asyncMsg.AsyncMsgTest

```
public class AsyncMsgTest
extends Object
```
A class to contain methods useful for all asyncMessaging functional tests.

Field Summary

Fields
Modifier and Type	Field and Description
`protected static AsyncMsgTest`	`asyncTest`
`protected int`	`concurrentLeaderTid`
`static String`	`DIST_ACK_REGION`
`static int`	`EQUAL`
`static int`	`EQUIVALENT`
`protected int`	`maxKeys`
`static int`	`NO_MIRRORING`
`static int`	`NO_MIRRORING_KV`
`static int`	`NO_MIRRORING_RESTRICTION`
`protected int`	`numPeerThreadsInTest`
`static int`	`numUpdatesThisRound`
`RandomValues`	`randomValues`
`static String`	`REGION_NAME`
`static String`	`SLEEP_KEY`

Constructor Summary

Constructors
Constructor and Description

AsyncMsgTest()

Constructors
Constructor and Description
`AsyncMsgTest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`clearDestroyedRegions()` Clear destroyed regions from the blackboard.
`static void`	`clearNumUpdatesThisRound()` clears counter for numUpdatesThisRound
`Operation`	`closeCache()` Closes the cache.
`void`	`createAllDestroyedRegions(boolean fill)` Creates all regions that currently don't exist.
`void`	`createDestroyedRegionsFromBB(boolean fill)` Creates all regions previously destroyed that were recorded in the AsyncMsgBB shared map entry AsyncMsgBB.DestroyedRegionsKey.
`static void`	`createDistAckRegion()` Creates a distAck region for use in coordinating between publisher and subscribers.
`Operation`	`createEntry(com.gemstone.gemfire.cache.Region aRegion)` Creates a new key/value in the given region by creating a new (never-used-before) key and a random value.
`static void`	`createLocatorTask()`
`Operation`	`createRegion()` Creates a region that was previously destroyed.
`void`	`createRegionHierarchy()` Create a forest of regions based on numRootRegions, numSubRegions, regionDepth
`Object[]`	`createRegionWithPath(String regionName, boolean fill)` Given a region name, return the region instance for it.
`Operation`	`destroyEntry(boolean isLocalDestroy, com.gemstone.gemfire.cache.Region aRegion, Object key)` Destroys an entry in aRegion.
`Operation`	`destroyRegion(boolean isLocalDestroy, com.gemstone.gemfire.cache.Region aRegion)` Destroys the given region.
`void`	`dispAllKeys()` Method to traverse tree & display all keys
`protected void`	`doConsumer()` Consumer in a mirrored VM.
`protected void`	`doControlledOperations()` Do random operations by honoring the lower and upper threshold settings.
`OpList`	`doOperations()` Do random operations on random regions using the hydra parameter AsyncMsgPrms.operations as the list of available operations and AsyncMsgPrms.numOps as the number of operations to do.
`OpList`	`doOperations(Vector operations, int numOperationsToDo)` Do random operations on random regions.
`protected void`	`doProducer()` Producer in a non-mirrored VM.
`void`	`doUpdates(com.gemstone.gemfire.cache.Region aRegion)` Do AsyncMsgPrms.numOps updates on an entry in the given region
`com.gemstone.gemfire.cache.CacheLoader`	`getCacheLoader()`
`com.gemstone.gemfire.cache.CacheWriter`	`getCacheWriter()`
`protected com.gemstone.gemfire.distributed.internal.DMStats`	`getDMStats()`
`Operation`	`getEntry(com.gemstone.gemfire.cache.Region aRegion, Object key, String opName)` Does a get with the given key.
`Operation`	`getEntryWithExistingKey(com.gemstone.gemfire.cache.Region aRegion)` Gets a value in aRegion with a key existing in aRegion.
`Operation`	`getEntryWithNewKey(com.gemstone.gemfire.cache.Region aRegion)` Gets a value in aRegion with a the next new (never-before_used) key.
`Operation`	`getEntryWithPreviousKey(com.gemstone.gemfire.cache.Region aRegion)` Gets a value in aRegion with a random key that was previously used in the test.
`BaseValueHolder`	`getNewValue(Object key)`
`Object`	`getRandomKey(com.gemstone.gemfire.cache.Region aRegion)` Get a random key from the given region.
`Object`	`getRandomKey(com.gemstone.gemfire.cache.Region aRegion, Object excludeKey)` Get a random key from the given region, excluding the key specified by excludeKey.
`com.gemstone.gemfire.cache.Region`	`getRandomRegion(boolean allowRootRegion)` Return a currently existing random region.
`com.gemstone.gemfire.cache.Region`	`getRandomRegion(boolean allowRootRegion, com.gemstone.gemfire.cache.Region excludeRegion, int restriction)` Return a currently existing random region.
`com.gemstone.gemfire.cache.Region`	`getRandomRegionNoMirroring(boolean allowRootRegion)` Return a currently existing random region that is not mirrored, nor is any of its subregion.
`com.gemstone.gemfire.cache.Region`	`getRandomRegionNoMirroringKV(boolean allowRootRegion)` Return a currently existing random region that is not mirrored with keys/values, nor is any of its subregions.
`RegionDefinition`	`getRegionDefFromBB(String fullPathOfRegion)` Given a full path for a region, return its RegionDefinition.
`Map`	`getRegionDefMap()` Get a map containing the RegionDefintions for this VM.
`Set`	`getSubregions(com.gemstone.gemfire.cache.Region aRegion, boolean recursive)` Return a Set of subregions of the given region, while handling regionDestroyedExceptions.
`static void`	`handlePossibleSlowReceiverException(Exception e)` Check for the possibility we were disconnected because of a slow receiver
`static void`	`HydraTask_asyncMsgVerifyRegionContents()` Hydra task to verify the keys and values in a region using keyIntervals.
`static void`	`HydraTask_checkForConflation()` verify that the publishing thread actually performed asyncConflation by using the DistributionStats (asyncConflatedMsgs)
`static void`	`HydraTask_createDistAckRegion()` Hydra task method to create a dist ack region.
`static void`	`HydraTask_createRegionForest()` Hydra task to create a forest of region hierarchies.
`static void`	`HydraTask_doConsumer()` Hydra task method for consumer for concurrent tests with verification.
`static void`	`HydraTask_doControlledOperations()` Hydra task method for consumer for concurrent tests with verification.
`static void`	`HydraTask_doOperations()` Do random operations on random regions using the hydra parameter operations as the list of available operations and AsyncMsgPrms.numOps as the number of operations to do.
`static void`	`HydraTask_doOperationsWithPrimedQueue()` Do random operations on random regions using the hydra parameter operations as the list of available operations and AsyncMsgPrms.numOps as the number of operations to do.
`static void`	`HydraTask_doProducer()` Hydra task method for producer for concurrent tests with verification.
`static void`	`HydraTask_doUpdatesWithPrimedQueue()` Do AsyncMsgPrms.numOps updates on a random region/entry (after priming the queue for asyncQueuing).
`static void`	`HydraTask_initConsumer()` Creates and initializes the singleton instance of AsyncMsgTest in this VM.
`static void`	`HydraTask_initialize()`
`static void`	`HydraTask_initProducer()` Creates and initializes the singleton instance of AsyncMsgTest in this VM.
`static void`	`HydraTask_initProducerConsumer()` Creates and initializes the singleton instance of AsyncMsgTest in this VM.
`static void`	`HydraTask_verifyEventCounters()` Hydra task to verify event counters.
`static void`	`HydraTask_verifyNoAsyncBufferWrites()` Hydra task method to ensure that no aync buffer writes have occurred.
`static void`	`HydraTask_verifyNonBlocking()` Hydra task to verify that operations concurrent to getInitialImage are non-blocking.
`static void`	`HydraTask_verifyQueuedMessages()` Hydra task method to ensure that messages have been queued.
`static void`	`HydraTask_verifyRegionContents()` HydraTask to for validation threads to verify that they have processed all messages in the OpList (saved in the BBoard by the putter thread Note that we must conflate the updates (or we'll try to verify intermediate state.
`static void`	`HydraTask_waitForEventsByPut()` Hydra task method to put into a dist ack region to cause all slow receivers to catch up.
`static int`	`incNumUpdatesThisRound()` increments numUpdatesThisRound
`void`	`initialize()`
`Operation`	`invalEntry(boolean isLocalInval, com.gemstone.gemfire.cache.Region aRegion, Object key)` Invalidates an entry in aRegion.
`Operation`	`invalRegion(boolean isLocalInval, com.gemstone.gemfire.cache.Region aRegion)` Invalidates the given region.
`boolean`	`isHierMirrored(com.gemstone.gemfire.cache.Region aRegion)` Return true if the region or any of its subregions is mirrored, return false otherwise.
`boolean`	`isHierMirroredKV(com.gemstone.gemfire.cache.Region aRegion)` Return true if the region or any of its subregions is mirrored with keys/values, return false otherwise.
`static void`	`logExecutionNumber()` Log the number of tasks that have been executed in this test.
`boolean`	`messagesQueued()`
`com.gemstone.gemfire.cache.Region`	`primeQueue()` Prime the Q by putting large objects (for distribution) use unique keys (so they don't get conflated).
`Operation`	`putEntry(com.gemstone.gemfire.cache.Region aRegion, Object key, BaseValueHolder value, String opName)` Puts a new key/value in the given region.
`void`	`putSleepKey(com.gemstone.gemfire.cache.Region aRegion, int sleepMs)`
`boolean`	`queuedMessagesConflated()`
`boolean`	`queueSizeExceeded()`
`boolean`	`queueTimeoutExceeded()`
`void`	`recordDestroyedRegion(com.gemstone.gemfire.cache.Region aRegion)` Save destroyed region(s) in the blackboard.
`void`	`recordRegionDefInBB(String fullPathOfRegion, RegionDefinition regDef)` Given a full path for a region, and its RegionDefinition instance, write it to the AsyncMsgBB blackboard shared map.
`static void`	`startLocatorAndAdminDSTask()`
`void`	`summarizeRegionHier()` Log the regions and the number of keys in each.
`Operation`	`updateEntry(com.gemstone.gemfire.cache.Region aRegion, Object key)` Updates an existing entry in aRegion.
`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 void`	`verifyNoAsyncBufferWrites()`
`protected void`	`verifyQueuedMessages()`
`void`	`verifyRegionContents()`
`static void`	`waitForEventsByPut()` Wait for all other vms to process their events by doing a put into an ack region.
`protected void`	`waitForEventsByTime()` Wait for all threads to report they have not received an event for NO_EVENTS_MILLIS milliseconds.
`protected void`	`writeSnapshot()` One thread in the producer VM writes the current state of the region to the blackboard.

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

- Field Detail
  - asyncTest
```
protected static AsyncMsgTest asyncTest
```
  - randomValues
```
public RandomValues randomValues
```
  - maxKeys
```
protected int maxKeys
```
  - concurrentLeaderTid
```
protected int concurrentLeaderTid
```
  - numPeerThreadsInTest
```
protected int numPeerThreadsInTest
```
  - SLEEP_KEY
```
public static final String SLEEP_KEY
```
    See Also:
    
    Constant Field Values
  - DIST_ACK_REGION
```
public static final String DIST_ACK_REGION
```
    See Also:
    
    Constant Field Values
  - NO_MIRRORING_RESTRICTION
```
public static final int NO_MIRRORING_RESTRICTION
```
    See Also:
    
    Constant Field Values
  - NO_MIRRORING
```
public static final int NO_MIRRORING
```
    See Also:
    
    Constant Field Values
  - NO_MIRRORING_KV
```
public static final int NO_MIRRORING_KV
```
    See Also:
    
    Constant Field Values
  - REGION_NAME
```
public static final String REGION_NAME
```
    See Also:
    
    Constant Field Values
  - numUpdatesThisRound
```
public static int numUpdatesThisRound
```
  - EQUAL
```
public static int EQUAL
```
  - EQUIVALENT
```
public static int EQUIVALENT
```
- Constructor Detail
  - AsyncMsgTest
```
public AsyncMsgTest()
```
- Method Detail
  - createLocatorTask
```
public static void createLocatorTask()
```
  - startLocatorAndAdminDSTask
```
public static void startLocatorAndAdminDSTask()
```
  - HydraTask_initialize
```
public static void HydraTask_initialize()
```
  - initialize
```
public void initialize()
```
  - HydraTask_createRegionForest
```
public static void HydraTask_createRegionForest()
```
    Hydra task to create a forest of region hierarchies. This task can be called from more than one thread in the same VM.
  - HydraTask_doOperationsWithPrimedQueue
```
public static void HydraTask_doOperationsWithPrimedQueue()
```
    Do random operations on random regions using the hydra parameter operations as the list of available operations and AsyncMsgPrms.numOps as the number of operations to do.
  - HydraTask_doUpdatesWithPrimedQueue
```
public static void HydraTask_doUpdatesWithPrimedQueue()
```
    Do AsyncMsgPrms.numOps updates on a random region/entry (after priming the queue for asyncQueuing).
  - HydraTask_doOperations
```
public static void HydraTask_doOperations()
```
    Do random operations on random regions using the hydra parameter operations as the list of available operations and AsyncMsgPrms.numOps as the number of operations to do.
  - HydraTask_checkForConflation
```
public static void HydraTask_checkForConflation()
```
    verify that the publishing thread actually performed asyncConflation by using the DistributionStats (asyncConflatedMsgs)
  - HydraTask_initProducer
```
public static void HydraTask_initProducer()
```
    Creates and initializes the singleton instance of AsyncMsgTest in this VM.
  - HydraTask_initConsumer
```
public static void HydraTask_initConsumer()
```
    Creates and initializes the singleton instance of AsyncMsgTest in this VM.
  - HydraTask_initProducerConsumer
```
public static void HydraTask_initProducerConsumer()
```
    Creates and initializes the singleton instance of AsyncMsgTest in this VM.
  - HydraTask_doProducer
```
public static void HydraTask_doProducer()
```
    Hydra task method for producer for concurrent tests with verification.
  - HydraTask_doConsumer
```
public static void HydraTask_doConsumer()
```
    Hydra task method for consumer for concurrent tests with verification.
  - HydraTask_doControlledOperations
```
public static void HydraTask_doControlledOperations()
```
    Hydra task method for consumer for concurrent tests with verification.
  - HydraTask_verifyQueuedMessages
```
public static void HydraTask_verifyQueuedMessages()
```
    Hydra task method to ensure that messages have been queued.
  - HydraTask_verifyNoAsyncBufferWrites
```
public static void HydraTask_verifyNoAsyncBufferWrites()
```
    Hydra task method to ensure that no aync buffer writes have occurred. Used to validate async messaging disabled in SSL tests
  - HydraTask_createDistAckRegion
```
public static void HydraTask_createDistAckRegion()
```
    Hydra task method to create a dist ack region.
  - HydraTask_waitForEventsByPut
```
public static void HydraTask_waitForEventsByPut()
```
    Hydra task method to put into a dist ack region to cause all slow receivers to catch up.
  - HydraTask_verifyNonBlocking
```
public static void HydraTask_verifyNonBlocking()
```
    Hydra task to verify that operations concurrent to getInitialImage are non-blocking.
  - HydraTask_verifyEventCounters
```
public static void HydraTask_verifyEventCounters()
```
    Hydra task to verify event counters.
  - HydraTask_asyncMsgVerifyRegionContents
```
public static void HydraTask_asyncMsgVerifyRegionContents()
```
    Hydra task to verify the keys and values in a region using keyIntervals.
  - logExecutionNumber
```
public static void logExecutionNumber()
```
    Log the number of tasks that have been executed in this test. Useful for debugging/analyzing serial execution tests.
  - createDistAckRegion
```
public static void createDistAckRegion()
```
    Creates a distAck region for use in coordinating between publisher and subscribers. When the publisher completes this operation, we know that all events have beeen processed. The publisher can then return and the validators can execute.
  - createRegionHierarchy
```
public void createRegionHierarchy()
```
    Create a forest of regions based on numRootRegions, numSubRegions, regionDepth
  - getRandomRegion
```
public com.gemstone.gemfire.cache.Region getRandomRegion(boolean allowRootRegion)
```
    Return a currently existing random region.
    
    Parameters:
    
    allowRootRegion - true if this call can return the root region, false otherwise.
    
    Returns:
    
    A random region, or null of none available.
  - getRandomRegionNoMirroring
```
public com.gemstone.gemfire.cache.Region getRandomRegionNoMirroring(boolean allowRootRegion)
```
    Return a currently existing random region that is not mirrored, nor is any of its subregion.
    
    Parameters:
    
    allowRootRegion - true if this call can return the root region, false otherwise.
    
    Returns:
    
    A random region, or null of none available.
  - getRandomRegionNoMirroringKV
```
public com.gemstone.gemfire.cache.Region getRandomRegionNoMirroringKV(boolean allowRootRegion)
```
    Return a currently existing random region that is not mirrored with keys/values, nor is any of its subregions.
    
    Parameters:
    
    allowRootRegion - true if this call can return the root region, false otherwise.
    
    Returns:
    
    A random region, or null of none available.
  - getRandomRegion
```
public com.gemstone.gemfire.cache.Region getRandomRegion(boolean allowRootRegion,
                                                         com.gemstone.gemfire.cache.Region excludeRegion,
                                                         int restriction)
```
    Return a currently existing random region.
    
    Parameters:
    
    allowRootRegion - true if this call can return the root region, false otherwise.
    
    excludeRegion - Return a region other than this region, or null if none to exclude.
    
    restriction - Restriction on what region can be returned, for example NO_MIRRORING_RESTRICTION, NO_MIRRORING, NO_MIRRORING_KV
    
    Returns:
    
    A random region, or null of none available.
  - dispAllKeys
```
public void dispAllKeys()
```
    Method to traverse tree & display all keys
  - summarizeRegionHier
```
public void summarizeRegionHier()
```
    Log the regions and the number of keys in each.
  - doUpdates
```
public void doUpdates(com.gemstone.gemfire.cache.Region aRegion)
```
    Do AsyncMsgPrms.numOps updates on an entry in the given region
  - doOperations
```
public OpList doOperations()
```
    Do random operations on random regions using the hydra parameter AsyncMsgPrms.operations as the list of available operations and AsyncMsgPrms.numOps as the number of operations to do.
  - doOperations
```
public OpList doOperations(Vector operations,
                           int numOperationsToDo)
```
    Do random operations on random regions.
    
    Parameters:
    
    operations - - a Vector of operations to choose from.
    
    numOperationsToDo - - the number of operations to execute.
  - createEntry
```
public Operation createEntry(com.gemstone.gemfire.cache.Region aRegion)
```
    Creates a new key/value in the given region by creating a new (never-used-before) key and a random value.
    
    Parameters:
    
    aRegion - The region to create the new key in.
    
    Returns:
    
    An instance of tx.Operation describing the create operation.
  - updateEntry
```
public Operation updateEntry(com.gemstone.gemfire.cache.Region aRegion,
                             Object key)
```
    Updates an existing entry in aRegion. The value in the key is increment by 1.
    
    Parameters:
    
    aRegion - The region to modify a key in.
    
    key - The key to modify.
    
    Returns:
    
    An instance of tx.Operation describing the update operation.
  - destroyEntry
```
public Operation destroyEntry(boolean isLocalDestroy,
                              com.gemstone.gemfire.cache.Region aRegion,
                              Object key)
```
    Destroys an entry in aRegion.
    
    Parameters:
    
    isLocalDestroy - True if the opertion is a local destroy, false otherwise.
    
    aRegion - The region to destroy the entry in.
    
    key - The key to destroy.
    
    Returns:
    
    An instance of tx.Operation describing the destroy operation.
  - invalEntry
```
public Operation invalEntry(boolean isLocalInval,
                            com.gemstone.gemfire.cache.Region aRegion,
                            Object key)
```
    Invalidates an entry in aRegion.
    
    Parameters:
    
    isLocalInval - True if the opertion is a local invalidate, false otherwise.
    
    aRegion - The region to invalidate the entry in.
    
    key - The key to invalidate.
    
    Returns:
    
    An instance of tx.Operation describing the invalidate operation.
  - getEntryWithExistingKey
```
public Operation getEntryWithExistingKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Gets a value in aRegion with a key existing in aRegion.
    
    Parameters:
    
    aRegion - The region to get from.
    
    Returns:
    
    An instance of tx.Operation describing the get operation.
  - getEntryWithPreviousKey
```
public Operation getEntryWithPreviousKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Gets a value in aRegion with a random key that was previously used in the test.
    
    Parameters:
    
    aRegion - The region to get from.
    
    Returns:
    
    An instance of tx.Operation describing the get operation.
  - getEntryWithNewKey
```
public Operation getEntryWithNewKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Gets a value in aRegion with a the next new (never-before_used) key.
    
    Parameters:
    
    aRegion - The region to get from.
    
    Returns:
    
    An instance of tx.Operation describing the get operation.
  - putEntry
```
public Operation putEntry(com.gemstone.gemfire.cache.Region aRegion,
                          Object key,
                          BaseValueHolder value,
                          String opName)
```
    Puts a new key/value in the given region.
    
    Parameters:
    
    aRegion - The region to create the new key in.
    
    key - The key to use for the put.
    
    value - The value to put.
    
    opName - The operation to use for the returned tx.Operation instance.
    
    Returns:
    
    An instance of tx.Operation describing the put operation.
  - getEntry
```
public Operation getEntry(com.gemstone.gemfire.cache.Region aRegion,
                          Object key,
                          String opName)
```
    Does a get with the given key.
    
    Parameters:
    
    aRegion - The region to create the new key in.
    
    key - The key to use for the put.
    
    opName - The operation to use for the returned tx.Operation instance.
    
    Returns:
    
    An instance of tx.Operation describing the get operation.
  - invalRegion
```
public Operation invalRegion(boolean isLocalInval,
                             com.gemstone.gemfire.cache.Region aRegion)
```
    Invalidates the given region.
    
    Parameters:
    
    isLocalInval - True if the opertion is a local invalidate, false otherwise.
    
    aRegion - The region to invalidate.
    
    Returns:
    
    An instance of tx.Operation describing the invalidate operation.
  - destroyRegion
```
public Operation destroyRegion(boolean isLocalDestroy,
                               com.gemstone.gemfire.cache.Region aRegion)
```
    Destroys the given region.
    
    Parameters:
    
    isLocalDestroy - True if the opertion is a local destroy, false otherwise.
    
    aRegion - The region to destroy.
    
    Returns:
    
    An instance of tx.Operation describing the destroy operation.
  - createRegion
```
public Operation createRegion()
```
    Creates a region that was previously destroyed. If this test is using the BB to track destroyed regions, then choose a region from the BB. Otherwise, look for a previously destroyed region by attempting to create all regions in the hierarchy until one is found to create. This is less efficient than getting the values from the blackboard, but the blackboard is used only for serial execution tests as it can't be maintained properly for concurrently execution tests.
    
    Returns:
    
    An instance of tx.Operation describing the destroy operation.
  - closeCache
```
public Operation closeCache()
```
    Closes the cache.
    
    Returns:
    
    An instance of tx.Operation describing the close operation.
  - getRandomKey
```
public Object getRandomKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Get a random key from the given region. If no keys are present in the region, return null.
    
    Parameters:
    
    aRegion - - The region to get the key from.
  - 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. This looks only for keys which begin with the prefix "Object_".
    
    Parameters:
    
    aRegion - - The region to get the key from.
    
    excludeKey - - The region to get the key from.
  - getCacheLoader
```
public com.gemstone.gemfire.cache.CacheLoader getCacheLoader()
```
  - getCacheWriter
```
public com.gemstone.gemfire.cache.CacheWriter getCacheWriter()
```
  - getNewValue
```
public BaseValueHolder getNewValue(Object key)
```
  - createRegionWithPath
```
public Object[] createRegionWithPath(String regionName,
                                     boolean fill)
```
    Given a region name, return the region instance for it. If the region with regionName currently does not exist, create it (and any parents required to create it).
    
    Parameters:
    
    regionName - - The full path name of a region.
    
    fill - - If true, then fill each created region with entries according to AsyncMsgPrms.maxEntries
  - clearDestroyedRegions
```
public void clearDestroyedRegions()
```
    Clear destroyed regions from the blackboard.
    
    Parameters:
    
    aRegion - The region being destroyed. Save it and all its children.
  - recordDestroyedRegion
```
public void recordDestroyedRegion(com.gemstone.gemfire.cache.Region aRegion)
```
    Save destroyed region(s) in the blackboard.
    
    Parameters:
    
    aRegion - The region being destroyed. Save it and all its children.
  - createDestroyedRegionsFromBB
```
public void createDestroyedRegionsFromBB(boolean fill)
```
    Creates all regions previously destroyed that were recorded in the AsyncMsgBB shared map entry AsyncMsgBB.DestroyedRegionsKey.
    
    Parameters:
    
    fill - True if each newly created region should be populated with entries according to AsyncMsgPrms.maxKeys
  - createAllDestroyedRegions
```
public void createAllDestroyedRegions(boolean fill)
```
    Creates all regions that currently don't exist.
    
    Parameters:
    
    fill - True if each newly created region should be populated with entries according to AsyncMsgPrms.maxKeys
  - isHierMirrored
```
public boolean isHierMirrored(com.gemstone.gemfire.cache.Region aRegion)
```
    Return true if the region or any of its subregions is mirrored, return false otherwise.
    
    Parameters:
    
    aRegion - The region parent to test for mirroring.
  - isHierMirroredKV
```
public boolean isHierMirroredKV(com.gemstone.gemfire.cache.Region aRegion)
```
    Return true if the region or any of its subregions is mirrored with keys/values, return false otherwise.
    
    Parameters:
    
    aRegion - The region parent to test for mirroring keys/values.
  - getSubregions
```
public Set getSubregions(com.gemstone.gemfire.cache.Region aRegion,
                         boolean recursive)
```
    Return a Set of subregions of the given region, while handling regionDestroyedExceptions.
    
    Parameters:
    
    aRegion - - The region to get subregions of.
    
    recursive - - If true, return all subregions, otherwise only aRegion's subregions.
  - getRegionDefMap
```
public Map getRegionDefMap()
```
    Get a map containing the RegionDefintions for this VM. Keys are the full path name for the region, values are the RegionDefinition.
  - recordRegionDefInBB
```
public void recordRegionDefInBB(String fullPathOfRegion,
                                RegionDefinition regDef)
```
    Given a full path for a region, and its RegionDefinition instance, write it to the AsyncMsgBB blackboard shared map. The shared map has one key per VM in the form: AsyncMsgBB.RegDefForPIDKey_xxxxx, where xxxxs is the PID for the current VM. The value for this key is a Map, containing the fullPathName for the key, and the RegionDefinition for the value. The blackboard must record the region definition for each VM (PID) because if any disk regions are used, disk dirs include the PID of the VM (so another VM with the same region name will use different disk dirs). The PID of the disk dirs is specified in util.RegionDefinition.
    
    Parameters:
    
    fullPathOfRegion - - the full path of the region to get the key for.
    
    regDef - - The RegionDefinition instance for fullPathOfRegion.
  - getRegionDefFromBB
```
public RegionDefinition getRegionDefFromBB(String fullPathOfRegion)
```
    Given a full path for a region, return its RegionDefinition. The shared map has one key per VM in the form: AsyncMsgBB.RegDefForPIDKey_xxxxx, where xxxxs is the PID for the current VM. The value for this key is a Map, containing the fullPathName for the key, and the RegionDefinition for the value. The blackboard must record the region definition for each VM (PID) because if any disk regions are used, disk dirs include the PID of the VM (so another VM with the same region name will use different disk dirs). The PID of the disk dirs is specified in util.RegionDefinition.
    
    Parameters:
    
    fullPathOfRegion - - the full path of the region to get the key for.
  - HydraTask_verifyRegionContents
```
public static void HydraTask_verifyRegionContents()
```
    HydraTask to for validation threads to verify that they have processed all messages in the OpList (saved in the BBoard by the putter thread Note that we must conflate the updates (or we'll try to verify intermediate state.
  - verifyRegionContents
```
public void verifyRegionContents()
```
  - primeQueue
```
public com.gemstone.gemfire.cache.Region primeQueue()
```
    Prime the Q by putting large objects (for distribution) use unique keys (so they don't get conflated).
  - getDMStats
```
protected com.gemstone.gemfire.distributed.internal.DMStats getDMStats()
```
  - verifyQueuedMessages
```
protected void verifyQueuedMessages()
```
  - verifyNoAsyncBufferWrites
```
protected void verifyNoAsyncBufferWrites()
```
  - messagesQueued
```
public boolean messagesQueued()
```
  - queuedMessagesConflated
```
public boolean queuedMessagesConflated()
```
  - queueSizeExceeded
```
public boolean queueSizeExceeded()
```
  - queueTimeoutExceeded
```
public boolean queueTimeoutExceeded()
```
  - putSleepKey
```
public void putSleepKey(com.gemstone.gemfire.cache.Region aRegion,
                        int sleepMs)
```
  - doProducer
```
protected void doProducer()
```
    Producer in a non-mirrored VM. 1) Do random operations. 2) Signal a pause when random ops are done. 3) Wait for consumers to report they are no longer receiving events. 4) Write a snapshot of the region to the blackboard. 5) Wait for consumer VMs to signal they have finished verification. After threads are done with verification, the task ends.
  - doConsumer
```
protected void doConsumer()
```
    Consumer in a mirrored VM. 1) Wait for the producer VM to finish its ops and pause. 2) Wait for all events to occur in this VM. 3) Wait for the producer VM to write the region snapshot to the BB. 4) Verify the current state of the mirrored VM against the BB. After all threads are done with verification, the task ends.
  - waitForEventsByTime
```
protected void waitForEventsByTime()
```
    Wait for all threads to report they have not received an event for NO_EVENTS_MILLIS milliseconds. This returns when the wait is complete.
  - waitForEventsByPut
```
public static void waitForEventsByPut()
```
    Wait for all other vms to process their events by doing a put into an ack region. When the put returns, all VMs have processed their events.
  - doControlledOperations
```
protected void doControlledOperations()
```
    Do random operations by honoring the lower and upper threshold settings. This controls the size of the region.
  - writeSnapshot
```
protected void writeSnapshot()
```
    One thread in the producer VM writes the current state of the region to the blackboard.
  - 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.
  - 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 - The value that is expected to be expectedValue.
    
    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.
  - 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
  - incNumUpdatesThisRound
```
public static int incNumUpdatesThisRound()
```
    increments numUpdatesThisRound
  - clearNumUpdatesThisRound
```
public static void clearNumUpdatesThisRound()
```
    clears counter for numUpdatesThisRound
  - handlePossibleSlowReceiverException
```
public static void handlePossibleSlowReceiverException(Exception e)
```
    Check for the possibility we were disconnected because of a slow receiver

Class AsyncMsgTest

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

asyncTest

randomValues

maxKeys

concurrentLeaderTid

numPeerThreadsInTest

SLEEP_KEY

DIST_ACK_REGION

NO_MIRRORING_RESTRICTION

NO_MIRRORING

NO_MIRRORING_KV

REGION_NAME

numUpdatesThisRound

EQUAL

EQUIVALENT

Constructor Detail

AsyncMsgTest

Method Detail

createLocatorTask

startLocatorAndAdminDSTask

HydraTask_initialize

initialize

HydraTask_createRegionForest

HydraTask_doOperationsWithPrimedQueue

HydraTask_doUpdatesWithPrimedQueue

HydraTask_doOperations

HydraTask_checkForConflation

HydraTask_initProducer

HydraTask_initConsumer

HydraTask_initProducerConsumer

HydraTask_doProducer

HydraTask_doConsumer

HydraTask_doControlledOperations

HydraTask_verifyQueuedMessages

HydraTask_verifyNoAsyncBufferWrites

HydraTask_createDistAckRegion

HydraTask_waitForEventsByPut

HydraTask_verifyNonBlocking

HydraTask_verifyEventCounters

HydraTask_asyncMsgVerifyRegionContents

logExecutionNumber

createDistAckRegion

createRegionHierarchy

getRandomRegion

getRandomRegionNoMirroring

getRandomRegionNoMirroringKV

getRandomRegion

dispAllKeys

summarizeRegionHier

doUpdates

doOperations

doOperations

createEntry

updateEntry

destroyEntry

invalEntry

getEntryWithExistingKey

getEntryWithPreviousKey

getEntryWithNewKey

putEntry

getEntry

invalRegion

destroyRegion

createRegion

closeCache

getRandomKey

getRandomKey

getCacheLoader

getCacheWriter

getNewValue

createRegionWithPath

clearDestroyedRegions

recordDestroyedRegion

createDestroyedRegionsFromBB

createAllDestroyedRegions