Built by Maven

Developers Guide

Contributions to the dbUnit Eclipse Plugin are welcome. This page describes how the repository is organized and how to work on the plugin in Eclipse. Building covers the command-line build, and Releasing the release procedure.

Repository Layout

Path Contents
bundles/org.dbunit.eclipse.dataset.core UI-independent dataset model, flat XML parser, and edit engine
bundles/org.dbunit.eclipse.dataset.ui The editor: registration, NatTable grid, commands, preferences
features/org.dbunit.eclipse.feature The installable feature (and its generated source feature)
releng/org.dbunit.eclipse.target Target platform definitions: baseline (the oldest supported Eclipse release) and latest
releng/org.dbunit.eclipse.repository The p2 repository (update site) definition, category.xml
releng/icons A generator of the editor’s icons, run with java releng/icons/GenerateIcons.java
releng/marketplace Eclipse Marketplace listing content
releng/perf A generator of large datasets for checking the editor’s performance
src/site This documentation site, published to GitHub Pages
.github/workflows CI build, release, and site/update-site publishing

Developing in Eclipse

  1. Install the Eclipse IDE for RCP and RAP Developers package, or add Eclipse Plug-in Development Environment and m2e to any package.
  2. File > Import…​ > Maven > Existing Maven Projects, then select the repository’s root directory.
  3. Open releng/org.dbunit.eclipse.target/latest.target and click Set as Active Target Platform.
  4. Run or debug with Run As > Eclipse Application from the org.dbunit.eclipse.dataset.ui project.

Checking Performance

releng/perf/GenerateLargeDataset.java writes a large dataset with five tables in a given dbUnit dataset format, for example 100,000 rows of 20 columns; the same arguments always produce the same file. Its first argument names the format; flatxml, the flat XML format, is the only one so far. Run it from the repository root with a JDK 17 or newer:

java releng/perf/GenerateLargeDataset.java flatxml 100000 20 target/perf/dataset-100000.xml

Open the generated file in a runtime workbench, then edit, insert, delete, undo, and paste on the Tables page, and type on the Source page. The editor should open a dataset of 100,000 rows and 10 MB within 3 seconds and apply each edit within 1 second, and should apply a cell edit to a dataset of 10,000 rows within 150 ms.