eu.stratosphere.core.testing

Class TestRecords

java.lang.Object

eu.stratosphere.core.testing.GenericTestRecords<eu.stratosphere.types.Record>

eu.stratosphere.core.testing.TestRecords

All Implemented Interfaces:

Closeable, AutoCloseable, Iterable<eu.stratosphere.types.Record>

public class TestRecords
extends GenericTestRecords<eu.stratosphere.types.Record>

Represents the input or output values of a TestPlan. The class is especially important when setting the expected values in the TestPlan.

There are two ways to specify the values:

1. From a file: with GenericTestRecords.load(Class, Configuration) and GenericTestRecords.load(Class, String, Configuration) the location, format, and configuration of the data can be specified. The file is lazily loaded and thus can be comparable large.
2. Ad-hoc: key/value records can be added with add(Record...), add(Value...), and add(Iterable). Please note that the actual amount of records is quite for a test case as the TestPlan already involves a certain degree of overhead.
   
   TestRecords are directly comparable with equals and hashCode based on its content. Please note that in the case of large file-based TestRecords, the time needed to compute the GenericTestRecords.hashCode() or to compare two instances with GenericTestRecords.equals(Object) can become quite long. Currently, the comparison result is order-dependent as TestRecords are interpreted as a list.

Constructor Summary

Constructors

Constructor and Description
TestRecords(Class<? extends eu.stratosphere.types.Value>[] schema) Initializes TestRecords with the given schema.
TestRecords(Class<? extends eu.stratosphere.types.Value> firstEntry, Class<?>... remainingEntries) Initializes TestRecords with the given schema.
TestRecords(TypeConfig<eu.stratosphere.types.Record> typeConfig) Initializes TestRecords with the given type config.

Method Summary

Methods

Modifier and Type	Method and Description
TestRecords	add(GenericTestRecords<eu.stratosphere.types.Record> records) Adds several records at once.
TestRecords	add(Iterable<? extends eu.stratosphere.types.Record> records) Adds several records at once.
TestRecords	add(eu.stratosphere.types.Record... records) Adds several records at once.
TestRecords	add(eu.stratosphere.types.Value... values) Adds input or expected values to this TestRecords.
static TypeConfig<eu.stratosphere.types.Record>	getRecordConfig(Class<? extends eu.stratosphere.types.Value>[] schema) Creates the type config specific for Stratosphere Records with the given schema.
static TypeConfig<eu.stratosphere.types.Record>	getRecordConfig(Class<? extends eu.stratosphere.types.Value> firstEntry, Class<?>... remainingEntries) Creates the type config specific for Stratosphere Records with the given schema.
static Class<? extends eu.stratosphere.types.Value>[]	getSchema(TypeConfig<eu.stratosphere.types.Record> config) Returns the schema from the given config.
void	inferTypeConfig()
void	setAllowedDoubleDelta(double delta) Sets the double delta that is allowed so that DoubleValues are treated as equal.
TestRecords	withAllowedDoubleDelta(double delta) Sets the double delta that is allowed so that DoubleValues are treated as equal.

Methods inherited from class eu.stratosphere.core.testing.GenericTestRecords

assertEquals, close, equals, getRecords, getTypeConfig, hashCode, isAdhoc, isInitialized, iterator, iterator, load, load, saveToFile, setEmpty, setTypeConfig, toString, unsortedIterator

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

TestRecords

public TestRecords(Class<? extends eu.stratosphere.types.Value> firstEntry,
           Class<?>... remainingEntries)

Initializes TestRecords with the given schema.

TestRecords

public TestRecords(Class<? extends eu.stratosphere.types.Value>[] schema)

Initializes TestRecords with the given schema.

TestRecords

public TestRecords(TypeConfig<eu.stratosphere.types.Record> typeConfig)

Initializes TestRecords with the given type config.

Method Detail

add

public TestRecords add(GenericTestRecords<eu.stratosphere.types.Record> records)

Description copied from class: GenericTestRecords

Adds several records at once.

Overrides:

add in class GenericTestRecords<eu.stratosphere.types.Record>

Parameters:

records - the records to add

Returns:

this

add

public TestRecords add(Iterable<? extends eu.stratosphere.types.Record> records)

Description copied from class: GenericTestRecords

Adds several records at once.

Overrides:

add in class GenericTestRecords<eu.stratosphere.types.Record>

Parameters:

records - the records to add

Returns:

this

add

public TestRecords add(eu.stratosphere.types.Record... records)

Description copied from class: GenericTestRecords

Adds several records at once.

Overrides:

add in class GenericTestRecords<eu.stratosphere.types.Record>

Parameters:

records - the records to add

Returns:

this

add

public TestRecords add(eu.stratosphere.types.Value... values)

Adds input or expected values to this TestRecords.

inferTypeConfig

public void inferTypeConfig()

setAllowedDoubleDelta

public void setAllowedDoubleDelta(double delta)

Sets the double delta that is allowed so that DoubleValues are treated as equal.

withAllowedDoubleDelta

public TestRecords withAllowedDoubleDelta(double delta)

Sets the double delta that is allowed so that DoubleValues are treated as equal.

getRecordConfig

public static final TypeConfig<eu.stratosphere.types.Record> getRecordConfig(Class<? extends eu.stratosphere.types.Value> firstEntry,
                                                       Class<?>... remainingEntries)

Creates the type config specific for Stratosphere Records with the given schema.

Returns:

the type config

getRecordConfig

public static final TypeConfig<eu.stratosphere.types.Record> getRecordConfig(Class<? extends eu.stratosphere.types.Value>[] schema)

Creates the type config specific for Stratosphere Records with the given schema.

Returns:

the type config

getSchema

public static final Class<? extends eu.stratosphere.types.Value>[] getSchema(TypeConfig<eu.stratosphere.types.Record> config)

Returns the schema from the given config.