com.bigdata.journal

Class AbstractIndexManagerTestCase<S extends IIndexManager>

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

junit.framework.TestCase2

com.bigdata.io.TestCase3

com.bigdata.journal.AbstractIndexManagerTestCase<S>

All Implemented Interfaces:

junit.framework.Test

Direct Known Subclasses:

AbstractJournalTestCase, ProxyTestCase, TestEDS

public abstract class AbstractIndexManagerTestCase<S extends IIndexManager>
extends TestCase3

Author:

Bryan Thompson

Nested Class Summary

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

TestCase2.MyProperties, TestCase2.RandomType

Field Summary

Fields inherited from class com.bigdata.io.TestCase3

r

Fields inherited from class junit.framework.TestCase2

_randomType, log

Constructor Summary

Constructors

Constructor and Description
AbstractIndexManagerTestCase()
AbstractIndexManagerTestCase(String name)

Method Summary

Methods

Modifier and Type	Method and Description
protected void	checkIfProxy() This method is invoked from methods that MUST be proxied to this class.
protected void	fail(Callable<?> c, Class<? extends Throwable> expected) Test helper evaluates a Callable and fails unless the expected exception is thrown.
Properties	getProperties() Reads in the configuration properties for the test from a variety of resources and returns a properties hierarchy.
ByteBuffer	getRandomData() Returns random data that will fit in N bytes.
protected abstract S	getStore(Properties properties) Open/create an IIndexManager using the given properties.
protected abstract S	reopenStore(S store) Close and then re-open an IIndexManager backed by the same persistent data.
void	setUp()
void	setUp(ProxyTestCase<S> testCase) Invoked from TestCase.setUp() for each test in the suite.
void	tearDown()
void	tearDown(ProxyTestCase<S> testCase) Invoked from TestCase.tearDown() for each test in the suite.

Methods inherited from class com.bigdata.io.TestCase3

assertCondition, assertCondition, assertEquals, assertEquals, getBytes, getPort, getRandomData, getRandomData

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

Constructor Detail

AbstractIndexManagerTestCase

public AbstractIndexManagerTestCase()

AbstractIndexManagerTestCase

public AbstractIndexManagerTestCase(String name)

Method Detail

setUp

public void setUp(ProxyTestCase<S> testCase)
           throws Exception

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

Throws:

Exception

tearDown

public void tearDown(ProxyTestCase<S> testCase)
              throws Exception

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

Throws:

Exception

setUp

public void setUp()
           throws Exception

Overrides:

setUp in class TestCase3

Throws:

Exception

tearDown

public void tearDown()
              throws Exception

Overrides:

tearDown in class TestCase3

Throws:

Exception

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.

getStore

protected abstract S getStore(Properties properties)

Open/create an IIndexManager using the given properties.

reopenStore

protected abstract S reopenStore(S store)

Close and then re-open an IIndexManager backed by the same persistent data.

Parameters:

store - the existing store.

Returns:

A new store.

Throws:

Throwable - if the existing store is closed or if the store can not be re-opened, e.g., from failure to obtain a file lock, etc.

checkIfProxy

protected final 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 methods 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.

getRandomData

public ByteBuffer getRandomData()

Returns random data that will fit in N bytes. N is chosen randomly in 1:1024.

Returns:

A new ByteBuffer wrapping a new byte[] of random length and having random contents.

fail

protected void fail(Callable<?> c,
        Class<? extends Throwable> expected)

Test helper evaluates a Callable and fails unless the expected exception is thrown. This is typically used to perform correct rejection tests for methods.

Parameters:

c - The Callable.

expected - The expected exception.