com.bigdata.journal

Class AbstractBufferStrategyTestCase

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

junit.framework.TestCase2

com.bigdata.io.TestCase3

com.bigdata.rawstore.AbstractRawStoreTestCase

com.bigdata.journal.AbstractBufferStrategyTestCase

All Implemented Interfaces:

junit.framework.Test

Direct Known Subclasses:

AbstractRestartSafeTestCase, TestTransientJournal.TestRawStore

public abstract class AbstractBufferStrategyTestCase
extends AbstractRawStoreTestCase

Base class for writing test cases for the different IBufferStrategy implementations.

Version:

$Id$

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.rawstore.AbstractRawStoreTestCase

r

Fields inherited from class junit.framework.TestCase2

_randomType, log

Constructor Summary

Constructors

Constructor and Description
AbstractBufferStrategyTestCase()
AbstractBufferStrategyTestCase(String name)

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract BufferMode	getBufferMode()
Properties	getProperties() Reads in the configuration properties for the test from a variety of resources and returns a properties hierarchy.
protected IRawStore	getStore() Return a new store that will serve as the fixture for the test.
void	test_overflow() Unit test for AbstractBufferStrategy.overflow(long).
void	test_writeNoExtend() Test verifies that a write up to the remaining extent does not trigger an overflow.
void	test_writeWithExtend() Test verifies that a write over the remaining extent triggers an overflow.
protected long	writeRandomData(Journal store, long nbytesToWrite, boolean allowChecksum) Write random bytes on the store.

Methods inherited from class com.bigdata.rawstore.AbstractRawStoreTestCase

getRandomData, test_close, test_multipleWrites, test_read_correctRejection_0L, test_read_correctRejection_zeroLength, test_readImmutable, test_write_correctRejection_emptyRecord, test_write_correctRejection_null, test_writeImmutable, test_writeRead, test_writeReadRead, testBlobObjectStreams, testEmptyStream, testSimpleStringStream, testSimpleStringStreamFromStandardAllocation, testZipStreams

Methods inherited from class com.bigdata.io.TestCase3

assertCondition, assertCondition, assertEquals, assertEquals, getBytes, getPort, getRandomData, getRandomData, setUp, tearDown

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

AbstractBufferStrategyTestCase

public AbstractBufferStrategyTestCase()

AbstractBufferStrategyTestCase

public AbstractBufferStrategyTestCase(String name)

Method Detail

getBufferMode

protected abstract BufferMode getBufferMode()

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 IRawStore getStore()

Description copied from class: AbstractRawStoreTestCase

Return a new store that will serve as the fixture for the test. A stable store must remove the pre-existing store. A transient store should open a new store every time.

Specified by:

getStore in class AbstractRawStoreTestCase

Returns:

The fixture for the test.

test_overflow

public void test_overflow()

Unit test for AbstractBufferStrategy.overflow(long). The test verifies that the extent and the user extent are correctly updated after an overflow.

test_writeNoExtend

public void test_writeNoExtend()

Test verifies that a write up to the remaining extent does not trigger an overflow.

writeRandomData

protected long writeRandomData(Journal store,
                   long nbytesToWrite,
                   boolean allowChecksum)

Write random bytes on the store.

Parameters:

store - The store.

nbytesToWrite - The #of bytes to be written. If this is larger than the maximum record length then multiple records will be written.

Returns:

The address of the last record written.

test_writeWithExtend

public void test_writeWithExtend()

Test verifies that a write over the remaining extent triggers an overflow. The test also makes sure that the existing data is recoverable and that the new data is also recoverable (when the buffer is extended it is typically copied while the length of a file is simply changed).