TxUtil (GemFire XD Java API Documentation)

java.lang.Object
- tx.TxUtil

Direct Known Subclasses:

RtxUtil, TxUtilKeyRange, TxViewUtil
```
public class TxUtil
extends Object
```
A class to contain methods useful for all transactions tests.

Field Summary

Fields
Modifier and Type	Field and Description
`protected static String`	`createCallbackPrefix`
`protected static String`	`destroyCallbackPrefix`
`protected static String`	`invalidateCallbackPrefix`
`protected boolean`	`isBridgeClient`
`protected boolean`	`isSerialExecution`
`protected int`	`maxKeys`
`protected static String`	`memberIdString`
`int`	`modValInitializer`
`static int`	`NO_REPLICATION`
`static int`	`NO_REPLICATION_RESTRICTION`
`RandomValues`	`randomValues`
`protected static String`	`regionDestroyCallbackPrefix`
`protected static String`	`regionInvalidateCallbackPrefix`
`boolean`	`suspendResume`
`protected HydraThreadLocal`	`txState`
`static TxUtil`	`txUtilInstance`
`protected static String`	`updateCallbackPrefix`

Constructor Summary

Constructors
Constructor and Description

TxUtil()

Constructors
Constructor and Description
`TxUtil()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`clearDestroyedRegions()` Clear destroyed regions from the blackboard.
`Operation`	`closeCache()` Closes the cache.
`boolean`	`containsKey(com.gemstone.gemfire.cache.Region aRegion, Object key)` Call containsKey on the given region and key using suspend and resume.
`Operation`	`containsKeyExisting(com.gemstone.gemfire.cache.Region aRegion)` Does a containsKey in aRegion with a key existing in aRegion.
`Operation`	`containsValueExisting(com.gemstone.gemfire.cache.Region aRegion)` Does a containsValue in aRegion with a key existing in aRegion.
`Operation`	`containsValueForKeyExisting(com.gemstone.gemfire.cache.Region aRegion)` Does a containsValueForKey in aRegion with a key existing in aRegion.
`void`	`createAllDestroyedRegions(boolean fill)` Creates all regions that currently don't exist.
`void`	`createDestroyedRegionsFromBB(boolean fill)` Creates all regions previously destroyed that were recorded in the TxBB shared map entry TxBB.DestroyedRegionsKey.
`void`	`createEntries(com.gemstone.gemfire.cache.Region aRegion)` Create TxPrms.maxKeys entries in the given region Initializes ValueHolder.modVal sequentially 1-n across all regions
`Operation`	`createEntry(com.gemstone.gemfire.cache.Region aRegion, boolean exists)` Does a creates for a key.
`void`	`createPartitionedRegions()`
`Operation`	`createRegion()` Creates a region that was previously destroyed.
`void`	`createRegionHierarchy()` Create a forest of regions based on numRootRegions, numSubRegions, regionDepth
`Object[]`	`createRegionWithPath(String regionName, boolean fill)` Given a region name, return the region instance for it.
`Operation`	`destroyEntry(boolean isLocalDestroy, com.gemstone.gemfire.cache.Region aRegion, Object key, boolean entryNotFoundExcOK)` Destroys an entry in aRegion.
`Operation`	`destroyRegion(boolean isLocalDestroy, com.gemstone.gemfire.cache.Region aRegion)` Destroys the given region.
`void`	`dispAllKeys()` Method to traverse tree & display all keys
`OpList`	`doNonrepeatableReadOperations(int numOperationsToDo)` Do random non-repeatable read operations on random regions.
`static OpList`	`doOperations()` Do random operations on random regions using the hydra parameter TxPrms.operations as the list of available operations and TxPrms.numOps as the number of operations to do.
`static OpList`	`doOperations(boolean allowGetOperations)` Do random operations on random regions using the hydra parameter TxPrms.operations as the list of available operations and TxPrms.numOps as the number of operations to do.
`OpList`	`doOperations(Vector operations, int numOperationsToDo)` Do random operations on random regions.
`OpList`	`doOperations(Vector operations, int numOperationsToDo, boolean allowGetOperations)` Do random operations on random regions.
`OpList`	`doRepeatableReadOperations(int numOperationsToDo)` Do random repeatable read operations on random regions.
`Operation`	`getAll(com.gemstone.gemfire.cache.Region r)`
`Operation`	`getEntry(com.gemstone.gemfire.cache.Region aRegion, Object key, String opName)` Does a get with the given key.
`Operation`	`getEntryWithExistingKey(com.gemstone.gemfire.cache.Region aRegion)` Does a getEntry in aRegion with a key existing in aRegion.
`Operation`	`getEntryWithNewKey(com.gemstone.gemfire.cache.Region aRegion)` Gets a value in aRegion with a the next new (never-before_used) key.
`Operation`	`getEntryWithPreviousKey(com.gemstone.gemfire.cache.Region aRegion)` Gets a value in aRegion with a random key that was previously used in the test.
`Object`	`getNewKey(com.gemstone.gemfire.cache.Region aRegion)` Gets a new (never before seen) key
`Object`	`getNewValue(Object key)`
`Object`	`getRandomKey(com.gemstone.gemfire.cache.Region aRegion)` Get a random key from the given region.
`Object`	`getRandomKey(com.gemstone.gemfire.cache.Region aRegion, Object excludeKey)` Get a random key from the given region, excluding the key specified by excludeKey.
`com.gemstone.gemfire.cache.Region`	`getRandomRegion(boolean allowRootRegion)` Return a currently existing random region.
`com.gemstone.gemfire.cache.Region`	`getRandomRegion(boolean allowRootRegion, com.gemstone.gemfire.cache.Region excludeRegion, int restriction)` Return a currently existing random region.
`com.gemstone.gemfire.cache.Region`	`getRandomRegionNoReplication(boolean allowRootRegion)` Return a currently existing random region that is not replicated, nor are any of its subregions.
`String`	`getRegionConfigFromBB(String fullPathOfRegion)` Given a full path for a region, return its (String) regionConfig The shared map has one key per VM in the form: TxBB.RegConfigForPIDKey_xxxxx, where xxxxs is the PID for the current VM.
`Map`	`getRegionConfigMap()` Get a map containing the RegionDefintions for this VM.
`static long`	`getRoundRobinNumber()` Return the current roundRobin number.
`Set`	`getSubregions(com.gemstone.gemfire.cache.Region aRegion, boolean recursive)` Return a Set of subregions of the given region, while handling regionDestroyedExceptions.
`Object`	`getValueInVM(com.gemstone.gemfire.cache.Region aRegion, Object key)` Call getValueInVM on the given region and key
`Object`	`getValueInVM(com.gemstone.gemfire.cache.Region aRegion, Object key, boolean translateToInvalidToken)`
`Operation`	`getWithExistingKey(com.gemstone.gemfire.cache.Region aRegion)` Gets a value in aRegion with a key existing in aRegion.
`static void`	`HydraTask_createPartitionedRegions()` Create the cache and Region (non-colocated PartitionedRegions)
`static void`	`HydraTask_createRegionForest()` Hydra task to create a forest of region hierarchies.
`static void`	`HydraTask_doOperations()`
`static void`	`HydraTask_populateRegions()`
`static void`	`HydraTask_startBridgeServer()` Stops the bridge server in this VM.
`static void`	`HydraTask_stopBridgeServer()` Stops the bridge server in this VM.
`void`	`initialize()`
`static boolean`	`inTxThreadWithTxInProgress()`
`static boolean`	`inTxVm()`
`Operation`	`invalEntry(boolean isLocalInval, com.gemstone.gemfire.cache.Region aRegion, Object key, boolean entryNotFoundExcOK)` Invalidates an entry in aRegion.
`Operation`	`invalRegion(boolean isLocalInval, com.gemstone.gemfire.cache.Region aRegion)` Invalidates the given region.
`boolean`	`isHierReplicated(com.gemstone.gemfire.cache.Region aRegion)` Return true if the region or any of its subregions is replicated, return false otherwise.
`static void`	`logExecutionNumber()` Log the number of tasks that have been executed in this test.
`static boolean`	`logRoundRobinNumber()` Log the "round" number for this test.
`void`	`populateRegions()`
`List<Operation>`	`putAll(com.gemstone.gemfire.cache.Region r)`
`Operation`	`putEntry(com.gemstone.gemfire.cache.Region aRegion, Object key, BaseValueHolder value, String opName)` Puts a new key/value in the given region.
`void`	`recordDestroyedRegion(com.gemstone.gemfire.cache.Region aRegion)` Save destroyed region(s) in the blackboard.
`void`	`recordRegionConfigInBB(String fullPathOfRegion, String regionConfig)` Given a full path for a region, and its (String) regionConfig, write it to the TxBB blackboard shared map.
`Operation`	`removeEntry(com.gemstone.gemfire.cache.Region aRegion, boolean exists)` Removes an entry in aRegion.
`static void`	`StartTask_initialize()` Hydra start task to initialize dataPolicies to use in ViewTests This allows specification of the txThread (client1) as Proxy or Cached and the same for the validator (view) threads.
`void`	`summarizeRegionHier()` Log the regions and the number of keys in each.
`boolean`	`supportsConcurrentMapOps(com.gemstone.gemfire.cache.Region aRegion)` Determine whether or not concurrent map operations are supported for the given region.
`Operation`	`updateEntry(com.gemstone.gemfire.cache.Region aRegion, Object key)` Updates an existing entry in aRegion.

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

- Field Detail
  - txUtilInstance
```
public static TxUtil txUtilInstance
```
  - randomValues
```
public RandomValues randomValues
```
  - maxKeys
```
protected int maxKeys
```
  - modValInitializer
```
public int modValInitializer
```
  - isSerialExecution
```
protected boolean isSerialExecution
```
  - isBridgeClient
```
protected boolean isBridgeClient
```
  - txState
```
protected HydraThreadLocal txState
```
  - suspendResume
```
public boolean suspendResume
```
  - NO_REPLICATION_RESTRICTION
```
public static final int NO_REPLICATION_RESTRICTION
```
    See Also:
    
    Constant Field Values
  - NO_REPLICATION
```
public static final int NO_REPLICATION
```
    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
  - memberIdString
```
protected static final String memberIdString
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - TxUtil
```
public TxUtil()
```
- Method Detail
  - StartTask_initialize
```
public static void StartTask_initialize()
```
    Hydra start task to initialize dataPolicies to use in ViewTests This allows specification of the txThread (client1) as Proxy or Cached and the same for the validator (view) threads.
  - initialize
```
public void initialize()
```
  - HydraTask_startBridgeServer
```
public static void HydraTask_startBridgeServer()
```
    Stops the bridge server in this VM.
  - HydraTask_stopBridgeServer
```
public static void HydraTask_stopBridgeServer()
```
    Stops the bridge server in this VM.
  - HydraTask_createRegionForest
```
public static void HydraTask_createRegionForest()
```
    Hydra task to create a forest of region hierarchies. This task can be called from more than one thread in the same VM.
  - HydraTask_createPartitionedRegions
```
public static void HydraTask_createPartitionedRegions()
```
    Create the cache and Region (non-colocated PartitionedRegions)
  - createPartitionedRegions
```
public void createPartitionedRegions()
```
  - HydraTask_populateRegions
```
public static void HydraTask_populateRegions()
```
  - populateRegions
```
public void populateRegions()
```
  - HydraTask_doOperations
```
public static void HydraTask_doOperations()
```
  - logExecutionNumber
```
public static void logExecutionNumber()
```
    Log the number of tasks that have been executed in this test. Useful for debugging/analyzing serial execution tests.
  - logRoundRobinNumber
```
public static boolean logRoundRobinNumber()
```
    Log the "round" number for this test. This is called for serial execution tests that use round-robin scheduling. Each task can call this method and it will remember the first thread in the round, then increment and log a counter each time a new round begins.
  - getRoundRobinNumber
```
public static long getRoundRobinNumber()
```
    Return the current roundRobin number.
  - createRegionHierarchy
```
public void createRegionHierarchy()
```
    Create a forest of regions based on numRootRegions, numSubRegions, regionDepth
  - createEntries
```
public void createEntries(com.gemstone.gemfire.cache.Region aRegion)
```
    Create TxPrms.maxKeys entries in the given region Initializes ValueHolder.modVal sequentially 1-n across all regions
  - getRandomRegion
```
public com.gemstone.gemfire.cache.Region getRandomRegion(boolean allowRootRegion)
```
    Return a currently existing random region.
    
    Parameters:
    
    allowRootRegion - true if this call can return the root region, false otherwise.
    
    Returns:
    
    A random region, or null of none available.
  - getRandomRegionNoReplication
```
public com.gemstone.gemfire.cache.Region getRandomRegionNoReplication(boolean allowRootRegion)
```
    Return a currently existing random region that is not replicated, nor are any of its subregions.
    
    Parameters:
    
    allowRootRegion - true if this call can return the root region, false otherwise.
    
    Returns:
    
    A random region, or null of none available.
  - getRandomRegion
```
public com.gemstone.gemfire.cache.Region getRandomRegion(boolean allowRootRegion,
                                                         com.gemstone.gemfire.cache.Region excludeRegion,
                                                         int restriction)
```
    Return a currently existing random region.
    
    Parameters:
    
    allowRootRegion - true if this call can return the root region, false otherwise.
    
    excludeRegion - Return a region other than this region, or null if none to exclude.
    
    restriction - Restriction on what region can be returned, for example NO_REPLICATION_RESTRICTION, NO_REPLICATION
    
    Returns:
    
    A random region, or null of none available.
  - dispAllKeys
```
public void dispAllKeys()
```
    Method to traverse tree & display all keys
  - summarizeRegionHier
```
public void summarizeRegionHier()
```
    Log the regions and the number of keys in each.
  - doOperations
```
public static OpList doOperations()
```
    Do random operations on random regions using the hydra parameter TxPrms.operations as the list of available operations and TxPrms.numOps as the number of operations to do.
  - doOperations
```
public static OpList doOperations(boolean allowGetOperations)
```
    Do random operations on random regions using the hydra parameter TxPrms.operations as the list of available operations and TxPrms.numOps as the number of operations to do.
    
    Parameters:
    
    allowGetOperations - - to prevent proxy clients from attempting gets (since they have no storage this always invokes the loader and oldValue is always reported as null).
  - doOperations
```
public OpList doOperations(Vector operations,
                           int numOperationsToDo)
```
    Do random operations on random regions.
    
    Parameters:
    
    operations - - a Vector of operations to choose from.
    
    numOperationsToDo - - the number of operations to execute.
  - doOperations
```
public OpList doOperations(Vector operations,
                           int numOperationsToDo,
                           boolean allowGetOperations)
```
    Do random operations on random regions.
    
    Parameters:
    
    operations - - a Vector of operations to choose from.
    
    numOperationsToDo - - the number of operations to execute.
    
    allowGetOperations - - if false, replace entry-get ops with entry-create
  - doRepeatableReadOperations
```
public OpList doRepeatableReadOperations(int numOperationsToDo)
```
    Do random repeatable read operations on random regions. See bugmail for 36688 for a list of supported repeatable read operations.
    
    Parameters:
    
    numOperationsToDo - The number of repeatable read operations to do.
  - doNonrepeatableReadOperations
```
public OpList doNonrepeatableReadOperations(int numOperationsToDo)
```
    Do random non-repeatable read operations on random regions. See bugmail for 36688 for a list of supported repeatable read operations. TxPrms.numOps as the number of operations to do.
    
    Parameters:
    
    numOperationsToDo - The number of repeatable read operations to do.
  - createEntry
```
public Operation createEntry(com.gemstone.gemfire.cache.Region aRegion,
                             boolean exists)
```
    Does a creates for a key.
    
    Parameters:
    
    aRegion - The region to create the new key in.
    
    exists - True if the key to create already exists, false if the key has never before been created.
    
    Returns:
    
    An instance of Operation describing the create operation.
  - updateEntry
```
public Operation updateEntry(com.gemstone.gemfire.cache.Region aRegion,
                             Object key)
```
    Updates an existing entry in aRegion. The value in the key is increment by 1.
    
    Parameters:
    
    aRegion - The region to modify a key in.
    
    key - The key to modify.
    
    Returns:
    
    An instance of Operation describing the update operation.
  - putAll
```
public List<Operation> putAll(com.gemstone.gemfire.cache.Region r)
```
  - destroyEntry
```
public Operation destroyEntry(boolean isLocalDestroy,
                              com.gemstone.gemfire.cache.Region aRegion,
                              Object key,
                              boolean entryNotFoundExcOK)
```
    Destroys an entry in aRegion.
    
    Parameters:
    
    isLocalDestroy - True if the opertion is a local destroy, false otherwise.
    
    aRegion - The region to destroy the entry in.
    
    key - The key to destroy.
    
    entryNotFoundExcOK - True if it is ok to get an EntryNotFoundException on this destroy.
    
    Returns:
    
    An instance of Operation describing the destroy operation.
  - removeEntry
```
public Operation removeEntry(com.gemstone.gemfire.cache.Region aRegion,
                             boolean exists)
```
    Removes an entry in aRegion.
    
    Parameters:
    
    aRegion - The region to remove the entry from.
    
    exists - True if the key exists in the region, false otherwise.
    
    Returns:
    
    An instance of Operation describing the remove operation.
  - invalEntry
```
public Operation invalEntry(boolean isLocalInval,
                            com.gemstone.gemfire.cache.Region aRegion,
                            Object key,
                            boolean entryNotFoundExcOK)
```
    Invalidates an entry in aRegion.
    
    Parameters:
    
    isLocalInval - True if the opertion is a local invalidate, false otherwise.
    
    aRegion - The region to invalidate the entry in.
    
    key - The key to invalidate.
    
    entryNotFoundExcOK - True if it is ok to get an EntryNotFoundException on this invalidate.
    
    Returns:
    
    An instance of Operation describing the invalidate operation.
  - getWithExistingKey
```
public Operation getWithExistingKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Gets a value in aRegion with a key existing in aRegion.
    
    Parameters:
    
    aRegion - The region to get from.
    
    Returns:
    
    An instance of Operation describing the get operation.
  - getAll
```
public Operation getAll(com.gemstone.gemfire.cache.Region r)
```
  - getEntryWithExistingKey
```
public Operation getEntryWithExistingKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Does a getEntry in aRegion with a key existing in aRegion.
    
    Parameters:
    
    aRegion - The region to get from.
    
    Returns:
    
    An instance of Operation describing the get operation.
  - containsKeyExisting
```
public Operation containsKeyExisting(com.gemstone.gemfire.cache.Region aRegion)
```
    Does a containsKey in aRegion with a key existing in aRegion.
    
    Parameters:
    
    aRegion - The region to get from.
    
    Returns:
    
    An instance of Operation describing the get operation.
  - containsValueForKeyExisting
```
public Operation containsValueForKeyExisting(com.gemstone.gemfire.cache.Region aRegion)
```
    Does a containsValueForKey in aRegion with a key existing in aRegion.
    
    Parameters:
    
    aRegion - The region to get from.
    
    Returns:
    
    An instance of Operation describing the get operation.
  - containsValueExisting
```
public Operation containsValueExisting(com.gemstone.gemfire.cache.Region aRegion)
```
    Does a containsValue in aRegion with a key existing in aRegion.
    
    Parameters:
    
    aRegion - The region to get from.
    
    Returns:
    
    An instance of Operation describing the get operation.
  - getEntryWithPreviousKey
```
public Operation getEntryWithPreviousKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Gets a value in aRegion with a random key that was previously used in the test.
    
    Parameters:
    
    aRegion - The region to get from.
    
    Returns:
    
    An instance of Operation describing the get operation.
  - getNewKey
```
public Object getNewKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Gets a new (never before seen) key
    
    Returns:
    
    the next key from NameFactory
  - getEntryWithNewKey
```
public Operation getEntryWithNewKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Gets a value in aRegion with a the next new (never-before_used) key.
    
    Parameters:
    
    aRegion - The region to get from.
    
    Returns:
    
    An instance of Operation describing the get operation.
  - putEntry
```
public Operation putEntry(com.gemstone.gemfire.cache.Region aRegion,
                          Object key,
                          BaseValueHolder value,
                          String opName)
```
    Puts a new key/value in the given region.
    
    Parameters:
    
    aRegion - The region to create the new key in.
    
    key - The key to use for the put.
    
    value - The value to put.
    
    opName - The operation to use for the returned Operation instance.
    
    Returns:
    
    An instance of Operation describing the put operation.
  - getEntry
```
public Operation getEntry(com.gemstone.gemfire.cache.Region aRegion,
                          Object key,
                          String opName)
```
    Does a get with the given key.
    
    Parameters:
    
    aRegion - The region to create the new key in.
    
    key - The key to use for the put.
    
    opName - The operation to use for the returned Operation instance.
    
    Returns:
    
    An instance of Operation describing the get operation.
  - invalRegion
```
public Operation invalRegion(boolean isLocalInval,
                             com.gemstone.gemfire.cache.Region aRegion)
```
    Invalidates the given region.
    
    Parameters:
    
    isLocalInval - True if the opertion is a local invalidate, false otherwise.
    
    aRegion - The region to invalidate.
    
    Returns:
    
    An instance of Operation describing the invalidate operation.
  - destroyRegion
```
public Operation destroyRegion(boolean isLocalDestroy,
                               com.gemstone.gemfire.cache.Region aRegion)
```
    Destroys the given region.
    
    Parameters:
    
    isLocalDestroy - True if the opertion is a local destroy, false otherwise.
    
    aRegion - The region to destroy.
    
    Returns:
    
    An instance of Operation describing the destroy operation.
  - createRegion
```
public Operation createRegion()
```
    Creates a region that was previously destroyed. If this test is using the BB to track destroyed regions, then choose a region from the BB. Otherwise, look for a previously destroyed region by attempting to create all regions in the hierarchy until one is found to create. This is less efficient than getting the values from the blackboard, but the blackboard is used only for serial execution tests as it can't be maintained properly for concurrently execution tests.
    
    Returns:
    
    An instance of Operation describing the destroy operation.
  - closeCache
```
public Operation closeCache()
```
    Closes the cache.
    
    Returns:
    
    An instance of Operation describing the close operation.
  - getRandomKey
```
public Object getRandomKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Get a random key from the given region. If no keys are present in the region, return null.
    
    Parameters:
    
    aRegion - - The region to get the key from.
  - getRandomKey
```
public Object getRandomKey(com.gemstone.gemfire.cache.Region aRegion,
                           Object excludeKey)
```
    Get a random key from the given region, excluding the key specified by excludeKey. If no keys qualify in the region, return null. If suspendResume is true, then suspend the tx before finding the random key, then resume before returning.
    
    Parameters:
    
    aRegion - - The region to get the key from.
    
    excludeKey - - The region to get the key from.
  - getNewValue
```
public Object getNewValue(Object key)
```
  - createRegionWithPath
```
public Object[] createRegionWithPath(String regionName,
                                     boolean fill)
```
    Given a region name, return the region instance for it. If the region with regionName currently does not exist, create it (and any parents required to create it).
    
    Parameters:
    
    regionName - - The full path name of a region.
    
    fill - - If true, then fill each created region with entries according to TxPrms.maxEntries
  - clearDestroyedRegions
```
public void clearDestroyedRegions()
```
    Clear destroyed regions from the blackboard.
    
    Parameters:
    
    aRegion - The region being destroyed. Save it and all its children.
  - recordDestroyedRegion
```
public void recordDestroyedRegion(com.gemstone.gemfire.cache.Region aRegion)
```
    Save destroyed region(s) in the blackboard.
    
    Parameters:
    
    aRegion - The region being destroyed. Save it and all its children.
  - createDestroyedRegionsFromBB
```
public void createDestroyedRegionsFromBB(boolean fill)
```
    Creates all regions previously destroyed that were recorded in the TxBB shared map entry TxBB.DestroyedRegionsKey.
    
    Parameters:
    
    fill - True if each newly created region should be populated with entries according to TxPrms.maxKeys
  - createAllDestroyedRegions
```
public void createAllDestroyedRegions(boolean fill)
```
    Creates all regions that currently don't exist.
    
    Parameters:
    
    fill - True if each newly created region should be populated with entries according to TxPrms.maxKeys
  - inTxThreadWithTxInProgress
```
public static boolean inTxThreadWithTxInProgress()
```
  - inTxVm
```
public static boolean inTxVm()
```
  - isHierReplicated
```
public boolean isHierReplicated(com.gemstone.gemfire.cache.Region aRegion)
```
    Return true if the region or any of its subregions is replicated, return false otherwise.
    
    Parameters:
    
    aRegion - The region parent to test for replication.
  - getSubregions
```
public Set getSubregions(com.gemstone.gemfire.cache.Region aRegion,
                         boolean recursive)
```
    Return a Set of subregions of the given region, while handling regionDestroyedExceptions.
    
    Parameters:
    
    aRegion - - The region to get subregions of.
    
    recursive - - If true, return all subregions, otherwise only aRegion's subregions.
  - getRegionConfigMap
```
public Map getRegionConfigMap()
```
    Get a map containing the RegionDefintions for this VM. Keys are the full path name for the region, values are the (String) regionConfig
  - recordRegionConfigInBB
```
public void recordRegionConfigInBB(String fullPathOfRegion,
                                   String regionConfig)
```
    Given a full path for a region, and its (String) regionConfig, write it to the TxBB blackboard shared map. The shared map has one key per VM in the form: TxBB.RegConfigForPIDKey_xxxxx, where xxxxs is the PID for the current VM. The value for this key is a Map, containing the fullPathName for the key, and the (String) regionConfig for the value. The blackboard maintains the region config string for each VM (PID)
    
    Parameters:
    
    fullPathOfRegion - - the full path of the region to get the key for.
    
    regionConfig - - The (String) regionConfig for this region
  - getRegionConfigFromBB
```
public String getRegionConfigFromBB(String fullPathOfRegion)
```
    Given a full path for a region, return its (String) regionConfig The shared map has one key per VM in the form: TxBB.RegConfigForPIDKey_xxxxx, where xxxxs is the PID for the current VM. The value for this key is a Map, containing the fullPathName for the key, and the String (RegionConfig) for the value. The blackboard records the (String) region config for each VM (PID)
    
    Parameters:
    
    fullPathOfRegion - - the full path of the region to get the key for.
  - containsKey
```
public boolean containsKey(com.gemstone.gemfire.cache.Region aRegion,
                           Object key)
```
    Call containsKey on the given region and key using suspend and resume.
    
    Parameters:
    
    aRegion - - The region to test for the key.
    
    key - - The key to use for containsKey.
  - getValueInVM
```
public Object getValueInVM(com.gemstone.gemfire.cache.Region aRegion,
                           Object key)
```
    Call getValueInVM on the given region and key
    
    Parameters:
    
    aRegion - - The region to use for the call.
    
    key - - The key to use for the call.
  - getValueInVM
```
public Object getValueInVM(com.gemstone.gemfire.cache.Region aRegion,
                           Object key,
                           boolean translateToInvalidToken)
```
  - supportsConcurrentMapOps
```
public boolean supportsConcurrentMapOps(com.gemstone.gemfire.cache.Region aRegion)
```
    Determine whether or not concurrent map operations are supported for the given region. EMPTY and NORMAL regions are not supported in GemFire 6.5.
    
    Parameters:
    
    aRegion - - The region to check

Class TxUtil

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

txUtilInstance

randomValues

maxKeys

modValInitializer

isSerialExecution

isBridgeClient

txState

suspendResume

NO_REPLICATION_RESTRICTION

NO_REPLICATION

createCallbackPrefix

updateCallbackPrefix

invalidateCallbackPrefix

destroyCallbackPrefix

regionInvalidateCallbackPrefix

regionDestroyCallbackPrefix

memberIdString

Constructor Detail

TxUtil

Method Detail

StartTask_initialize

initialize

HydraTask_startBridgeServer

HydraTask_stopBridgeServer

HydraTask_createRegionForest

HydraTask_createPartitionedRegions

createPartitionedRegions

HydraTask_populateRegions

populateRegions

HydraTask_doOperations

logExecutionNumber

logRoundRobinNumber

getRoundRobinNumber

createRegionHierarchy

createEntries

getRandomRegion

getRandomRegionNoReplication

getRandomRegion

dispAllKeys

summarizeRegionHier

doOperations

doOperations

doOperations

doOperations

doRepeatableReadOperations

doNonrepeatableReadOperations

createEntry

updateEntry

putAll

destroyEntry

removeEntry

invalEntry

getWithExistingKey

getAll

getEntryWithExistingKey

containsKeyExisting

containsValueForKeyExisting

containsValueExisting

getEntryWithPreviousKey

getNewKey

getEntryWithNewKey

putEntry

getEntry

invalRegion

destroyRegion

createRegion

closeCache

getRandomKey

getRandomKey

getNewValue

createRegionWithPath

clearDestroyedRegions

recordDestroyedRegion

createDestroyedRegionsFromBB