Skip to main content
Entwickler Themen
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

DataGrid mit Filtern und JDBC

DataGrid<K,T> ergänzt den Tabellenrenderer aus NeitzelLib um abfragbare Datenquellen, Seitennavigation und asynchrone Aktualisierung. Die bestehende Table für lokale Collections bleibt verfügbar. Für neue Ansichten mit größeren Datenbeständen oder externen Quellen wird das DataGrid ausdrücklich eingerichtet.

Datenquelle und Spalten

  • data-grid enthält die JavaFX-unabhängigen Abfrageverträge und MemoryGridSource für Collections. Die Quelle erhält eine Funktion für stabile Zeilenschlüssel, explizite Spaltenzuordnungen und einen Executor der Anwendung. Sie erfasst die benötigten Werte beim Aufruf und filtert, sortiert und schneidet die Seite auf diesem Executor zu.
  • fx enthält DataGrid, ResultColumn und den Renderer. Richte Spalten mit stabilen IDs sowie eine Factory für die Zeilen ein und rufe auf dem JavaFX Application Thread load() auf. Beim Schließen der View gibt close() die Zeilen frei und fordert den Abbruch der aktiven Anfrage an. Den Executor verwaltet die Anwendung.
  • data-grid-jdbc ist ein optionaler JDBC-Adapter. Die Anwendung liefert DataSource, Treiber und Spaltenzuordnungen. Der Adapter führt Filterung, Sortierung und Seitenauswahl an der Quelle aus. Die dokumentierten Datenbankeigenschaften sind mit H2 geprüft. Für andere SQL-Dialekte müssen Vergleichsverhalten und Transaktionsgrenzen separat geprüft werden.

Beim Laden oder nach einem Fehler bleiben die zuletzt angezeigten Zeilen sichtbar, sind aber vorübergehend deaktiviert. Eine alte Antwort kann das Ergebnis einer neueren Anfrage nicht überschreiben. Nach einem Fehler kann der Benutzer die Anfrage wiederholen. Die Auswahl All erzeugt für jeden Treffer eine JavaFX-Component. Oberhalb des konfigurierten Grenzwerts fragt das Grid deshalb vor der Materialisierung nach, standardmäßig bei mehr als 1.000 Treffern.

Filter und gespeicherte Ansichten

Die Standardfilter unterstützen Text, exakte Dezimalzahlen, fehlende oder vorhandene Werte sowie die Auswahl konkreter Werte in einer Checkliste. Zeichen wie % und _ werden in Textfiltern wörtlich gesucht. Bei Checklisten kann die Anwendung die Werte der aktuellen Seite oder Werte aus einer konfigurierten Quelle anbieten. Der Editor zeigt diesen Geltungsbereich. Eigene FXML-Editoren bearbeiten zunächst einen Entwurf. Beim Übernehmen übergibt der Editor eine unveränderliche Filterbedingung an die Abfrage. Eine eigene Bedingung braucht passende Unterstützung in jeder verwendeten Quelle.

Mit dem optionalen Gson-Modul lassen sich Filter, Sortierung, Seiteneinstellung, Spaltenreihenfolge und Breiten als versioniertes JSON speichern. Zeilendaten, Auswahl und Zugangsdaten gehören nicht in die Datei. Beim Laden werden Layout und Abfrage gemeinsam übernommen, sobald die Abfrage erfolgreich war. Für geänderte Spaltendefinitionen kann die Anwendung eine Migration anbieten.

Das Produktbeispiel ausprobieren

Führe im Stammverzeichnis von NeitzelLib mit JDK 25 aus:

./mvnw -pl fx-example -am package -DskipTests
java -cp 'fx-example/target/fx-example-1.0-SNAPSHOT.jar:fx-example/target/libs/*' de.neitzel.fx.example.grid.ProductGridMain

Der Startbefehl verwendet den Klassenpfadtrenner von macOS und Linux. Das Beispiel bietet denselben Produktkatalog im Speicher und in einer eingebetteten H2-Datenbank. Sortiere die Liste, filtere nach einem Preisbereich, speichere die Ansicht und wechsle zwischen Memory und H2. Ein Filter, den nur die Speicherquelle unterstützt, zeigt beim Wechsel einen Fehler und lässt die letzte erfolgreiche Ansicht stehen.

Weitere Beispiele bieten der englische DataGrid-Leitfaden und der Rundgang durch die Produktdemo.