Deprecated API
Contents
- Terminally Deprecated
- Interfaces
- Classes
- Enum Classes
- Exception Classes
- Fields
- Methods
- Constructors
- Enum Constants
-
Terminally Deprecated ElementsElementDescriptionreplaced by
ConnectionCosts(Path)
for files andConnectionCosts(URL)
for classpath/module resources.replaced byTokenInfoDictionary(Path, Path, Path, Path)
for files andTokenInfoDictionary(URL, URL, URL, URL)
for classpath/module resourcesreplaced byUnknownDictionary(Path, Path, Path)
for files andUnknownDictionary(URL, URL, URL)
for classpath/module resourcesreplaced byConnectionCosts(Path)
for files andConnectionCosts(URL)
for classpath/module resources.replaced byTokenInfoDictionary(Path, Path, Path, Path)
for files andTokenInfoDictionary(URL, URL, URL, URL)
for classpath/module resourcesreplaced byUnknownDictionary(Path, Path, Path)
for files andUnknownDictionary(URL, URL, URL)
for classpath/module resourcesClass.getResourceAsStream(String)
is caller sensitive and cannot load resources across Java Modules. Please call thegetResourceAsStream()
andWordlistLoader.getWordSet(Reader, String, CharArraySet)
or other methods directly.UseKeywordField.newSetQuery(String, Collection)
instead.Please use new system propertyMMapDirectory.ENABLE_UNMAP_HACK_SYSPROP
insteadClass.getResourceAsStream(String)
is caller sensitive and cannot load resources across Java Modules. Please call thegetResourceAsStream()
directly and useIOUtils.requireResourceNonNull(Object,String)
to signal missing resourcesnull
was replaced byIOConsumer
.was replaced byIOFunction
.
-
Deprecated Interfaces
-
Deprecated ClassesClassDescriptionUse
SpanishPluralStemFilter
instead.UseSpanishPluralStemFilterFactory
insteadUseSpanishPluralStemmer
instead.Fix the token filters that create broken offsets in the first place.UseWordDelimiterGraphFilter
instead: it produces a correct token graph so that e.g.PhraseQuery
works correctly when it's used in the search time analyzer.UseWordDelimiterGraphFilterFactory
instead: it produces a correct token graph so that e.g.PhraseQuery
works correctly when it's used in the search time analyzer.UseSynonymGraphFilter
instead, but be sure to also useFlattenGraphFilter
at index time (not at search time) as well.UseSynonymGraphFilterFactory
instead, but be sure to also useFlattenGraphFilterFactory
at index time (not at search time) as well.useKnnFloatVectorField
insteadOnly here for back-compat support. Should be removed with Lucene 10.Custom binary encodings for taxonomy ordinals are no longer supported starting with Lucene 9Custom binary encodings for taxonomy ordinals are no longer supported starting with Lucene 9Visibility of this class will be reduced to pkg-private in a future version. This class is meant to host common code as an internal implementation detail to taxonomy faceting,and is not intended as an extension point for user-createdFacets
implementations. If your code is relying on this, please migrate necessary functionality down into your own class.Visibility of this class will be reduced to pkg-private in a future version. This class is meant to host common code as an internal implementation detail toFastTaxonomyFacetCounts
andTaxonomyFacetIntAssociations
,and is not intended as an extension point for user-createdFacets
implementations. If your code is relying on this, please migrate necessary functionality down into your own class.Custom binary encodings for taxonomy ordinals are no longer supported starting with Lucene 9Custom binary encodings for taxonomy ordinals are no longer supported starting with Lucene 9. Please switch toFastTaxonomyFacetCounts
or implement your ownFacets
implementation if you have custom needs.Visibility of this class will be reduced to pkg-private in a future version. This class is meant to host common code as an internal implementation detail to taxonomy faceting,and is not intended as an extension point for user-createdFacets
implementations. If your code is relying on this, please migrate necessary functionality down into your own class.This class is being deprecated in favor ofTaxonomyFacetFloatAssociations
, which provides more flexible aggregation functionality beyond just "sum"This class is being deprecated in favor ofTaxonomyFacetIntAssociations
, which provides more flexible aggregation functionality beyond just "sum"This class is being deprecated in favor ofTaxonomyFacetFloatAssociations
, which provides more flexible aggregation functionality beyond just "sum"UseLruTaxonomyWriterCache
instead.Replaced byTopOrdAndFloatQueue
in 10.xReplaced byTopOrdAndIntQueue
in 10.xuseFloatVectorValues
insteadUseFieldExistsQuery
instead.UseFieldExistsQuery
instead.useKnnFloatVectorQuery
insteadUseFieldExistsQuery
instead.UseIndexSearcher.setTimeout(QueryTimeout)
to time out queries.This class was made public for internal reasons (instanceof
checks). InMMapDirectory
it was replaced byMemorySegment
basedIndexInput
implementations and will be no longer required in Lucene 10.Visibility of this class will be reduced in a future release. Users can access this functionality directly throughAutomata.makeStringUnion(Iterable)
This comparator is only a transition mechanism
-
Deprecated Enum Classes
-
Deprecated Exception ClassesException ClassDescription
-
Deprecated FieldsFieldDescriptionUse
JavascriptLexer.VOCABULARY
instead.UseJavascriptParser.VOCABULARY
instead.This field will be removed in a future version.FacetsConfig.pathToString(String[])
can be applied topath
as a replacement if string path is desired.Will be removed in a future version. Please useSortedSetDocValues.docValueCount()
to know the number of doc values for the current document up-front.UseByteBuffersDirectory.OUTPUT_AS_MANY_BUFFERS
instead.Better use little endian unless it is needed for backwards compatibility.Better use little endian unless it is needed for backwards compatibility.Better use little endian unless it is needed for backwards compatibility.Better use little endian unless it is needed for backwards compatibility.Better use little endian unless it is needed for backwards compatibility.This comparator is only a transition mechanismTo detect Java versions useRuntime.version()
This constant is useless and alwaystrue
. To detect Java versions useRuntime.version()
This constant is useless and alwaystrue
. To detect Java versions useRuntime.version()
This constant is useless and alwaystrue
. To detect Java versions useRuntime.version()
To detect Java versions useRuntime.version()
To detect Java versions useRuntime.version()
(9.0.0) Use latestUse latestUse latestUse latestUse latest(8.11.1) Use latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latestUse latest(9.1.0) Use latest(9.2.0) Use latest(9.11.0) Use latest(9.12.0) Use latestUse latest(9.3.0) Use latest(9.4.0) Use latest(9.5.0) Use latestUse latestUse latest(9.6.0) Use latest(9.7.0) Use latest(9.8.0) Use latest(9.9.0) Use latest(9.9.1) Use latest(9.9.2) Use latest(9.10.0) Use latestUseVersion.LATEST
-
Deprecated MethodsMethodDescription
Class.getResourceAsStream(String)
is caller sensitive and cannot load resources across Java Modules. Please call thegetResourceAsStream()
andWordlistLoader.getWordSet(Reader, String, CharArraySet)
or other methods directly.UseKeywordField.newSetQuery(String, Collection)
instead.This is only used by the deprecatedDrillSideways.search(DrillDownQuery, Collector)
entry-point. Please useDrillSideways.search(DrillDownQuery, CollectorManager)
instead, and leverageDrillSideways.createDrillDownFacetsCollectorManager()
as necessaryThis method is deprecated in interest of theDrillSideways.search(DrillDownQuery, CollectorManager)
method.Starting in Lucene 9, we moved to a more straight-forward numeric doc values encoding and no longer support custom binary encodings.Please do not rely on this method. It is added as a temporary measure for providing index backwards-compatibility with Lucene 8 and earlier indexes, and will be removed in Lucene 10.Please do not rely on this method. It is added as a temporary measure for providing index backwards-compatibility with Lucene 8 and earlier indexes, and will be removed in Lucene 10.Please useLongValueFacetCounts.getTopChildren(int, String, String...)
instead for the same functionality.Custom binary formats are no longer directly supported for taxonomy faceting starting in Lucene 9Custom binary formats are no longer directly supported for taxonomy faceting starting in Lucene 9Please don't rely on this method as it will be removed in Lucene 10. It's being introduced to support backwards-compatibility with Lucene 8 and earlier index formats temporarily.useIndexReader.storedFields()
to retrieve one or more documentsuseIndexReader.storedFields()
to retrieve one or more documentsuseIndexReader.storedFields()
to retrieve one or more documentsuseIndexReader.termVectors()
to retrieve one or more documentsuseIndexReader.termVectors()
to retrieve one or more documentsPass an executor toBPIndexReorderer.reorder(CodecReader, Directory, Executor)
insteadin favour ofBulkScorer.score(LeafCollector, Bits, int, int)
. Callers should instead call the method variant that takes min and max as arguments, providing 0 andDocIdSetIterator.NO_MORE_DOCS
to score the entire segment. Subclasses that override it should instead override its replacement.UseIndexSearcher.storedFields()
to access fields for one or more documentsUseIndexSearcher.storedFields()
to access fields for one or more documentsUseIndexSearcher.storedFields()
to access fields for one or more documentsuseIndexSearcher.getTaskExecutor()
executor instead to execute concurrent tasksThis method is being deprecated in favor ofIndexSearcher.search(Query, CollectorManager)
due to its support for concurrency in IndexSearcherset this using a constructor insteadThis is a duplicate method forSortField#getOptimizeSortWithIndexedData
.should only be used for compatibility with 8.x indices that got created with inconsistent data across fields, or the wrong sort configuration in the index sortshould only be used for compatibility with 8.x indices that got created with inconsistent data across fields, or the wrong sort configuration in the index sort. This is a duplicate method forSortField#setOptimizeSortWithIndexedData
.the encoded terms will no longer be exposed in a future major version; this is an implementation detail that could change at some point and shouldn't be relied on directly. CallTermInSetQuery.getBytesRefIterator()
instead to retrieve over the terms.This method is deprecated in favor of the constructor ofTopFieldCollectorManager
due to its support for concurrency in IndexSearcherThis method is deprecated in favor of the constructor ofTopFieldCollectorManager
due to its support for concurrency in IndexSearcherThis method is deprecated in favor of the constructor ofTopFieldCollectorManager
due to its support for concurrency in IndexSearcherThis method is deprecated in favor of the constructor ofTopScoreDocCollectorManager
due to its support for concurrency in IndexSearcherThis method is deprecated in favor of the constructor ofTopScoreDocCollectorManager
due to its support for concurrency in IndexSearcherThis method is deprecated in favor of the constructor ofTopScoreDocCollectorManager
due to its support for concurrency in IndexSearcherorg.apache.lucene.search.uhighlight.UnifiedHighlighter.shouldPreferPassageRelevancyOverSpeed(String) UseByteBuffersDataInput.length()
instead.This information is no longer reliable now that preloading is more granularly configured via a predicate.UseMMapDirectory.setPreload(BiPredicate)
instead which provides more granular control.Please use new system propertyMMapDirectory.ENABLE_UNMAP_HACK_SYSPROP
insteadPlease seeAutomata.makeStringUnion(Iterable)
insteadThis comparator is only a transition mechanismClass.getResourceAsStream(String)
is caller sensitive and cannot load resources across Java Modules. Please call thegetResourceAsStream()
directly and useIOUtils.requireResourceNonNull(Object,String)
to signal missing resourcesnull
-
Deprecated ConstructorsConstructorDescriptionreplaced by
ConnectionCosts(Path)
for files andConnectionCosts(URL)
for classpath/module resources.replaced byTokenInfoDictionary(Path, Path, Path, Path)
for files andTokenInfoDictionary(URL, URL, URL, URL)
for classpath/module resourcesreplaced byUnknownDictionary(Path, Path, Path)
for files andUnknownDictionary(URL, URL, URL)
for classpath/module resourcesreplaced byConnectionCosts(Path)
for files andConnectionCosts(URL)
for classpath/module resources.replaced byTokenInfoDictionary(Path, Path, Path, Path)
for files andTokenInfoDictionary(URL, URL, URL, URL)
for classpath/module resourcesreplaced byUnknownDictionary(Path, Path, Path)
for files andUnknownDictionary(URL, URL, URL)
for classpath/module resourcesUseDoubleField(String, double, Field.Store)
withField.Store.NO
instead.UseFloatField(String, float, Field.Store)
withField.Store.NO
instead.UseIntField(String, int, Field.Store)
withField.Store.NO
instead.UseLongField(String, long, Field.Store)
withField.Store.NO
instead.Users should explicitly provide facet configuration during instantiation. SeeDefaultSortedSetDocValuesReaderState(IndexReader, FacetsConfig)
. To maintain all existing behavior, a "default" facet configuration can be provided withFacetsConfig()
.Users should explicitly provide facet configuration during instantiation. SeeDefaultSortedSetDocValuesReaderState(IndexReader, String, FacetsConfig)
. To maintain all existing behavior, a "default" facet configuration can be provided withFacetsConfig()
.Custom binary encodings for taxonomy ordinals are no longer supported starting with Lucene 9Custom binary encodings for taxonomy ordinals are no longer supported starting with Lucene 9To be removed in Lucene 10.Custom binary encodings for taxonomy ordinals are no longer supported starting with Lucene 9UseTermInSetQuery(String, Collection)
instead.UseTermInSetQuery(RewriteMethod, String, Collection)
instead.useMMapDirectory(Path, long)
instead.useMMapDirectory(Path, LockFactory, long)
instead.
-
Deprecated Enum Constants