hu.ibello.data

Interface CsvTestDataBuilder<T>

All Superinterfaces:

StreamBasedBuilder, StringBasedBuilder<CsvTestDataBuilder<T>>

public interface CsvTestDataBuilder<T>
extends StringBasedBuilder<CsvTestDataBuilder<T>>

This interface specifies a test data loader which loads data from CSV files. CSV files are describing a tabular structure, therefore the loaded result is a list of java objects.

With the withId(String) method we can specify an optional identifier for the loaded CSV file.

The load() method returns the loaded java list. The loadString() method returns the CSV content of the test data. The StreamBasedBuilder.openStream() method opens a stream which contains this content.

By default, the file is loaded with UTF-8 character set. We can change this with the StringBasedBuilder.withCharset(java.nio.charset.Charset) method.

Author:

Kornél Simon

See Also:

TestDataBuilder.fromCsv(Class)

Method Summary

Modifier and Type	Method and Description
List<T>	load() Loads the test data from CSV file, and convert it to a list of java objects.
String	loadString() Loads the test data from CSV file.
CsvTestDataBuilder<T>	withId(String testDataId) With this method we can specify an optional identifier for the loaded CSV file.

Methods inherited from interface hu.ibello.data.StringBasedBuilder

withCharset

Methods inherited from interface hu.ibello.data.StreamBasedBuilder

openStream

Method Detail

withId

CsvTestDataBuilder<T> withId(String testDataId)

With this method we can specify an optional identifier for the loaded CSV file. The identifier should be part of the file name.

Parameters:

testDataId - an identifier of the loaded CSV file

Returns:

this loader instance

load

List<T> load()

Loads the test data from CSV file, and convert it to a list of java objects. If the test data cannot be found then returns null.

Returns:

the loaded test data as a java list

loadString

String loadString()

Loads the test data from CSV file. If the test data cannot be found then returns null. If the test data is coming from multiple files then the header of these files should be the same, otherwise a runtime exception will be thrown.

Specified by:

loadString in interface StringBasedBuilder<CsvTestDataBuilder<T>>

Returns:

the loaded test data as String