org.apache.lucene.index

Class Term

java.lang.Object

org.apache.lucene.index.Term

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable

public final class Term
extends java.lang.Object
implements java.lang.Comparable, java.io.Serializable

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 occured in, an interned string. Note that terms may represent more than words from text fields, but also things like dates, email addresses, urls, etc.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Term(java.lang.String fld, java.lang.String txt) Constructs a Term with the given field and text.

Method Summary

Modifier and Type	Method and Description
int	compareTo(java.lang.Object other)
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(java.lang.String text) Optimized construction of new Terms by reusing same field as this Term - avoids field.intern() overhead
boolean	equals(java.lang.Object o) Compares two terms, returning true iff they have the same field and text.
java.lang.String	field() Returns the field of this term, an interned string.
int	hashCode() Combines the hashCode() of the field and the text.
java.lang.String	text() Returns the text of this term.
java.lang.String	toString()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Term

public Term(java.lang.String fld,
            java.lang.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.

Method Detail

field

public final java.lang.String field()

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

text

public final java.lang.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.

createTerm

public Term createTerm(java.lang.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

equals

public final boolean equals(java.lang.Object o)

Compares two terms, returning true iff they have the same field and text.

Overrides:

equals in class java.lang.Object

hashCode

public final int hashCode()

Combines the hashCode() of the field and the text.

Overrides:

hashCode in class java.lang.Object

compareTo

public int compareTo(java.lang.Object other)

Specified by:

compareTo in interface java.lang.Comparable

compareTo

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.

toString

public final java.lang.String toString()

Overrides:

toString in class java.lang.Object