# datatable-java

**Repository Path**: mirrors_cucumber/datatable-java

## Basic Information

- **Project Name**: datatable-java
- **Description**: [READ ONLY] Data Table for Java - subtree of monorepo. Now part of Cucumber-JVM
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-05-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![Maven Central](https://img.shields.io/maven-central/v/io.cucumber/datatable.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:%22io.cucumber%22%20AND%20a:%22datatable%22)

# Data Table for Java

For general information about data tables please refer to the [polyglot project](../) 
for specific information the [DataTable javadoc](datatable/src/main/java/io/cucumber/datatable/DataTable.java).  

## Comparing data tables

The matchers module contains [Hamcrest matchers](http://hamcrest.org/) 
to compare data tables. These can be used in most common test frameworks and
produces pretty error messages.


Add the `datatable-matchers` dependency to your pom.

```
<dependencies>
  [...]
    <dependency>
        <groupId>io.cucumber</groupId>
        <artifactId>datatable-matchers</artifactId>
        <version>${cucumber-datatable.version}</version>
        <scope>test</scope>
    </dependency>
  [...]
</dependencies>
```

Use the matcher in your step definition.

```java
import static io.cucumber.datatable.matchers.DataTableHasTheSameRowsAs.hasTheSameRowsAs;

[...]

private final DataTable expected = DataTable.create(
    asList(
        asList("Annie M. G.", "Schmidt"),
        asList("Roald", "Dahl"),
));
    
@Then("these authors have registered:")
public void these_authors_have_registered(DataTable registeredAuthors){
    assertThat(registeredAuthors, hasTheSameRowsAs(expected).inOrder());
    
    // java.lang.AssertionError: 
    // Expected: a datable with the same rows
    // but: the tables were different
    // - | Annie M. G. | Schmidt  |
    //   | Roald       | Dahl     |
    // + | Astrid      | Lindgren |
} 
```

## Build ##

Not building?

We're using shaded dependencies in a reactor build so make sure you run `mvn clean install` the first time.
 
IntelliJ IDEA also doesn't know how to handle the shaded pom

0. `mvn install`
1. Open the 'Maven Projects' tool window. 
2. Choose "Shaded DataTable Dependencies" -> "Ignore Projects". 
3. Open Project Structure, choose the "DataTable" module, add jars, select dependencies/datatable-dependencies-....jar
4. Select the top level `pom.xml` and choose "Maven" -> "Reimport".