org.apache.derbyTesting.unitTests.services

Class T_LockFactory

java.lang.Object

org.apache.derbyTesting.unitTests.harness.T_Generic

org.apache.derbyTesting.unitTests.harness.T_MultiIterations

org.apache.derbyTesting.unitTests.services.T_LockFactory

All Implemented Interfaces:

org.apache.derby.iapi.services.monitor.ModuleControl, UnitTest

public class T_LockFactory
extends T_MultiIterations

Protocol unit test for the LockManager.

See Also:

LockFactory, UnitTest

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	ITERATIONS
protected org.apache.derby.iapi.services.locks.LockFactory	lf

Fields inherited from class org.apache.derbyTesting.unitTests.harness.T_Generic

out, shortModuleToTestName, startParams

Constructor Summary

Constructors

Constructor and Description
T_LockFactory()

Method Summary

Modifier and Type	Method and Description
(package private) void	checkLockCount(org.apache.derby.iapi.services.locks.CompatibilitySpace cs, int expected) Check to see if the total number of locks we have is as expected.
(package private) void	checkLockGroupCount(org.apache.derby.iapi.services.locks.CompatibilitySpace cs, java.lang.Object group, int expected) Check to see if the number of locks in a group we have is as expected.
protected java.lang.String	getModuleToTestProtocolName() Get the name of the protocol for the module to test.
(package private) void	M001() Multi-user test 001.
(package private) void	M002() Multi-user test 002 Create a single lockable and have three threads lock it, yield and then release it.
(package private) void	M003() Multi-user test 003 Create a single lockable and have three threads lock it, yield and then release it.
(package private) void	M004() Multi-user test 004 As M003 but each thread will lock the object twice, to ensure that lock manager grantes the lock when the compatability space and qualifier match.
protected void	runTestSet() Run once per-iteration to run the actual test.
(package private) void	S001() Single user API test 001.
(package private) void	S002() Single user API test 002.
(package private) void	S003() Single user API test 003.
(package private) void	S004() Single user API test 004.
(package private) void	S005() Single user API test 005.
(package private) void	S007() Single user API test 007.
protected void	setupTest() Run all the tests, each test that starts with 'S' is a single user test, each test that starts with 'M' is a multi-user test.

Methods inherited from class org.apache.derbyTesting.unitTests.harness.T_MultiIterations

runTests

Methods inherited from class org.apache.derbyTesting.unitTests.harness.T_Generic

boot, Execute, FAIL, PASS, REPORT, stop, UnitTestDuration, UnitTestType

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ITERATIONS

protected static final int ITERATIONS

See Also:

Constant Field Values

lf

protected org.apache.derby.iapi.services.locks.LockFactory lf

Constructor Detail

T_LockFactory

public T_LockFactory()

Method Detail

getModuleToTestProtocolName

protected java.lang.String getModuleToTestProtocolName()

Description copied from class: T_Generic

Get the name of the protocol for the module to test. This is the 'factory.MODULE' variable. 'moduleName' to the name of the module to test.

Specified by:

getModuleToTestProtocolName in class T_Generic

setupTest

protected void setupTest()
                  throws T_Fail

Run all the tests, each test that starts with 'S' is a single user test, each test that starts with 'M' is a multi-user test.

Specified by:

setupTest in class T_MultiIterations

Throws:

T_Fail - The test failed in some way.

runTestSet

protected void runTestSet()
                   throws T_Fail

Run once per-iteration to run the actual test.

Specified by:

runTestSet in class T_MultiIterations

Throws:

T_Fail - the test failed in some way.

S001

void S001()
   throws org.apache.derby.iapi.error.StandardException,
          T_Fail

Single user API test 001. Lock an single object in a single group with all lock methods and then unlock the object with all unlock methods.

Throws:

org.apache.derby.iapi.error.StandardException - An exception thrown by a method of LockFactory

T_Fail - Some behaviour of the LockFactory is incorrect

S002

void S002()
   throws org.apache.derby.iapi.error.StandardException,
          T_Fail

Single user API test 002. Lock an object in different groups and check unlocks apply to a single group.

Throws:

org.apache.derby.iapi.error.StandardException - An exception thrown by a method of LockFactory

T_Fail - Some behaviour of the LockFactory is incorrect

S003

void S003()
   throws org.apache.derby.iapi.error.StandardException,
          T_Fail

Single user API test 003. Lock multiple objects in different groups and check unlocks apply to a single group.

Throws:

org.apache.derby.iapi.error.StandardException - An exception thrown by a method of LockFactory

T_Fail - Some behaviour of the LockFactory is incorrect

S004

void S004()
   throws org.apache.derby.iapi.error.StandardException,
          T_Fail

Single user API test 004. Lock multiple objects in different groups and transfer locks between groups.

Throws:

org.apache.derby.iapi.error.StandardException - An exception thrown by a method of LockFactory

T_Fail - Some behaviour of the LockFactory is incorrect

S005

void S005()
   throws org.apache.derby.iapi.error.StandardException,
          T_Fail

Single user API test 005. Create two compatability spaces and ensure that locks block each other out.

Throws:

org.apache.derby.iapi.error.StandardException - An exception thrown by a method of LockFactory

T_Fail - Some behaviour of the LockFactory is incorrect

S007

void S007()
   throws org.apache.derby.iapi.error.StandardException,
          T_Fail

Single user API test 007. Tests on groups and compatibility spaces never seen by the lock manager.

Throws:

org.apache.derby.iapi.error.StandardException - An exception thrown by a method of LockFactory

T_Fail - Some behaviour of the LockFactory is incorrect

M001

void M001()
   throws org.apache.derby.iapi.error.StandardException,
          T_Fail

Multi-user test 001. Create two lockable objects and pass them off to two threads. Each thread will run lock the first object, set its value then lock the second object & set its value, yield and then release the lock on one and then on two. Various checks are made to ensure the values are as expected.

Throws:

org.apache.derby.iapi.error.StandardException - An exception thrown by a method of LockFactory

T_Fail - Some behaviour of the LockFactory is incorrect

M002

void M002()
   throws org.apache.derby.iapi.error.StandardException,
          T_Fail

Multi-user test 002 Create a single lockable and have three threads lock it, yield and then release it. The single lockable can only have one locker.

Throws:

org.apache.derby.iapi.error.StandardException - An exception thrown by a method of LockFactory

T_Fail - Some behaviour of the LockFactory is incorrect

M003

void M003()
   throws org.apache.derby.iapi.error.StandardException,
          T_Fail

Multi-user test 003 Create a single lockable and have three threads lock it, yield and then release it. The single lockable is a semaphore that can have two lockers.

Throws:

org.apache.derby.iapi.error.StandardException - An exception thrown by a method of LockFactory

T_Fail - Some behaviour of the LockFactory is incorrect

M004

void M004()
   throws org.apache.derby.iapi.error.StandardException,
          T_Fail

Multi-user test 004 As M003 but each thread will lock the object twice, to ensure that lock manager grantes the lock when the compatability space and qualifier match.

Throws:

org.apache.derby.iapi.error.StandardException - An exception thrown by a method of LockFactory

T_Fail - Some behaviour of the LockFactory is incorrect

checkLockCount

void checkLockCount(org.apache.derby.iapi.services.locks.CompatibilitySpace cs,
                    int expected)
             throws T_Fail

Check to see if the total number of locks we have is as expected.

Throws:

T_Fail - Number of locks is not as expected.

checkLockGroupCount

void checkLockGroupCount(org.apache.derby.iapi.services.locks.CompatibilitySpace cs,
                         java.lang.Object group,
                         int expected)
                  throws T_Fail

Check to see if the number of locks in a group we have is as expected.

Throws:

T_Fail - Number of locks is not as expected.