DeltaTest (GemFire XD Java API Documentation)

java.lang.Object
- delta.DeltaTest

```
public class DeltaTest
extends Object
```

Field Summary

Fields
Modifier and Type	Field and Description
`com.gemstone.gemfire.cache.Region`	`aRegion`
`protected Set<String>`	`before_inVMSet`
`protected long`	`before_numBytesInThisVM`
`protected Set<String>`	`before_onDiskSet`
`protected long`	`before_stat_entriesInVM`
`protected long`	`before_stat_lruEvictions`
`protected long`	`before_stat_numOverflowOnDisk`
`protected Map<String,Integer>`	`beforeMap`
`protected boolean`	`cacheIsClosed`
`protected static MethodCoordinator`	`concVerifyCoordinator`
`protected static String`	`createCallbackPrefix`
`protected String`	`currentKeyListKey`
`protected static String`	`destroyCallbackPrefix`
`protected boolean`	`disconnected`
`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_MODIFY_VALUE`
`protected static int`	`ENTRY_UPDATE_OPERATION`
`protected static String`	`fromDeltaKey`
`protected static String`	`fullDistribution`
`protected static String`	`getCallbackPrefix`
`protected static String`	`hasDeltaKey`
`protected boolean`	`highAvailability`
`protected static String`	`invalidateCallbackPrefix`
`boolean`	`isBridgeClient`
`boolean`	`isBridgeConfiguration`
`protected boolean`	`isSerialExecution`
`protected int`	`lowerThreshold`
`protected long`	`minTaskGranularityMS`
`protected long`	`minTaskGranularitySec`
`protected List<com.gemstone.gemfire.cache.Region>`	`multiRegionList`
`protected int`	`numberOfCycles`
`protected int`	`numFieldsToModify`
`protected int`	`numOpsPerTask`
`protected int`	`numQueriesPerClientVM`
`protected int`	`numThreadsInClients`
`protected int`	`numThreadsInThisVM`
`protected String`	`opKey`
`protected List<Long>`	`overageHistory`
`protected int`	`redundantCopies`
`protected static String`	`redundantCopiesKey`
`protected static String`	`regionDestroyCallbackPrefix`
`protected static String`	`regionInvalidateCallbackPrefix`
`protected Map`	`regionSnapshot`
`protected static String`	`regionSnapshotKey`
`protected int`	`secondsToRun`
`static DeltaTest`	`testInstance`
`protected static String`	`toDeltaKey`
`HydraThreadLocal`	`uniqueKeyIndex`
`protected boolean`	`uniqueKeys`
`protected static String`	`updateCallbackPrefix`
`protected List`	`updatedKeys`
`protected static String`	`updatedKeysKey`
`protected static String`	`updatedKeysNotDistKey`
`protected List`	`updatedKeysNotDistributed`
`protected List`	`updatedKeysWithDelta`
`protected static String`	`updatedKeysWithDeltaKey`
`protected int`	`upperThreshold`

Constructor Summary

Constructors
Constructor and Description

DeltaTest()

Constructors
Constructor and Description
`DeltaTest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected Object`	`addEntry(com.gemstone.gemfire.cache.Region aReg)` Add a new entry to the given region.
`protected String`	`addNewValue()` Add a new entry for eviction tests
`protected void`	`badDeltaController(int testCase)` Test the given bad delta test case.
`protected void`	`checkEviction()` Check eviction in this vm for a particular key (the last operation).
`protected static void`	`checkForError()` Check for any errors written to the bb
`protected void`	`checkForLastIteration()` Check if we have run for the desired length of time.
`protected long`	`checkMemLRULevelForPR()` Iterates over all the entries hosted in this vm and calculates their bytes.
`protected void`	`checkOverageHistory()` This is called from a close task to allow the test to hit bug 41952 and report its occurrence in a close task.
`protected void`	`clear()` Clear variables that save up information for validation.
`protected void`	`concVerify()` Create a region snapshot from one vm's point of view, while any other threads in this or the same the vm also executing this method will compare to that snapshot.
`protected void`	`destroyEntry(com.gemstone.gemfire.cache.Region aReg, boolean isLocalDestroy)` Destroy an entry in the given region.
`protected void`	`doConcOpsAndVerify()` Do random operations and verification for concurrent tests.
`protected void`	`doEntryOperations(com.gemstone.gemfire.cache.Region aReg)` Do random entry operations on the given region ending either with minTaskGranularityMS or numOpsPerTask.
`protected void`	`doEvictionTestOps()` Do operations for eviction tests
`protected void`	`doRROpsAndVerify()` Do random operations and verification for serial round robin test.
`void`	`doSerialRREvictionTest()` Serial test for eviction with careful validation
`protected void`	`evictionTestLoad(com.gemstone.gemfire.cache.Region aReg)` Load the region with N entries, specified by DeltaPropagationPrms.upperThreshold.
`static Object`	`getExistingKey(com.gemstone.gemfire.cache.Region aRegion, boolean uniqueKeys, int numThreads)` Return a random key currently in the given region.
`protected void`	`getKey(com.gemstone.gemfire.cache.Region aReg)` Get an existing key in the given region if one is available, otherwise get a new key.
`protected Object`	`getKeyForBadDeltaTest()` For bad delta tests: Get a key that will be distributed for an update.
`protected Object`	`getNewKey()` Return a new key, never before used in the test.
`protected void`	`getNewKey(com.gemstone.gemfire.cache.Region aReg)` Get a new key int the given region.
`protected int`	`getOperation(Long whichPrm)` Get a random operation using the given hydra parameter.
`protected void`	`HAController()` While other threads are doing ops, stop or close the region of servers (not clients), reinstate the servers/regions, pause and verify.
`protected void`	`HADoEntryOps()` Do entry ops and handle disconnects or cache closes.
`protected void`	`handleBadDeltaException(Class expected, Throwable got, boolean expectedIsFromRemoteVM)` Look for expected exception returned from remote vm.
`protected void`	`handleBadDeltaSuccessfulUpdate(int badDeltaTestCase, Class expectedExceptionClass, Object key, BadDeltaObject value)` Handle the case where a bad delta was invoked, but the delta update (the put) succeeded.
`protected void`	`handleException(Exception anExcept)` Handle an exception thrown by doing general operations during HA.
`static void`	`HydraTask_badDeltaController()` Hydra task method for serial tests with bad delta implementations.
`static void`	`HydraTask_checkMemLRULevelForPR()` Hydra task method to check the memLRU levels in a vm.
`static void`	`HydraTask_checkOverageHistory()` Hydra task method to check the overages found because of bug 41952.
`static void`	`HydraTask_doConcOps()` Hydra task method for concurrent tests with verification.
`static void`	`HydraTask_doConcOpsAndVerify()` Hydra task method for concurrent tests with verification.
`static void`	`HydraTask_doConcOpsWithMultiRegions()` Hydra task method for concurrent tests with verification.
`static void`	`HydraTask_doMixedTest()`
`static void`	`HydraTask_doRROpsAndVerify()` Hydra task method for serial round robin tests.
`static void`	`HydraTask_doSerialRREvictionTest()` Hydra task method for eviction tests with delta.
`static void`	`HydraTask_evictionTestLoad()` Hydra task method to load the region with N entries, specified by DeltaPropagationPrms.upperThreshold.
`static void`	`HydraTask_HAController()` Hydra task method to control VMs going down/up one at a time.
`static void`	`HydraTask_HADoEntryOps()` Hydra task method to do random entry operations.
`static void`	`HydraTask_initializeBridgeServer()` Creates and initializes a bridge server.
`static void`	`HydraTask_initializeClient()` Creates and initializes the singleton instance of DeltaTest in a client.
`static void`	`HydraTask_initMultiRegions()` Create several root regions with various data policies.
`static void`	`HydraTask_initMultiRegionsForClients()` Create several root regions for clients in a bridge configuration.
`static void`	`HydraTask_initRedundantCopies()` Write the number of redundant copies for the pr to the blackboard by using the hydra param DeltaPropagationPrms.redundantCopies, which can be: "zero" - Write 0 to the blackboard.
`static void`	`HydraTask_loadBadDeltaToUpperThreshold()` Hydra task method to load the region with N entries, specified by DeltaPropagationPrms.upperThreshold.
`static void`	`HydraTask_loadMultiRegToUpperThreshold()` Hydra task method to load the regions with N entries, specified by DeltaPropagationPrms.upperThreshold.
`static void`	`HydraTask_loadToUpperThreshold()` Hydra task method to load the region with N entries, specified by DeltaPropagationPrms.upperThreshold.
`static void`	`HydraTask_recordLoadToBB()` Hydra task method to follow HydraTask_loadToUpperThreshold to get the current state of the region recorded to the BB for serial tests.
`static void`	`HydraTask_verifyNoDeltaCalls()` Verify that no delta calls have occurred
`void`	`initializeInstance()` Initialize instance fields of this test class
`com.gemstone.gemfire.cache.Region`	`initializeRegion(String regDescriptName)` Create a region with the given region description name.
`protected void`	`invalidateEntry(com.gemstone.gemfire.cache.Region aReg, boolean isLocalInvalidate)` Invalidate an entry in the given region.
`protected boolean`	`isBadDeltaWarningCase(int testCase)` Return true if a delta put in this vm is the case where a warning is logged.
`protected static String`	`keysToString(Collection listOfKeys)` Logs a Collection of keys, inserting line breaks for large key lists.
`protected void`	`loadToUpperThreshold(com.gemstone.gemfire.cache.Region aReg)` Load the region with N entries, specified by DeltaPropagationPrms.upperThreshold.
`protected static void`	`logExecutionNumber()` Log the execution number of this serial task.
`static void`	`logPRMembers(com.gemstone.gemfire.cache.Region reg, Object key)` Log primary and secondary members for the key and value for this event
`protected boolean`	`modifyDeltaObject(DeltaObject anObj)` Modify 1 or more primitive fields of the given DeltaObject.
`protected void`	`recordLoadToBB()` Record the state of the region to the blackbloard for serial tests.
`protected static void`	`registerInterest(com.gemstone.gemfire.cache.Region aRegion)` Register interest with ALL_KEYS, and InterestPolicyResult = KEYS_VALUES which is equivalent to a full GII.
`protected void`	`saveEvictionStats(long numBytesInVM)` Make the current values the before values
`protected boolean`	`thisVMHostsKey(com.gemstone.gemfire.cache.Region aReg, Object key)` Return true if the region hosts the key in this vm.
`protected void`	`trackUpdate(com.gemstone.gemfire.cache.Region aReg, Object key, boolean isDeltaDistribution)` Update tracking of updated keys to be used for later validation
`protected Object[]`	`updateDeltaValueHolder(List currentKeyList)` Perform an update on an existing key.
`protected void`	`updateEntry(com.gemstone.gemfire.cache.Region aReg)` Update an existing entry in the given region.
`protected void`	`verifyDeltaBehavior()` Verify that the delta behavior was correct (toDelta/fromDelta was called and NOT called when appropriate, and cloning was handled correctly).
`protected static void`	`verifyDeltaCalls(int vmID, List deltaKeys, String whichDelta, List expectedKeys)` Verify that the given deltaKeys are expected.
`protected void`	`verifyEviction()` Verify eviction (both for all entries in the cache and for the last operation
`protected void`	`verifyNoUpdates()` Verify that no updates have occured.
`protected void`	`verifyRegionContents(Map expected)` Verify the state of the region and the given expected snapshot.
`protected void`	`verifyValue(Object key, BadDeltaObject expectedValue)` Verify that the given key has the given value.
`protected void`	`writeDeltaInfoToBlackboard()` Write this vm's delta and cloning information to the blackboard to be used later for verification.

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

- Field Detail
  - testInstance
```
public static DeltaTest testInstance
```
  - redundantCopiesKey
```
protected static final String redundantCopiesKey
```
    See Also:
    
    Constant Field Values
  - toDeltaKey
```
protected static final String toDeltaKey
```
    See Also:
    
    Constant Field Values
  - fromDeltaKey
```
protected static final String fromDeltaKey
```
    See Also:
    
    Constant Field Values
  - hasDeltaKey
```
protected static final String hasDeltaKey
```
    See Also:
    
    Constant Field Values
  - updatedKeysKey
```
protected static final String updatedKeysKey
```
    See Also:
    
    Constant Field Values
  - updatedKeysWithDeltaKey
```
protected static final String updatedKeysWithDeltaKey
```
    See Also:
    
    Constant Field Values
  - updatedKeysNotDistKey
```
protected static final String updatedKeysNotDistKey
```
    See Also:
    
    Constant Field Values
  - regionSnapshotKey
```
protected static final String regionSnapshotKey
```
    See Also:
    
    Constant Field Values
  - minTaskGranularitySec
```
protected long minTaskGranularitySec
```
  - minTaskGranularityMS
```
protected long minTaskGranularityMS
```
  - numOpsPerTask
```
protected int numOpsPerTask
```
  - isBridgeConfiguration
```
public boolean isBridgeConfiguration
```
  - isBridgeClient
```
public boolean isBridgeClient
```
  - numThreadsInClients
```
protected int numThreadsInClients
```
  - aRegion
```
public com.gemstone.gemfire.cache.Region aRegion
```
  - uniqueKeyIndex
```
public HydraThreadLocal uniqueKeyIndex
```
  - isSerialExecution
```
protected boolean isSerialExecution
```
  - highAvailability
```
protected boolean highAvailability
```
  - upperThreshold
```
protected int upperThreshold
```
  - lowerThreshold
```
protected int lowerThreshold
```
  - uniqueKeys
```
protected boolean uniqueKeys
```
  - numQueriesPerClientVM
```
protected int numQueriesPerClientVM
```
  - secondsToRun
```
protected int secondsToRun
```
  - cacheIsClosed
```
protected boolean cacheIsClosed
```
  - disconnected
```
protected boolean disconnected
```
  - numThreadsInThisVM
```
protected int numThreadsInThisVM
```
  - numFieldsToModify
```
protected int numFieldsToModify
```
  - multiRegionList
```
protected List<com.gemstone.gemfire.cache.Region> multiRegionList
```
  - updatedKeys
```
protected List updatedKeys
```
  - updatedKeysWithDelta
```
protected List updatedKeysWithDelta
```
  - updatedKeysNotDistributed
```
protected List updatedKeysNotDistributed
```
  - numberOfCycles
```
protected int numberOfCycles
```
  - redundantCopies
```
protected int redundantCopies
```
  - regionSnapshot
```
protected Map regionSnapshot
```
  - before_stat_entriesInVM
```
protected long before_stat_entriesInVM
```
  - before_stat_numOverflowOnDisk
```
protected long before_stat_numOverflowOnDisk
```
  - before_numBytesInThisVM
```
protected long before_numBytesInThisVM
```
  - before_stat_lruEvictions
```
protected long before_stat_lruEvictions
```
  - beforeMap
```
protected Map<String,Integer> beforeMap
```
  - before_inVMSet
```
protected Set<String> before_inVMSet
```
  - before_onDiskSet
```
protected Set<String> before_onDiskSet
```
  - opKey
```
protected String opKey
```
  - currentKeyListKey
```
protected String currentKeyListKey
```
  - overageHistory
```
protected List<Long> overageHistory
```
  - 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
  - ENTRY_MODIFY_VALUE
```
protected static final int ENTRY_MODIFY_VALUE
```
    See Also:
    
    Constant Field Values
  - 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
  - fullDistribution
```
protected static final String fullDistribution
```
    See Also:
    
    Constant Field Values
  - concVerifyCoordinator
```
protected static volatile MethodCoordinator concVerifyCoordinator
```
- Constructor Detail
  - DeltaTest
```
public DeltaTest()
```
- Method Detail
  - HydraTask_initializeClient
```
public static void HydraTask_initializeClient()
```
    Creates and initializes the singleton instance of DeltaTest in a client.
  - HydraTask_initializeBridgeServer
```
public static void HydraTask_initializeBridgeServer()
```
    Creates and initializes a bridge server.
  - initializeRegion
```
public com.gemstone.gemfire.cache.Region initializeRegion(String regDescriptName)
```
    Create a region with the given region description name.
    
    Parameters:
    
    regDescriptName - The name of a region description.
  - initializeInstance
```
public void initializeInstance()
```
    Initialize instance fields of this test class
  - HydraTask_initMultiRegions
```
public static void HydraTask_initMultiRegions()
```
    Create several root regions with various data policies. Used in test configurations that don't support delta to make sure delta is not called.
  - HydraTask_initMultiRegionsForClients
```
public static void HydraTask_initMultiRegionsForClients()
```
    Create several root regions for clients in a bridge configuration.
  - 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.
  - HydraTask_doConcOps
```
public static void HydraTask_doConcOps()
```
    Hydra task method for concurrent tests with verification.
  - HydraTask_doConcOpsWithMultiRegions
```
public static void HydraTask_doConcOpsWithMultiRegions()
```
    Hydra task method for concurrent tests with verification.
  - HydraTask_HADoEntryOps
```
public static void HydraTask_HADoEntryOps()
```
    Hydra task method to do random entry operations.
  - HydraTask_HAController
```
public static void HydraTask_HAController()
```
    Hydra task method to control VMs going down/up one at a time.
  - HydraTask_loadBadDeltaToUpperThreshold
```
public static void HydraTask_loadBadDeltaToUpperThreshold()
```
    Hydra task method to load the region with N entries, specified by DeltaPropagationPrms.upperThreshold.
  - HydraTask_loadToUpperThreshold
```
public static void HydraTask_loadToUpperThreshold()
```
    Hydra task method to load the region with N entries, specified by DeltaPropagationPrms.upperThreshold.
  - HydraTask_evictionTestLoad
```
public static void HydraTask_evictionTestLoad()
```
    Hydra task method to load the region with N entries, specified by DeltaPropagationPrms.upperThreshold.
  - HydraTask_loadMultiRegToUpperThreshold
```
public static void HydraTask_loadMultiRegToUpperThreshold()
```
    Hydra task method to load the regions with N entries, specified by DeltaPropagationPrms.upperThreshold.
  - HydraTask_recordLoadToBB
```
public static void HydraTask_recordLoadToBB()
```
    Hydra task method to follow HydraTask_loadToUpperThreshold to get the current state of the region recorded to the BB for serial tests.
  - HydraTask_initRedundantCopies
```
public static void HydraTask_initRedundantCopies()
```
    Write the number of redundant copies for the pr to the blackboard by using the hydra param DeltaPropagationPrms.redundantCopies, which can be: "zero" - Write 0 to the blackboard. "nonZero" - Randomly choose 1, 2 or 3 and write to the blackboard.
  - HydraTask_verifyNoDeltaCalls
```
public static void HydraTask_verifyNoDeltaCalls()
```
    Verify that no delta calls have occurred
  - HydraTask_badDeltaController
```
public static void HydraTask_badDeltaController()
```
    Hydra task method for serial tests with bad delta implementations.
  - HydraTask_doMixedTest
```
public static void HydraTask_doMixedTest()
```
  - HydraTask_doSerialRREvictionTest
```
public static void HydraTask_doSerialRREvictionTest()
```
    Hydra task method for eviction tests with delta.
  - HydraTask_checkMemLRULevelForPR
```
public static void HydraTask_checkMemLRULevelForPR()
```
    Hydra task method to check the memLRU levels in a vm.
  - HydraTask_checkOverageHistory
```
public static void HydraTask_checkOverageHistory()
```
    Hydra task method to check the overages found because of bug 41952.
  - doRROpsAndVerify
```
protected void doRROpsAndVerify()
```
    Do random operations and verification for serial round robin test. A test cycle takes to round robin rounds to complete. First round of cycle: - If this is the first task in the round, then do random operations and record region state and delta information to the blackboard. - If this is not the first in the round, then write the delta information from this vm collected during the ops phase to the blackboard. Second round of cycle: - verify region contents and delta behavior - If last in this round, become first in the round for the next cycle and do ops, etc.
  - doConcOpsAndVerify
```
protected void doConcOpsAndVerify()
```
    Do random operations and verification for concurrent tests. The task starts up and all threads concurrently do random operations. The operations run for maxTaskGranularitySec or numOpsPerTask, depending the on the defined hydra parameters, then all threads will pause. During the pause, one thread goes first and writes the regionSnapshot to the blackboard. Then all other client threads read the blackboard and verify. After all threads are done with verification, the task ends.
  - HAController
```
protected void HAController()
```
    While other threads are doing ops, stop or close the region of servers (not clients), reinstate the servers/regions, pause and verify. This method coordinates the use of blackboard counters with HADoEntryOps for pausing.
  - HADoEntryOps
```
protected void HADoEntryOps()
```
    Do entry ops and handle disconnects or cache closes. This coordinates counters with HAController to allow for verification.
  - doEntryOperations
```
protected void doEntryOperations(com.gemstone.gemfire.cache.Region aReg)
```
    Do random entry operations on the given region ending either with minTaskGranularityMS or numOpsPerTask. Uses DeltaPropagationPrms.entryOperations to determine the operations to execute.
  - loadToUpperThreshold
```
protected void loadToUpperThreshold(com.gemstone.gemfire.cache.Region aReg)
```
    Load the region with N entries, specified by DeltaPropagationPrms.upperThreshold.
  - evictionTestLoad
```
protected void evictionTestLoad(com.gemstone.gemfire.cache.Region aReg)
```
    Load the region with N entries, specified by DeltaPropagationPrms.upperThreshold.
  - recordLoadToBB
```
protected void recordLoadToBB()
```
    Record the state of the region to the blackbloard for serial tests.
  - addEntry
```
protected Object addEntry(com.gemstone.gemfire.cache.Region aReg)
```
    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 aReg,
                               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 aReg,
                            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.
  - updateEntry
```
protected void updateEntry(com.gemstone.gemfire.cache.Region aReg)
```
    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 aReg)
```
    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 aReg)
```
    Get a new key int the given region.
    
    Parameters:
    
    aRegion - The region to use for getting an entry.
  - getNewKey
```
protected Object getNewKey()
```
    Return a new key, never before used in the test.
  - logExecutionNumber
```
protected static void logExecutionNumber()
```
    Log the execution number of this serial task.
  - registerInterest
```
protected static void registerInterest(com.gemstone.gemfire.cache.Region aRegion)
```
    Register interest with ALL_KEYS, and InterestPolicyResult = KEYS_VALUES which is equivalent to a full GII.
    
    Parameters:
    
    aRegion - The region to register interest on.
  - badDeltaController
```
protected void badDeltaController(int testCase)
```
    Test the given bad delta test case.
  - getKeyForBadDeltaTest
```
protected Object getKeyForBadDeltaTest()
```
    For bad delta tests: Get a key that will be distributed for an update. This eliminates keys hosted in this vm by a PR with no redundantCopies in a peer configuration, since if we update in this situation there's nobody to distribute to.
  - handleBadDeltaException
```
protected void handleBadDeltaException(Class expected,
                                       Throwable got,
                                       boolean expectedIsFromRemoteVM)
```
    Look for expected exception returned from remote vm.
    
    Parameters:
    
    expected - The class of the expected exception.
    
    got - The exception the test caught.
    
    expectedIsFromRemoteVM - true if the expected exception was expected to be returned from a remote vm, false if the expected exception was expected to be generated from the current vm.
  - handleBadDeltaSuccessfulUpdate
```
protected void handleBadDeltaSuccessfulUpdate(int badDeltaTestCase,
                                              Class expectedExceptionClass,
                                              Object key,
                                              BadDeltaObject value)
```
    Handle the case where a bad delta was invoked, but the delta update (the put) succeeded.
    
    Parameters:
    
    expectedExceptionClass - The class of the expected exception for the update to be used IF this method determines that an exception should have been returned to the caller of the put. There is only 1 case where a failed delta call logs a warning and lets the update occur: the update occurs in a server and there are no server peers to distribute to (redundantCopies = 0 or no other servers), and the only member to distribute to is a client---in this case the server put succeeds and the client logs a warning.
  - concVerify
```
protected void concVerify()
```
    Create a region snapshot from one vm's point of view, while any other threads in this or the same the vm also executing this method will compare to that snapshot.
  - verifyRegionContents
```
protected void verifyRegionContents(Map expected)
```
    Verify the state of the region and the given expected snapshot.
  - writeDeltaInfoToBlackboard
```
protected void writeDeltaInfoToBlackboard()
```
    Write this vm's delta and cloning information to the blackboard to be used later for verification.
  - clear
```
protected void clear()
```
    Clear variables that save up information for validation.
  - verifyDeltaBehavior
```
protected void verifyDeltaBehavior()
```
    Verify that the delta behavior was correct (toDelta/fromDelta was called and NOT called when appropriate, and cloning was handled correctly). This verifies the current vm, using information in the blackboard written by all other vms. Specifically this verifies: - the appropriate toDelta calls were made (and not made) in this vm - the appropriate fromDelta calls were made (and not made) in this vm - if the region in this vm is a PR - check PR metadata - check PR primaries - check data is consistent in all bucket copies
  - verifyDeltaCalls
```
protected static void verifyDeltaCalls(int vmID,
                                       List deltaKeys,
                                       String whichDelta,
                                       List expectedKeys)
```
    Verify that the given deltaKeys are expected.
    
    Parameters:
    
    vmID - The vmID this is doing validation for.
    
    deltaKeys - The list of keys whose values had a delta call.
    
    whichDelta - "to" if this is validating toDelta calls, "from" if this is validating fromDelta calls, "has" if this is validating hasDelta calls.
    
    expectedKeys - The List of keys whose values are expected to have had toDelta/fromDelta/hasDelta called on them.
  - verifyNoUpdates
```
protected void verifyNoUpdates()
```
    Verify that no updates have occured.
  - doSerialRREvictionTest
```
public void doSerialRREvictionTest()
```
    Serial test for eviction with careful validation
  - doEvictionTestOps
```
protected void doEvictionTestOps()
```
    Do operations for eviction tests
  - addNewValue
```
protected String addNewValue()
```
    Add a new entry for eviction tests
  - updateDeltaValueHolder
```
protected Object[] updateDeltaValueHolder(List currentKeyList)
```
    Perform an update on an existing key.
    
    Returns:
    
    [0] (String) The key that was updated [1] (Integer) The size of the byte[] payload previously associated with this key.
  - verifyEviction
```
protected void verifyEviction()
```
    Verify eviction (both for all entries in the cache and for the last operation
  - saveEvictionStats
```
protected void saveEvictionStats(long numBytesInVM)
```
    Make the current values the before values
  - checkEviction
```
protected void checkEviction()
```
    Check eviction in this vm for a particular key (the last operation).
  - checkMemLRULevelForPR
```
protected long checkMemLRULevelForPR()
```
    Iterates over all the entries hosted in this vm and calculates their bytes. Determines whether we are over eviction or not. This throws an exception if we are over the limit.
    
    Returns:
    
    The calculated number of bytes in this vm.
  - checkOverageHistory
```
protected void checkOverageHistory()
```
    This is called from a close task to allow the test to hit bug 41952 and report its occurrence in a close task. This way the test can keep running and we can see if the overages are a trend or get corrected by other evictions later on.
  - thisVMHostsKey
```
protected boolean thisVMHostsKey(com.gemstone.gemfire.cache.Region aReg,
                                 Object key)
```
    Return true if the region hosts the key in this vm.
    
    Parameters:
    
    aReg - A partitioned region.
    
    Returns:
  - verifyValue
```
protected void verifyValue(Object key,
                           BadDeltaObject expectedValue)
```
    Verify that the given key has the given value.
    
    Parameters:
    
    key - The key to check.
    
    expectedValue - The expected value of key.
  - getOperation
```
protected int getOperation(Long whichPrm)
```
    Get a random operation using the given hydra parameter.
    
    Parameters:
    
    whichPrm - A hydra parameter which specifies random operations.
  - getExistingKey
```
public static Object getExistingKey(com.gemstone.gemfire.cache.Region aRegion,
                                    boolean uniqueKeys,
                                    int numThreads)
```
    Return a random key currently in the given region.
    
    Parameters:
    
    aRegion - The region to use for getting an existing key.
    
    uniqueKeys - True if each thread operates on a unique set of keys.
    
    numThreads - Used if uniqueKeys is true. This is the number of threads using uniqueKeys.
  - 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.
  - handleException
```
protected void handleException(Exception anExcept)
```
    Handle an exception thrown by doing general operations during HA.
  - modifyDeltaObject
```
protected boolean modifyDeltaObject(DeltaObject anObj)
```
    Modify 1 or more primitive fields of the given DeltaObject. Randomly choose to set the delta booleans (so the subsequent put will do a delta distribution) or not (so the subsequent put will do a full distribution).
    
    Parameters:
    
    anObj - The DeltaObject to modify
  - trackUpdate
```
protected void trackUpdate(com.gemstone.gemfire.cache.Region aReg,
                           Object key,
                           boolean isDeltaDistribution)
```
    Update tracking of updated keys to be used for later validation
  - checkForError
```
protected static void checkForError()
```
    Check for any errors written to the bb
  - keysToString
```
protected static String keysToString(Collection listOfKeys)
```
    Logs a Collection of keys, inserting line breaks for large key lists.
  - isBadDeltaWarningCase
```
protected boolean isBadDeltaWarningCase(int testCase)
```
    Return true if a delta put in this vm is the case where a warning is logged. That case is if fromDelta gets an exception and the put originated in a server and the server had only clients to distribute to (no peers). In other words, a server to client distribution. If there are peers to distribute to, then the exception will be returned to the putter.
  - logPRMembers
```
public static void logPRMembers(com.gemstone.gemfire.cache.Region reg,
                                Object key)
```
    Log primary and secondary members for the key and value for this event

Class DeltaTest

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

testInstance

redundantCopiesKey

toDeltaKey

fromDeltaKey

hasDeltaKey

updatedKeysKey

updatedKeysWithDeltaKey

updatedKeysNotDistKey

regionSnapshotKey

minTaskGranularitySec

minTaskGranularityMS

numOpsPerTask

isBridgeConfiguration

isBridgeClient

numThreadsInClients

aRegion

uniqueKeyIndex

isSerialExecution

highAvailability

upperThreshold

lowerThreshold

uniqueKeys

numQueriesPerClientVM

secondsToRun

cacheIsClosed

disconnected

numThreadsInThisVM

numFieldsToModify

multiRegionList

updatedKeys

updatedKeysWithDelta

updatedKeysNotDistributed

numberOfCycles

redundantCopies

regionSnapshot

before_stat_entriesInVM

before_stat_numOverflowOnDisk

before_numBytesInThisVM

before_stat_lruEvictions

beforeMap

before_inVMSet

before_onDiskSet

opKey

currentKeyListKey

overageHistory

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

ENTRY_MODIFY_VALUE

getCallbackPrefix

createCallbackPrefix

updateCallbackPrefix

invalidateCallbackPrefix

destroyCallbackPrefix

regionInvalidateCallbackPrefix

regionDestroyCallbackPrefix

fullDistribution

concVerifyCoordinator

Constructor Detail

DeltaTest

Method Detail

HydraTask_initializeClient

HydraTask_initializeBridgeServer

initializeRegion

initializeInstance

HydraTask_initMultiRegions

HydraTask_initMultiRegionsForClients

HydraTask_doRROpsAndVerify

HydraTask_doConcOpsAndVerify