Hibernate Search is a library that integrates Hibernate ORM with Apache Lucene or Elasticsearch by automatically indexing entities, enabling advanced search functionality: full-text, geospatial, aggregations and more. For more information, see Hibernate Search on hibernate.org.

We just published Hibernate Search 6.2.0.CR1, a candidate release of the next minor version of Hibernate Search.

This release brings in particular a new excludePaths filter for @IndexedEmbedded, and includePaths/includeDepth/excludePaths filters for @ObjectProjection.

6.2.0.CR1 also includes compatibility with OpenSearch 2.8, an upgrade to Hibernate ORM 5.6.15.Final, an upgrade of -orm6 artifacts to Hibernate ORM 6.2.5.Final, and other bugfixes and improvements.

What’s new

For a summary of all new features and improvements since 6.1, head to the dedicated page on hibernate.org.

Dependency upgrades

Hibernate ORM (HSEARCH-4880/HSEARCH-4875/HSEARCH-4869)

Hibernate Search now depends on Hibernate ORM 5.6.15.Final for its main artifacts, and 6.2.5.Final for -orm6 artifacts. Hibernate ORM 6.0 and 6.1 are no longer considered compatible.

Elasticsearch (HSEARCH-4857)

The Elasticsearch backend now works with Elasticsearch 8.8 as well as other versions that were already compatible.

OpenSearch (HSEARCH-4870)

The Elasticsearch backend now works with OpenSearch 2.8 as well as other versions that were already compatible.


@IndexedEmbedded(excludePaths = …​)

With HSEARCH-1182, the @IndexedEmbedded annotation now exposes an excludePaths attribute, allowing the inclusion of all paths with only a few selectively excluded, as opposed to the previous approach of selectively including paths with includePaths.

@ObjectProjection(includeDepth = …​)/@ObjectProjection(includePaths = …​)/@ObjectProjection(excludePaths = …​)

With HSEARCH-4725, the @ObjectProjection annotation now exposes an includeDepth/includePaths/excludePaths attributes, which allows in particular breaking cycles of nested object projections.

Other improvements and bug fixes

  • HSEARCH-4616: For clarity, "automatic indexing" was renamed to something more explicit throughout Hibernate Search and its documentation. As a result:

    • hibernate.search.automatic_indexing.enabled is now deprecated in favor of hibernate.search.indexing.listeners.enabled

    • hibernate.search.automatic_indexing.synchronization.strategy is now deprecated in favor of hibernate.search.indexing.plan.synchronization.strategy

  • HSEARCH-4866: hibernate.search.automatic_indexing.enable_dirty_check is now deprecated with no alternative to replace it. In future versions, a dirty check will always be performed when considering whether to trigger reindexing.

  • HSEARCH-4877: (Infinispan) Provided identifier bridges are now applied in the Search DSL and id projections.

And more. For a full list of changes since the previous releases, please see the release notes.

How to get this release

All details are available and up to date on the dedicated page on hibernate.org.

Getting started, migrating

For new applications, refer to the getting started guide:

For existing applications, Hibernate Search 6.2 is a drop-in replacement for 6.1, assuming you also upgrade the dependencies. Information about deprecated configuration and API is included in the migration guide.

Feedback, issues, ideas?

To get in touch, use the following channels:

Back to top