/jooq-demo

A fork of the jOOQ demo code that works with the Sakila database.

Primary LanguageScalaApache License 2.0Apache-2.0

jOOQ demo

A jOOQ demo working with the Sakila database running in a testcontainers database instance (in docker).

It depends on the latest released version of jOOQ. A branch is available that works with a SNAPSHOT build of the dev version, which is available from:

It includes a variety of feature combinations including:

  • jOOQ features
    • of the jOOQ Professional and Enterprise Editions (in jOOQ-demo-pro)
    • of the jOOQ Open Source Edition (in jOOQ-demo-oss)
  • Language support
    • Java (e.g. in jOOQ-demo-java)
    • Kotlin (e.g. in jOOQ-demo-kotlin)
    • Scala (e.g. in jOOQ-demo-scala)
  • Build support
    • Maven
    • Gradle (soon)
  • Testcontainers integration
  • Database change management integration
    • Flyway
    • Liquibase (soon)
  • RDBMS support for any RDBMS currently supported in the Sakila database. Currently:
    • PostgreSQL

For more details, see jOOQ#1

Why testcontainers?

Testcontainers is a wonderful utility that makes running non-trivial integration tests very easy, on docker. The old days where you run MySQL, Oracle, PostgreSQL, SQL Server in production but test things on something like H2, HSQLDB, etc. are over. You shouldn't do that anymore. Instead, test your code against your production database product. Benefits are obvious:

  • Your quality will increase (despite using jOOQ, which can abstract over a lot, you will have production like behaviour in your tests as well, avoiding all sorts of edge cases that even jOOQ cannot handle)
  • You can use all vendor specific features (e.g. stored procedures, which are a great thing!)

Why Flyway / Liquibase?

Proper database change management is important, and jOOQ urges you to do it right up front in every new project. It will lead to:

  • A cleaner database schema
  • A more streamlined jOOQ code generation process (always 1. migrate, 2. generate, 3. integration test)
  • Higher confidence when upgrading your production database, as that has already been tested (ideally, again, with testcontainers)

Why not [XYZ]?

You might want to see an example of using [XYZ] in action, including

  • Your favourite connection pool (e.g. Hikari)
  • Your favourite application framework (e.g. Spring Boot, Quarkus, Micronaut, Dropwizard, etc.)
  • Your favourite architecture style (e.g. monolith webapp, microservices, REST API, rich clients, etc.)

All of these are interesting use-cases for jOOQ and trust us, jOOQ works everywhere. All jOOQ needs is a JDBC Connection or DataSource, or an R2DBC Connection or ConnectionFactory. That's it. That's all jOOQ needs to work. And these things already work everywhere. jOOQ doesn't make any assumptions about your architecture, nor does it have an opinion. As such, these examples are unnecessary. They're also very hard to maintain, because those third parties evolve constantly, making example code outdated. Besides, there's a combinatorial explosion of using e.g. (Spring Boot with Hikari with Vaadin).

This demo project focuses only on jOOQ functionality.