Package org.apache.lucene.facet.taxonomy
Class TaxonomyFacetLabels.FacetLabelReader
java.lang.Object
org.apache.lucene.facet.taxonomy.TaxonomyFacetLabels.FacetLabelReader
- Enclosing class:
TaxonomyFacetLabels
Utility class to retrieve facet labels for multiple documents.
- WARNING: This API is experimental and might change in incompatible ways in the next release.
-
Constructor Summary
ConstructorDescriptionFacetLabelReader
(OrdinalsReader ordsReader, LeafReaderContext readerContext) Deprecated.Custom binary encodings for taxonomy ordinals are no longer supported starting with Lucene 9FacetLabelReader
(SortedNumericDocValues ordinalValues) Construct from a specifiedSortedNumericDocValues
field; useful for reading the default encoding. -
Method Summary
Modifier and TypeMethodDescriptionnextFacetLabel
(int docId) nextFacetLabel
(int docId, String facetDimension) Retrieves the nextFacetLabel
for the specifieddocId
under the requestedfacetDimension
, ornull
if there are no more.
-
Constructor Details
-
FacetLabelReader
Construct from a specifiedSortedNumericDocValues
field; useful for reading the default encoding. -
FacetLabelReader
@Deprecated public FacetLabelReader(OrdinalsReader ordsReader, LeafReaderContext readerContext) throws IOException Deprecated.Custom binary encodings for taxonomy ordinals are no longer supported starting with Lucene 9Construct using a customOrdinalsReader
; useful if using a custom binary format.Note: If using the default encoding, you can use
FacetLabelReader(SortedNumericDocValues)
directly- Throws:
IOException
-
-
Method Details
-
nextFacetLabel
Retrieves the nextFacetLabel
for the specifieddocId
, ornull
if there are no more. This method has state: if the provideddocId
is the same as the previous invocation, it returns the nextFacetLabel
for that document. Otherwise, it advances to the newdocId
and provides the firstFacetLabel
for that document, ornull
if that document has no indexed facets. Each newdocId
must be in strictly monotonic (increasing) order.NOTE: The returned FacetLabels may not be in the same order in which they were indexed
- Parameters:
docId
- input docId provided in monotonic (non-decreasing) order- Returns:
- the first or next
FacetLabel
, ornull
if there are no more - Throws:
IOException
- when a low-level IO issue occursIllegalArgumentException
- if docId provided is less than docId supplied in an earlier invocation
-
nextFacetLabel
Retrieves the nextFacetLabel
for the specifieddocId
under the requestedfacetDimension
, ornull
if there are no more. This method has state: if the provideddocId
is the same as the previous invocation, it returns the nextFacetLabel
for that document. Otherwise, it advances to the newdocId
and provides the firstFacetLabel
for that document, ornull
if that document has no indexed facets. Each newdocId
must be in strictly monotonic (increasing) order.NOTE: This method loads the
int[] parents
array from the taxonomy index. The returned FacetLabels may not be in the same order in which they were indexed.- Parameters:
docId
- input docId provided in non-decreasing order- Returns:
- the first or next
FacetLabel
, ornull
if there are no more - Throws:
IOException
- ifTaxonomyReader
has problems getting path for an ordinalIllegalArgumentException
- if docId provided is less than docId supplied in an earlier invocationIllegalArgumentException
- if facetDimension is null
-