public class

OrdFieldSource

extends ValueSource
java.lang.Object
   ↳ org.apache.lucene.search.function.ValueSource
     ↳ org.apache.lucene.search.function.OrdFieldSource

Class Overview

Expert: obtains the ordinal of the field value from the default Lucene Fieldcache using getStringIndex().

The native lucene index order is used to assign an ordinal value for each field value.

Example:
If there were only three field values: "apple","banana","pear"
then ord("apple")=1, ord("banana")=2, ord("pear")=3

WARNING: ord() depends on the position in an index and can thus change when other documents are inserted or deleted, or if a MultiSearcher is used.

WARNING: The status of the search.function package is experimental. The APIs introduced here might change in the future and will not be supported anymore in such a case.

NOTE: with the switch in 2.9 to segment-based searching, if getValues(IndexReader) is invoked with a composite (multi-segment) reader, this can easily cause double RAM usage for the values in the FieldCache. It's best to switch your application to pass only atomic (single segment) readers to this API.

Summary

Fields
protected String field
Public Constructors
OrdFieldSource(String field)
Constructor for a certain field.
Public Methods
String description()
description of field, used in explain()
boolean equals(Object o)
Needed for possible caching of query results - used by equals(Object).
DocValues getValues(IndexReader reader)
Return the DocValues used by the function query.
int hashCode()
Needed for possible caching of query results - used by hashCode().
[Expand]
Inherited Methods
From class org.apache.lucene.search.function.ValueSource
From class java.lang.Object

Fields

protected String field

Public Constructors

public OrdFieldSource (String field)

Constructor for a certain field.

Parameters
field field whose values order is used.

Public Methods

public String description ()

description of field, used in explain()

public boolean equals (Object o)

Needed for possible caching of query results - used by equals(Object).

public DocValues getValues (IndexReader reader)

Return the DocValues used by the function query.

Parameters
reader the IndexReader used to read these values. If any caching is involved, that caching would also be IndexReader based.
Throws
IOException

public int hashCode ()

Needed for possible caching of query results - used by hashCode().