cucumber.api

Class DataTable

java.lang.Object

cucumber.api.DataTable

public class DataTable
extends java.lang.Object

Represents the data from a Gherkin DataTable. Cucumber will convert the table in Gherkin to a DataTable instance and pass it to a step definition.

Constructor Summary

Constructors

Constructor and Description
DataTable(gherkin.pickles.PickleTable pickleTable, TableConverter tableConverter) Creates a new DataTable.

Method Summary

Modifier and Type	Method and Description
<T> java.util.List<T>	asList(java.lang.Class<T> itemType) Converts the table to a List.
<T> java.util.List<java.util.List<T>>	asLists(java.lang.Class<T> itemType) Converts the table to a List of List of scalar.
<K,V> java.util.Map<K,V>	asMap(java.lang.Class<K> keyType, java.lang.Class<V> valueType) Converts the table to a single Map.
<K,V> java.util.List<java.util.Map<K,V>>	asMaps(java.lang.Class<K> keyType, java.lang.Class<V> valueType) Converts the table to a List of Map.
java.util.List<java.util.List<java.lang.String>>	cells(int firstRow)
static DataTable	create(java.util.List<?> raw)
static DataTable	create(java.util.List<?> raw, java.util.Locale locale, java.lang.String... columnNames)
static DataTable	create(java.util.List<?> raw, java.lang.String format, java.lang.String... columnNames)
protected cucumber.runtime.table.TablePrinter	createTablePrinter()
void	diff(DataTable other) Diffs this table with other.
void	diff(java.util.List<?> other) Diffs this table with other, which can be a List&lt;List&lt;String&gt;&gt; or a List&lt;YourType&gt;.
java.util.List<cucumber.runtime.table.DiffableRow>	diffableRows()
boolean	equals(java.lang.Object o)
java.util.List<gherkin.pickles.PickleRow>	getPickleRows() Internal method.
TableConverter	getTableConverter()
int	hashCode()
java.util.List<java.util.List<java.lang.String>>	raw()
java.util.List<java.lang.String>	topCells()
java.lang.String	toString()
DataTable	toTable(java.util.List<?> raw, java.lang.String... columnNames) Creates another table using the same Locale and Format that was used to create this table.
DataTable	transpose()
void	unorderedDiff(DataTable other) Diffs this table with other.
void	unorderedDiff(java.util.List<?> other) Diffs this table with other, which can be a List&lt;List&lt;String&gt;&gt; or a List&lt;YourType&gt;.

Methods inherited from class java.lang.Object

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

Constructor Detail

DataTable

public DataTable(gherkin.pickles.PickleTable pickleTable,
                 TableConverter tableConverter)

Creates a new DataTable. This constructor should not be called by Cucumber users - it's used internally only.

Parameters:

pickleTable - the underlying table.

tableConverter - how to convert the rows.

Method Detail

create

public static DataTable create(java.util.List<?> raw)

create

public static DataTable create(java.util.List<?> raw,
                               java.lang.String format,
                               java.lang.String... columnNames)

create

public static DataTable create(java.util.List<?> raw,
                               java.util.Locale locale,
                               java.lang.String... columnNames)

raw

public java.util.List<java.util.List<java.lang.String>> raw()

Returns:

a List of List of String.

asMaps

public <K,V> java.util.List<java.util.Map<K,V>> asMaps(java.lang.Class<K> keyType,
                                                       java.lang.Class<V> valueType)

Converts the table to a List of Map. The top row is used as keys in the maps, and the rows below are used as values.

Type Parameters:

K - key type

V - value type

Parameters:

keyType - key type

valueType - value type

Returns:

a List of Map.

asMap

public <K,V> java.util.Map<K,V> asMap(java.lang.Class<K> keyType,
                                      java.lang.Class<V> valueType)

Converts the table to a single Map. The left column is used as keys, the right column as values.

Type Parameters:

K - key type

V - value type

Parameters:

keyType - key type

valueType - value type

Returns:

a Map.

Throws:

cucumber.runtime.CucumberException - if the table doesn't have 2 columns.

asList

public <T> java.util.List<T> asList(java.lang.Class<T> itemType)

Converts the table to a List. If itemType is a scalar type the table is flattened. Otherwise, the top row is used to name the fields/properties and the remaining rows are turned into list items.

Type Parameters:

T - the type of the list items

Parameters:

itemType - the type of the list items

Returns:

a List of objects

asLists

public <T> java.util.List<java.util.List<T>> asLists(java.lang.Class<T> itemType)

Converts the table to a List of List of scalar.

Type Parameters:

T - the type of the list items

Parameters:

itemType - the type of the list items

Returns:

a List of List of objects

topCells

public java.util.List<java.lang.String> topCells()

cells

public java.util.List<java.util.List<java.lang.String>> cells(int firstRow)

toTable

public DataTable toTable(java.util.List<?> raw,
                         java.lang.String... columnNames)

Creates another table using the same Locale and Format that was used to create this table.

Parameters:

raw - a list of objects

columnNames - optional explicit header columns

Returns:

a new table

diff

public void diff(java.util.List<?> other)
          throws cucumber.runtime.table.TableDiffException

Diffs this table with other, which can be a List<List<String>> or a List<YourType>.

Parameters:

other - the other table to diff with.

Throws:

cucumber.runtime.table.TableDiffException - if the tables are different.

diff

public void diff(DataTable other)
          throws cucumber.runtime.table.TableDiffException

Diffs this table with other.

Parameters:

other - the other table to diff with.

Throws:

cucumber.runtime.table.TableDiffException - if the tables are different.

unorderedDiff

public void unorderedDiff(DataTable other)
                   throws cucumber.runtime.table.TableDiffException

Diffs this table with other. The order is not important. A set-difference is applied.

Parameters:

other - the other table to diff with.

Throws:

cucumber.runtime.table.TableDiffException - if the tables are different.

unorderedDiff

public void unorderedDiff(java.util.List<?> other)
                   throws cucumber.runtime.table.TableDiffException

Diffs this table with other, which can be a List<List<String>> or a List<YourType>.

Parameters:

other - the other table to diff with.

Throws:

cucumber.runtime.table.TableDiffException - if the tables are different.

getPickleRows

public java.util.List<gherkin.pickles.PickleRow> getPickleRows()

Internal method. Do not use.

Returns:

a list of raw rows.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

diffableRows

public java.util.List<cucumber.runtime.table.DiffableRow> diffableRows()

getTableConverter

public TableConverter getTableConverter()

transpose

public DataTable transpose()

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

createTablePrinter

protected cucumber.runtime.table.TablePrinter createTablePrinter()