Home
Fluent Data Toolkit for Jakarta EE / CDI
A lightweight, modular toolkit for data access, messaging, and application infrastructure — built on standard Jakarta EE and CDI.
What is FluDa?¶
FluDa provides a developer-friendly, fluent programming model for data access that mirrors modern APIs like Spring's JdbcClient — without the bulk of a full framework. It is organized into six standalone pillars:
-
JDBC Client
A lightweight, type-safe, fluent query engine built directly over JDBC.
-
SQL Initialization
Automates database schema management and data population on application startup.
-
Transaction Support
Container-agnostic declarative and programmatic transaction boundaries.
-
Mail
Simple mail abstraction with Jakarta Mail and pluggable providers.
-
Data
A Jakarta Data implementation —
@Repositoryinterfaces with query-by-method-name,@Find, and@Query, generated at compile time and executed throughJdbcClient. -
JMS Client
A fluent Jakarta Messaging client with CDI wiring, payload converters and cached connections.
Why FluDa?¶
-
Lightweight
Zero framework dependencies — built on standard CDI and Jakarta EE. No Spring, no heavyweight runtime.
-
Modular
Use only what you need — core, config, CDI, or any combination — across every pillar.
-
Jakarta EE/CDI Friendly
Built on standard Jakarta EE, CDI, Jakarta Data, and MicroProfile Config. Works with GlassFish, WildFly, and any compatible server.
Modules¶
| Pillar | Artifacts | Latest Version | Description |
|---|---|---|---|
| JDBC Client | core, config, cdi |
1.0.0-Beta1 |
Fluent query engine over JDBC |
| SQL Init | core, config, cdi |
1.0.0-SNAPSHOT (In development) |
Automated schema migration on startup |
| Transaction Support | core, cdi, jdbc, jpa |
1.0.0-SNAPSHOT (In development) |
Declarative & programmatic transactions |
core, config, cdi |
1.0.0-SNAPSHOT (In development) |
Mail abstraction with Jakarta Mail and pluggable providers | |
| Data | core, qbn, processor |
1.0.0-SNAPSHOT (In development) |
Jakarta Data repositories generated at compile time |
| JMS Client | core, config, cdi |
1.0.0-SNAPSHOT (In development) |
Fluent Jakarta Messaging client with CDI wiring |
Quick example¶
Add the dependency to your project:
<dependency>
<groupId>io.github.fludakit</groupId>
<artifactId>fluda-jdbc-core</artifactId>
<version>1.0.0-Beta1</version>
</dependency>
Then create a client from any DataSource and run fluent queries:
import io.github.fludakit.jdbc.JdbcClient;
// Create a client from any DataSource
JdbcClient client = new JdbcClient(dataSource);
// Fluent queries with named parameters
List<Engineer> engineers = client.sql("SELECT id, name FROM engineers WHERE department = :dept")
.param("dept", "Engineering")
.query(Engineer.class)
.list();
// Updates with generated keys
int rows = client.sql("INSERT INTO engineers (name, department) VALUES (:name, :dept)")
.param("name", "Ada Lovelace")
.param("dept", "Engineering")
.update();
See the getting started guide for all options.
Examples¶
Explore the example applications for all modules' usages.