Hibernate Search Migration Guide

Hibernate Search 3.0.0.GA

Query

query.setIndexProjection has been removed (after deprecation), the replaced method is query.setProjection

Hibernate Search 3.0.0.CR1

DirectoryProvider

DirectoryProvider has a new method start()

Mappings

@Text, @Keyword and @Unstored have been removed

Hibernate Search 3.0.0.Beta4

Mappings

@Text, @Keyword etc have been deprecated for a while, they will be removed in the next release.

Query

fullTextQuery.setIndexProjection() has been renamed fullTextQuery.setProjection()

The default reader strategy is now shared (this should not affect the compatibility though)

SearchFactory

ContextHelper.getSearchFactory is deprecated, prefer fullTextSession.getSearchFactory();

searchFactory.getDirectoryProvider(Class) is now searchFactory.getDirectoryProviders(Class)

Lucene

Lucene Core 2.2 is now used: your index structure will be automatically migrated by Lucene.

Hibernate Search 3.0.0.Beta2

Query

All org.hibernate.search.query.FullTextQueryImpl casting should be replaced by org.hibernate.search.FullTextQuery casting

resultSize() has been renamed getResultSize()

Queries restricting to one entity now use one SQL query rather than depending on @BatchSize() when list() is used, the major impact is that it's going to be faster :)

Query query = fullTextSession.createFullTextQuery(luceneQuery, book.class);
query.list();

Indexing

The build phase for Lucene Documents is now done in the beforeCompletion phase of a transaction, making the process insensible to LazyInitializationException. There should be no impact to users that did not hit the bug.

Previous versions

Check the Java Persistence Migration Guide for migrations from previous versions of Hibernate Search (formerly known as Hibernate Annotations)