FDInitImageTest (GemFire XD Java API Documentation)

java.lang.Object
- splitBrain.gii.FDInitImageTest

public class FDInitImageTest
extends Object

Field Summary

Fields
Modifier and Type	Field and Description
`protected com.gemstone.gemfire.cache.Region`	`aRegion`
`protected long`	`createRegionDurationMS`
`protected com.gemstone.gemfire.cache.Region`	`FDRegion`
`protected long`	`giiDurationMS`
`protected long`	`LOG_INTERVAL_MILLIS`
`protected int`	`numKeys`
`protected RandomValues`	`randomValues`
`protected static String`	`REGION_NAME`
`protected static FDInitImageTest`	`testInstance`
`protected static long`	`verifyRegionContentsAccumulatedTime`
`protected static boolean`	`verifyRegionContentsCompleted`
`protected static StringBuffer`	`verifyRegionContentsErrStr`
`protected static int`	`verifyRegionContentsIndex`

Constructor Summary

Constructors
Constructor and Description

FDInitImageTest()

Constructors
Constructor and Description
`FDInitImageTest()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`blockedGetRegion()` Wait for another thread in this VM to begin a getInitialImage, then get the region REGION_NAME, which should block while somebody else has a getInitialImage in progress.
`protected void`	`checkContainsKey(Object key, boolean expected)` Check that containsKey() called on the tests' region has the expected result.
`protected void`	`checkContainsValueForKey(Object key, boolean expected)` Check that containsValueForKey() called on the tests' region has the expected result.
`protected void`	`checkValue(Object key, Object value)` Check that the value of the given key is expected for this test.
`protected void`	`doGetInitImage()` Get the region REGION_NAME, which should do a getInitialImage.
`protected Set`	`getRegionKeySet(com.gemstone.gemfire.cache.Region aRegion)`
`protected Object`	`getValueToAdd(Object key)` Return a value to add to a region for the given key
`protected static boolean`	`hasLocalGiiCompleted()` Test whether the local GII has completed.
`static void`	`HydraTask_becomeDead()` Cause a forced disconnect in the current vm
`static void`	`HydraTask_blockedGetRegion()` Hydra task to wait until another thread does a getInitialImage, then this get region should block.
`static void`	`HydraTask_createFDRegion()`
`static void`	`HydraTask_doGetInitImage()` Hydra task to do a get region, which does a getInitialImage.
`static void`	`HydraTask_initCache()` Hydra task to initialize the cache
`static void`	`HydraTask_initRegion()` Hydra task to initialize a region.
`static void`	`HydraTask_loadRegion()` Hydra batched task to load a region according to hydra param settings.
`static void`	`HydraTask_loadRegionWithGets()` Hydra batched task to load a region by getting values from another distributed system using gets.
`static void`	`HydraTask_putFDRegion()` Do puts to help a forced disconnect to occur in another vm.
`static void`	`HydraTask_verifyPossiblePartialGII()` Task to verify a potentially partial gii.
`static void`	`HydraTask_verifyRegionContents()` Hydra task to verify the keys and values in a region
`static void`	`HydraTask_verifyRegionSize()` Verify the size of the region.
`protected static void`	`initializeInstance()` Initialize the single instance of this test class but not a region.
`protected static void`	`initializeRegion(com.gemstone.gemfire.cache.DataPolicy dataPolicy)` Initialize the single instance of this test class and a region.
`protected void`	`initInstance()` Initialize fields for this instance
`protected void`	`initRegion(com.gemstone.gemfire.cache.DataPolicy dataPolicy)` Initialize a region with the desired attributes.
`protected static boolean`	`isAnyGiiInProgress()` Test whether any GII is in progress.
`protected static boolean`	`isLocalGiiInProgress()` Test whether a local GII is in progress.
`protected static boolean`	`isLocalGiiInProgress(com.gemstone.gemfire.cache.Region aRegion)` Test whether a local GII is in progress.
`void`	`loadRegion()` Load a region with keys and values.
`void`	`loadRegionWithGets()`
`static void`	`StartTask_initialize()` Hydra start task to initialize dataPolicy on the blackboard.
`protected void`	`verifyPossiblePartialGII()` Verify a potentially partial gii.
`void`	`verifyRegionContents()` Verify the contents of the region.
`protected static void`	`waitForAllGiiToComplete()` Wait for getInitialImage in ALL vms to complete.
`static void`	`waitForAnyGiiToBegin()` Wait for a getInitialImage in ANY vm to be in progress.
`static void`	`waitForForcedDiscConditions(com.gemstone.gemfire.distributed.DistributedSystem ds, com.gemstone.gemfire.cache.Cache theCache)` Wait for forced disconnect conditions 1) Cache.isClosed() should be true 2) DistributedSystem.isConnected() should be false 3) Notifier hooks for forced disconnect before and after should complete.
`protected static void`	`waitForLocalGiiCompleted()` Wait for stats to indicate that a getInitialImage has completed.
`protected static void`	`waitForLocalGiiToBegin()` Wait for stats to indicate that a getInitialImage is in progress.

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

- Field Detail
  - testInstance
```
protected static FDInitImageTest testInstance
```
  - REGION_NAME
```
protected static final String REGION_NAME
```
    See Also:
    
    Constant Field Values
  - numKeys
```
protected int numKeys
```
  - randomValues
```
protected RandomValues randomValues
```
  - aRegion
```
protected com.gemstone.gemfire.cache.Region aRegion
```
  - FDRegion
```
protected com.gemstone.gemfire.cache.Region FDRegion
```
  - createRegionDurationMS
```
protected long createRegionDurationMS
```
  - giiDurationMS
```
protected long giiDurationMS
```
  - LOG_INTERVAL_MILLIS
```
protected final long LOG_INTERVAL_MILLIS
```
    See Also:
    
    Constant Field Values
  - verifyRegionContentsIndex
```
protected static int verifyRegionContentsIndex
```
  - verifyRegionContentsErrStr
```
protected static StringBuffer verifyRegionContentsErrStr
```
  - verifyRegionContentsCompleted
```
protected static boolean verifyRegionContentsCompleted
```
  - verifyRegionContentsAccumulatedTime
```
protected static long verifyRegionContentsAccumulatedTime
```
- Constructor Detail
  - FDInitImageTest
```
public FDInitImageTest()
```
- Method Detail
  - initializeRegion
```
protected static void initializeRegion(com.gemstone.gemfire.cache.DataPolicy dataPolicy)
```
    Initialize the single instance of this test class and a region. If this VM has already initialized its instance, then skip reinitializing.
  - initializeInstance
```
protected static void initializeInstance()
```
    Initialize the single instance of this test class but not a region. If this VM has already initialized its instance, then skip reinitializing.
  - initRegion
```
protected void initRegion(com.gemstone.gemfire.cache.DataPolicy dataPolicy)
```
    Initialize a region with the desired attributes. Initialize instance fields for this instance.
  - initInstance
```
protected void initInstance()
```
    Initialize fields for this instance
  - StartTask_initialize
```
public static void StartTask_initialize()
```
    Hydra start task to initialize dataPolicy on the blackboard.
  - HydraTask_createFDRegion
```
public static void HydraTask_createFDRegion()
```
  - HydraTask_verifyPossiblePartialGII
```
public static void HydraTask_verifyPossiblePartialGII()
```
    Task to verify a potentially partial gii.
  - verifyPossiblePartialGII
```
protected void verifyPossiblePartialGII()
```
    Verify a potentially partial gii. The gii could be partial if the test caused a forced disconnect in a replicate vm. Since gii prefers replicates it could have targeted the replicate that got the forced disconnect, causing a partial gii. This method is not called for the case where all sources are normal (union). This is batched.
  - HydraTask_verifyRegionSize
```
public static void HydraTask_verifyRegionSize()
```
    Verify the size of the region.
  - HydraTask_putFDRegion
```
public static void HydraTask_putFDRegion()
```
    Do puts to help a forced disconnect to occur in another vm.
  - HydraTask_becomeDead
```
public static void HydraTask_becomeDead()
```
    Cause a forced disconnect in the current vm
  - HydraTask_initRegion
```
public static void HydraTask_initRegion()
```
    Hydra task to initialize a region.
  - HydraTask_loadRegion
```
public static void HydraTask_loadRegion()
```
    Hydra batched task to load a region according to hydra param settings.
  - HydraTask_loadRegionWithGets
```
public static void HydraTask_loadRegionWithGets()
```
    Hydra batched task to load a region by getting values from another distributed system using gets.
  - HydraTask_doGetInitImage
```
public static void HydraTask_doGetInitImage()
```
    Hydra task to do a get region, which does a getInitialImage.
  - HydraTask_blockedGetRegion
```
public static void HydraTask_blockedGetRegion()
```
    Hydra task to wait until another thread does a getInitialImage, then this get region should block.
  - HydraTask_verifyRegionContents
```
public static void HydraTask_verifyRegionContents()
```
    Hydra task to verify the keys and values in a region
  - HydraTask_initCache
```
public static void HydraTask_initCache()
```
    Hydra task to initialize the cache
  - doGetInitImage
```
protected void doGetInitImage()
```
    Get the region REGION_NAME, which should do a getInitialImage. Verify that the getInitialImage occurred by checking the stat for completion of getInitialImage. Save the number of millis taken for the getRegion in the createRegionDurationMS instance field.
  - blockedGetRegion
```
protected void blockedGetRegion()
```
    Wait for another thread in this VM to begin a getInitialImage, then get the region REGION_NAME, which should block while somebody else has a getInitialImage in progress. When finished, compare time to createRegionDurationMS (the time taken by the thread that did the getInitialImage) to verify that this blocked. Also, check stats to make sure this thread did not do another getInitialImage.
  - loadRegion
```
public void loadRegion()
```
    Load a region with keys and values. The number of keys and values is specified by numKeys (hydra param). This can be invoked by several threads in numerous vms to accomplish the work. Note that, for example, if two vms invoke this, and they are not replicates, then the union of the two vms will include numKeys entries.
  - loadRegionWithGets
```
public void loadRegionWithGets()
```
  - verifyRegionContents
```
public void verifyRegionContents()
```
    Verify the contents of the region. Throw an error of any problems are detected.
  - checkContainsKey
```
protected void checkContainsKey(Object key,
                                boolean expected)
```
    Check that containsKey() called on the tests' region has the expected result. Throw an error if any problems.
    
    Parameters:
    
    key - The key to check.
    
    expected - The expected result of containsKey
    
    logStr - Used if throwing an error due to an unexpected value.
  - checkContainsValueForKey
```
protected void checkContainsValueForKey(Object key,
                                        boolean expected)
```
    Check that containsValueForKey() called on the tests' region has the expected result. Throw an error if any problems.
    
    Parameters:
    
    key - The key to check.
    
    expected - The expected result of containsValueForKey
  - checkValue
```
protected void checkValue(Object key,
                          Object value)
```
    Check that the value of the given key is expected for this test. Throw an error if any problems.
    
    Parameters:
    
    key - The key to check.
    
    value - The value for the key.
    
    logStr - Used if throwing an error due to an unexpected value.
  - getValueToAdd
```
protected Object getValueToAdd(Object key)
```
    Return a value to add to a region for the given key
  - getRegionKeySet
```
protected Set getRegionKeySet(com.gemstone.gemfire.cache.Region aRegion)
```
  - isLocalGiiInProgress
```
protected static boolean isLocalGiiInProgress()
```
    Test whether a local GII is in progress. Not as accurate as isLocalGiiInProgress(Region), but works if you don't have a region available.
  - isLocalGiiInProgress
```
protected static boolean isLocalGiiInProgress(com.gemstone.gemfire.cache.Region aRegion)
```
    Test whether a local GII is in progress. Is more accurate than isLocalGiiInProgress().
    
    Parameters:
    
    The - region that may be in a getInitialImage
  - hasLocalGiiCompleted
```
protected static boolean hasLocalGiiCompleted()
```
    Test whether the local GII has completed.
  - isAnyGiiInProgress
```
protected static boolean isAnyGiiInProgress()
```
    Test whether any GII is in progress.
  - waitForAnyGiiToBegin
```
public static void waitForAnyGiiToBegin()
```
    Wait for a getInitialImage in ANY vm to be in progress.
  - waitForAllGiiToComplete
```
protected static void waitForAllGiiToComplete()
```
    Wait for getInitialImage in ALL vms to complete.
  - waitForLocalGiiToBegin
```
protected static void waitForLocalGiiToBegin()
```
    Wait for stats to indicate that a getInitialImage is in progress. Note that this will wait for stats for this VM only.
  - waitForLocalGiiCompleted
```
protected static void waitForLocalGiiCompleted()
```
    Wait for stats to indicate that a getInitialImage has completed. Note that this will wait for stats for this VM only.
  - waitForForcedDiscConditions
```
public static void waitForForcedDiscConditions(com.gemstone.gemfire.distributed.DistributedSystem ds,
                                               com.gemstone.gemfire.cache.Cache theCache)
```
    Wait for forced disconnect conditions 1) Cache.isClosed() should be true 2) DistributedSystem.isConnected() should be false 3) Notifier hooks for forced disconnect before and after should complete. 4) An afterRegionDestroy with a forcedDisconnect operation should occur. This relies on ControllerBB.incMapCounter(ControllerBB.NumForcedDiscEvents) being called when an afterRegionDestroyed event with a forced disconnect Operation is detected. Also, splitBrain.MemberNotifyHook must be installed in the vm receiving the forced disconnect.

Class FDInitImageTest

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

testInstance

REGION_NAME

numKeys

randomValues

aRegion

FDRegion

createRegionDurationMS

giiDurationMS

LOG_INTERVAL_MILLIS

verifyRegionContentsIndex

verifyRegionContentsErrStr

verifyRegionContentsCompleted

verifyRegionContentsAccumulatedTime

Constructor Detail

FDInitImageTest

Method Detail

initializeRegion

initializeInstance

initRegion

initInstance

StartTask_initialize

HydraTask_createFDRegion

HydraTask_verifyPossiblePartialGII

verifyPossiblePartialGII

HydraTask_verifyRegionSize

HydraTask_putFDRegion

HydraTask_becomeDead

HydraTask_initRegion

HydraTask_loadRegion

HydraTask_loadRegionWithGets

HydraTask_doGetInitImage

HydraTask_blockedGetRegion

HydraTask_verifyRegionContents

HydraTask_initCache

doGetInitImage

blockedGetRegion

loadRegion

loadRegionWithGets

verifyRegionContents

checkContainsKey

checkContainsValueForKey

checkValue

getValueToAdd

getRegionKeySet

isLocalGiiInProgress

isLocalGiiInProgress

hasLocalGiiCompleted

isAnyGiiInProgress

waitForAnyGiiToBegin

waitForAllGiiToComplete

waitForLocalGiiToBegin

waitForLocalGiiCompleted

waitForForcedDiscConditions