InterestResultPolicyDUnitTest (GemFire XD Java API Documentation)

java.lang.Object
- junit.framework.Assert
- - junit.framework.TestCase
  - - dunit.DistributedTestCase
    - - com.gemstone.gemfire.internal.cache.tier.sockets.InterestResultPolicyDUnitTest

All Implemented Interfaces:

Serializable, junit.framework.Test
```
public class InterestResultPolicyDUnitTest
extends DistributedTestCase
```
DUnit Test for use-cases of various InterestResultPolicy types.

See Also:

Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from class dunit.DistributedTestCase
  DistributedTestCase.ExpectedException, DistributedTestCase.WaitCriterion, DistributedTestCase.WaitCriterion2

Field Summary
- Fields inherited from class dunit.DistributedTestCase
  logPerTest, reconnect, system, testName

Constructor Summary

Constructors
Constructor and Description

InterestResultPolicyDUnitTest(String name)
Creates a test instance with the given name

Constructors
Constructor and Description
`InterestResultPolicyDUnitTest(String name)` Creates a test instance with the given name

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`closeCache()` Closes the cache instance created and disconnects from the distributed system.
`static void`	`createClientCache(String host, Integer port)` Creates the client cache and region.
`static Integer`	`createServerCache()` Creates the cache and starts the server
`static Object`	`getEntryCount()` Gets the total number of keys in the test region
`static void`	`populateServerCache()` Populates the server cache by putting some entries
`protected void`	`realTearDown()`
`static void`	`registerInterest(Object interestPolicy, Object totalKeysToRegister)` Registers the test region on client with a keylist containing all keys pre-populated on server and a given `InterestResultPolicy` type.
`void`	`setUp()` Creates the server cache and populates it with some entries
`void`	`tearDown2()` Closes the cache on server and client
`void`	`testBug35358()` This test does the following 1)Create client cache and region 2)Call registerInterest with specific keys (having extra keys other than those pre-populated on server cache) and policy:KEYS 3)At the end of registerInterest call, verify that only prepolulated entries are created in the client cache with null values (entries for keys in the keylist which are not on the server should not be created on the client as a result of registerInterest call)
`void`	`testPolicyKeys()` This test does the following 1)Create client cache and region 2)Call registerInterest with all keys pre-populated on server and policy:KEYS 3)At the end of registerInterest call, verify that entries are created in the client cache with value null
`void`	`testPolicyKeysValues()` This test does the following 1)Create client cache and region 2)Call registerInterest with all keys pre-populated on server and policy:KEYS_VALUES 3)At the end of registerInterest call, verify that all entries are created in the client cache with values
`void`	`testPolicyNone()` This test does the following 1)Create client cache and region 2)Call registerInterest with all keys pre-populated on server and policy:NONE 3)At the end of registerInterest call, verify that no entries are created in the client cache
`static void`	`verifyResult(Object interestPolicy, Object totalKeysRegistered)` Verifies the number of entries (including values) created on the test region at the end of `Region.registerInterest(K)` call depending on the type of `InterestResultPolicy` registered for the region.

Methods inherited from class dunit.DistributedTestCase
addExpectedException, addExpectedException, addHydraProperties, attachDebugger, checkBBFlag, cleanupAllVms, clearBBFlag, crashDistributedSystem, crashDistributedSystem, createLogWriter, disconnectAllFromDS, disconnectFromDS, dumpAllStacks, dumpMyThreads, dumpStack, dumpStack, dumpStack, dumpStackTrace, fail, getAllDistributedSystemProperties, getDistributedSystemProperties, getDUnitLocatorAddress, getDUnitLocatorPort, getDUnitLocatorString, getDUnitLogLevel, getIPLiteral, getLogWriter, getLonerSystem, getMcastSystem, getMcastSystem, getRepeatTimeoutMs, getServerHostName, getSystem, getSystem, getTestClass, getTestName, getUniqueName, getVMCount, incBBFlag, invokeInEveryVM, invokeInEveryVM, invokeInEveryVM, invokeInEveryVM, invokeInEveryVMRepeatingIfNecessary, invokeInLocator, invokeRepeatingIfNecessary, isConnectedToDS, join, noteTiming, pause, pause, perVMSetUp, setDiskStoreForGateway, setSystem, setTestName, staticPause, tearDown, unregisterAllDataSerializersFromAllVms, unregisterDataSerializerInThisVM, unregisterInstantiatorsInThisVM, waitForBBFlag, waitForCriterion, waitMutex

Methods inherited from class junit.framework.TestCase
assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, countTestCases, createResult, fail, fail, failNotEquals, failNotSame, failSame, format, getName, run, run, runBare, runTest, setName, toString

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

- Constructor Detail
  - InterestResultPolicyDUnitTest
```
public InterestResultPolicyDUnitTest(String name)
```
    Creates a test instance with the given name
    
    Parameters:
    
    name - - name of test instance
- Method Detail
  - setUp
```
public void setUp()
           throws Exception
```
    Creates the server cache and populates it with some entries
    
    Overrides:
    
    setUp in class DistributedTestCase
    
    Throws:
    
    Exception
  - tearDown2
```
public void tearDown2()
               throws Exception
```
    Closes the cache on server and client
    
    Overrides:
    
    tearDown2 in class DistributedTestCase
    
    Throws:
    
    Exception
  - realTearDown
```
protected void realTearDown()
                     throws Exception
```
    Overrides:
    
    realTearDown in class DistributedTestCase
    
    Throws:
    
    Exception
  - testPolicyNone
```
public void testPolicyNone()
```
    This test does the following
    1)Create client cache and region
    2)Call registerInterest with all keys pre-populated on server and policy:NONE
    3)At the end of registerInterest call, verify that no entries are created in the client cache
  - testPolicyKeys
```
public void testPolicyKeys()
```
    This test does the following
    1)Create client cache and region
    2)Call registerInterest with all keys pre-populated on server and policy:KEYS
    3)At the end of registerInterest call, verify that entries are created in the client cache with value null
  - testPolicyKeysValues
```
public void testPolicyKeysValues()
```
    This test does the following
    1)Create client cache and region
    2)Call registerInterest with all keys pre-populated on server and policy:KEYS_VALUES
    3)At the end of registerInterest call, verify that all entries are created in the client cache with values
  - testBug35358
```
public void testBug35358()
```
    This test does the following
    1)Create client cache and region
    2)Call registerInterest with specific keys (having extra keys other than those pre-populated on server cache) and policy:KEYS
    3)At the end of registerInterest call, verify that only prepolulated entries are created in the client cache with null values (entries for keys in the keylist which are not on the server should not be created on the client as a result of registerInterest call)
  - closeCache
```
public static void closeCache()
```
    Closes the cache instance created and disconnects from the distributed system.
  - createServerCache
```
public static Integer createServerCache()
                                 throws Exception
```
    Creates the cache and starts the server
    
    Throws:
    
    Exception - - thrown if any problem occurs in creating server cache or starting the server
  - populateServerCache
```
public static void populateServerCache()
                                throws Exception
```
    Populates the server cache by putting some entries
    
    Throws:
    
    Exception - - thrown if any problem occurs while creating entries at server cache
  - createClientCache
```
public static void createClientCache(String host,
                                     Integer port)
                              throws Exception
```
    Creates the client cache and region.
    
    Throws:
    
    Exception - - thrown if any problem occurs in creating cache or region
  - registerInterest
```
public static void registerInterest(Object interestPolicy,
                                    Object totalKeysToRegister)
```
    Registers the test region on client with a keylist containing all keys pre-populated on server and a given InterestResultPolicy type.
    
    Parameters:
    
    interestPolicy - - InterestResultPolicy type specified (NONE,KEYS,KEY_VALUES or DEFAULT)
  - verifyResult
```
public static void verifyResult(Object interestPolicy,
                                Object totalKeysRegistered)
```
    Verifies the number of entries (including values) created on the test region at the end of Region.registerInterest(K) call depending on the type of InterestResultPolicy registered for the region.
    
    Parameters:
    
    interestPolicy - - InterestResultPolicy registered for the region
  - getEntryCount
```
public static Object getEntryCount()
```
    Gets the total number of keys in the test region
    
    Returns:
    
    - total keys

Class InterestResultPolicyDUnitTest

Nested Class Summary

Nested classes/interfaces inherited from class dunit.DistributedTestCase

Field Summary

Fields inherited from class dunit.DistributedTestCase

Constructor Summary

Method Summary

Methods inherited from class dunit.DistributedTestCase

Methods inherited from class junit.framework.TestCase

Methods inherited from class java.lang.Object

Constructor Detail

InterestResultPolicyDUnitTest

Method Detail

setUp

tearDown2

realTearDown

testPolicyNone

testPolicyKeys

testPolicyKeysValues

testBug35358

closeCache

createServerCache

populateServerCache

createClientCache

registerInterest

verifyResult

getEntryCount