org.apache.derbyTesting.unitTests.store

Class T_SortController

java.lang.Object

org.apache.derbyTesting.unitTests.harness.T_Generic

org.apache.derbyTesting.unitTests.store.T_SortController

All Implemented Interfaces:

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

public class T_SortController
extends T_Generic

Unit test for sorting.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	testService
protected boolean	verbose Set this to print out the rows that are inserted into and returned from each sort.

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

out, shortModuleToTestName, startParams

Constructor Summary

Constructors

Constructor and Description
T_SortController()

Method Summary

Modifier and Type	Method and Description
java.lang.String	getModuleToTestProtocolName() Get the name of the protocol for the module to test.
private T_AccessRow[]	getSortDescendingInput()
protected int	runEachTest(org.apache.derby.iapi.store.access.AccessFactory store, java.lang.String tail)
protected void	runTests() Run the test.
private void	setSortBufferSize(java.lang.String buf_length)
(package private) boolean	sortAllDuplicates(org.apache.derby.iapi.store.access.TransactionController tc) Test a sort where all the rows are duplicates
(package private) boolean	sortBoundaries(org.apache.derby.iapi.store.access.TransactionController tc) Test a sorts with one or zero rows.
(package private) boolean	sortBufferCoverage(org.apache.derby.iapi.store.access.TransactionController tc) This test covers specific code paths in the external sort's sort buffer.
(package private) boolean	sortDescending(org.apache.derby.iapi.store.access.TransactionController tc) Test a sort where we have some ascending and descending keys.
(package private) boolean	sortExample(org.apache.derby.iapi.store.access.TransactionController tc) This test is more of an example, with lots of comments to explain what's going on.
(package private) boolean	testSort(org.apache.derby.iapi.store.access.TransactionController tc, T_AccessRow[] in, T_AccessRow[] outrow, long sortid) Insert the given rows into the given sort, and check that the rows retrieved from the sort match the output rows.

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

testService

private static final java.lang.String testService

See Also:

Constant Field Values

verbose

protected boolean verbose

Set this to print out the rows that are inserted into and returned from each sort.

Constructor Detail

T_SortController

public T_SortController()

Method Detail

getModuleToTestProtocolName

public 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

setSortBufferSize

private void setSortBufferSize(java.lang.String buf_length)

runTests

protected void runTests()
                 throws T_Fail

Description copied from class: T_Generic

Run the test. The test should raise an exception if it fails. runTests should return if the tests pass.

Specified by:

runTests in class T_Generic

Throws:

T_Fail - test has failed

runEachTest

protected int runEachTest(org.apache.derby.iapi.store.access.AccessFactory store,
                          java.lang.String tail)
                   throws T_Fail,
                          org.apache.derby.iapi.error.StandardException

Throws:

T_Fail

org.apache.derby.iapi.error.StandardException

sortExample

boolean sortExample(org.apache.derby.iapi.store.access.TransactionController tc)
             throws org.apache.derby.iapi.error.StandardException

This test is more of an example, with lots of comments to explain what's going on.

Throws:

org.apache.derby.iapi.error.StandardException

sortBufferCoverage

boolean sortBufferCoverage(org.apache.derby.iapi.store.access.TransactionController tc)
                    throws org.apache.derby.iapi.error.StandardException

This test covers specific code paths in the external sort's sort buffer. It really should live closer to the sort buffer since the effectiveness of this test is very very implementation dependent.

Throws:

org.apache.derby.iapi.error.StandardException

sortBoundaries

boolean sortBoundaries(org.apache.derby.iapi.store.access.TransactionController tc)
                throws org.apache.derby.iapi.error.StandardException

Test a sorts with one or zero rows.

Throws:

org.apache.derby.iapi.error.StandardException

sortAllDuplicates

boolean sortAllDuplicates(org.apache.derby.iapi.store.access.TransactionController tc)
                   throws org.apache.derby.iapi.error.StandardException

Test a sort where all the rows are duplicates

Throws:

org.apache.derby.iapi.error.StandardException

sortDescending

boolean sortDescending(org.apache.derby.iapi.store.access.TransactionController tc)
                throws org.apache.derby.iapi.error.StandardException

Test a sort where we have some ascending and descending keys.

Throws:

org.apache.derby.iapi.error.StandardException

getSortDescendingInput

private T_AccessRow[] getSortDescendingInput()

testSort

boolean testSort(org.apache.derby.iapi.store.access.TransactionController tc,
                 T_AccessRow[] in,
                 T_AccessRow[] outrow,
                 long sortid)
          throws org.apache.derby.iapi.error.StandardException

Insert the given rows into the given sort, and check that the rows retrieved from the sort match the output rows.

Throws:

org.apache.derby.iapi.error.StandardException