CQTest (GemFire XD Java API Documentation)

java.lang.Object
- cq.CQTest

Direct Known Subclasses:

CQStatisticsTest, FDCQTest
```
public class CQTest
extends Object
```

Field Summary

Fields
Modifier and Type	Field and Description
`com.gemstone.gemfire.cache.Region`	`aRegion`
`protected boolean`	`cacheIsClosed`
`protected static MethodCoordinator`	`concVerifyCoordinator`
`protected static boolean`	`CQsOn`
`protected static String`	`createCallbackPrefix`
`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`	`getCallbackPrefix`
`protected boolean`	`highAvailability`
`protected static String`	`invalidateCallbackPrefix`
`boolean`	`isBridgeClient`
`boolean`	`isBridgeConfiguration`
`protected boolean`	`isOldClient`
`protected boolean`	`isSerialExecution`
`protected int`	`lowerThreshold`
`protected long`	`minTaskGranularityMS`
`protected long`	`minTaskGranularitySec`
`protected int`	`numOpsPerTask`
`protected int`	`numQueriesPerClientVM`
`protected int`	`numThreadsInClients`
`protected int`	`numThreadsInThisVM`
`protected com.gemstone.gemfire.cache.query.QueryService`	`qService`
`int`	`queryDepth`
`Map`	`queryMap`
`protected static String`	`regionDestroyCallbackPrefix`
`protected static String`	`regionInvalidateCallbackPrefix`
`protected Map`	`regionSnapshot`
`protected int`	`secondsToRun`
`static CQTest`	`testInstance`
`protected static String`	`ThreadIDStr`
`protected Map`	`txRegionSnapshot`
`HydraThreadLocal`	`uniqueKeyIndex`
`protected boolean`	`uniqueKeys`
`protected static String`	`updateCallbackPrefix`
`protected int`	`upperThreshold`
`protected boolean`	`useDeltaObjects`
`static CQTestVersionHelper`	`versionHelperInstance`
`protected static String`	`VmIDStr`

Constructor Summary

Constructors
Constructor and Description

CQTest()

Constructors
Constructor and Description
`CQTest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected Object`	`addEntry(com.gemstone.gemfire.cache.Region aRegion)` Add a new entry to the given region.
`protected void`	`checkForLastIteration()` Check if we have run for the desired length of time.
`protected 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 aRegion, 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 aRegion)` Do random entry operations on the given region ending either with minTaskGranularityMS or numOpsPerTask.
`protected void`	`doRandomOp(com.gemstone.gemfire.cache.Region aRegion)`
`protected void`	`doRROpsAndVerify()` Do random operations and verification for serial round robin test.
`protected Map`	`generateBorderCaseQueries(int maxPathLength)` Generate a series of queries the query against border case values (min/max) based on the given parameters.
`protected Map`	`generateCharacterQueries(String fieldName, int maxPathLength)` Generate a series of queries based on the given parameters.
`protected Map`	`generateNullQueries(int maxPathLength)` Generate a series of queries against null values based on the given parameters.
`protected Map`	`generateNumericQueries(String fieldName, long minValue, long maxValue, int maxPathLength)` Generate a series of queries based on the given parameters.
`Map`	`generateQueries(int maxQueryDepth)` Initialize the queries to be used in the test by putting them in the queryMap
`protected Map`	`generateStringQueries(String fieldName, int maxPathLength)` Generate a series of queries based on the given parameters.
`protected static String`	`getComparatorInQuery(String queryStr)` Given a query string, return the comparator in it.
`protected static int`	`getDepthInQuery(String queryStr)` Return the depth of the query in queryStr.
`static Object`	`getExistingKey(com.gemstone.gemfire.cache.Region aRegion, boolean uniqueKeys, int numThreads)` Return a random key currently in the given region.
`protected List`	`getExpectedResults(String queryStr)` Return a Set of expected results of the given queryStr using regionSnapshot as the basis of determining what to expect.
`protected static String`	`getFieldInQuery(String queryStr)` Given a query string, return the field in it being queried (the last field in the path).
`protected void`	`getKey(com.gemstone.gemfire.cache.Region aRegion)` Get an existing key in the given region if one is available, otherwise get a new key.
`protected Object`	`getNewKey()` Return a new key, never before used in the test.
`protected void`	`getNewKey(com.gemstone.gemfire.cache.Region aRegion)` Get a new key in the given region.
`protected String`	`getNextQueryName()` Return a unique query name.
`protected int`	`getOperation(Long whichPrm)` Get a random operation using the given hydra parameter.
`protected int`	`getOperation(com.gemstone.gemfire.cache.Region reg)` Get an operation to perform on the region
`protected static String`	`getPathInQuery(String queryStr)` Given a query string, return the query path.
`protected String`	`getQueryPath(String fieldName, int maxPathLength)` Given a field name and maximum path depth, return a random path to the field.
`static String`	`getReadableQueryString(String queryStr)` Returns the given query string with addition information if necessary to make it more readable, such as converting any characters to their byte equivalent (to aid with debugging).
`protected static String`	`getValueToCompareInQuery(String queryStr)` Given a query string, return the value being compared to.
`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`	`handleException(Exception anExcept)` Handle an exception thrown by doing general operations during HA.
`static void`	`HydraTask_doConcOpsAndVerify()` Hydra task method for concurrent tests with verification.
`static void`	`HydraTask_doRROpsAndVerify()` Hydra task method for serial round robin tests.
`static void`	`HydraTask_executeCQsAndVerify()` Hydra task method to execute all the registered CQs and verify results.
`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_initializeAccessorServer1()` Creates and initializes a bridge server.
`static void`	`HydraTask_initializeAccessorServer2()` Creates and initializes a bridge server.
`static void`	`HydraTask_initializeBridgeServer()` Creates and initializes a bridge server.
`static void`	`HydraTask_initializeClient()` Creates and initializes the singleton instance of CQTest in a client.
`static void`	`HydraTask_initializeClient1()` Creates and initializes the singleton instance of CQTest in a client.
`static void`	`HydraTask_initializeClient2()` Creates and initializes the singleton instance of CQTest in a client.
`static void`	`HydraTask_initializeDataHostServer()` Creates and initializes a bridge server.
`static void`	`HydraTask_initializeServer1()` Creates and initializes a bridge server.
`static void`	`HydraTask_initializeServer2()` Creates and initializes a bridge server.
`static void`	`HydraTask_load()`
`static void`	`HydraTask_loadToUpperThreshold()` Hydra task method to load the region with N entries, specified by CQUtilPrms.upperThreshold.
`static void`	`HydraTask_missingJarTest()` Test for missing antlr.jar.
`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.
`void`	`initializeCQs()` Initialize (create) the continuous queries for this test
`void`	`initializeInstance()` Initialize instance fields of this test class
`void`	`initializeQueryService()`
`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 aRegion, boolean isLocalInvalidate)` Invalidate an entry in the given region.
`protected void`	`loadToUpperThreshold()` Load the region with N entries, specified by CQUtilPrms.upperThreshold.
`protected static void`	`logExecutionNumber()` Log the execution number of this serial task.
`protected void`	`modifyValue(com.gemstone.gemfire.cache.Region aRegion)` Modifies an existing value in an entry in the given region, but does not do a put.
`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`	`restoreRegionSnapshot()` restoreRegionSnapshot() - restore this VMs internal RegionSnapshot (HashMap) after a tx failure during commit.
`static boolean`	`satisfiesQuery(String queryStr, QueryObject qo)` Return true of the given qo satisfies the queryStr, false otherwise.
`protected void`	`saveRegionSnapshot()` saveRegionSnapshot() - save this VMs internal RegionSnapshot (HashMap) in case of tx failure during commit.
`protected void`	`updateEntry(com.gemstone.gemfire.cache.Region aRegion)` Update an existing entry in the given region.
`protected void`	`verify(com.gemstone.gemfire.cache.query.CqQuery cq, com.gemstone.gemfire.cache.query.SelectResults sr)` Verifies that for a given CQ, the following are all consistent with each other: 1) expected results derived from the regionSnapshot 2) selectResults 3) gatherMap
`protected void`	`verifyQuery(String cqName)` Verify the query with the given name
`protected void`	`verifyQueryResults()` Verify the result of the CQs registered for this VM.
`protected void`	`verifyRegionContents()` Verify the state of the region and the regionSnapshot.

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

- Field Detail
  - testInstance
```
public static CQTest testInstance
```
  - versionHelperInstance
```
public static CQTestVersionHelper versionHelperInstance
```
  - VmIDStr
```
protected static final String VmIDStr
```
    See Also:
    
    Constant Field Values
  - ThreadIDStr
```
protected static final String ThreadIDStr
```
    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
```
  - qService
```
protected com.gemstone.gemfire.cache.query.QueryService qService
```
  - uniqueKeyIndex
```
public HydraThreadLocal uniqueKeyIndex
```
  - isSerialExecution
```
protected boolean isSerialExecution
```
  - highAvailability
```
protected boolean highAvailability
```
  - upperThreshold
```
protected int upperThreshold
```
  - lowerThreshold
```
protected int lowerThreshold
```
  - uniqueKeys
```
protected boolean uniqueKeys
```
  - queryDepth
```
public int queryDepth
```
  - numQueriesPerClientVM
```
protected int numQueriesPerClientVM
```
  - queryMap
```
public Map queryMap
```
  - secondsToRun
```
protected int secondsToRun
```
  - cacheIsClosed
```
protected boolean cacheIsClosed
```
  - disconnected
```
protected boolean disconnected
```
  - numThreadsInThisVM
```
protected int numThreadsInThisVM
```
  - CQsOn
```
protected static boolean CQsOn
```
  - useDeltaObjects
```
protected boolean useDeltaObjects
```
  - isOldClient
```
protected boolean isOldClient
```
  - regionSnapshot
```
protected Map regionSnapshot
```
  - txRegionSnapshot
```
protected Map txRegionSnapshot
```
  - 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
  - concVerifyCoordinator
```
protected static volatile MethodCoordinator concVerifyCoordinator
```
- Constructor Detail
  - CQTest
```
public CQTest()
```
- Method Detail
  - HydraTask_initializeClient
```
public static void HydraTask_initializeClient()
```
    Creates and initializes the singleton instance of CQTest in a client.
  - HydraTask_initializeClient1
```
public static void HydraTask_initializeClient1()
```
    Creates and initializes the singleton instance of CQTest in a client.
  - HydraTask_initializeClient2
```
public static void HydraTask_initializeClient2()
```
    Creates and initializes the singleton instance of CQTest in a client.
  - HydraTask_initializeBridgeServer
```
public static void HydraTask_initializeBridgeServer()
```
    Creates and initializes a bridge server.
  - HydraTask_initializeAccessorServer1
```
public static void HydraTask_initializeAccessorServer1()
```
    Creates and initializes a bridge server.
  - HydraTask_initializeAccessorServer2
```
public static void HydraTask_initializeAccessorServer2()
```
    Creates and initializes a bridge server.
  - HydraTask_initializeServer1
```
public static void HydraTask_initializeServer1()
```
    Creates and initializes a bridge server.
  - HydraTask_initializeServer2
```
public static void HydraTask_initializeServer2()
```
    Creates and initializes a bridge server.
  - HydraTask_initializeDataHostServer
```
public static void HydraTask_initializeDataHostServer()
```
    Creates and initializes a bridge server.
  - HydraTask_missingJarTest
```
public static void HydraTask_missingJarTest()
```
    Test for missing antlr.jar. We would like to see a NoClassDefFoundError thrown every time so the user has a clue what is wrong. This should be executed by only one thread per VM.
  - 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.
  - initializeQueryService
```
public void initializeQueryService()
```
  - initializeInstance
```
public void initializeInstance()
```
    Initialize instance fields of this test class
  - initializeCQs
```
public void initializeCQs()
```
    Initialize (create) the continuous queries for this test
  - HydraTask_doRROpsAndVerify
```
public static void HydraTask_doRROpsAndVerify()
```
    Hydra task method for serial round robin tests.
  - HydraTask_load
```
public static void HydraTask_load()
```
  - HydraTask_doConcOpsAndVerify
```
public static void HydraTask_doConcOpsAndVerify()
```
    Hydra task method for concurrent tests with verification.
  - HydraTask_executeCQsAndVerify
```
public static void HydraTask_executeCQsAndVerify()
```
    Hydra task method to execute all the registered CQs and verify results.
  - 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_loadToUpperThreshold
```
public static void HydraTask_loadToUpperThreshold()
```
    Hydra task method to load the region with N entries, specified by CQUtilPrms.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.
  - generateNumericQueries
```
protected Map generateNumericQueries(String fieldName,
                                     long minValue,
                                     long maxValue,
                                     int maxPathLength)
```
    Generate a series of queries based on the given parameters. This can only be called for numeric (int, long, float etc) fields.
    
    Parameters:
    
    fieldName - The name of the field to query on.
    
    minValue - Choose a random value between minValue and maxValue to query against.
    
    maxValue - Choose a random value between minValue and maxValue to query against.
    
    pathLength - Choose a random value between 1 and pathLength to generate the query path. For example, 1 might be "anInt = 1", 2 might be "aQueryObject.anInt = 1", etc.
  - generateStringQueries
```
protected Map generateStringQueries(String fieldName,
                                    int maxPathLength)
```
    Generate a series of queries based on the given parameters. This can only be called for String fields.
    
    Parameters:
    
    fieldName - The name of the field to query on.
    
    pathLength - Choose a random value between 1 and pathLength to generate the query path. For example, 1 might be "aString = "abc"", 2 might be "aQueryObject.aString = "def"", etc.
  - generateCharacterQueries
```
protected Map generateCharacterQueries(String fieldName,
                                       int maxPathLength)
```
    Generate a series of queries based on the given parameters. This can only be called for character fields.
    
    Parameters:
    
    fieldName - The name of the field to query on.
    
    pathLength - Choose a random value between 1 and pathLength to generate the query path. For example, 1 might be "aCharacter = "a"", 2 might be "aQueryObject.aCharacter = "d"", etc.
  - generateBorderCaseQueries
```
protected Map generateBorderCaseQueries(int maxPathLength)
```
    Generate a series of queries the query against border case values (min/max) based on the given parameters.
    
    Parameters:
    
    fieldName - The name of the field to query on.
    
    pathLength - Choose a random value between 1 and pathLength to generate the query path. For example, 1 might be "anInt = 1", 2 might be "aQueryObject.anInt = 1", etc.
  - generateNullQueries
```
protected Map generateNullQueries(int maxPathLength)
```
    Generate a series of queries against null values based on the given parameters.
    
    Parameters:
    
    pathLength - Choose a random value between 1 and pathLength to generate the query path. For example, 1 might be "anInteger = NULL", 2 might be "aQueryObject.anInteger = NULL", etc.
  - generateQueries
```
public Map generateQueries(int maxQueryDepth)
```
    Initialize the queries to be used in the test by putting them in the queryMap
  - getQueryPath
```
protected String getQueryPath(String fieldName,
                              int maxPathLength)
```
    Given a field name and maximum path depth, return a random path to the field.
    
    Parameters:
    
    fieldName - The name of the field the path should end with.
    
    maxPathLength - The maximum path length to return.
    
    Returns:
    
    A query path ending with fieldName, between 1 and maxPathLength for the query path depth.
  - doRROpsAndVerify
```
protected void doRROpsAndVerify()
```
    Do random operations and verification for serial round robin test. If this is the first task in the round, then do a random operation and record it to the blackboard. If this is not the first in the round, then verify this client's view of the operation done by the first thread in the round. If this is the last thread in the round, then do the verification and become the new first thread in the round by doing a random operation. Thus, a different thread in each round will do the random entry opertion.
  - 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 the state of the cqs they have registered. 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 aRegion)
```
    Do random entry operations on the given region ending either with minTaskGranularityMS or numOpsPerTask. Uses CQUtilPrms.entryOperations to determine the operations to execute.
  - doRandomOp
```
protected void doRandomOp(com.gemstone.gemfire.cache.Region aRegion)
```
  - getOperation
```
protected int getOperation(com.gemstone.gemfire.cache.Region reg)
```
    Get an operation to perform on the region
    
    Parameters:
    
    reg - The region to get an operation for.
  - loadToUpperThreshold
```
protected void loadToUpperThreshold()
```
    Load the region with N entries, specified by CQUtilPrms.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 aRegion)
```
    Add a new entry to the given region.
    
    Parameters:
    
    aRegion - The region to use for adding a new entry.
  - invalidateEntry
```
protected void invalidateEntry(com.gemstone.gemfire.cache.Region aRegion,
                               boolean isLocalInvalidate)
```
    Invalidate an entry in the given region.
    
    Parameters:
    
    aRegion - The region to use for invalidating an entry.
    
    isLocalInvalidate - True if the invalidate should be local, false otherwise.
  - destroyEntry
```
protected void destroyEntry(com.gemstone.gemfire.cache.Region aRegion,
                            boolean isLocalDestroy)
```
    Destroy an entry in the given region.
    
    Parameters:
    
    aRegion - The region to use for destroying an entry.
    
    isLocalDestroy - True if the destroy should be local, false otherwise.
  - updateEntry
```
protected void updateEntry(com.gemstone.gemfire.cache.Region aRegion)
```
    Update an existing entry in the given region. If there are no available keys in the region, then this is a noop.
    
    Parameters:
    
    aRegion - The region to use for updating an entry.
  - modifyValue
```
protected void modifyValue(com.gemstone.gemfire.cache.Region aRegion)
```
    Modifies an existing value in an entry in the given region, but does not do a put.
    
    Parameters:
    
    aRegion - The region to use for updating an entry.
  - getKey
```
protected void getKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Get an existing key in the given region if one is available, otherwise get a new key.
    
    Parameters:
    
    aRegion - The region to use for getting an entry.
  - getNewKey
```
protected void getNewKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Get a new key in 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.
  - 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.
  - verify
```
protected void verify(com.gemstone.gemfire.cache.query.CqQuery cq,
                      com.gemstone.gemfire.cache.query.SelectResults sr)
```
    Verifies that for a given CQ, the following are all consistent with each other: 1) expected results derived from the regionSnapshot 2) selectResults 3) gatherMap
    
    Parameters:
    
    cq - The cq to check results for.
    
    sr - The SelectResults for the cq.
  - verifyRegionContents
```
protected void verifyRegionContents()
```
    Verify the state of the region and the regionSnapshot.
  - verifyQueryResults
```
protected void verifyQueryResults()
```
    Verify the result of the CQs registered for this VM.
  - verifyQuery
```
protected void verifyQuery(String cqName)
```
    Verify the query with the given name
  - getPathInQuery
```
protected static String getPathInQuery(String queryStr)
```
    Given a query string, return the query path.
    
    Parameters:
    
    queryStr - A string containing a query.
    
    Returns - a string containing the path being queried, or null if none.
  - getFieldInQuery
```
protected static String getFieldInQuery(String queryStr)
```
    Given a query string, return the field in it being queried (the last field in the path).
    
    Parameters:
    
    queryStr - A string containing a query.
    
    Returns - a string containing the field being queried, or null if none.
  - getComparatorInQuery
```
protected static String getComparatorInQuery(String queryStr)
```
    Given a query string, return the comparator in it. Queries supported are well-defined and simple. Here is a sample: "select * from /testRegion" "select * from /testRegion where p.aPrimitiveInt > 0"
    
    Parameters:
    
    queryStr - A string containing a query.
    
    Returns - a string containing the comparator, or null if none.
  - getValueToCompareInQuery
```
protected static String getValueToCompareInQuery(String queryStr)
```
    Given a query string, return the value being compared to. Queries supported are well-defined and simple. Here is a sample: "select * from /testRegion" "select * from /testRegion where p.aPrimitiveInt > 0"
    
    Parameters:
    
    queryStr - A string containing a query.
    
    Returns - a string containing the value being comparied, or null if none.
  - getDepthInQuery
```
protected static int getDepthInQuery(String queryStr)
```
    Return the depth of the query in queryStr. For example, for "aPrimitiveInt > 0", depth is 1, and for "aQueryObject.aQueryObject.aFloat < 2", depth is 3
    
    Parameters:
    
    queryStr - A string containing a query.
  - getExpectedResults
```
protected List getExpectedResults(String queryStr)
```
    Return a Set of expected results of the given queryStr using regionSnapshot as the basis of determining what to expect.
    
    Parameters:
    
    queryStr - A string containing a query.
  - satisfiesQuery
```
public static boolean satisfiesQuery(String queryStr,
                                     QueryObject qo)
```
    Return true of the given qo satisfies the queryStr, false otherwise.
    
    Parameters:
    
    queryStr - A string containing a query.
    
    qo - The QueryObject to test against the query.
  - 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.
  - getNextQueryName
```
protected String getNextQueryName()
```
    Return a unique query name.
  - getReadableQueryString
```
public static String getReadableQueryString(String queryStr)
```
    Returns the given query string with addition information if necessary to make it more readable, such as converting any characters to their byte equivalent (to aid with debugging).
    
    Parameters:
    
    queryStr - A query string.
  - 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.
  - saveRegionSnapshot
```
protected void saveRegionSnapshot()
```
    saveRegionSnapshot() - save this VMs internal RegionSnapshot (HashMap) in case of tx failure during commit. for use in serial tx tests only (to return the internal region snapshot to its previosus state when a TransactionDataNodeHasDeparted, TransactionDataRebalanced or TransactionInDoubt Exception encountered at commit time.
  - restoreRegionSnapshot
```
protected void restoreRegionSnapshot()
```
    restoreRegionSnapshot() - restore this VMs internal RegionSnapshot (HashMap) after a tx failure during commit. for use in serial tx tests only (to return the internal region snapshot to its previosus state when a TransactionDataNodeHasDeparted, TransactionDataRebalanced or TransactionInDoubt Exception encountered at commit time.

Class CQTest

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

testInstance

versionHelperInstance

VmIDStr

ThreadIDStr

minTaskGranularitySec

minTaskGranularityMS

numOpsPerTask

isBridgeConfiguration

isBridgeClient

numThreadsInClients

aRegion

qService

uniqueKeyIndex

isSerialExecution

highAvailability

upperThreshold

lowerThreshold

uniqueKeys

queryDepth

numQueriesPerClientVM

queryMap

secondsToRun

cacheIsClosed

disconnected

numThreadsInThisVM

CQsOn

useDeltaObjects

isOldClient

regionSnapshot

txRegionSnapshot

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

concVerifyCoordinator

Constructor Detail

CQTest

Method Detail

HydraTask_initializeClient

HydraTask_initializeClient1

HydraTask_initializeClient2

HydraTask_initializeBridgeServer

HydraTask_initializeAccessorServer1

HydraTask_initializeAccessorServer2

HydraTask_initializeServer1

HydraTask_initializeServer2

HydraTask_initializeDataHostServer

HydraTask_missingJarTest

initializeRegion

initializeQueryService

initializeInstance

initializeCQs

HydraTask_doRROpsAndVerify

HydraTask_load

HydraTask_doConcOpsAndVerify

HydraTask_executeCQsAndVerify

HydraTask_HADoEntryOps

HydraTask_HAController

HydraTask_loadToUpperThreshold

HydraTask_recordLoadToBB

generateNumericQueries

generateStringQueries