Quarkus Concepts
Hibernate ORM and Jakarta Persistence in Quarkus — configuration, caching, multitenancy, and modern data access.
Core Configuration
Hibernate Dialect Selection and Database Version Targeting
How Quarkus auto-detects the Hibernate dialect from your datasource, and how to pin an exact database version or override the dialect explicitly.
Multiple Persistence Units in Quarkus
How to declare named persistence units backed by separate datasources, scope entities to them, and inject or extend each unit independently via CDI.
Schema Management: Dev Mode vs Production Mode
How quarkus.hibernate-orm.schema-management.strategy and sql-load-script differ between dev and production profiles, and why production should hand schema control to a migration tool.
Caching & Auditing
Second-Level Cache: Regions, Eviction, and Query Cache
How @Cacheable, per-region memory/expiration properties, and the org.hibernate.cacheable query hint work together to enable Hibernate's second-level and query caches in Quarkus.
Hibernate Envers: Auditing and Versioning
The quarkus-hibernate-envers extension records a full change history per entity via @Audited, revision entities, and the AuditReader query API.
Multitenancy
Multitenancy Strategies: Schema, Database, and Discriminator
Quarkus offers three multitenancy strategies (SCHEMA, DATABASE, DISCRIMINATOR) selected via quarkus.hibernate-orm.multitenant, each trading isolation strength for operational simplicity.
Programmatic Tenant Resolution with TenantConnectionResolver
TenantConnectionResolver lets an application build JDBC connection providers per tenant id at runtime instead of relying on statically configured schemas or datasources.
Customization & Migration
Interceptors and StatementInspector: Hooking into Hibernate's Lifecycle
Interceptor and StatementInspector CDI beans, registered with @PersistenceUnitExtension, let you observe or rewrite entity lifecycle events and SQL statements without touching entities or queries.
Flyway Integration with Hibernate ORM
Flyway takes over schema versioning from Hibernate by seeding its first migration from Hibernate-generated DDL, then owning every migration afterward.
Modern Data Access
Static Metamodel with the Hibernate Annotation Processor
The hibernate-processor annotation processor generates type-safe metamodel classes so CriteriaBuilder queries reference entity attributes at compile time instead of by string.
Jakarta Data Repositories
Jakarta Data lets you declare repository interfaces like CrudRepository and get build-time-generated implementations, custom queries via @Query/@Find, and method-level security.
Panache: Active Record and Repository Patterns
Panache offers active-record entities and repository-style alternatives on top of plain Hibernate ORM, with simplified query strings, pagination, and sorting built in.
Extensions & Tooling
Hibernate Spatial: Geometry Types and PostGIS Queries
Hibernate Spatial maps JTS geometry types (Point, LineString, Polygon) to native PostGIS columns, so routes and areas can be indexed and queried spatially instead of serialized as JSON or scanned row by row.
Quarkus Dev Services: Zero-Config Containers for Dev and Test
Dev Services auto-launches Testcontainers-backed infrastructure (Postgres, Kafka, Redis, and more) whenever an extension is present but no connection is configured, including privileged init scripts for things like CREATE EXTENSION.
Multipart File Uploads with RESTEasy Reactive
Quarkus REST handles multipart/form-data uploads via @RestForm and FileUpload, deserializing mixed text/JSON/file parts in one request with configurable size limits and upload-directory cleanup.
OpenAPI Generator: Quarkus Server Stubs with the Gradle Plugin
How the openapi-generator-gradle-plugin generates JAX-RS resource stubs for a Quarkus server using generatorName=jaxrs-spec and library=quarkus, including Jakarta EE namespacing, MicroProfile OpenAPI annotations, and Mutiny-typed reactive signatures.