com.gemstone.gemfire.distributed

Class DistributedLockServiceTest

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

dunit.DistributedTestCase

com.gemstone.gemfire.distributed.DistributedLockServiceTest

All Implemented Interfaces:

Serializable, junit.framework.Test

public class DistributedLockServiceTest
extends DistributedTestCase

This class tests distributed ownership via the DistributedLockService api.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DistributedLockServiceTest.BasicLockClient

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 int[]	count_testFairness
protected static com.gemstone.gemfire.distributed.DistributedLockService	dls_testFairness
protected static com.gemstone.gemfire.distributed.DistributedSystem	dlstSystem
protected static boolean[]	done_testFairness
protected static DistributedLockServiceTest.BasicLockClient	lockClientSuspendLockingBehaves
protected static Object	monitor
protected static boolean	stop_testFairness
protected static DistributedLockServiceTest.BasicLockClient	suspendClientSuspendLockingBehaves

Fields inherited from class dunit.DistributedTestCase

logPerTest, reconnect, system, testName

Constructor Summary

Constructors

Constructor and Description
DistributedLockServiceTest(String name)

Method Summary

Modifier and Type	Method and Description
protected static void	becomeLockGrantor(String serviceName) Accessed via reflection.
static void	caseSetUp()
static void	caseTearDown()
protected static void	connectDistributedSystem() Connects a DistributedSystem, saves it in static variable "system"
static void	destroyAllDLockServices()
void	doTestReleaseOrphanedGrant_Remote(boolean destroyLockService)
void	forNumVMsInvoke(int numVMs, String methodName, Object[] args) Assumes there is only one host, and invokes the given method in the first numVMs VMs that host knows about.
static Integer	get_count_testFairness(Integer i) Accessed by reflection.
Properties	getDistributedSystemProperties() Returns a Properties object used to configure a connection to a DistributedSystem.
protected boolean	getDone()
static com.gemstone.gemfire.distributed.internal.membership.InternalDistributedMember	identifyLockGrantor(String serviceName) Accessed via reflection.
protected void	incCompletes()
protected void	incHits()
static Boolean	isLockGrantor(String serviceName) Accessed via reflection.
protected static Boolean	lock(String serviceName, Object name) Accessed via reflection.
protected static void	logInfo(String msg)
void	notestSuspendLockingBehaves() Test that suspend locking behaves under various usage patterns.
protected static void	remoteCreateService(String name) Creates a new DistributedLockService in a remote VM.
static void	remoteDumpAllDLockServices()
protected void	setDone(boolean done)
protected void	setGot(boolean got)
void	setUp() Returns a previously created (or new, if this is the first time this method is called in this VM) distributed system which is somewhat configurable via hydra test parameters.
void	tearDown2() Tears down the test.
void	testBasic()
void	testBasicGrantorRecovery()
void	testBecomeLockGrantor()
void	testBug32461() Tests for 32461 R3 StuckLocks can occur on locks with an expiration lease
void	testCreateDestroy()
void	testDepartedLastOwnerNoLease()
void	testDepartedLastOwnerWithLease()
void	testDestroyLockServiceAfterGrantResponse()
void	testDestroyLockServiceBeforeGrantRequest()
void	testFairness()
void	testGrantorSelection()
void	testGrantTokenCleanup()
void	testLeaseDoesntExpire()
void	testLeaseExpiresBeforeOtherLocks()
void	testLeaseExpiresWhileOtherLocks()
void	testLocalGetLockAndIncrement()
void	testLockDestroyedService() Tests what happens when you attempt to lock a name on a lock service that has been destroyed.
void	testLockDifferentNames()
void	testLockExpireUnlock()
void	testLockFailover()
void	testLockInterruptiblyIsInterruptible()
void	testLockIsNotInterruptible()
void	testLockQuery()
void	testLockRecursion()
void	testLockRecursionWithExpiration()
void	testLockSameNameDifferentService()
void	testLockThenBecomeLockGrantor()
void	testLockUnlock()
void	testNoStuckLock()
void	testOneGetsAndOthersTimeOut()
void	testOneGetsThenOtherGets()
void	testReleaseOrphanedGrant_Local() Client requests lock and then interrupts lock request before processing the grant reply.
void	testReleaseOrphanedGrant_Remote()
void	testReleaseOrphanedGrant_RemoteWithDestroy()
void	testRemoteGetLockAndIncrement()
void	testSuspendLockingAfterExpiration()
void	testSuspendLockingBasic() Test DistributedLockService.acquireExclusiveLocking(), releaseExclusiveLocking()
void	testSuspendLockingBlocksUntilNoLocks() Test that exlusive locking prohibits locking activity
void	testSuspendLockingInterruptiblyIsInterruptible()
void	testSuspendLockingIsNotInterruptible()
void	testSuspendLockingProhibitsLocking() Test that exlusive locking prohibits locking activity
void	testTokenCleanup()
void	testTryLock()
protected static Boolean	tryLock(String serviceName, Object name, Long wait) Accessed via reflection.
protected static Boolean	tryToLock(String serviceName) Accessed via reflection.
protected static Boolean	unlock(String serviceName, Object name) Accessed via reflection.

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, 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, 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

dlstSystem

protected static com.gemstone.gemfire.distributed.DistributedSystem dlstSystem

monitor

protected static Object monitor

dls_testFairness

protected static com.gemstone.gemfire.distributed.DistributedLockService dls_testFairness

count_testFairness

protected static int[] count_testFairness

stop_testFairness

protected static volatile boolean stop_testFairness

done_testFairness

protected static volatile boolean[] done_testFairness

suspendClientSuspendLockingBehaves

protected static DistributedLockServiceTest.BasicLockClient suspendClientSuspendLockingBehaves

lockClientSuspendLockingBehaves

protected static DistributedLockServiceTest.BasicLockClient lockClientSuspendLockingBehaves

Constructor Detail

DistributedLockServiceTest

public DistributedLockServiceTest(String name)

Method Detail

caseSetUp

public static void caseSetUp()
                      throws Exception

Throws:

Exception

caseTearDown

public static void caseTearDown()
                         throws Exception

Throws:

Exception

setUp

public void setUp()
           throws Exception

Returns a previously created (or new, if this is the first time this method is called in this VM) distributed system which is somewhat configurable via hydra test parameters.

Overrides:

setUp in class DistributedTestCase

Throws:

Exception

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

destroyAllDLockServices

public static void destroyAllDLockServices()

remoteDumpAllDLockServices

public static void remoteDumpAllDLockServices()

getDistributedSystemProperties

public Properties getDistributedSystemProperties()

Description copied from class: DistributedTestCase

Returns a Properties object used to configure a connection to a DistributedSystem. Unless overridden, this method will return an empty Properties object.

Overrides:

getDistributedSystemProperties in class DistributedTestCase

connectDistributedSystem

protected static void connectDistributedSystem()

Connects a DistributedSystem, saves it in static variable "system"

testBasic

public void testBasic()

testCreateDestroy

public void testCreateDestroy()
                       throws Exception

Throws:

Exception

testFairness

public void testFairness()
                  throws Exception

Throws:

Exception

get_count_testFairness

public static Integer get_count_testFairness(Integer i)

Accessed by reflection. DO NOT REMOVE

Parameters:

i -

Returns:

testOneGetsAndOthersTimeOut

public void testOneGetsAndOthersTimeOut()

identifyLockGrantor

public static com.gemstone.gemfire.distributed.internal.membership.InternalDistributedMember identifyLockGrantor(String serviceName)

Accessed via reflection. DO NOT REMOVE

Parameters:

serviceName -

Returns:

isLockGrantor

public static Boolean isLockGrantor(String serviceName)

Accessed via reflection. DO NOT REMOVE.

Parameters:

serviceName -

Returns:

becomeLockGrantor

protected static void becomeLockGrantor(String serviceName)

Accessed via reflection. DO NOT REMOVE.

Parameters:

serviceName -

testGrantorSelection

public void testGrantorSelection()

testBasicGrantorRecovery

public void testBasicGrantorRecovery()

testLockFailover

public void testLockFailover()

testLockThenBecomeLockGrantor

public void testLockThenBecomeLockGrantor()

testBecomeLockGrantor

public void testBecomeLockGrantor()

testTryLock

public void testTryLock()

testOneGetsThenOtherGets

public void testOneGetsThenOtherGets()

testLockDifferentNames

public void testLockDifferentNames()

testLocalGetLockAndIncrement

public void testLocalGetLockAndIncrement()

testRemoteGetLockAndIncrement

public void testRemoteGetLockAndIncrement()

testLockSameNameDifferentService

public void testLockSameNameDifferentService()

testLeaseDoesntExpire

public void testLeaseDoesntExpire()
                           throws InterruptedException

Throws:

InterruptedException

testLockUnlock

public void testLockUnlock()

testLockExpireUnlock

public void testLockExpireUnlock()

testLockRecursion

public void testLockRecursion()

testLockRecursionWithExpiration

public void testLockRecursionWithExpiration()

testLeaseExpiresBeforeOtherLocks

public void testLeaseExpiresBeforeOtherLocks()
                                      throws InterruptedException

Throws:

InterruptedException

testLeaseExpiresWhileOtherLocks

public void testLeaseExpiresWhileOtherLocks()
                                     throws InterruptedException

Throws:

InterruptedException

testSuspendLockingAfterExpiration

public void testSuspendLockingAfterExpiration()
                                       throws Exception

Throws:

Exception

testLockInterruptiblyIsInterruptible

public void testLockInterruptiblyIsInterruptible()

testLockIsNotInterruptible

public void testLockIsNotInterruptible()

testSuspendLockingBasic

public void testSuspendLockingBasic()
                             throws InterruptedException

Test DistributedLockService.acquireExclusiveLocking(), releaseExclusiveLocking()

Throws:

InterruptedException

testSuspendLockingProhibitsLocking

public void testSuspendLockingProhibitsLocking()

Test that exlusive locking prohibits locking activity

notestSuspendLockingBehaves

public void notestSuspendLockingBehaves()
                                 throws Exception

Test that suspend locking behaves under various usage patterns. This ensures that suspend and regular locks behave as ReadWriteLocks and processing occurs in order.

Throws:

Exception

testSuspendLockingBlocksUntilNoLocks

public void testSuspendLockingBlocksUntilNoLocks()
                                          throws InterruptedException

Test that exlusive locking prohibits locking activity

Throws:

InterruptedException

testSuspendLockingInterruptiblyIsInterruptible

public void testSuspendLockingInterruptiblyIsInterruptible()

testSuspendLockingIsNotInterruptible

public void testSuspendLockingIsNotInterruptible()

testLockDestroyedService

public void testLockDestroyedService()

Tests what happens when you attempt to lock a name on a lock service that has been destroyed.

testDepartedLastOwnerWithLease

public void testDepartedLastOwnerWithLease()

testDepartedLastOwnerNoLease

public void testDepartedLastOwnerNoLease()

testBug32461

public void testBug32461()
                  throws Exception

Tests for 32461 R3 StuckLocks can occur on locks with an expiration lease

VM-A locks/unlocks "lock", VM-B leases "lock" and disconnects, VM-C attempts to lock "lock" and old dlock throws StuckLockException. VM-C should now succeed in acquiring the lock.

Throws:

Exception

testNoStuckLock

public void testNoStuckLock()

testReleaseOrphanedGrant_Local

public void testReleaseOrphanedGrant_Local()

Client requests lock and then interrupts lock request before processing the grant reply. This causes the Client to send a release msg to the grantor.

testReleaseOrphanedGrant_Remote

public void testReleaseOrphanedGrant_Remote()

testReleaseOrphanedGrant_RemoteWithDestroy

public void testReleaseOrphanedGrant_RemoteWithDestroy()

doTestReleaseOrphanedGrant_Remote

public void doTestReleaseOrphanedGrant_Remote(boolean destroyLockService)

testDestroyLockServiceAfterGrantResponse

public void testDestroyLockServiceAfterGrantResponse()
                                              throws Throwable

Throws:

Throwable

testDestroyLockServiceBeforeGrantRequest

public void testDestroyLockServiceBeforeGrantRequest()
                                              throws Throwable

Throws:

Throwable

getDone

protected boolean getDone()

setDone

protected void setDone(boolean done)

setGot

protected void setGot(boolean got)

lock

protected static Boolean lock(String serviceName,
                              Object name)

Accessed via reflection. DO NOT REMOVE

Parameters:

serviceName -

name -

Returns:

tryLock

protected static Boolean tryLock(String serviceName,
                                 Object name,
                                 Long wait)

Accessed via reflection. DO NOT REMOVE

unlock

protected static Boolean unlock(String serviceName,
                                Object name)

Accessed via reflection. DO NOt REMOVE

tryToLock

protected static Boolean tryToLock(String serviceName)

Accessed via reflection. DO NOT REMOVE

Parameters:

numVMs -

numThreadsPerVM -

testTokenCleanup

public void testTokenCleanup()
                      throws Exception

Throws:

Exception

testGrantTokenCleanup

public void testGrantTokenCleanup()
                           throws Exception

Throws:

Exception

testLockQuery

public void testLockQuery()
                   throws Exception

Throws:

Exception

remoteCreateService

protected static void remoteCreateService(String name)

Creates a new DistributedLockService in a remote VM.

Parameters:

name - The name of the newly-created DistributedLockService. It is recommended that the name of the Region be the DistributedTestCase.getUniqueName() of the test, or at least derive from it.

incHits

protected void incHits()

incCompletes

protected void incCompletes()

logInfo

protected static void logInfo(String msg)

forNumVMsInvoke

public void forNumVMsInvoke(int numVMs,
                            String methodName,
                            Object[] args)

Assumes there is only one host, and invokes the given method in the first numVMs VMs that host knows about.