com.gemstone.gemfire.cache30

Class CacheTestCase

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

dunit.DistributedTestCase

com.gemstone.gemfire.cache30.CacheTestCase

All Implemented Interfaces:

Serializable, junit.framework.Test

Direct Known Subclasses:

AbstractLauncherDUnitTestCase, AdminAndCacheDUnitTest, AdminDUnitTestCase, AgentTest, BridgeTestCase, BridgeWriterMiscDUnitTest, Bug34387DUnitTest, Bug34948DUnitTest, Bug35214DUnitTest, Bug36853EventsExpiryDUnitTest, Bug37377DUnitTest, Bug38013DUnitTest, Bug39079DUnitTest, Bug39356DUnitTest, Bug40299DUnitTest, Bug40632DUnitTest, Bug40751DUnitTest, Bug41091DUnitTest, Bug41733DUnitTest, Bug42010StatsDUnitTest, Bug42055DUnitTest, Bug43522DUnit, Bug45164DUnitTest, Bug45934DUnitTest, CacheAdvisorTest, CacheCloseTest, CachedAllEventsDUnitTest, CacheLogRollTest, CacheRegionsReliablityStatsCheckTest, CacheStatisticsTest, CacheXml30Test, CallbackArgDUnitTest, ClassNotFoundExceptionDUnitTest, CliCommandTestBase, ClientServerCCEDUnitTest, ClientServerInvalidAndDestroyedEntryDUnitTest, ClientServerTransactionDUnitTest, ClientSnapshotDUnitTest, ClientsWithVersioningRetryDUnitTest, CliUtilDUnitTest, CoLocatedAgentDUnitTest, CompressionCacheConfigDUnitTest, CompressionCacheListenerDUnitTest, CompressionRegionConfigDUnitTest, CompressionRegionFactoryDUnitTest, CompressionRegionOperationsDUnitTest, CompressionStatsDUnitTest, ConcurrentDestroySubRegionDUnitTest, ConcurrentIndexInitOnOverflowRegionDUnitTest, ConcurrentIndexOperationsOnOverflowRegionDUnitTest, ConcurrentLeaveDuringGIIDUnitTest, ConcurrentMapOpsDUnitTest, ConnectDisconnectDUnitTest, ConnectionPoolAndLoaderDUnitTest, ConnectionPoolDUnitTest, ConsoleDistributionManagerTest, CopyOnReadIndexDUnitTest, CqDataDUnitTest, CqDataUsingPoolDUnitTest, CqPerfDUnitTest, CqPerfUsingPoolDUnitTest, CqQueryDUnitTest, CqQueryUsingPoolDUnitTest, CqResultSetUsingPoolDUnitTest, CqStatsDUnitTest, CqStatsUsingPoolDUnitTest, DeltaFaultInDUnitTest, DeltaSizingDUnitTest, DiskRegByteArrayDUnitTest, DiskRegionTest, DistrbutedRegionProfileOffHeapDUnitTest, DurableClientBug39997DUnitTest, DynamicRegionDUnitTest, ElidedPutAllDUnitTest, EventTrackerDUnitTest, EvictionObjectSizerDUnitTest, EvictionStatsDUnitTest, EvictionTestBase, FixedPRSinglehopDUnitTest, ForceInvalidateEvictionDUnitTest, GatewayConnectionDUnitTest, GatewayDUnitTest, GemFireDeadlockDetectorDUnitTest, GIIDeltaDUnitTest, GIIFlowControlDUnitTest, GlobalLockingTest, HAConflationDUnitTest, IncrementalBackupDUnitTest, IndexTrackingQueryObserverDUnitTest, InitializeIndexEntryDestroyQueryDUnitTest, IteratorDUnitTest, JarDeployerDUnitTest, JSONPdxClientServerDUnitTest, LocalDataSetDUnitTest, LocalDataSetIndexingDUnitTest, LondonToNewYorkDUnitTest, LRUEvictionControllerDUnitTest, LRUEvictionControllerTest, MapClearGIITest, MemberCommandsDUnitTest, MemberFunctionExecutionDUnitTest, MemLRUEvictionControllerTest, MultiRegionFunctionExecutionDUnitTest, NetSearchMessagingDUnitTest, OffHeapManagementDUnitTest, OutOfOffHeapMemoryDUnitTest, ParallelSnapshotDUnitTest, PartitionedRegionCqQueryDUnitTest, PartitionedRegionCustomEvictionDUnitTest, PartitionedRegionDelayedRecoveryDUnitTest, PartitionedRegionDUnitTestCase, PartitionedRegionEntryCountDUnitTest, PartitionedRegionEvictionDUnitTest, PartitionedRegionInvalidateDUnitTest, PartitionedRegionLoaderWriterDUnitTest, PartitionedRegionMetaDataCleanupDUnitTest, PartitionedRegionQueryDUnitTest, PartitionedRegionRedundancyZoneDUnitTest, PartitionedRegionSingleHopDUnitTest, PartitionedRegionSingleHopWithServerGroupDUnitTest, PartitionListenerDUnitTest, PartitionManagerDUnitTest, PartitionRegionHelperDUnitTest, PartitionResolverDUnitTest, PdxClientServerDUnitTest, PdxDeserializationDUnitTest, PdxGatewayEventListenerDUnitTest, PdxQueryDUnitTest, PdxSerializableDUnitTest, PdxStringQueryDUnitTest, PdxTypeExportDUnitTest, PDXWanDUnitTest, PersistentGatewayDUnitTest, PersistentPartitionedRegionTestBase, PersistentReplicatedTestBase, PRBadToDataDUnitTest, PRBucketSynchronizationDUnitTest, PRClientServerTestBase, PRColocationDUnitTest, PrCqUsingPoolDUnitTest, ProxyDUnitTest, PutAllWithIndexPerfDUnitTest, QueryDataInconsistencyDUnitTest, QueryIndexUpdateRIDUnitTest, QueryIndexUsingXMLDUnitTest, QueryMonitorDUnitTest, QueryUsingFunctionContextDUnitTest, QueryUsingPoolDUnitTest, RebalanceOperationDUnitTest, ReconnectDUnitTest, RegionExpirationTest, RegionMembershipListenerDUnitTest, RegionRecoveryDUnitTest, RegionTestCase, RegionWithHDFSTestBase, ReliabilityTestCase, RemoteQueryDUnitTest, RemoteTransactionDUnitTest, ResourceManagerDUnitTest, RolePerformanceTest, RRSynchronizationDUnitTest, SearchAndLoadTest, SelectStarQueryDUnitTest, ShowDeadlockDUnitTest, ShutdownAllDUnitTest, SingleWriteSingleReadRegionQueueDUnitTest, SizingFlagDUnitTest, SlowRecDUnitTest, SnapshotByteArrayDUnitTest, SnapshotDUnitTest, SnapshotPerformanceDUnitTest, StatisticsDUnitTest, StreamingPartitionOperationManyDUnitTest, StreamingPartitionOperationOneDUnitTest, TransactionsWithDeltaDUnitTest, TXDistributedTest, TXOrderDUnitTest, TXRestrictionsTest, UpgradeDiskStoreDUnitTest, WanQueueSizeDUnitTest

public abstract class CacheTestCase
extends DistributedTestCase

The abstract superclass of tests that require the creation of a Cache.

Since:

3.0

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class dunit.DistributedTestCase

DistributedTestCase.ExpectedException, DistributedTestCase.WaitCriterion, DistributedTestCase.WaitCriterion2

Field Summary

Fields

Modifier and Type	Field and Description
protected static com.gemstone.gemfire.cache.Cache	cache The Cache from which regions are obtained All references synchronized via CacheTestCase.class

Fields inherited from class dunit.DistributedTestCase

logPerTest, reconnect, system, testName

Constructor Summary

Constructors

Constructor and Description
CacheTestCase(String name)

Method Summary

Modifier and Type	Method and Description
protected CacheSerializableRunnable	addExceptionTag1(String expectedException)
static com.gemstone.gemfire.cache.Cache	basicGetCache() Return current cache without creating one.
static void	beginCacheXml() Sets this test up with a CacheCreation as its cache.
static void	cleanDiskDirs()
protected void	closeAllCache() Closed the cache in all VMs.
static void	closeCache() Close the cache
com.gemstone.gemfire.cache.Cache	createLonerCache() Creates the Cache for this test that is not connected to other members
com.gemstone.gemfire.cache.Cache	createMcastCache() Creates the Cache for this test that has its own mcast group
com.gemstone.gemfire.cache.Cache	createMcastCache(int jgroupsPort) Creates the Cache for this test that has its own mcast group
com.gemstone.gemfire.cache.Region	createRegion(String name, com.gemstone.gemfire.cache.RegionAttributes attrs) Returns a region with the given name and attributes
com.gemstone.gemfire.cache.Region	createRegion(String name, String rootName, com.gemstone.gemfire.cache.RegionAttributes attrs)
protected com.gemstone.gemfire.cache.Region	createRootRegion(com.gemstone.gemfire.cache.RegionAttributes attrs)
com.gemstone.gemfire.cache.Region	createRootRegion(String rootName, com.gemstone.gemfire.cache.RegionAttributes attrs)
static void	disconnectFromDS()
void	finishCacheXml(String name) Finish what beginCacheXml started.
void	finishCacheXml(String name, String xmlVersion) Finish what beginCacheXml started.
com.gemstone.gemfire.cache.Cache	getCache() Return a cache for obtaining regions, created lazily.
com.gemstone.gemfire.cache.Cache	getCache(boolean client)
com.gemstone.gemfire.cache.Cache	getCache(boolean client, com.gemstone.gemfire.cache.CacheFactory cf)
com.gemstone.gemfire.cache.Cache	getCache(com.gemstone.gemfire.cache.CacheFactory cf)
com.gemstone.gemfire.cache.client.ClientCache	getClientCache(com.gemstone.gemfire.cache.client.ClientCacheFactory factory) creates a client cache from the factory if one does not already exist
static File[]	getDiskDirs() Return a set of disk directories for persistence tests.
com.gemstone.gemfire.internal.cache.GemFireCacheImpl	getGemfireCache() same as getCache() but with casting
com.gemstone.gemfire.internal.cache.InternalRegionArguments	getInternalRegionArguments() Provide any internal region arguments, typically required when internal use (aka meta-data) regions are needed.
com.gemstone.gemfire.cache.Region	getRootRegion()
com.gemstone.gemfire.cache.Region	getRootRegion(String rootName)
static boolean	hasCache()
protected static void	remoteTearDown() Local destroy all root regions and close the cache.
protected CacheSerializableRunnable	removeExceptionTag1(String expectedException)
void	sendSerialMessageToAll() send an ordered message requiring an ack to all connected members in order to flush the ordered communication channel
void	sendUnorderedMessageToAll() send an unordered message requiring an ack to all connected members in order to flush the unordered communication channel
void	tearDown2() Tears down the test.

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

Field Detail

cache

protected static com.gemstone.gemfire.cache.Cache cache

The Cache from which regions are obtained All references synchronized via CacheTestCase.class

Constructor Detail

CacheTestCase

public CacheTestCase(String name)

Method Detail

createLonerCache

public com.gemstone.gemfire.cache.Cache createLonerCache()

Creates the Cache for this test that is not connected to other members

createMcastCache

public com.gemstone.gemfire.cache.Cache createMcastCache()

Creates the Cache for this test that has its own mcast group

createMcastCache

public com.gemstone.gemfire.cache.Cache createMcastCache(int jgroupsPort)

Creates the Cache for this test that has its own mcast group

beginCacheXml

public static void beginCacheXml()

Sets this test up with a CacheCreation as its cache. Any existing cache is closed. Whoever calls this must also call finishCacheXml

finishCacheXml

public void finishCacheXml(String name)

Finish what beginCacheXml started. It does this be generating a cache.xml file and then creating a real cache using that cache.xml.

finishCacheXml

public void finishCacheXml(String name,
                           String xmlVersion)

Finish what beginCacheXml started. It does this be generating a cache.xml file and then creating a real cache using that cache.xml.

getCache

public final com.gemstone.gemfire.cache.Cache getCache()

Return a cache for obtaining regions, created lazily.

getCache

public final com.gemstone.gemfire.cache.Cache getCache(com.gemstone.gemfire.cache.CacheFactory cf)

getCache

public final com.gemstone.gemfire.cache.Cache getCache(boolean client)

getCache

public final com.gemstone.gemfire.cache.Cache getCache(boolean client,
                                                       com.gemstone.gemfire.cache.CacheFactory cf)

getClientCache

public final com.gemstone.gemfire.cache.client.ClientCache getClientCache(com.gemstone.gemfire.cache.client.ClientCacheFactory factory)

creates a client cache from the factory if one does not already exist

Parameters:

factory -

Returns:

the client cache

Since:

6.5

getGemfireCache

public final com.gemstone.gemfire.internal.cache.GemFireCacheImpl getGemfireCache()

same as getCache() but with casting

hasCache

public static final boolean hasCache()

basicGetCache

public static final com.gemstone.gemfire.cache.Cache basicGetCache()

Return current cache without creating one.

disconnectFromDS

public static void disconnectFromDS()

closeCache

public static void closeCache()

Close the cache

closeAllCache

protected void closeAllCache()

Closed the cache in all VMs.

tearDown2

public void tearDown2()
               throws Exception

Description copied from class: DistributedTestCase

Tears down the test. This method is called by the final DistributedTestCase.tearDown() method, and should be over ridden in its place.

Overrides:

tearDown2 in class DistributedTestCase

Throws:

Exception

remoteTearDown

protected static void remoteTearDown()

Local destroy all root regions and close the cache.

createRegion

public final com.gemstone.gemfire.cache.Region createRegion(String name,
                                                            com.gemstone.gemfire.cache.RegionAttributes attrs)
                                                     throws com.gemstone.gemfire.cache.CacheException

Returns a region with the given name and attributes

Throws:

com.gemstone.gemfire.cache.CacheException

getInternalRegionArguments

public com.gemstone.gemfire.internal.cache.InternalRegionArguments getInternalRegionArguments()

Provide any internal region arguments, typically required when internal use (aka meta-data) regions are needed.

Returns:

internal arguements, which may be null. If null, then default InternalRegionArguments are used to construct the Region

createRegion

public final com.gemstone.gemfire.cache.Region createRegion(String name,
                                                            String rootName,
                                                            com.gemstone.gemfire.cache.RegionAttributes attrs)
                                                     throws com.gemstone.gemfire.cache.CacheException

Throws:

com.gemstone.gemfire.cache.CacheException

getRootRegion

public final com.gemstone.gemfire.cache.Region getRootRegion()

getRootRegion

public final com.gemstone.gemfire.cache.Region getRootRegion(String rootName)

createRootRegion

protected final com.gemstone.gemfire.cache.Region createRootRegion(com.gemstone.gemfire.cache.RegionAttributes attrs)
                                                            throws com.gemstone.gemfire.cache.RegionExistsException,
                                                                   com.gemstone.gemfire.cache.TimeoutException

Throws:

com.gemstone.gemfire.cache.RegionExistsException

com.gemstone.gemfire.cache.TimeoutException

createRootRegion

public final com.gemstone.gemfire.cache.Region createRootRegion(String rootName,
                                                                com.gemstone.gemfire.cache.RegionAttributes attrs)
                                                         throws com.gemstone.gemfire.cache.RegionExistsException,
                                                                com.gemstone.gemfire.cache.TimeoutException

Throws:

com.gemstone.gemfire.cache.RegionExistsException

com.gemstone.gemfire.cache.TimeoutException

sendUnorderedMessageToAll

public void sendUnorderedMessageToAll()

send an unordered message requiring an ack to all connected members in order to flush the unordered communication channel

sendSerialMessageToAll

public void sendSerialMessageToAll()

send an ordered message requiring an ack to all connected members in order to flush the ordered communication channel

addExceptionTag1

protected CacheSerializableRunnable addExceptionTag1(String expectedException)

removeExceptionTag1

protected CacheSerializableRunnable removeExceptionTag1(String expectedException)

getDiskDirs

public static File[] getDiskDirs()

Return a set of disk directories for persistence tests. These directories will be automatically cleaned up on test case closure.

cleanDiskDirs

public static void cleanDiskDirs()
                          throws IOException

Throws:

IOException