org.apache.lucene.facet.taxonomy

Class TaxonomyFacets

java.lang.Object

org.apache.lucene.facet.Facets

org.apache.lucene.facet.taxonomy.TaxonomyFacets

Direct Known Subclasses:

FloatTaxonomyFacets, IntTaxonomyFacets

public abstract class TaxonomyFacets
extends Facets

Base class for all taxonomy-based facets impls.

Field Summary

Fields

Modifier and Type	Field and Description
protected int[]	children Maps parent ordinal to its child, or -1 if the parent is childless.
protected FacetsConfig	config FacetsConfig provided to the constructor.
protected java.lang.String	indexFieldName Index field name provided to the constructor.
protected int[]	siblings Maps an ordinal to its sibling, or -1 if there is no sibling.
protected TaxonomyReader	taxoReader TaxonomyReader provided to the constructor.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TaxonomyFacets(java.lang.String indexFieldName, TaxonomyReader taxoReader, FacetsConfig config) Sole constructor.

Method Summary

Modifier and Type	Method and Description
java.util.List<FacetResult>	getAllDims(int topN) Returns topN labels for any dimension that had hits, sorted by the number of hits that dimension matched; this is used for "sparse" faceting, where many different dimensions were indexed, for example depending on the type of document.
protected FacetsConfig.DimConfig	verifyDim(java.lang.String dim) Throws IllegalArgumentException if the dimension is not recognized.

Methods inherited from class org.apache.lucene.facet.Facets

getSpecificValue, getTopChildren

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

indexFieldName

protected final java.lang.String indexFieldName

Index field name provided to the constructor.

taxoReader

protected final TaxonomyReader taxoReader

TaxonomyReader provided to the constructor.

config

protected final FacetsConfig config

FacetsConfig provided to the constructor.

children

protected final int[] children

Maps parent ordinal to its child, or -1 if the parent is childless.

siblings

protected final int[] siblings

Maps an ordinal to its sibling, or -1 if there is no sibling.

Constructor Detail

TaxonomyFacets

protected TaxonomyFacets(java.lang.String indexFieldName,
                         TaxonomyReader taxoReader,
                         FacetsConfig config)
                  throws java.io.IOException

Sole constructor.

Throws:

java.io.IOException

Method Detail

verifyDim

protected FacetsConfig.DimConfig verifyDim(java.lang.String dim)

Throws IllegalArgumentException if the dimension is not recognized. Otherwise, returns the FacetsConfig.DimConfig for this dimension.

getAllDims

public java.util.List<FacetResult> getAllDims(int topN)
                                       throws java.io.IOException

Description copied from class: Facets

Returns topN labels for any dimension that had hits, sorted by the number of hits that dimension matched; this is used for "sparse" faceting, where many different dimensions were indexed, for example depending on the type of document.

Specified by:

getAllDims in class Facets

Throws:

java.io.IOException