DeltaGIITest (GemFire XD Java API Documentation)

java.lang.Object
- deltagii.DeltaGIITest

public class DeltaGIITest
extends Object

Since:: 7.5

Field Summary

Fields
Modifier and Type	Field and Description
`protected static int`	`CACHE_OPERATIONS`
`protected static int`	`CLEAR_REGION`
`protected static String`	`createCallbackPrefix`
`protected static String`	`destroyCallbackPrefix`
`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_PUTALL_OPERATION`
`protected static int`	`ENTRY_UPDATE_OPERATION`
`protected static String`	`getCallbackPrefix`
`protected static String`	`invalidateCallbackPrefix`
`static Object`	`killSyncObject`
`protected static int`	`PUTS_FOR_KEY_ORDER_POLICY`
`static DeltaGIITest`	`testInstance` instance of this test class
`protected static HydraThreadLocal`	`threadIsPaused`
`protected static String`	`updateCallbackPrefix`
`protected static String`	`VMID`

Constructor Summary

Constructors
Constructor and Description

DeltaGIITest()

Constructors
Constructor and Description
`DeltaGIITest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected Object`	`addEntry(com.gemstone.gemfire.cache.Region theRegion)` Add a new entry to the given region.
`protected void`	`addEntry(com.gemstone.gemfire.cache.Region theRegion, Object key)` Add a new entry to the given region.
`protected static void`	`checkForLastIteration()` Check if we have run for the desired length of time.
`protected com.gemstone.gemfire.cache.Region`	`clearRegion()` Invoke region.clear() - only one region is cleared during any round of execution Note that Partitioned Regions do not support clear
`protected void`	`destroyEntry(com.gemstone.gemfire.cache.Region theRegion, boolean isLocalDestroy)` Destroy an entry in the given region.
`protected void`	`destroyEntry(com.gemstone.gemfire.cache.Region theRegion, Object key, boolean isLocalDestroy)` Destroy an entry in the given region.
`protected void`	`doOperations(long msToRun)` Do random operations on the test region
`protected void`	`doOperations(Long opsPrm, long msToRun)` Do random operations on the test region
`protected void`	`getExistingKey(com.gemstone.gemfire.cache.Region theRegion)` Does a get operation on an existing key.
`protected void`	`getNewKey(com.gemstone.gemfire.cache.Region theRegion)` Get a new key int the given region.
`protected int`	`getOperation(Long whichPrm)` Get a random operation using the given hydra parameter.
`protected int`	`getOperation(Long opsPrm, com.gemstone.gemfire.cache.Region theRegion)` Get an operation to perform on the region
`protected Map`	`getPutAllMap(com.gemstone.gemfire.cache.Region theRegion)` Get a map to use for putAll for the given region.
`static int`	`getStat_tombstones(String regionName)` Returns the current stat value of CachePerfStats.tombstones This is done by getting the stat directly without going to the archive file, thus the stat is local to this cache and cannot be combined across archives, but it is faster than going to the archive.
`protected void`	`getThisNewKey(com.gemstone.gemfire.cache.Region theRegion, Object key)` Do a get on the given new key.
`protected Object`	`getUpdateObject(com.gemstone.gemfire.cache.Region r, String key)` Return an object to be used to update the given key.
`static void`	`HydraTask_addGatewayHub()` Create gateway hub
`static void`	`HydraTask_createGatewayHub()` Create gateway hub
`static void`	`HydraTask_createLocator()`
`static void`	`HydraTask_doOperations()` Task to do random operations
`static void`	`HydraTask_giiNewMember()` Task for newMembers (increment pausing so we won't wait for these threads).
`static void`	`HydraTask_giiProvider()` Task to control the GII Provider VM (test controller)
`static void`	`HydraTask_giiRequester()` Task to respond to the provider's (controller's) commands
`static void`	`HydraTask_initialize()` Creates and initializes a server or peer.
`static void`	`HydraTask_initializeClient()` Creates and initializes an edge client.
`static void`	`HydraTask_load()` Hydra task to load the region with keys/values (as a batched task)
`static void`	`HydraTask_resetUniqueKeyIndex()` Reset the uniqueKeyIndex to be higher than the current blackboard counter (resulting from load)
`static void`	`HydraTask_startGatewayHub()` Start gateway hub
`static void`	`HydraTask_startLocatorAndDS()`
`static void`	`HydraTask_stopGatewayHub()` Stop the gateway hub
`static void`	`HydraTask_verifyDeltaGII()` Verify if initialized remotely (via gii) verify that we used deltaGII if expected.
`static void`	`HydraTask_verifyFromSnapshot()` Verify all regions from the snapshot
`static void`	`HydraTask_verifyFromSnapshotAndSync()` Verify region from the snapshot and wait for all threads to complete verify
`static void`	`HydraTask_verifyPR()` Verify regions that are PRs
`static void`	`HydraTask_writeSnapshot()`
`protected void`	`invalidateEntry(com.gemstone.gemfire.cache.Region theRegion, boolean isLocalInvalidate)` Invalidate an entry in the given region.
`protected void`	`invalidateEntry(com.gemstone.gemfire.cache.Region theRegion, Object key, boolean isLocalInvalidate)` Invalidate an entry in the given region.
`protected boolean`	`isClearedRegion(com.gemstone.gemfire.cache.Region theRegion)` Whether or not the given Region was the target of a Region.clear().
`protected static long`	`logExecutionNumber()` Log the execution number of this serial task.
`protected Object`	`obtainExistingKey(com.gemstone.gemfire.cache.Region theRegion)` Return a random key from theRegion
`protected List<String>`	`obtainExistingKeys(com.gemstone.gemfire.cache.Region theRegion, int numToObtain)` Return a random key from theRegion
`protected Object`	`obtainNewKey()` Return a new key, never before used in the test.
`protected void`	`putAll(com.gemstone.gemfire.cache.Region theRegion)` putall a map to the given region.
`static void`	`resetUniqueKeyIndex()` set each newVersion uniqueKey blackboard value to a value higher than was used in the oldVersion ops to ensure unique keys and that new keys obtained by newVersion vms have never been used by oldVersion vms
`void`	`setupGetInitialImageTestCallbacks(String giiStatePrm)`
`protected void`	`updateEntry(com.gemstone.gemfire.cache.Region theRegion)` Update an existing entry in the given region.
`protected void`	`updateEntry(com.gemstone.gemfire.cache.Region theRegion, Object key)` Update an existing entry in the given region.
`protected void`	`verifyFromSnapshot()` For each region written to the blackboard, verify its state against the region in this vm.
`void`	`verifyFromSnapshot(com.gemstone.gemfire.cache.Region theRegion, Map regionSnapshot)` Verify that the given region is consistent with the given snapshot.
`protected void`	`writeSnapshot()` Write the region snapshot to the BB (includes only persistent regions)

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

- Field Detail
  - testInstance
```
public static DeltaGIITest testInstance
```
    instance of this test class
  - threadIsPaused
```
protected static HydraThreadLocal threadIsPaused
```
  - VMID
```
protected static final String VMID
```
    See Also:
    
    Constant Field Values
  - 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_PUTALL_OPERATION
```
protected static final int ENTRY_PUTALL_OPERATION
```
    See Also:
    
    Constant Field Values
  - CACHE_OPERATIONS
```
protected static final int CACHE_OPERATIONS
```
    See Also:
    
    Constant Field Values
  - PUTS_FOR_KEY_ORDER_POLICY
```
protected static final int PUTS_FOR_KEY_ORDER_POLICY
```
    See Also:
    
    Constant Field Values
  - CLEAR_REGION
```
protected static final int CLEAR_REGION
```
    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
  - killSyncObject
```
public static Object killSyncObject
```
- Constructor Detail
  - DeltaGIITest
```
public DeltaGIITest()
```
- Method Detail
  - HydraTask_createLocator
```
public static void HydraTask_createLocator()
                                    throws Throwable
```
    Throws:
    
    Throwable
  - HydraTask_startLocatorAndDS
```
public static void HydraTask_startLocatorAndDS()
                                        throws Throwable
```
    Throws:
    
    Throwable
  - HydraTask_createGatewayHub
```
public static void HydraTask_createGatewayHub()
```
    Create gateway hub
  - HydraTask_addGatewayHub
```
public static void HydraTask_addGatewayHub()
```
    Create gateway hub
  - HydraTask_startGatewayHub
```
public static void HydraTask_startGatewayHub()
```
    Start gateway hub
  - HydraTask_stopGatewayHub
```
public static void HydraTask_stopGatewayHub()
```
    Stop the gateway hub
  - HydraTask_initialize
```
public static void HydraTask_initialize()
                                 throws Throwable
```
    Creates and initializes a server or peer.
    
    Throws:
    
    Throwable
  - HydraTask_initializeClient
```
public static void HydraTask_initializeClient()
                                       throws Throwable
```
    Creates and initializes an edge client.
    
    Throws:
    
    Throwable
  - setupGetInitialImageTestCallbacks
```
public void setupGetInitialImageTestCallbacks(String giiStatePrm)
```
  - HydraTask_load
```
public static void HydraTask_load()
```
    Hydra task to load the region with keys/values (as a batched task)
  - HydraTask_resetUniqueKeyIndex
```
public static void HydraTask_resetUniqueKeyIndex()
```
    Reset the uniqueKeyIndex to be higher than the current blackboard counter (resulting from load)
  - resetUniqueKeyIndex
```
public static void resetUniqueKeyIndex()
```
    set each newVersion uniqueKey blackboard value to a value higher than was used in the oldVersion ops to ensure unique keys and that new keys obtained by newVersion vms have never been used by oldVersion vms
  - HydraTask_giiProvider
```
public static void HydraTask_giiProvider()
                                  throws Throwable
```
    Task to control the GII Provider VM (test controller)
    
    Throws:
    
    Throwable
  - HydraTask_giiRequester
```
public static void HydraTask_giiRequester()
                                   throws Throwable
```
    Task to respond to the provider's (controller's) commands
    
    Throws:
    
    Throwable
  - HydraTask_giiNewMember
```
public static void HydraTask_giiNewMember()
                                   throws Exception
```
    Task for newMembers (increment pausing so we won't wait for these threads).
    
    Throws:
    
    Exception
  - HydraTask_writeSnapshot
```
public static void HydraTask_writeSnapshot()
```
  - writeSnapshot
```
protected void writeSnapshot()
```
    Write the region snapshot to the BB (includes only persistent regions)
  - HydraTask_verifyFromSnapshotAndSync
```
public static void HydraTask_verifyFromSnapshotAndSync()
```
    Verify region from the snapshot and wait for all threads to complete verify
  - HydraTask_verifyFromSnapshot
```
public static void HydraTask_verifyFromSnapshot()
```
    Verify all regions from the snapshot
  - verifyFromSnapshot
```
protected void verifyFromSnapshot()
```
    For each region written to the blackboard, verify its state against the region in this vm.
  - verifyFromSnapshot
```
public void verifyFromSnapshot(com.gemstone.gemfire.cache.Region theRegion,
                               Map regionSnapshot)
```
    Verify that the given region is consistent with the given snapshot.
    
    Parameters:
    
    theRegion - The region to verify
    
    snapshot - The expected contents of theRegion.
  - HydraTask_verifyPR
```
public static void HydraTask_verifyPR()
```
    Verify regions that are PRs
  - HydraTask_doOperations
```
public static void HydraTask_doOperations()
                                   throws Exception
```
    Task to do random operations
    
    Throws:
    
    Exception
  - doOperations
```
protected void doOperations(long msToRun)
                     throws Exception
```
    Do random operations on the test region
    
    Parameters:
    
    msToRun - The number of milliseconds to run operations before returning.
    
    Throws:
    
    Exception
  - doOperations
```
protected void doOperations(Long opsPrm,
                            long msToRun)
                     throws Exception
```
    Do random operations on the test region
    
    Parameters:
    
    opsPrm - Specifies which list of operations to execute (provider vs. requester operations)
    
    msToRun - The number of milliseconds to run operations before returning.
    
    Throws:
    
    Exception
  - getOperation
```
protected int getOperation(Long opsPrm,
                           com.gemstone.gemfire.cache.Region theRegion)
```
    Get an operation to perform on the region
    
    Parameters:
    
    reg - The region to get an operation for.
  - 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
```
protected void getExistingKey(com.gemstone.gemfire.cache.Region theRegion)
```
    Does a get operation on an existing key.
    
    Parameters:
    
    theRegion - The region to perform the get on.
  - addEntry
```
protected Object addEntry(com.gemstone.gemfire.cache.Region theRegion)
```
    Add a new entry to the given region.
    
    Parameters:
    
    theRegion - The region to use for adding a new entry.
  - addEntry
```
protected void addEntry(com.gemstone.gemfire.cache.Region theRegion,
                        Object key)
```
    Add a new entry to the given region.
    
    Parameters:
    
    theRegion - The region to use for adding a new entry.
    
    key - The key to add.
  - putAll
```
protected void putAll(com.gemstone.gemfire.cache.Region theRegion)
```
    putall a map to the given region.
    
    Parameters:
    
    theRegion - The region to use for putall a map.
  - getPutAllMap
```
protected Map getPutAllMap(com.gemstone.gemfire.cache.Region theRegion)
```
    Get a map to use for putAll for the given region. Make sure the values in the map honor unique keys.
    
    Parameters:
    
    theRegion - The region to consider for the putAll.
    
    Returns:
    
    Map The map to use for the argument to putAll
  - invalidateEntry
```
protected void invalidateEntry(com.gemstone.gemfire.cache.Region theRegion,
                               boolean isLocalInvalidate)
```
    Invalidate an entry in the given region.
    
    Parameters:
    
    theRegion - The region to use for invalidating an entry.
    
    isLocalInvalidate - True if the invalidate should be local, false otherwise.
  - invalidateEntry
```
protected void invalidateEntry(com.gemstone.gemfire.cache.Region theRegion,
                               Object key,
                               boolean isLocalInvalidate)
```
    Invalidate an entry in the given region.
    
    Parameters:
    
    theRegion - The region to use for invalidating an entry.
    
    key - The key to invalidate.
    
    isLocalInvalidate - True if the invalidate should be local, false otherwise.
  - destroyEntry
```
protected void destroyEntry(com.gemstone.gemfire.cache.Region theRegion,
                            boolean isLocalDestroy)
```
    Destroy an entry in the given region.
    
    Parameters:
    
    theRegion - The region to use for destroying an entry.
    
    isLocalDestroy - True if the destroy should be local, false otherwise.
  - destroyEntry
```
protected void destroyEntry(com.gemstone.gemfire.cache.Region theRegion,
                            Object key,
                            boolean isLocalDestroy)
```
    Destroy an entry in the given region.
    
    Parameters:
    
    theRegion - The region to use for destroying an entry.
    
    key - The key to destroy.
    
    isLocalDestroy - True if the destroy should be local, false otherwise.
  - updateEntry
```
protected void updateEntry(com.gemstone.gemfire.cache.Region theRegion)
```
    Update an existing entry in the given region. If there are no available keys in the region, then this is a noop.
    
    Parameters:
    
    theRegion - The region to use for updating an entry.
  - updateEntry
```
protected void updateEntry(com.gemstone.gemfire.cache.Region theRegion,
                           Object key)
```
    Update an existing entry in the given region. If there are no available keys in the region, then this is a noop.
    
    Parameters:
    
    theRegion - The region to use for updating an entry.
    
    key - The key to update.
  - getNewKey
```
protected void getNewKey(com.gemstone.gemfire.cache.Region theRegion)
```
    Get a new key int the given region.
    
    Parameters:
    
    theRegion - The region to use for getting an entry.
  - getThisNewKey
```
protected void getThisNewKey(com.gemstone.gemfire.cache.Region theRegion,
                             Object key)
```
    Do a get on the given new key.
    
    Parameters:
    
    theRegion - The region to use for getting an entry.
    
    key - A new key never used before.
  - obtainExistingKey
```
protected Object obtainExistingKey(com.gemstone.gemfire.cache.Region theRegion)
```
    Return a random key from theRegion
    
    Parameters:
    
    theRegion - The region to get the existing key from.
    
    Returns:
    
    A random key from theRegion.
  - obtainExistingKeys
```
protected List<String> obtainExistingKeys(com.gemstone.gemfire.cache.Region theRegion,
                                          int numToObtain)
```
    Return a random key from theRegion
    
    Parameters:
    
    theRegion - The region to get the existing key from.
    
    Returns:
    
    A List of existing keys.
  - clearRegion
```
protected com.gemstone.gemfire.cache.Region clearRegion()
```
    Invoke region.clear() - only one region is cleared during any round of execution Note that Partitioned Regions do not support clear
  - isClearedRegion
```
protected boolean isClearedRegion(com.gemstone.gemfire.cache.Region theRegion)
```
    Whether or not the given Region was the target of a Region.clear().
  - obtainNewKey
```
protected Object obtainNewKey()
```
    Return a new key, never before used in the test.
  - getUpdateObject
```
protected Object getUpdateObject(com.gemstone.gemfire.cache.Region r,
                                 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:
    
    theRegion - The region which possible contains key.
    
    key - The key to get a new value for.
  - getStat_tombstones
```
public static int getStat_tombstones(String regionName)
```
    Returns the current stat value of CachePerfStats.tombstones This is done by getting the stat directly without going to the archive file, thus the stat is local to this cache and cannot be combined across archives, but it is faster than going to the archive.
    
    Returns:
    
    - the current value of CachePerfStats.tombstones
  - logExecutionNumber
```
protected static long logExecutionNumber()
```
    Log the execution number of this serial task.
  - checkForLastIteration
```
protected static 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.
  - HydraTask_verifyDeltaGII
```
public static void HydraTask_verifyDeltaGII()
```
    Verify if initialized remotely (via gii) verify that we used deltaGII if expected.

Class DeltaGIITest

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

testInstance

threadIsPaused

VMID

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_PUTALL_OPERATION

CACHE_OPERATIONS

PUTS_FOR_KEY_ORDER_POLICY

CLEAR_REGION

getCallbackPrefix

createCallbackPrefix

updateCallbackPrefix

invalidateCallbackPrefix

destroyCallbackPrefix

killSyncObject

Constructor Detail

DeltaGIITest

Method Detail

HydraTask_createLocator

HydraTask_startLocatorAndDS

HydraTask_createGatewayHub

HydraTask_addGatewayHub

HydraTask_startGatewayHub

HydraTask_stopGatewayHub

HydraTask_initialize

HydraTask_initializeClient

setupGetInitialImageTestCallbacks

HydraTask_load

HydraTask_resetUniqueKeyIndex

resetUniqueKeyIndex

HydraTask_giiProvider

HydraTask_giiRequester

HydraTask_giiNewMember

HydraTask_writeSnapshot

writeSnapshot

HydraTask_verifyFromSnapshotAndSync

HydraTask_verifyFromSnapshot

verifyFromSnapshot

verifyFromSnapshot

HydraTask_verifyPR

HydraTask_doOperations

doOperations

doOperations

getOperation

getOperation

getExistingKey

addEntry

addEntry

putAll

getPutAllMap

invalidateEntry

invalidateEntry

destroyEntry

destroyEntry

updateEntry

updateEntry

getNewKey

getThisNewKey

obtainExistingKey

obtainExistingKeys

clearRegion

isClearedRegion

obtainNewKey

getUpdateObject

getStat_tombstones

logExecutionNumber

checkForLastIteration

HydraTask_verifyDeltaGII