com.bigdata.service

Class AbstractEmbeddedFederationTestCase

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

junit.framework.TestCase2

com.bigdata.btree.AbstractBTreeTestCase

com.bigdata.service.AbstractEmbeddedFederationTestCase

All Implemented Interfaces:

junit.framework.Test

Direct Known Subclasses:

AbstractRepositoryTestCase, StressTestConcurrent, TestBasicIndexStuff, TestDistributedTransactionService, TestEmbeddedClient, TestFederatedQueryEngine, TestMapBindingSetsOverNodes, TestMapBindingSetsOverShards, TestMetadataIndex, TestMove, TestOverflow, TestOverflowGRS, TestRangeQuery, TestRemoteAccessPath, TestRestartSafe, TestScatterSplit, TestSplitJoin

public abstract class AbstractEmbeddedFederationTestCase
extends AbstractBTreeTestCase

An abstract test harness that sets up (and tears down) the metadata and data services required for a bigdata federation using in-process services rather than service discovery (which means that there is no network IO).

Version:

$Id$ FIXME modify this and TestLDS to be proxy test suites so that I can run tests against both with ease and make use of them for testing the FullTextIndex and BigdataFileSystem.

Author:

Bryan Thompson

Nested Class Summary

Nested classes/interfaces inherited from class junit.framework.TestCase2

TestCase2.MyProperties, TestCase2.RandomType

Field Summary

Fields

Modifier and Type	Field and Description
protected IBigdataClient<?>	client
protected IDataService	dataService0
protected IDataService	dataService1
protected IBigdataFederation<?>	fed
protected IMetadataService	metadataService

Fields inherited from class com.bigdata.btree.AbstractBTreeTestCase

keyBuilder, log, r

Fields inherited from class junit.framework.TestCase2

_randomType

Constructor Summary

Constructors

Constructor and Description
AbstractEmbeddedFederationTestCase()
AbstractEmbeddedFederationTestCase(String arg0)

Method Summary

Methods

Modifier and Type	Method and Description
void	assertEquals(byte[][] expected, byte[][] actual) Compares two byte[][]s for equality.
static void	assertEquals(Split expected, Split actual) Verifies that two splits have the same data.
void	assertEquals(String msg, byte[][] expected, byte[][] actual) Compares two byte[][]s for equality.
protected void	assertIndexRegistered(IDataService dataService, String name, UUID indexUUID) Verify that a named index is registered on a specific DataService with the specified indexUUID.
protected long	awaitAsynchronousOverflow(IDataService dataService, long priorOverflowCounter) Waits until the asynchronous overflow counter has been incremented, indicating that overflow processing has occurred and that post-processing for the overflow event is complete.
protected int	getPartitionCount(String name) Return the #of index partitions in a scale-out index.
Properties	getProperties() Reads in the configuration properties for the test from a variety of resources and returns a properties hierarchy.
void	setUp() Data files are placed into a directory named by the test.
void	tearDown()

Methods inherited from class com.bigdata.btree.AbstractBTreeTestCase

assertChildKeys, assertEntryCounts, assertKeys, assertKeys, assertKeys, assertSameAbstractNodeData, assertSameBTree, assertSameEntryIterator, assertSameEntryIterator, assertSameIterator, assertSameIterator, assertSameLeaf, assertSameLeafData, assertSameNode, assertSameNodeData, assertSameNodeOrLeaf, assertSameRaba, assertValues, assertValues, doEntryIteratorTest, doInsertKeySequenceTest, doInsertLookupRemoveStressTest, doInsertRandomKeySequenceTest, doInsertRandomKeySequenceTest, doInsertRandomSparseKeySequenceTest, doKnownKeySequenceTest, doRandomIndexOfTest, doRandomKeyInsertTest, doRandomLookupTest, doRemoveStructureStressTest, doSplitTest, doSplitWithDecreasingKeySequence, doSplitWithIncreasingKeySequence, doSplitWithRandomDenseKeySequence, getBTree, getBTree, getKeysAndValues, getRandomKeys, getRandomKeyValues, i2k, nextLong, useRawRecords

Methods inherited from class junit.framework.TestCase2

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEqualsWithinUlps, assertSameArray, assertSameArray, assertSameBigDecimal, assertSameBigDecimal, assertSameBigInteger, assertSameBigInteger, assertSameIterator, assertSameIterator, assertSameIteratorAnyOrder, assertSameIteratorAnyOrder, assertSameValue, assertSameValue, assertZeroUlps, assertZeroUlps, fail, getInnerCause, getNormalInt, getProjectBuildPath, getRandomObject, getRandomObject, getRandomOrder, getRandomString, getTestInputStream, getTestResource, getTestResource, getUlps, getUlps, isDEBUG, isDEBUG, isINFO, isINFO, isInnerCause, logProperties

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

client

protected IBigdataClient<?> client

fed

protected IBigdataFederation<?> fed

metadataService

protected IMetadataService metadataService

dataService0

protected IDataService dataService0

dataService1

protected IDataService dataService1

Constructor Detail

AbstractEmbeddedFederationTestCase

public AbstractEmbeddedFederationTestCase()

AbstractEmbeddedFederationTestCase

public AbstractEmbeddedFederationTestCase(String arg0)

Parameters:

arg0 -

Method Detail

getProperties

public Properties getProperties()

Description copied from class: TestCase2

Reads in the configuration properties for the test from a variety of resources and returns a properties hierarchy. If a property name is not bound at the top-level of the returned Properties object, then the lower levels of the hierarchy are recursively searched.

The hierarchy is constructed from the following properties files in the following order. The first property file in this list corresponds to the top of the property hierarchy. The last property file in this list corresponds to the bottom of the property hierarchy. The property resources are:

1. The System properties specified using the -D argument on the command line.
2. ${user.home}/build.properties. ${user.home} is the value of the Java system environment variable named "user.home" and corresponds to the user home directory. A warning is logged if this properties file does not exist. Note: The JUnit UI can wind up with a different value for this property than when you execute tests without the UI. It is an error if the properties file exists but can not be read.
3. {class}.properties, where {class} is the class name reported by Java reflection, is loaded iff it is found.
4. {class} is repeatedly truncated by dropping the last package name component to generate a package name. If a properties file named "test.properties" exists in that package then those properties are loaded.

Overrides:

getProperties in class TestCase2

Returns:

A Properties object that supplies bindings for property names according to the described hierarchy among property resources. The returned Properties is NOT cached. TODO This does not handle the recursive truncation of the class name to search for "test.properties" yet.

setUp

public void setUp()
           throws Exception

Data files are placed into a directory named by the test. If the directory exists, then it is removed before the federation is set up.

Overrides:

setUp in class junit.framework.TestCase

Throws:

Exception

tearDown

public void tearDown()
              throws Exception

Overrides:

tearDown in class junit.framework.TestCase

Throws:

Exception

assertEquals

public static final void assertEquals(Split expected,
                Split actual)

Verifies that two splits have the same data.

Parameters:

expected -

actual -

assertIndexRegistered

protected final void assertIndexRegistered(IDataService dataService,
                         String name,
                         UUID indexUUID)
                                    throws Exception

Verify that a named index is registered on a specific DataService with the specified indexUUID.

Parameters:

dataService - The data service.

name - The index name.

indexUUID - The unique identifier assigned to all instances of that index.

Throws:

Exception

assertEquals

public final void assertEquals(byte[][] expected,
                byte[][] actual)

Compares two byte[][]s for equality.

Parameters:

expected -

actual -

assertEquals

public final void assertEquals(String msg,
                byte[][] expected,
                byte[][] actual)

Compares two byte[][]s for equality.

Parameters:

expected -

actual -

awaitAsynchronousOverflow

protected long awaitAsynchronousOverflow(IDataService dataService,
                             long priorOverflowCounter)
                                  throws IOException

Waits until the asynchronous overflow counter has been incremented, indicating that overflow processing has occurred and that post-processing for the overflow event is complete.

Note: Normally you use bring the data service to the brink of the desired overflow event, note the current overflow counter using IDataService.getAsynchronousOverflowCounter(), use IDataService#forceOverflow() to set the forceOverflow flag, do one more write to trigger group commit and overflow processing, and then invoke this method to await the end of overflow post-processing.

Parameters:

dataService - The data service.

priorOverflowCounter -

Returns:

The new value of the overflow counter.

Throws:

IOException

getPartitionCount

protected int getPartitionCount(String name)

Return the #of index partitions in a scale-out index.

Note: This uses an key range scan to count only the non-deleted index partition entries (the MetadataIndex does not use delete markers so a normal range count is exact).

Parameters:

name - The name of the scale-out index.

Returns:

The #of index partitions.