ForcedDiscTest (GemFire XD Java API Documentation)

java.lang.Object
- splitBrain.ForcedDiscTest

public class ForcedDiscTest
extends Object

Field Summary

Fields
Modifier and Type	Field and Description
`com.gemstone.gemfire.cache.Region`	`aRegion`
`protected static String`	`createCallbackPrefix`
`protected static String`	`destroyCallbackPrefix`
`protected com.gemstone.gemfire.distributed.DistributedLockService`	`distLockService`
`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_UPDATE_OPERATION`
`protected boolean`	`expectingForcedDisconnect`
`protected static String`	`getCallbackPrefix`
`protected static String`	`invalidateCallbackPrefix`
`protected boolean`	`isBridgeClient`
`protected boolean`	`isBridgeConfiguration`
`protected static String`	`LOCK_NAME`
`protected static String`	`LOCK_SERVICE_NAME`
`protected boolean`	`lockOperations`
`protected int`	`lowerThreshold`
`protected long`	`minTaskGranularityMS`
`protected long`	`minTaskGranularitySec`
`protected int`	`numExceptionThreads`
`protected int`	`numOpsPerTask`
`protected int`	`numVMsToStop`
`protected RandomValues`	`randomValues`
`protected static String`	`regionDestroyCallbackPrefix`
`protected static String`	`regionInvalidateCallbackPrefix`
`protected int`	`secondsToRun`
`protected static Object`	`syncObject`
`static ForcedDiscTest`	`testInstance`
`protected static String`	`updateCallbackPrefix`
`protected int`	`upperThreshold`
`protected static String`	`VmIDStr`

Constructor Summary

Constructors
Constructor and Description

ForcedDiscTest()

Constructors
Constructor and Description
`ForcedDiscTest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`addEntry(com.gemstone.gemfire.cache.Region aRegion)` Add a new entry to the given region.
`protected void`	`causeForcedDisconnect()` Attempt to cause a forced disconnect in the current vm, either through a slow listener with playDead or by becoming sick with playDead.
`protected void`	`checkForLastIteration()` Check if we have run for the desired length of time.
`protected void`	`checkForTimeToStop()` If we have a signal to stop, then throw StopSchedulingOrder
`protected void`	`cycleWellness()` Allow conditions for a forced disconnect, then reinitialize after the forced disconnect without waiting for other threads to get exception from the forced disconnect.
`protected void`	`destroyEntry(com.gemstone.gemfire.cache.Region aRegion, boolean isLocalDestroy)` Destroy an entry in the given region.
`protected void`	`doEntryOperations(com.gemstone.gemfire.cache.Region aRegion)` Do random entry operations on the given region ending either with minTaskGranularityMS or numOpsPerTask.
`static Object`	`getExistingKey(com.gemstone.gemfire.cache.Region aRegion)` Return a random key currently in the given region.
`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 int the given region.
`protected int`	`getOperation(Long whichPrm)` Get a random operation using the given hydra parameter.
`protected Object`	`getRecentKey(com.gemstone.gemfire.cache.Region aRegion, int recentHistory)` Return a random recently used key.
`protected BaseValueHolder`	`getUpdateObject(com.gemstone.gemfire.cache.Region aRegion, String key)` Return an object to be used to update the given key.
`protected BaseValueHolder`	`getValueForKey(Object key)` Return a value for the given key
`protected void`	`handleException(Exception anExcept)` Handle an exception thrown by doing general operations while a forced disconnect occurs.
`protected void`	`handleExceptionWithCycleWellness(Exception anExcept)` Handle an exception thrown by doing general operations while a forced disconnect occurs.
`static void`	`HydraTask_causeForcedDisconnect()` Cause a forced disconnect in the current vm.
`static void`	`HydraTask_cycleWellness()` Allow conditions for a forced disconnect in the current vm, then reinitialize without regard for what other threads in this vm is doing.
`static void`	`HydraTask_doEntryOps()` Hydra task method to do random entry operations.
`static void`	`HydraTask_doEntryOpsWithCycleWellness()` Hydra task method to do random entry operations in a fd test.
`static void`	`HydraTask_initializeClient()` Creates and initializes the singleton instance of ForcedDiscTest in this VM.
`static void`	`HydraTask_initializeServer()` Creates and initializes the singleton instance of ForcedDiscTest in this VM.
`void`	`initializeInstance()` Initialize this test instance
`void`	`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 static void`	`logExecutionNumber()` Log the execution number of this serial task.
`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`	`reinitialize()` Reinitialize either a client or server, depending on which this vm is.
`protected void`	`reinitializeClient()`
`protected void`	`reinitializeServer()`
`protected void`	`updateEntry(com.gemstone.gemfire.cache.Region aRegion)` Update an existing entry in the given region.

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

- Field Detail
  - testInstance
```
public static ForcedDiscTest testInstance
```
  - 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
  - minTaskGranularitySec
```
protected long minTaskGranularitySec
```
  - minTaskGranularityMS
```
protected long minTaskGranularityMS
```
  - numOpsPerTask
```
protected int numOpsPerTask
```
  - randomValues
```
protected RandomValues randomValues
```
  - aRegion
```
public com.gemstone.gemfire.cache.Region aRegion
```
  - upperThreshold
```
protected int upperThreshold
```
  - lowerThreshold
```
protected int lowerThreshold
```
  - numVMsToStop
```
protected int numVMsToStop
```
  - secondsToRun
```
protected int secondsToRun
```
  - lockOperations
```
protected boolean lockOperations
```
  - distLockService
```
protected com.gemstone.gemfire.distributed.DistributedLockService distLockService
```
  - isBridgeConfiguration
```
protected boolean isBridgeConfiguration
```
  - isBridgeClient
```
protected boolean isBridgeClient
```
  - expectingForcedDisconnect
```
protected boolean expectingForcedDisconnect
```
  - numExceptionThreads
```
protected int numExceptionThreads
```
  - syncObject
```
protected static Object syncObject
```
  - LOCK_SERVICE_NAME
```
protected static String LOCK_SERVICE_NAME
```
  - LOCK_NAME
```
protected static String LOCK_NAME
```
  - 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
  - VmIDStr
```
protected static final String VmIDStr
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - ForcedDiscTest
```
public ForcedDiscTest()
```
- Method Detail
  - HydraTask_initializeClient
```
public static void HydraTask_initializeClient()
```
    Creates and initializes the singleton instance of ForcedDiscTest in this VM. This is used for initializing clients in bridge configuration, or initializing a client in a peer configuration.
  - HydraTask_initializeServer
```
public static void HydraTask_initializeServer()
```
    Creates and initializes the singleton instance of ForcedDiscTest in this VM. This is used for initializing servers in bridge configurations.
  - initializeInstance
```
public void initializeInstance()
```
    Initialize this test instance
  - initializeRegion
```
public void initializeRegion(String regDescriptName)
```
    Create a region with the given region description name.
    
    Parameters:
    
    regDescriptName - The name of a region description.
  - reinitializeClient
```
protected void reinitializeClient()
```
  - reinitializeServer
```
protected void reinitializeServer()
```
  - reinitialize
```
protected void reinitialize()
```
    Reinitialize either a client or server, depending on which this vm is.
  - HydraTask_doEntryOps
```
public static void HydraTask_doEntryOps()
```
    Hydra task method to do random entry operations.
  - HydraTask_causeForcedDisconnect
```
public static void HydraTask_causeForcedDisconnect()
```
    Cause a forced disconnect in the current vm.
  - HydraTask_cycleWellness
```
public static void HydraTask_cycleWellness()
```
    Allow conditions for a forced disconnect in the current vm, then reinitialize without regard for what other threads in this vm is doing.
  - HydraTask_doEntryOpsWithCycleWellness
```
public static void HydraTask_doEntryOpsWithCycleWellness()
```
    Hydra task method to do random entry operations in a fd test.
  - doEntryOperations
```
protected void doEntryOperations(com.gemstone.gemfire.cache.Region aRegion)
```
    Do random entry operations on the given region ending either with minTaskGranularityMS or numOpsPerTask.
  - addEntry
```
protected void 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.
  - 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 int the given region.
    
    Parameters:
    
    aRegion - The region to use for getting an entry.
  - causeForcedDisconnect
```
protected void causeForcedDisconnect()
```
    Attempt to cause a forced disconnect in the current vm, either through a slow listener with playDead or by becoming sick with playDead. Wait for a forced disconnect to occur and don't return until it occurs.
  - cycleWellness
```
protected void cycleWellness()
```
    Allow conditions for a forced disconnect, then reinitialize after the forced disconnect without waiting for other threads to get exception from the forced disconnect.
  - getValueForKey
```
protected BaseValueHolder getValueForKey(Object key)
```
    Return a value for the given key
  - getNewKey
```
protected Object getNewKey()
```
    Return a new key, never before used in the test.
  - getRecentKey
```
protected Object getRecentKey(com.gemstone.gemfire.cache.Region aRegion,
                              int recentHistory)
```
    Return a random recently used key.
    
    Parameters:
    
    aRegion - The region to use for getting a recently used key.
    
    recentHistory - The number of most recently used keys to consider for returning.
  - getUpdateObject
```
protected BaseValueHolder getUpdateObject(com.gemstone.gemfire.cache.Region aRegion,
                                          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:
    
    aRegion - The region which possible contains key.
    
    key - The key to get a new value for.
  - logExecutionNumber
```
protected static void logExecutionNumber()
```
    Log the execution number of this serial task.
  - getOperation
```
protected int getOperation(Long whichPrm)
```
    Get a random operation using the given hydra parameter.
    
    Parameters:
    
    whichPrm - A hydra parameter which specifies random operations.
  - 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.
  - getExistingKey
```
public static Object getExistingKey(com.gemstone.gemfire.cache.Region aRegion)
```
    Return a random key currently in the given region.
    
    Parameters:
    
    aRegion - The region to use for getting an existing key (may or may not be a partitioned region).
  - 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 tasks being dependent on each other.
  - handleException
```
protected void handleException(Exception anExcept)
```
    Handle an exception thrown by doing general operations while a forced disconnect occurs.
  - checkForTimeToStop
```
protected void checkForTimeToStop()
```
    If we have a signal to stop, then throw StopSchedulingOrder
  - handleExceptionWithCycleWellness
```
protected void handleExceptionWithCycleWellness(Exception anExcept)
```
    Handle an exception thrown by doing general operations while a forced disconnect occurs.

Class ForcedDiscTest

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

testInstance

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

minTaskGranularitySec

minTaskGranularityMS

numOpsPerTask

randomValues

aRegion

upperThreshold

lowerThreshold

numVMsToStop

secondsToRun

lockOperations

distLockService

isBridgeConfiguration

isBridgeClient

expectingForcedDisconnect

numExceptionThreads

syncObject

LOCK_SERVICE_NAME

LOCK_NAME

getCallbackPrefix

createCallbackPrefix

updateCallbackPrefix

invalidateCallbackPrefix

destroyCallbackPrefix

regionInvalidateCallbackPrefix

regionDestroyCallbackPrefix

VmIDStr

Constructor Detail

ForcedDiscTest

Method Detail

HydraTask_initializeClient

HydraTask_initializeServer

initializeInstance

initializeRegion

reinitializeClient

reinitializeServer

reinitialize

HydraTask_doEntryOps

HydraTask_causeForcedDisconnect

HydraTask_cycleWellness

HydraTask_doEntryOpsWithCycleWellness

doEntryOperations

addEntry

invalidateEntry

destroyEntry

updateEntry

getKey

getNewKey

causeForcedDisconnect

cycleWellness

getValueForKey

getNewKey

getRecentKey

getUpdateObject

logExecutionNumber

getOperation

registerInterest

getExistingKey

checkForLastIteration

handleException

checkForTimeToStop

handleExceptionWithCycleWellness