Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Enums
• Deprecated Annotation Types
• Deprecated Methods
• Deprecated Constructors
• Deprecated Annotation Type Elements

Deprecated Interfaces

Interface and Description
org.hibernate.search.engine.BoostStrategy Index-time boosting will not be possible anymore starting from Lucene 7. You should use query-time boosting instead, for instance by calling boostedTo(float) when building queries with the Hibernate Search query DSL.
org.hibernate.search.store.IndexShardingStrategy Deprecated as of Hibernate Search 4.4. Might be removed in Search 5. Use ShardIdentifierProvider instead.
org.hibernate.search.store.Workspace This interface will be moved and should be considered non-public API [HSEARCH-1915]

Deprecated Classes

Class and Description
org.hibernate.search.filter.FilterKey Custom filter keys are deprecated and are scheduled for removal in Hibernate Search 6. As of Hibernate Search 5.1, keys for caching Lucene filters are calculated automatically based on the given filter parameters.
org.hibernate.search.filter.StandardFilterKey Custom filter keys are deprecated and are scheduled for removal in Hibernate Search 6. As of Hibernate Search 5.1, keys for caching Lucene filters are calculated automatically based on the given filter parameters.

Deprecated Enums

Enum and Description
org.hibernate.search.annotations.FieldCacheType Remove the annotation. No alternative replacement necessary.

Deprecated Annotation Types

Annotation Type and Description
org.hibernate.search.annotations.Boost Index-time boosting will not be possible anymore starting from Lucene 7. You should use query-time boosting instead, for instance by calling boostedTo(float) when building queries with the Hibernate Search query DSL.
org.hibernate.search.annotations.CacheFromIndex Remove the annotation. No alternative replacement necessary.
org.hibernate.search.annotations.DynamicBoost Index-time boosting will not be possible anymore starting from Lucene 7. You should use query-time boosting instead, for instance by calling boostedTo(float) when building queries with the Hibernate Search query DSL.
org.hibernate.search.annotations.Key Custom filter cache keys are a deprecated feature scheduled to be removed in Hibernate Search 6. As of Hibernate Search 5.1, filter cache keys will be determinated automatically based on the filter parameters. Custom filter cache key methods should therefore be removed.
org.hibernate.search.annotations.ProvidedId with no replacement: this annotation will be removed.

Deprecated Methods

Method and Description
org.hibernate.search.filter.FilterCachingStrategy.addCachedFilter(FilterKey, Filter) This method is not used by Hibernate Search anymore and will be removed in a future version. Please implement FilterCachingStrategy.addCachedFilter(FilterKey, Query) instead.
org.hibernate.search.query.dsl.sort.SortAdditionalSortFieldContext.andByField(String, SortField.Type) Using this method shouldn't be needed if your custom field bridges implement MetadataProvidingFieldBridge. Use SortAdditionalSortFieldContext.andByField(String) instead.
org.hibernate.search.FullTextSharedSessionBuilder.autoClose(boolean)
org.hibernate.search.query.dsl.sort.SortContext.byField(String, SortField.Type) Using this method shouldn't be needed if your custom field bridges implement MetadataProvidingFieldBridge. Use SortContext.byField(String) instead.
org.hibernate.search.cfg.IndexedMapping.cacheFromIndex(FieldCacheType...) This will be removed with no replacement.
org.hibernate.search.FullTextSharedSessionBuilder.connectionReleaseMode()
org.hibernate.search.FullTextSharedSessionBuilder.connectionReleaseMode(ConnectionReleaseMode)
org.hibernate.search.cfg.IndexedMapping.dynamicBoost(Class<? extends BoostStrategy>) Index-time boosting will not be possible anymore starting from Lucene 7. You should use query-time boosting instead, for instance by calling boostedTo(float) when building queries with the Hibernate Search query DSL.
org.hibernate.search.cfg.EntityMapping.dynamicBoost(Class<? extends BoostStrategy>) Index-time boosting will not be possible anymore starting from Lucene 7. You should use query-time boosting instead, for instance by calling boostedTo(float) when building queries with the Hibernate Search query DSL.
org.hibernate.search.cfg.PropertyMapping.dynamicBoost(Class<? extends BoostStrategy>) Index-time boosting will not be possible anymore starting from Lucene 7. You should use query-time boosting instead, for instance by calling boostedTo(float) when building queries with the Hibernate Search query DSL.
org.hibernate.search.query.engine.spi.HSQuery.filter(Filter) use the FullTextFilterDef approach, or handle filtering when building the query (see BooleanJunction.must(Query) and MustJunction.disableScoring()).
org.hibernate.search.query.dsl.QueryCustomization.filteredBy(Filter) Lucene Filters have been deprecated and will be removed in a future version. Please use Queries instead of Filters and use QueryCustomization.filteredBy(Query) instead of this method.
org.hibernate.search.FullTextSharedSessionBuilder.flushBeforeCompletion()
org.hibernate.search.FullTextSharedSessionBuilder.flushBeforeCompletion(boolean)
org.hibernate.search.spi.IndexedTypeMap.get(Class<?>) use IndexedTypeMap.get(IndexedTypeIdentifier). This method will be removed.
org.hibernate.search.bridge.LuceneOptions.getBoost() Index-time boosting will not be possible anymore starting from Lucene 7. You should use query-time boosting instead, for instance by calling boostedTo(float) when building queries with the Hibernate Search query DSL.
org.hibernate.search.filter.FilterCachingStrategy.getCachedFilter$$bridge$$FilterReturnType(FilterKey) This method is only here so that Hibernate Search build tools can generate bytecode allowing to preserve binary compatibility with applications written for Hibernate Search 5.5. It will be removed in a future version. Please implement FilterCachingStrategy.getCachedFilter(FilterKey) instead.
org.hibernate.search.cfg.EntityDescriptor.getCacheInMemory() This will be removed with no replacement.
org.hibernate.search.metadata.IndexedTypeDescriptor.getDynamicBoost() Index-time boosting will not be possible anymore starting from Lucene 7. You should use query-time boosting instead, for instance by calling boostedTo(float) when building queries with the Hibernate Search query DSL.
org.hibernate.search.backend.LuceneWork.getEntityClass() use LuceneWork.getEntityType(): this method will be removed!
org.hibernate.search.query.engine.spi.HSQuery.getExtendedSearchIntegrator() should be at most SearchIntegrator, preferably removed altogether
org.hibernate.search.engine.spi.DocumentBuilderIndexedEntity.getFieldCacheOption()
org.hibernate.search.spi.IndexedTypeIdentifier.getPojoType() This only exists to facilitate an iterative integration, and will be removed ASAP.
org.hibernate.search.indexes.spi.IndexManager.getSerializer() This method is scheduled for removal. It is not invoked by Hibernate Search any more, implementations may make this a no-op and safely return null.
org.hibernate.search.metadata.IndexedTypeDescriptor.getStaticBoost() Index-time boosting will not be possible anymore starting from Lucene 7. You should use query-time boosting instead, for instance by calling boostedTo(float) when building queries with the Hibernate Search query DSL.
org.hibernate.search.metadata.IndexedTypeDescriptor.getType() Use IndexedTypeDescriptor.getIndexedType() instead. This method will be removed.
org.hibernate.search.backend.spi.BackendQueueProcessor.initialize(Properties, WorkerBuildContext, IndexManager) Use a Backend implementation and implement your initialization logic in Backend.createQueueProcessor(IndexManager, WorkerBuildContext) instead.
org.hibernate.search.cfg.ContainedInMapping.numericField() Invoke field().numericField() instead.
org.hibernate.search.spi.IndexedTypeMap.put(IndexedTypeIdentifier, V) This method will be removed. The implementations will be refactored to become immutable.
org.hibernate.search.cfg.EntityDescriptor.setCacheInMemory(Map<String, Object>) This will be removed with no replacement.
org.hibernate.search.jpa.FullTextQuery.setFilter(Filter)
org.hibernate.search.FullTextQuery.setFilter(Filter)
org.hibernate.search.FullTextQuery.setResultTransformer(ResultTransformer)
org.hibernate.search.MassIndexer.threadsForSubsequentFetching(int) Being ignored: this method will be removed.
org.hibernate.search.spi.IndexedTypeSet.toPojosSet() This only exists to facilitate an iterative integration, and will be removed ASAP.
org.hibernate.search.FullTextSharedSessionBuilder.transactionContext()
org.hibernate.search.query.dsl.FuzzyContext.withThreshold(float) use FuzzyContext.withEditDistanceUpTo(int)

Deprecated Constructors

Constructor and Description
org.hibernate.search.cfg.NumericFieldMapping(PropertyDescriptor, EntityDescriptor, SearchMapping) Do not use constructors, use numericField methods in other classes from the same package.
org.hibernate.search.cfg.NumericFieldMapping(String, PropertyDescriptor, EntityDescriptor, SearchMapping) Do not use constructors, use numericField methods in other classes from the same package.

Deprecated Annotation Type Elements

Annotation Type Element and Description
org.hibernate.search.annotations.Field.boost Index-time boosting will not be possible anymore starting from Lucene 7. You should use query-time boosting instead, for instance by calling boostedTo(float) when building queries with the Hibernate Search query DSL.
org.hibernate.search.annotations.Spatial.boost Index-time boosting will not be possible anymore starting from Lucene 7. You should use query-time boosting instead, for instance by calling boostedTo(float) when building queries with the Hibernate Search query DSL.