Skip to content

Home

FluDa

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.

Get Started GitHub

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 — @Repository interfaces with query-by-method-name, @Find, and @Query, generated at compile time and executed through JdbcClient.

  • 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
Mail 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.