com.bigdata.rawstore

Class AbstractRawStoreTestCase

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

junit.framework.TestCase2

com.bigdata.io.TestCase3

com.bigdata.rawstore.AbstractRawStoreTestCase

All Implemented Interfaces:

junit.framework.Test

Direct Known Subclasses:

AbstractBufferStrategyTestCase, AbstractInterruptsTestCase, AbstractMRMWTestCase, AbstractMROWTestCase, TestMemStore.TestRawStore, TestSimpleFileRawStore, TestSimpleMemoryRawStore, TestTemporaryStore, TestTemporaryStore.TestRawStore

public abstract class AbstractRawStoreTestCase
extends TestCase3

Base class for writing tests of the IRawStore interface.

Version:

$Id$

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 Random	r A random number generated - the seed is NOT fixed.

Fields inherited from class junit.framework.TestCase2

_randomType, log

Constructor Summary

Constructors

Constructor and Description
AbstractRawStoreTestCase()
AbstractRawStoreTestCase(String name)

Method Summary

Methods

Modifier and Type	Method and Description
ByteBuffer	getRandomData() Returns random data that will fit in N bytes.
protected abstract IRawStore	getStore() Return a new store that will serve as the fixture for the test.
void	test_close()
void	test_multipleWrites() Test writes a bunch of records and verifies that each can be read after it is written.
void	test_read_correctRejection_0L() A read with a 0L address is always an error.
void	test_read_correctRejection_zeroLength() A delete with an address encoding a zero length component is an error (the address is ill-formed since we do not allow writes of zero length records).
void	test_readImmutable() Test verifies that read does not permit changes to the store state by modifying the returned buffer.
void	test_write_correctRejection_emptyRecord() Test verifies correct rejection of a write operation when the caller supplies an empty buffer (no bytes remaining).
void	test_write_correctRejection_null() Test verifies correct rejection of a write operation when the caller supplies a [null] buffer.
void	test_writeImmutable() Test verifies that write does not permit changes to the store state by modifying the supplied buffer after the write operation (i.e., a copy is made of the data in the buffer).
void	test_writeRead() Test verifies that we can write and then read back a record.
void	test_writeReadRead() Test verifies that we can write and then read back a record twice.
void	testBlobObjectStreams() Writing a blob sized object stream is an excellent test since the ObjectInputStream will likely throw an exception if there is a data error.
void	testEmptyStream()
void	testSimpleStringStream()
void	testSimpleStringStreamFromStandardAllocation()
void	testZipStreams() This test exercises the stream interface and serves as an example of stream usage for compressed IO.

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, getProperties, 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

r

protected final Random r

A random number generated - the seed is NOT fixed.

Constructor Detail

AbstractRawStoreTestCase

public AbstractRawStoreTestCase()

AbstractRawStoreTestCase

public AbstractRawStoreTestCase(String name)

Parameters:

name -

Method Detail

getStore

protected abstract IRawStore getStore()

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.

Returns:

The fixture for the test.

test_write_correctRejection_emptyRecord

public void test_write_correctRejection_emptyRecord()

Test verifies correct rejection of a write operation when the caller supplies an empty buffer (no bytes remaining).

test_write_correctRejection_null

public void test_write_correctRejection_null()

Test verifies correct rejection of a write operation when the caller supplies a [null] buffer.

test_read_correctRejection_0L

public void test_read_correctRejection_0L()

A read with a 0L address is always an error.

test_read_correctRejection_zeroLength

public void test_read_correctRejection_zeroLength()

A delete with an address encoding a zero length component is an error (the address is ill-formed since we do not allow writes of zero length records).

test_writeRead

public void test_writeRead()

Test verifies that we can write and then read back a record.

test_writeReadRead

public void test_writeReadRead()

Test verifies that we can write and then read back a record twice.

test_writeImmutable

public void test_writeImmutable()

Test verifies that write does not permit changes to the store state by modifying the supplied buffer after the write operation (i.e., a copy is made of the data in the buffer).

test_readImmutable

public void test_readImmutable()

Test verifies that read does not permit changes to the store state by modifying the returned buffer.

test_multipleWrites

public void test_multipleWrites()

Test writes a bunch of records and verifies that each can be read after it is written. The test then performs a random order read and verifies that each of the records can be read correctly.

testSimpleStringStream

public void testSimpleStringStream()
                            throws IOException,
                                   ClassNotFoundException

Throws:

IOException

ClassNotFoundException

testSimpleStringStreamFromStandardAllocation

public void testSimpleStringStreamFromStandardAllocation()
                                                  throws IOException,
                                                         ClassNotFoundException

Throws:

IOException

ClassNotFoundException

testEmptyStream

public void testEmptyStream()
                     throws IOException,
                            ClassNotFoundException

Throws:

IOException

ClassNotFoundException

testBlobObjectStreams

public void testBlobObjectStreams()
                           throws IOException,
                                  ClassNotFoundException

Writing a blob sized object stream is an excellent test since the ObjectInputStream will likely throw an exception if there is a data error.

Throws:

IOException

ClassNotFoundException

testZipStreams

public void testZipStreams()
                    throws IOException,
                           ClassNotFoundException

This test exercises the stream interface and serves as an example of stream usage for compressed IO.

Throws:

IOException

ClassNotFoundException

test_close

public void test_close()

getRandomData

public ByteBuffer getRandomData()

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

Returns:

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