com.bigdata.rdf.store

Class AbstractTestCase

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

junit.framework.TestCase2

com.bigdata.rdf.store.AbstractTestCase

All Implemented Interfaces:

junit.framework.Test

Direct Known Subclasses:

ProxyTestCase, TestLocalQuadStore, TestLocalTripleStore, TestLocalTripleStoreWithoutInlining, TestLocalTripleStoreWithoutStatementIdentifiers, TestScaleOutTripleStoreWithEmbeddedFederation, TestTempTripleStore

public abstract class AbstractTestCase
extends TestCase2

Abstract harness for testing under a variety of configurations. In order to test a specific configuration, create a concrete instance of this class. The configuration can be described using a mixture of a .properties file of the same name as the test class and custom code.

When debugging from an IDE, it is very helpful to be able to run a single test case. You can do this, but you MUST define the property testClass as the name test class that has the logic required to instantiate and configure an appropriate object manager instance for the test.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AbstractTestCase.StatementVerifier Helper class verifies that all statements identified by a re-parse of some RDF/XML file are present in the KB.

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

TestCase2.MyProperties, TestCase2.RandomType

Field Summary

Fields

Modifier and Type	Field and Description
protected IV	NULL A null IV reference (NOT a NullIV object).

Fields inherited from class junit.framework.TestCase2

_randomType, log

Constructor Summary

Constructors

Constructor and Description
AbstractTestCase()
AbstractTestCase(String name)

Method Summary

Methods

Modifier and Type	Method and Description
void	assertEquals(SPO[] expected, SPO[] actual)
void	assertEquals(SPO expected, SPO actual)
void	assertEquals(String msg, SPO[] expected, SPO[] actual)
void	assertEquals(String msg, SPO expected, SPO actual)
static void	assertLexiconIndicesConsistent(AbstractTripleStore store) Verify that TERM2ID and ID2TERM have the same range count and that all ID2TERM entries resolve a TERM2ID entry and that each TERM2ID entry leads to an ID2TERM entry.
static void	assertSameSPOs(ISPO[] expected, IChunkedOrderedIterator<ISPO> actual)
static void	assertSameSPOs(String msg, ISPO[] expected, IChunkedOrderedIterator<ISPO> actual)
static void	assertSameSPOsAnyOrder(AbstractTripleStore store, ISPO[] expected, IChunkedOrderedIterator<ISPO> actual) Verify that the iterator visits the expected ISPOs in any order without duplicates.
static void	assertSameSPOsAnyOrder(AbstractTripleStore store, ISPO[] expected, IChunkedOrderedIterator<ISPO> actual, boolean ignoreAxioms) Verify that the iterator visits the expected ISPOs in any order without duplicates, optionally ignoring axioms.
static void	assertSameStatements(org.openrdf.model.Statement[] expected, BigdataStatementIterator actual)
static void	assertSameStatements(String msg, org.openrdf.model.Statement[] expected, BigdataStatementIterator actual)
static void	assertStatementIndicesConsistent(AbstractTripleStore db, int maxerrors) Validates that the same statements are found in each of the statement indices.
protected void	checkIfProxy() This method is invoked from methods that MUST be proxied to this class.
Properties	getProperties() Returns properties read from a hierarchy of sources.
protected abstract AbstractTripleStore	getStore(Properties properties)
protected void	recursiveDelete(File f) Recursively removes any files and subdirectories and then removes the file (or directory) itself.
protected abstract AbstractTripleStore	reopenStore(AbstractTripleStore store)
protected void	setUp(ProxyTestCase testCase) Invoked from TestCase.setUp() for each test in the suite.
protected void	tearDown(ProxyTestCase testCase) Invoked from TestCase.tearDown() for each test in the suite.

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, setUp, tearDown, toString

Methods inherited from class java.lang.Object

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

Field Detail

NULL

protected final IV NULL

A null IV reference (NOT a NullIV object).

Constructor Detail

AbstractTestCase

public AbstractTestCase()

AbstractTestCase

public AbstractTestCase(String name)

Method Detail

setUp

protected void setUp(ProxyTestCase testCase)
              throws Exception

Invoked from TestCase.setUp() for each test in the suite.

Throws:

Exception

tearDown

protected void tearDown(ProxyTestCase testCase)
                 throws Exception

Invoked from TestCase.tearDown() for each test in the suite.

Throws:

Exception

getProperties

public Properties getProperties()

Returns properties read from a hierarchy of sources. The underlying properties read from those sources are cached, but a new properties object is returned on each invocation (to prevent side effects by the caller).

In general, a test configuration critically relies on both the properties returned by this method and the appropriate properties must be provided either through the command line or in a properties file.

Overrides:

getProperties in class TestCase2

Returns:

A new properties object.

checkIfProxy

protected void checkIfProxy()

This method is invoked from methods that MUST be proxied to this class. GenericProxyTestCase extends this class, as do the concrete classes that drive the test suite for specific GOM integration test configuration. Many method on this class must be proxied from GenericProxyTestCase to the delegate. Invoking this method from the implementations of those methods in this class provides a means of catching omissions where the corresponding method is NOT being delegated. Failure to delegate these methods means that you are not able to share properties or object manager instances across tests, which means that you can not do configuration-based testing of integrations and can also wind up with mutually inconsistent test fixtures between the delegate and each proxy test.

getStore

protected abstract AbstractTripleStore getStore(Properties properties)

reopenStore

protected abstract AbstractTripleStore reopenStore(AbstractTripleStore store)

assertEquals

public void assertEquals(SPO expected,
                SPO actual)

assertEquals

public void assertEquals(String msg,
                SPO expected,
                SPO actual)

assertEquals

public void assertEquals(SPO[] expected,
                SPO[] actual)

assertEquals

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

assertSameSPOs

public static void assertSameSPOs(ISPO[] expected,
                  IChunkedOrderedIterator<ISPO> actual)

assertSameSPOs

public static void assertSameSPOs(String msg,
                  ISPO[] expected,
                  IChunkedOrderedIterator<ISPO> actual)

assertSameSPOsAnyOrder

public static void assertSameSPOsAnyOrder(AbstractTripleStore store,
                          ISPO[] expected,
                          IChunkedOrderedIterator<ISPO> actual)

Verify that the iterator visits the expected ISPOs in any order without duplicates.

Parameters:

store - Used to resolve term identifiers for messages.

expected -

actual -

assertSameSPOsAnyOrder

public static void assertSameSPOsAnyOrder(AbstractTripleStore store,
                          ISPO[] expected,
                          IChunkedOrderedIterator<ISPO> actual,
                          boolean ignoreAxioms)

Verify that the iterator visits the expected ISPOs in any order without duplicates, optionally ignoring axioms.

Parameters:

store - Used to resolve term identifiers for messages.

expected -

actual - (The iterator will be closed).

ignoreAxioms -

assertSameStatements

public static void assertSameStatements(org.openrdf.model.Statement[] expected,
                        BigdataStatementIterator actual)

assertSameStatements

public static void assertSameStatements(String msg,
                        org.openrdf.model.Statement[] expected,
                        BigdataStatementIterator actual)

assertLexiconIndicesConsistent

public static void assertLexiconIndicesConsistent(AbstractTripleStore store)

Verify that TERM2ID and ID2TERM have the same range count and that all ID2TERM entries resolve a TERM2ID entry and that each TERM2ID entry leads to an ID2TERM entry.

Parameters:

store2 -

assertStatementIndicesConsistent

public static void assertStatementIndicesConsistent(AbstractTripleStore db,
                                    int maxerrors)

Validates that the same statements are found in each of the statement indices.

recursiveDelete

protected void recursiveDelete(File f)

Recursively removes any files and subdirectories and then removes the file (or directory) itself.

Parameters:

f - A file or directory.