Feeder (GemFire XD Java API Documentation)

java.lang.Object
- delta.Feeder

```
public class Feeder
extends Object
```
A Feeder class for Delta testing. It creates a configurable ( passed through bt/conf) number of threads for doing puts and each thread does a put on fixed set of keys with range specified by configuration.

Since:

6.1

Field Summary

Fields
Modifier and Type	Field and Description
`protected String`	`deltaType`
`static boolean`	`isClient`
`static HashMap`	`keyToMap`
`static String`	`LAST_KEY` The last key to be put by feeder.
`protected static Map`	`latestValues` A Map which contains a thread-id as key and a map as value.
`protected static String`	`REGION_NAME`

Constructor Summary

Constructors
Constructor and Description

Feeder()

Constructors
Constructor and Description
`Feeder()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`closeTask()` Signals for stopping of the put threads and notifies all.
`protected static void`	`createEntry(com.gemstone.gemfire.cache.Region region)` Perform create operation for a random key within PUT_KEY_RANGE
`protected static void`	`destroyEntry(com.gemstone.gemfire.cache.Region region)` Perform destroy operation for a random key within PUT_KEY_RANGE
`static void`	`doNothing()`
`static void`	`feederCreateRegions()` This method is an INITTASK and does the following : 1)Create cache adn region
`static void`	`feederIsClient()`
`static void`	`feederSpawnThreads()` This method is an INITTASK and does the following : 2)Set the counters for all threads to 1 ( to run them once in INITTASK) 3)Initialize and start the put threads
`static void`	`feederTask()` Increments the value of counters in `threadList` for each thread and notifies all the put threads int wait().
`static void`	`feederTimedTask()` Does `feederTask()` for `DeltaPropagationPrms.feederTaskTimeSec`.
`protected static DeltaTestObj`	`getLatestDelta(String key, String threadIdKey, boolean isCreate)` Gets the latest delta for the given key from the latestValues map and returns the incremented value for doing entry operations.
`protected static Long`	`getLatestValue(String key, String threadIdKey)` Gets the latest value for the given key from the latestValues map and returns the incremented value for doing entry operations.
`static void`	`initTask()` This method is an INITTASK and does the following : 1)Create cache adn region 2)Set the counters for all threads to 1 ( to run them once in INITTASK) 3)Initialize and start the put threads
`static void`	`initTaskOnBridge()`
`static void`	`initToFeedMixOfDeltaAndOthers()` This method is an INITTASK and does the following : 1)Create cache adn region 2)Set the counters for all threads to 1 ( to run them once in INITTASK) 3)Initialize and start the put threads 4)Put object of Delta or Byte[] type
`protected static void`	`invalidateEntry(com.gemstone.gemfire.cache.Region region)` Perform invalidate operation for a random key within PUT_KEY_RANGE
`static void`	`noResetTask()`
`static void`	`populateSharedMapWithRegionData()`
`protected static void`	`registerInterest(com.gemstone.gemfire.cache.Region region)` Perform registerInterest operation for a random key within PUT_KEY_RANGE
`protected static void`	`unregisterInterest(com.gemstone.gemfire.cache.Region region)` Perform unregisterInterest operation for a random key within PUT_KEY_RANGE
`protected static void`	`updateEntry(com.gemstone.gemfire.cache.Region region)` Perform put operation for a random key within PUT_KEY_RANGE
`protected static boolean`	`updateLatestValueMap(com.gemstone.gemfire.cache.Region region, String key, String threadId, boolean isDestroyCall)` Updates the local `latestValues` map on a invalidate or destroy call.
`static void`	`verifyDeltaFailuresInC2S()`
`static void`	`verifyDeltaFailuresInP2P()`
`static void`	`verifyDeltaFailuresInS2C()`
`static void`	`waitForFeederThreadsToComplete()` Signals for stopping of the put threads and notifies all.

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

- Field Detail
  - latestValues
```
protected static final Map latestValues
```
    A Map which contains a thread-id as key and a map as value. This value map contains latest values for the key-set of that particular thread.
  - REGION_NAME
```
protected static final String REGION_NAME
```
  - deltaType
```
protected final String deltaType
```
  - LAST_KEY
```
public static final String LAST_KEY
```
    The last key to be put by feeder. This is used to signal for proceeding with the validation in some tests
    
    See Also:
    
    Constant Field Values
  - isClient
```
public static boolean isClient
```
  - keyToMap
```
public static HashMap keyToMap
```
- Constructor Detail
  - Feeder
```
public Feeder()
```
- Method Detail
  - createEntry
```
protected static void createEntry(com.gemstone.gemfire.cache.Region region)
```
    Perform create operation for a random key within PUT_KEY_RANGE
    
    Parameters:
    
    region - - the test region
  - updateEntry
```
protected static void updateEntry(com.gemstone.gemfire.cache.Region region)
```
    Perform put operation for a random key within PUT_KEY_RANGE
    
    Parameters:
    
    region - - the test region
  - invalidateEntry
```
protected static void invalidateEntry(com.gemstone.gemfire.cache.Region region)
```
    Perform invalidate operation for a random key within PUT_KEY_RANGE
    
    Parameters:
    
    region - - the test region
  - destroyEntry
```
protected static void destroyEntry(com.gemstone.gemfire.cache.Region region)
```
    Perform destroy operation for a random key within PUT_KEY_RANGE
    
    Parameters:
    
    region - - the test region
  - registerInterest
```
protected static void registerInterest(com.gemstone.gemfire.cache.Region region)
```
    Perform registerInterest operation for a random key within PUT_KEY_RANGE
    
    Parameters:
    
    region - - the test region
  - unregisterInterest
```
protected static void unregisterInterest(com.gemstone.gemfire.cache.Region region)
```
    Perform unregisterInterest operation for a random key within PUT_KEY_RANGE
    
    Parameters:
    
    region - - the test region
  - feederTimedTask
```
public static void feederTimedTask()
```
    Does feederTask() for DeltaPropagationPrms.feederTaskTimeSec.
  - feederTask
```
public static void feederTask()
```
    Increments the value of counters in threadList for each thread and notifies all the put threads int wait().
  - populateSharedMapWithRegionData
```
public static void populateSharedMapWithRegionData()
```
  - closeTask
```
public static void closeTask()
```
    Signals for stopping of the put threads and notifies all. Waits till all the put threads are complete and decrements the shared counter for TOTAL_UPDATES by TOTAL_PUT_THREADS * PUT_KEY_RANGE. This is done because the first set of PUTs by each thread will correspond to CREATE operations and UPDATES afterwards.
  - verifyDeltaFailuresInC2S
```
public static void verifyDeltaFailuresInC2S()
```
  - verifyDeltaFailuresInP2P
```
public static void verifyDeltaFailuresInP2P()
```
  - verifyDeltaFailuresInS2C
```
public static void verifyDeltaFailuresInS2C()
```
  - waitForFeederThreadsToComplete
```
public static void waitForFeederThreadsToComplete()
```
    Signals for stopping of the put threads and notifies all. Waits till all the put threads are complete. Signals to other VMs that the feed cyle is over.
  - getLatestValue
```
protected static Long getLatestValue(String key,
                                     String threadIdKey)
```
    Gets the latest value for the given key from the latestValues map and returns the incremented value for doing entry operations.
    
    Parameters:
    
    key - - the event key
    
    threadIdKey - - thread-id to which this key belongs
    
    Returns:
    
    - the latest incremented value for this key
  - getLatestDelta
```
protected static DeltaTestObj getLatestDelta(String key,
                                             String threadIdKey,
                                             boolean isCreate)
```
    Gets the latest delta for the given key from the latestValues map and returns the incremented value for doing entry operations.
    
    Parameters:
    
    key - - the event key
    
    threadIdKey - - thread-id to which this key belongs
    
    isCreate - - create or update operation
    
    Returns:
    
    - the latest incremented delta for this key
  - updateLatestValueMap
```
protected static boolean updateLatestValueMap(com.gemstone.gemfire.cache.Region region,
                                              String key,
                                              String threadId,
                                              boolean isDestroyCall)
                                       throws Exception
```
    Updates the local latestValues map on a invalidate or destroy call.
    
    Parameters:
    
    key - - the event key
    
    threadId - - thread-id to which this key belongs
    
    isDestroyCall - - true if this method was called for doing destroy operation, false if invalidate operation
    
    Returns:
    
    - whether to proceed with the calling invalidate or destroy operation or not.
    
    Throws:
    
    Exception - - thrown if any exception occurs while fetching the old value from the region
  - initToFeedMixOfDeltaAndOthers
```
public static void initToFeedMixOfDeltaAndOthers()
```
    This method is an INITTASK and does the following :
    1)Create cache adn region
    2)Set the counters for all threads to 1 ( to run them once in INITTASK)
    3)Initialize and start the put threads 4)Put object of Delta or Byte[] type
    
    Since:
    
    6.1
  - initTask
```
public static void initTask()
```
    This method is an INITTASK and does the following :
    1)Create cache adn region
    2)Set the counters for all threads to 1 ( to run them once in INITTASK)
    3)Initialize and start the put threads
  - feederCreateRegions
```
public static void feederCreateRegions()
```
    This method is an INITTASK and does the following :
    1)Create cache adn region
  - feederSpawnThreads
```
public static void feederSpawnThreads()
```
    This method is an INITTASK and does the following :
    2)Set the counters for all threads to 1 ( to run them once in INITTASK)
    3)Initialize and start the put threads
  - initTaskOnBridge
```
public static void initTaskOnBridge()
```
  - doNothing
```
public static void doNothing()
```
  - feederIsClient
```
public static void feederIsClient()
```
  - noResetTask
```
public static void noResetTask()
```

Class Feeder

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

latestValues

REGION_NAME

deltaType

LAST_KEY

isClient

keyToMap

Constructor Detail

Feeder

Method Detail

createEntry

updateEntry

invalidateEntry

destroyEntry

registerInterest

unregisterInterest

feederTimedTask

feederTask

populateSharedMapWithRegionData

closeTask

verifyDeltaFailuresInC2S

verifyDeltaFailuresInP2P

verifyDeltaFailuresInS2C

waitForFeederThreadsToComplete

getLatestValue

getLatestDelta

updateLatestValueMap

initToFeedMixOfDeltaAndOthers

initTask

feederCreateRegions

feederSpawnThreads

initTaskOnBridge

doNothing

feederIsClient

noResetTask