org.apache.lucene.index

Class DocValues

java.lang.Object

org.apache.lucene.index.DocValues

public final class DocValues
extends Object

This class contains utility methods and constants for DocValues

Method Summary

Methods

Modifier and Type	Method and Description
static Bits	docsWithValue(SortedDocValues dv, int maxDoc) Returns a Bits representing all documents from dv that have a value.
static Bits	docsWithValue(SortedNumericDocValues dv, int maxDoc) Returns a Bits representing all documents from dv that have a value.
static Bits	docsWithValue(SortedSetDocValues dv, int maxDoc) Returns a Bits representing all documents from dv that have a value.
static BinaryDocValues	emptyBinary() An empty BinaryDocValues which returns BytesRef.EMPTY_BYTES for every document
static NumericDocValues	emptyNumeric() An empty NumericDocValues which returns zero for every document
static SortedDocValues	emptySorted() An empty SortedDocValues which returns BytesRef.EMPTY_BYTES for every document
static SortedNumericDocValues	emptySortedNumeric(int maxDoc) An empty SortedNumericDocValues which returns zero values for every document
static RandomAccessOrds	emptySortedSet() An empty SortedDocValues which returns SortedSetDocValues.NO_MORE_ORDS for every document
static BinaryDocValues	getBinary(AtomicReader in, String field) Returns BinaryDocValues for the reader, or emptyBinary() if it has none.
static Bits	getDocsWithField(AtomicReader in, String field) Returns Bits for the reader, or Bits matching nothing if it has none.
static NumericDocValues	getNumeric(AtomicReader in, String field) Returns NumericDocValues for the reader, or emptyNumeric() if it has none.
static SortedDocValues	getSorted(AtomicReader in, String field) Returns SortedDocValues for the reader, or emptySorted() if it has none.
static SortedNumericDocValues	getSortedNumeric(AtomicReader in, String field) Returns SortedNumericDocValues for the reader, or emptySortedNumeric(int) if it has none.
static SortedSetDocValues	getSortedSet(AtomicReader in, String field) Returns SortedSetDocValues for the reader, or emptySortedSet() if it has none.
static SortedNumericDocValues	singleton(NumericDocValues dv, Bits docsWithField) Returns a multi-valued view over the provided NumericDocValues
static RandomAccessOrds	singleton(SortedDocValues dv) Returns a multi-valued view over the provided SortedDocValues
static NumericDocValues	unwrapSingleton(SortedNumericDocValues dv) Returns a single-valued view of the SortedNumericDocValues, if it was previously wrapped with singleton(NumericDocValues, Bits), or null.
static SortedDocValues	unwrapSingleton(SortedSetDocValues dv) Returns a single-valued view of the SortedSetDocValues, if it was previously wrapped with singleton(SortedDocValues), or null.
static Bits	unwrapSingletonBits(SortedNumericDocValues dv) Returns the documents with a value for the SortedNumericDocValues, if it was previously wrapped with singleton(NumericDocValues, Bits), or null.

Methods inherited from class java.lang.Object

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

Method Detail

emptyBinary

public static final BinaryDocValues emptyBinary()

An empty BinaryDocValues which returns BytesRef.EMPTY_BYTES for every document

emptyNumeric

public static final NumericDocValues emptyNumeric()

An empty NumericDocValues which returns zero for every document

emptySorted

public static final SortedDocValues emptySorted()

An empty SortedDocValues which returns BytesRef.EMPTY_BYTES for every document

emptySortedNumeric

public static final SortedNumericDocValues emptySortedNumeric(int maxDoc)

An empty SortedNumericDocValues which returns zero values for every document

emptySortedSet

public static final RandomAccessOrds emptySortedSet()

An empty SortedDocValues which returns SortedSetDocValues.NO_MORE_ORDS for every document

singleton

public static RandomAccessOrds singleton(SortedDocValues dv)

Returns a multi-valued view over the provided SortedDocValues

unwrapSingleton

public static SortedDocValues unwrapSingleton(SortedSetDocValues dv)

Returns a single-valued view of the SortedSetDocValues, if it was previously wrapped with singleton(SortedDocValues), or null.

unwrapSingleton

public static NumericDocValues unwrapSingleton(SortedNumericDocValues dv)

Returns a single-valued view of the SortedNumericDocValues, if it was previously wrapped with singleton(NumericDocValues, Bits), or null.

See Also:

unwrapSingletonBits(SortedNumericDocValues)

unwrapSingletonBits

public static Bits unwrapSingletonBits(SortedNumericDocValues dv)

Returns the documents with a value for the SortedNumericDocValues, if it was previously wrapped with singleton(NumericDocValues, Bits), or null.

singleton

public static SortedNumericDocValues singleton(NumericDocValues dv,
                               Bits docsWithField)

Returns a multi-valued view over the provided NumericDocValues

docsWithValue

public static Bits docsWithValue(SortedDocValues dv,
                 int maxDoc)

Returns a Bits representing all documents from dv that have a value.

docsWithValue

public static Bits docsWithValue(SortedSetDocValues dv,
                 int maxDoc)

Returns a Bits representing all documents from dv that have a value.

docsWithValue

public static Bits docsWithValue(SortedNumericDocValues dv,
                 int maxDoc)

Returns a Bits representing all documents from dv that have a value.

getNumeric

public static NumericDocValues getNumeric(AtomicReader in,
                          String field)
                                   throws IOException

Returns NumericDocValues for the reader, or emptyNumeric() if it has none.

Throws:

IOException

getBinary

public static BinaryDocValues getBinary(AtomicReader in,
                        String field)
                                 throws IOException

Returns BinaryDocValues for the reader, or emptyBinary() if it has none.

Throws:

IOException

getSorted

public static SortedDocValues getSorted(AtomicReader in,
                        String field)
                                 throws IOException

Returns SortedDocValues for the reader, or emptySorted() if it has none.

Throws:

IOException

getSortedNumeric

public static SortedNumericDocValues getSortedNumeric(AtomicReader in,
                                      String field)
                                               throws IOException

Returns SortedNumericDocValues for the reader, or emptySortedNumeric(int) if it has none.

Throws:

IOException

getSortedSet

public static SortedSetDocValues getSortedSet(AtomicReader in,
                              String field)
                                       throws IOException

Returns SortedSetDocValues for the reader, or emptySortedSet() if it has none.

Throws:

IOException

getDocsWithField

public static Bits getDocsWithField(AtomicReader in,
                    String field)
                             throws IOException

Returns Bits for the reader, or Bits matching nothing if it has none.

Throws:

IOException