SerialQueryAndEntryOpsTest (GemFire XD Java API Documentation)

java.lang.Object
- query.QueryTest
- - query.SerialQueryAndEntryOpsTest

```
public class SerialQueryAndEntryOpsTest
extends QueryTest
```
A version of the QueryTask that performs operations serially. It also validates the state of the cache after each operation. Note that this test must be configured to use regions whose scope is DISTRIBUTED_ACK or GLOBAL.

Nested Class Summary
- Nested classes/interfaces inherited from class query.QueryTest
  QueryTest.QueryObserverImpl

Field Summary

Fields
Modifier and Type Field and Description

static AtomicBoolean firstTimeInvocation

protected String[] queries

protected static String SELECT_STRING
- Fields inherited from class query.QueryTest
  ADD_OPERATION, COUNT_QUERY_OPERATION, countQueryResults, CREATE_INDEX_OPERATION, createCallbackPrefix, DESTROY_OPERATION, destroyCallbackPrefix, distLockService, enumWhereClause1, enumWhereClause2, ID_COMPACT_RANGE_INDEX, ID_HASH_INDEX, ID_RANGE_INDEX, ignoreQueryExecTimeOutException, INVALIDATE_OPERATION, invalidateCallbackPrefix, isCarefulValidation, isMirrored, isSerialExecution, LOCAL_DESTROY_OPERATION, LOCAL_INVALIDATE_OPERATION, LOCK_NAME, LOCK_SERVICE_NAME, MAP_RANGE_INDEX_1, MAP_RANGE_INDEX_2, maxObjects, MILLIS_TO_WAIT, minTaskGranularityMS, minTaskGranularitySec, numOfRegions, numQueries, numVMs, origClassLoader, pdxReadSerialized, PDXSTRING_QUERY_OPERATION, pool, QUERY_OPERATION, queryLimit, queryTest, randomValues, READ_OPERATION, REGION_NAME, REGION_WITHOUT_INDEX, REMOVE_INDEX_OPERATION, statisticsWrittenToBB, STATUS_COMPACT_RANGE_INDEX, STATUS_HASH_INDEX, STATUS_RANGE_INDEX, UPDATE_OPERATION, updateCallbackPrefix, useEvictionController

Fields
Modifier and Type	Field and Description
`static AtomicBoolean`	`firstTimeInvocation`
`protected String[]`	`queries`
`protected static String`	`SELECT_STRING`

Constructor Summary

Constructors
Constructor and Description

SerialQueryAndEntryOpsTest()

Constructors
Constructor and Description
`SerialQueryAndEntryOpsTest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`addObject(com.gemstone.gemfire.cache.Region aRegion, boolean aBoolean)`
`protected void`	`checkEventCounters()` Check all counters from EventCountersBB.
`protected void`	`checkEventCounters(boolean numCloseIsExact)` Check event counters.
`protected void`	`destroyObject(com.gemstone.gemfire.cache.Region aRegion, boolean isLocalDestroy)`
`protected void`	`doQuery(boolean logAddition)` This method will be called if this is a serial execution environment.
`protected int`	`getNumVMsWithListeners()`
`protected void`	`getQueryResultsWithIndexes()` Obtain the query results with indexes
`static void`	`HydraTask_attachQueryObserver()`
`static void`	`HydraTask_calculateAndVerifyIndexSizesForPR()` Calculate and verify index sizes for a partitioned region.
`static void`	`HydraTask_calculateIndexSizesForPR()` This method calculates the actual index sizes using index statistics and compares them with the expected index sizes based on the data in region.
`static void`	`HydraTask_createIndexes()`
`static void`	`HydraTask_getQueryResultsWithIndexes()` Obtain the query results with indexes
`static void`	`HydraTask_initialize()`
`static void`	`HydraTask_stopStartVMs_bridgeVMs()` Randomly stop and restart vms.
`static void`	`HydraTask_stopStartVMs_queryPRData()` Randomly stop and restart vms and query on partitioned region data.
`static void`	`HydraTask_stopVM_verifyIndex_queryPRData_startVM()` Randomly stop and restart vms and query on partitioned region data.
`static void`	`HydraTask_validateCountStar()`
`static void`	`HydraTask_verifyIndexSize_QueryData_EatExpectedException()` Hydra task to verify index data structures which were created in a node.
`static void`	`HydraTask_verifyIndexSize_QueryData()` HydraTask which verifies index datastructures and also queries data.
`static void`	`HydraTask_verifyIndexSizes()` This method calculates the actual index sizes using index statistics and compares them with the expected index sizes based on the data in region.
`static void`	`HydraTask_verifyQueryResultsWithAndWithoutIndexes()` Obtain the query results with and without indexes and compare them.
`protected void`	`invalidateObject(com.gemstone.gemfire.cache.Region aRegion, boolean isLocalInvalidate)`
`static void`	`queryData_EatExpectedException()`
`static void`	`queryData()` Execute specific queries on the data and verify result sizes based on region sizes.
`protected String`	`randRgn()`
`protected void`	`readObject(com.gemstone.gemfire.cache.Region aRegion)` Fetches (reads) the value of a randomly selected entry in the given region.
`protected void`	`updateObject(com.gemstone.gemfire.cache.Region aRegion)` Updates the "first" entry in a given region
`protected void`	`validateIndex(String expectedIndexName, String query)` This method will be called if this is a serial execution environment.
`protected void`	`validateQuery(com.gemstone.gemfire.cache.Region aRegion)`
`static void`	`verifyIndexSizes_PR(com.gemstone.gemfire.cache.query.internal.index.PartitionedIndex index, com.gemstone.gemfire.internal.cache.PartitionedRegion region)` This method calculates the actual index sizes using index statistics and compares them with the expected index sizes based on the data in region.
`static void`	`verifyIndexSizes(com.gemstone.gemfire.cache.query.Index index, com.gemstone.gemfire.cache.Region region)` Verify index size based on the region size, for a non-partitioned region
`protected void`	`verifyQueryResultsWithAndWithoutIndexes()` Obtain the query results with and without indexes and compare them.

Methods inherited from class query.QueryTest
compareQueryResultsBetweenIndexRegions, compareQueryResultsWithoutAndWithIndexes, createCacheFromXml, createIndex_task, createIndex, createRootRegions, doCountQuery, doEntryAndQueryOperations, doPdxStringQuery, getCacheListener, getNumNames, getObjectToAdd, getOperation, getUpdateObject, handleRegionDestroyedException, HydraTask_closeTask_writeQueryStats_To_Blackboard, HydraTask_compareQueryResultsBetweenIndexRegions, HydraTask_doEntryAndQueryOperations, HydraTask_endTask_verifyQueryStats_With_Blackboard, HydraTask_endTask, HydraTask_initialize_clientCache, HydraTask_initialize_withIndexTestHook, HydraTask_initialize_xml, HydraTask_iterate, HydraTask_load, HydraTask_populateRegions, HydraTask_printBB, initialize_clientCache, initialize, initialize, iterateRegion, logExecutionNumber, removeIndex, updateObject, validateQueryLimit, verifyCountQueryResults, verifyObjectDestroyed, verifyObjectInvalidated

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

- Field Detail
  - firstTimeInvocation
```
public static AtomicBoolean firstTimeInvocation
```
  - SELECT_STRING
```
protected static String SELECT_STRING
```
  - queries
```
protected String[] queries
```
- Constructor Detail
  - SerialQueryAndEntryOpsTest
```
public SerialQueryAndEntryOpsTest()
```
- Method Detail
  - randRgn
```
protected String randRgn()
```
    Overrides:
    
    randRgn in class QueryTest
  - HydraTask_initialize
```
public static void HydraTask_initialize()
```
  - HydraTask_createIndexes
```
public static void HydraTask_createIndexes()
```
  - HydraTask_attachQueryObserver
```
public static void HydraTask_attachQueryObserver()
```
  - getNumVMsWithListeners
```
protected int getNumVMsWithListeners()
```
    Overrides:
    
    getNumVMsWithListeners in class QueryTest
  - addObject
```
protected void addObject(com.gemstone.gemfire.cache.Region aRegion,
                         boolean aBoolean)
```
    Overrides:
    
    addObject in class QueryTest
  - invalidateObject
```
protected void invalidateObject(com.gemstone.gemfire.cache.Region aRegion,
                                boolean isLocalInvalidate)
```
    Overrides:
    
    invalidateObject in class QueryTest
  - destroyObject
```
protected void destroyObject(com.gemstone.gemfire.cache.Region aRegion,
                             boolean isLocalDestroy)
```
    Overrides:
    
    destroyObject in class QueryTest
  - updateObject
```
protected void updateObject(com.gemstone.gemfire.cache.Region aRegion)
```
    Description copied from class: QueryTest
    
    Updates the "first" entry in a given region
    
    Overrides:
    
    updateObject in class QueryTest
  - readObject
```
protected void readObject(com.gemstone.gemfire.cache.Region aRegion)
```
    Description copied from class: QueryTest
    
    Fetches (reads) the value of a randomly selected entry in the given region.
    
    Overrides:
    
    readObject in class QueryTest
  - HydraTask_validateCountStar
```
public static void HydraTask_validateCountStar()
                                        throws Throwable
```
    Throws:
    
    Throwable
  - validateQuery
```
protected void validateQuery(com.gemstone.gemfire.cache.Region aRegion)
```
  - checkEventCounters
```
protected void checkEventCounters()
```
    Check all counters from EventCountersBB. This verifies that all events were distributed to all VMs (full distribution) and that no region or local events occurred.
    
    Overrides:
    
    checkEventCounters in class QueryTest
  - checkEventCounters
```
protected void checkEventCounters(boolean numCloseIsExact)
```
    Check event counters. If numCloseIsExact is true, then the number of close events must be an exact match, otherwise allow numClose events to be the minimum of the expected numClose counter. This is useful in tests where the timing of shutting down the VMs/C clients may or may not cause a close event.
    
    Parameters:
    
    numCloseIsExact - True if the numClose event counters must exactly match the expected numClose value, false if the numClose event counters must be no less than the expected numClose counter.
  - doQuery
```
protected void doQuery(boolean logAddition)
```
    This method will be called if this is a serial execution environment. If QueryPrms-isIndexUsageValidation is set to true it will perform various index usage checks. It will utilize IndexValidator and blackboard for this purpose. If not, then it will call super.doQuery() which will perform simple query results validation using query observer and blackboard.
    
    Overrides:
    
    doQuery in class QueryTest
  - validateIndex
```
protected void validateIndex(String expectedIndexName,
                             String query)
```
    This method will be called if this is a serial execution environment. If QueryPrms-isIndexUsageValidation is set to true then this method will be called by doQuery(). It will perform various index usage checks. It will utilize IndexValidator and blackboard for this purpose.
  - HydraTask_verifyIndexSize_QueryData_EatExpectedException
```
public static void HydraTask_verifyIndexSize_QueryData_EatExpectedException()
```
    Hydra task to verify index data structures which were created in a node. This also performs querying on the data.
  - queryData_EatExpectedException
```
public static void queryData_EatExpectedException()
```
  - queryData
```
public static void queryData()
                      throws Exception
```
    Execute specific queries on the data and verify result sizes based on region sizes.
    
    Throws:
    
    Exception
  - HydraTask_verifyIndexSize_QueryData
```
public static void HydraTask_verifyIndexSize_QueryData()
                                                throws Exception
```
    HydraTask which verifies index datastructures and also queries data.
    
    Throws:
    
    Exception
  - HydraTask_calculateAndVerifyIndexSizesForPR
```
public static void HydraTask_calculateAndVerifyIndexSizesForPR()
```
    Calculate and verify index sizes for a partitioned region.
  - HydraTask_calculateIndexSizesForPR
```
public static void HydraTask_calculateIndexSizesForPR()
```
    This method calculates the actual index sizes using index statistics and compares them with the expected index sizes based on the data in region. For partitioned region the index sizes are calculated by aggregating the sizes of all bucket indexes.
  - verifyIndexSizes
```
public static void verifyIndexSizes(com.gemstone.gemfire.cache.query.Index index,
                                    com.gemstone.gemfire.cache.Region region)
```
    Verify index size based on the region size, for a non-partitioned region
    
    Parameters:
    
    index -
    
    region -
  - verifyIndexSizes_PR
```
public static void verifyIndexSizes_PR(com.gemstone.gemfire.cache.query.internal.index.PartitionedIndex index,
                                       com.gemstone.gemfire.internal.cache.PartitionedRegion region)
```
    This method calculates the actual index sizes using index statistics and compares them with the expected index sizes based on the data in region. For partitioned region the index sizes are calculated by aggregating the sizes of all bucket indexes.
  - HydraTask_verifyIndexSizes
```
public static void HydraTask_verifyIndexSizes()
```
    This method calculates the actual index sizes using index statistics and compares them with the expected index sizes based on the data in region.
  - HydraTask_getQueryResultsWithIndexes
```
public static void HydraTask_getQueryResultsWithIndexes()
```
    Obtain the query results with indexes
  - HydraTask_verifyQueryResultsWithAndWithoutIndexes
```
public static void HydraTask_verifyQueryResultsWithAndWithoutIndexes()
```
    Obtain the query results with and without indexes and compare them. This is general done in CLOSE TASK after doing various region operation like add/destroy/update in TASK This provides an extra verification for various index updates in Hydra concurrent environment.
  - getQueryResultsWithIndexes
```
protected void getQueryResultsWithIndexes()
```
    Obtain the query results with indexes
  - verifyQueryResultsWithAndWithoutIndexes
```
protected void verifyQueryResultsWithAndWithoutIndexes()
```
    Obtain the query results with and without indexes and compare them. This is general done in CLOSE TASK after doing various region operation like add/destroy/update in TASK This provides an extra verification for various index updates in Hydra concurrent environment.
  - HydraTask_stopStartVMs_bridgeVMs
```
public static void HydraTask_stopStartVMs_bridgeVMs()
```
    Randomly stop and restart vms.
  - HydraTask_stopStartVMs_queryPRData
```
public static void HydraTask_stopStartVMs_queryPRData()
```
    Randomly stop and restart vms and query on partitioned region data.
  - HydraTask_stopVM_verifyIndex_queryPRData_startVM
```
public static void HydraTask_stopVM_verifyIndex_queryPRData_startVM()
```
    Randomly stop and restart vms and query on partitioned region data.

Class SerialQueryAndEntryOpsTest

Nested Class Summary

Nested classes/interfaces inherited from class query.QueryTest

Field Summary

Fields inherited from class query.QueryTest

Constructor Summary

Method Summary

Methods inherited from class query.QueryTest

Methods inherited from class java.lang.Object

Field Detail

firstTimeInvocation

SELECT_STRING

queries

Constructor Detail

SerialQueryAndEntryOpsTest

Method Detail

randRgn

HydraTask_initialize

HydraTask_createIndexes

HydraTask_attachQueryObserver

getNumVMsWithListeners

addObject

invalidateObject

destroyObject

updateObject

readObject

HydraTask_validateCountStar

validateQuery

checkEventCounters

checkEventCounters

doQuery

validateIndex

HydraTask_verifyIndexSize_QueryData_EatExpectedException

queryData_EatExpectedException

queryData

HydraTask_verifyIndexSize_QueryData

HydraTask_calculateAndVerifyIndexSizesForPR

HydraTask_calculateIndexSizesForPR

verifyIndexSizes

verifyIndexSizes_PR

HydraTask_verifyIndexSizes

HydraTask_getQueryResultsWithIndexes

HydraTask_verifyQueryResultsWithAndWithoutIndexes

getQueryResultsWithIndexes

verifyQueryResultsWithAndWithoutIndexes

HydraTask_stopStartVMs_bridgeVMs

HydraTask_stopStartVMs_queryPRData

HydraTask_stopVM_verifyIndex_queryPRData_startVM