DiskRegionTest (GemFire XD Java API Documentation)

java.lang.Object
- junit.framework.Assert
- - junit.framework.TestCase
  - - dunit.DistributedTestCase
    - - com.gemstone.gemfire.cache30.CacheTestCase
      - com.gemstone.gemfire.cache30.DiskRegionTest

All Implemented Interfaces:

Serializable, junit.framework.Test
```
public class DiskRegionTest
extends CacheTestCase
```
Tests the functionality of cache regions whose contents may be written to disk.

Since:

3.2

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 com.gemstone.gemfire.cache30.CacheTestCase
  cache
- Fields inherited from class dunit.DistributedTestCase
  logPerTest, reconnect, system, testName

Constructor Summary

Constructors
Constructor and Description

DiskRegionTest(String name)
Creates a new DiskRegionTest

Constructors
Constructor and Description
`DiskRegionTest(String name)` Creates a new `DiskRegionTest`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`assertArrayEquals(Object expected, Object v)`
`void`	`fillUpOverflowRegion()` Tests that an `IllegalStateException` is thrown when the region is full of keys and entries.
`protected com.gemstone.gemfire.internal.cache.lru.LRUStatistics`	`getLRUStats(com.gemstone.gemfire.cache.Region region)` Returns the `LRUStatistics` for the given region
`void`	`testBackup()`
`void`	`testBackupStatistics()` Tests that the disk region statistics are updated correctly for persist backup regions.
`void`	`testCacheEvents()` Tests cache listeners in an overflow region are invoked and that their events are reasonable.
`void`	`testDestroy()` Tests destroying entries in an overflow region
`void`	`testDiskRegionOverflow()` Tests that data overflows correctly to a disk region
`void`	`testDistributedInvalidate()` Tests that invalidates and updates received from different VMs are handled appropriately by overflow regions.
`void`	`testEvictValueOnRegionWithEvictionAttributes()` Tests calling region.evictValue() on region with eviction-attribute set.
`void`	`testInvalidate()` Tests that once an overflowed entry is invalidated its value is gone.
`void`	`testLowLevelGetMethods()` Tests the `getValueInVM` and `getValueOnDisk` methods that were added for testing.
`void`	`testLRUCapacityController()` Tests disk overflow with an entry-based `LRUCapacityController`.
`void`	`testLRUCCSizeOne()` Tests a disk-based region with an `LRUCapacityController` with size 1 and an eviction action of "overflow".
`void`	`testNoFaults()` Overflows a region and makes sure that gets of recently-used objects do not cause faults.
`void`	`testOverflowMirror()` Tests overflow with mirrored regions.
`void`	`testOverflowUpdatedValue()` Tests that the updated value gets overflowed
`void`	`testPersistentReplicateB4NonPersistent()`
`void`	`testRegionEntryValues()` Tests getting the values of region entries that have been overflowed.
`void`	`testRegionEvictValue()` Tests for region.evictValue().
`void`	`testRemoteUpdates()` Makes sure that updates from other VMs cause existing entries to be written to disk.
`void`	`testRRProxyWithPersistentReplicates()`
`void`	`testTestHookStatistics()` Tests that the "test hook" `DiskRegionStats` work as advertised.
`void`	`testValues()` Tests iterating over all of the values when some have been overflowed.

Methods inherited from class com.gemstone.gemfire.cache30.CacheTestCase
addExceptionTag1, basicGetCache, beginCacheXml, cleanDiskDirs, closeAllCache, closeCache, createLonerCache, createMcastCache, createMcastCache, createRegion, createRegion, createRootRegion, createRootRegion, disconnectFromDS, finishCacheXml, finishCacheXml, getCache, getCache, getCache, getCache, getClientCache, getDiskDirs, getGemfireCache, getInternalRegionArguments, getRootRegion, getRootRegion, hasCache, remoteTearDown, removeExceptionTag1, sendSerialMessageToAll, sendUnorderedMessageToAll, tearDown2

Methods inherited from class dunit.DistributedTestCase
addExpectedException, addExpectedException, addHydraProperties, attachDebugger, checkBBFlag, cleanupAllVms, clearBBFlag, crashDistributedSystem, crashDistributedSystem, createLogWriter, disconnectAllFromDS, 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, realTearDown, setDiskStoreForGateway, setSystem, setTestName, setUp, 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
  - DiskRegionTest
```
public DiskRegionTest(String name)
```
    Creates a new DiskRegionTest
- Method Detail
  - getLRUStats
```
protected com.gemstone.gemfire.internal.cache.lru.LRUStatistics getLRUStats(com.gemstone.gemfire.cache.Region region)
```
    Returns the LRUStatistics for the given region
  - testDiskRegionOverflow
```
public void testDiskRegionOverflow()
                            throws Exception
```
    Tests that data overflows correctly to a disk region
    
    Throws:
    
    Exception
  - testRemoteUpdates
```
public void testRemoteUpdates()
                       throws Exception
```
    Makes sure that updates from other VMs cause existing entries to be written to disk.
    
    Throws:
    
    Exception
  - testNoFaults
```
public void testNoFaults()
                  throws Exception
```
    Overflows a region and makes sure that gets of recently-used objects do not cause faults.
    
    Throws:
    
    Exception
  - testOverflowMirror
```
public void testOverflowMirror()
                        throws Exception
```
    Tests overflow with mirrored regions. Note that we have to use byte array values in this test. Otherwise, the size of the data in the "puter" VM would be different from the size of the data in the receiver VM, thus cause the two VMs to have different LRU eviction behavior.
    
    Throws:
    
    Exception
  - testDestroy
```
public void testDestroy()
                 throws Exception
```
    Tests destroying entries in an overflow region
    
    Throws:
    
    Exception
  - testCacheEvents
```
public void testCacheEvents()
                     throws Exception
```
    Tests cache listeners in an overflow region are invoked and that their events are reasonable.
    
    Throws:
    
    Exception
  - fillUpOverflowRegion
```
public void fillUpOverflowRegion()
                          throws Exception
```
    Tests that an IllegalStateException is thrown when the region is full of keys and entries.
    
    Throws:
    
    Exception
  - testValues
```
public void testValues()
                throws Exception
```
    Tests iterating over all of the values when some have been overflowed.
    
    Throws:
    
    Exception
  - testRegionEvictValue
```
public void testRegionEvictValue()
                          throws Exception
```
    Tests for region.evictValue().
    
    Throws:
    
    Exception
  - testEvictValueOnRegionWithEvictionAttributes
```
public void testEvictValueOnRegionWithEvictionAttributes()
                                                  throws Exception
```
    Tests calling region.evictValue() on region with eviction-attribute set.
    
    Throws:
    
    Exception
  - testBackupStatistics
```
public void testBackupStatistics()
                          throws com.gemstone.gemfire.cache.CacheException
```
    Tests that the disk region statistics are updated correctly for persist backup regions.
    
    Throws:
    
    com.gemstone.gemfire.cache.CacheException
  - assertArrayEquals
```
public void assertArrayEquals(Object expected,
                              Object v)
```
  - testBackup
```
public void testBackup()
                throws Exception
```
    Throws:
    
    Exception
  - testRegionEntryValues
```
public void testRegionEntryValues()
                           throws Exception
```
    Tests getting the values of region entries that have been overflowed.
    
    Throws:
    
    Exception
  - testInvalidate
```
public void testInvalidate()
                    throws Exception
```
    Tests that once an overflowed entry is invalidated its value is gone.
    
    Throws:
    
    Exception
  - testDistributedInvalidate
```
public void testDistributedInvalidate()
                               throws Exception
```
    Tests that invalidates and updates received from different VMs are handled appropriately by overflow regions.
    
    Throws:
    
    Exception
  - testOverflowUpdatedValue
```
public void testOverflowUpdatedValue()
                              throws Exception
```
    Tests that the updated value gets overflowed
    
    Throws:
    
    Exception
  - testTestHookStatistics
```
public void testTestHookStatistics()
                            throws Exception
```
    Tests that the "test hook" DiskRegionStats work as advertised.
    
    Throws:
    
    Exception
  - testLowLevelGetMethods
```
public void testLowLevelGetMethods()
                            throws Exception
```
    Tests the getValueInVM and getValueOnDisk methods that were added for testing.
    
    Throws:
    
    Exception
  - testLRUCapacityController
```
public void testLRUCapacityController()
                               throws com.gemstone.gemfire.cache.CacheException
```
    Tests disk overflow with an entry-based LRUCapacityController.
    
    Throws:
    
    com.gemstone.gemfire.cache.CacheException
  - testLRUCCSizeOne
```
public void testLRUCCSizeOne()
                      throws com.gemstone.gemfire.cache.CacheException
```
    Tests a disk-based region with an LRUCapacityController with size 1 and an eviction action of "overflow".
    
    Throws:
    
    com.gemstone.gemfire.cache.CacheException
  - testPersistentReplicateB4NonPersistent
```
public void testPersistentReplicateB4NonPersistent()
```
  - testRRProxyWithPersistentReplicates
```
public void testRRProxyWithPersistentReplicates()
```

Class DiskRegionTest

Nested Class Summary

Nested classes/interfaces inherited from class dunit.DistributedTestCase

Field Summary

Fields inherited from class com.gemstone.gemfire.cache30.CacheTestCase

Fields inherited from class dunit.DistributedTestCase

Constructor Summary

Method Summary

Methods inherited from class com.gemstone.gemfire.cache30.CacheTestCase

Methods inherited from class dunit.DistributedTestCase

Methods inherited from class junit.framework.TestCase

Methods inherited from class java.lang.Object

Constructor Detail

DiskRegionTest

Method Detail

getLRUStats

testDiskRegionOverflow

testRemoteUpdates

testNoFaults

testOverflowMirror

testDestroy

testCacheEvents

fillUpOverflowRegion

testValues

testRegionEvictValue

testEvictValueOnRegionWithEvictionAttributes

testBackupStatistics

assertArrayEquals

testBackup

testRegionEntryValues

testInvalidate

testDistributedInvalidate

testOverflowUpdatedValue

testTestHookStatistics

testLowLevelGetMethods

testLRUCapacityController

testLRUCCSizeOne

testPersistentReplicateB4NonPersistent

testRRProxyWithPersistentReplicates