MongoDB Extension for Hibernate ORM is Now GA

Summary

The MongoDB Extension for Hibernate ORM is now generally available as a first-party, open-source library, giving Java teams a production-ready way to use familiar Hibernate APIs with MongoDB’s document model. Developers can continue using @Entity annotations, HQL, Criteria Queries, and Session APIs while building new applications or migrating existing Hibernate workloads from relational databases. The GA release adds JOIN support (INNER and LEFT OUTER) via standard HQL/JPQL syntax, optimistic locking with @Version, Spring Boot auto-configuration that auto-detects dialect and connection provider from the MongoDB JDBC URL, and clearer exception messaging and logging. The extension transparently translates Hibernate operations into MongoDB aggregation pipelines and requires Hibernate ORM 7.4 LTS. It also supports native embedded documents for faster reads and allows dropping into MongoDB’s native Query API for advanced operations like vector search and geospatial queries.

Takeaways

1. 1

   The extension supports JOINs (INNER and LEFT OUTER) across MongoDB collections using standard HQL/JPQL syntax, eliminating manual lookups.

2. 2

   It provides optimistic locking via @Version annotation for concurrency control, preventing conflicting updates to the same entity.

3. 3

   The extension requires Hibernate ORM 7.4 LTS and is designed for production use, but does not aim for full HQL coverage; some SQL constructs do not map to MongoDB’s document model.

FAQ