public final class

Term

extends Object
implements Serializable Comparable<T>
java.lang.Object
   ↳ org.apache.lucene.index.Term

Class Overview

A Term represents a word from text. This is the unit of search. It is composed of two elements, the text of the word, as a string, and the name of the field that the text occurred in, an interned string. Note that terms may represent more than words from text fields, but also things like dates, email addresses, urls, etc.

Summary

Public Constructors
Term(String fld, String txt)
Constructs a Term with the given field and text.
Term(String fld)
Constructs a Term with the given field and empty text.
Public Methods
final int compareTo(Term other)
Compares two terms, returning a negative integer if this term belongs before the argument, zero if this term is equal to the argument, and a positive integer if this term belongs after the argument.
Term createTerm(String text)
Optimized construction of new Terms by reusing same field as this Term - avoids field.intern() overhead
boolean equals(Object obj)
final String field()
Returns the field of this term, an interned string.
int hashCode()
final String text()
Returns the text of this term.
final String toString()
[Expand]
Inherited Methods
From class java.lang.Object
From interface java.lang.Comparable

Public Constructors

public Term (String fld, String txt)

Constructs a Term with the given field and text.

Note that a null field or null text value results in undefined behavior for most Lucene APIs that accept a Term parameter.

public Term (String fld)

Constructs a Term with the given field and empty text. This serves two purposes: 1) reuse of a Term with the same field. 2) pattern for a query.

Public Methods

public final int compareTo (Term other)

Compares two terms, returning a negative integer if this term belongs before the argument, zero if this term is equal to the argument, and a positive integer if this term belongs after the argument. The ordering of terms is first by field, then by text.

public Term createTerm (String text)

Optimized construction of new Terms by reusing same field as this Term - avoids field.intern() overhead

Parameters
text The text of the new term (field is implicitly same as this Term instance)
Returns
  • A new Term

public boolean equals (Object obj)

public final String field ()

Returns the field of this term, an interned string. The field indicates the part of a document which this term came from.

public int hashCode ()

public final String text ()

Returns the text of this term. In the case of words, this is simply the text of the word. In the case of dates and other types, this is an encoding of the object as a string.

public final String toString ()