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.
data-gridenthält die JavaFX-unabhängigen Abfrageverträge undMemoryGridSourcefü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.fxenthältDataGrid,ResultColumnund den Renderer. Richte Spalten mit stabilen IDs sowie eine Factory für die Zeilen ein und rufe auf dem JavaFX Application Threadload()auf. Beim Schließen der View gibtclose()die Zeilen frei und fordert den Abbruch der aktiven Anfrage an. Den Executor verwaltet die Anwendung.data-grid-jdbcist 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.
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.
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.