FileDocCategorySizeDatePackage
Term.javaAPI DocApache Lucene 1.93492Mon Feb 20 09:20:14 GMT 2006org.apache.lucene.index

Term

public final class Term extends Object implements Comparable, 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.

Fields Summary
String
field
String
text
Constructors Summary
public Term(String fld, String txt)
Constructs a Term with the given field and text.

    this(fld, txt, true);
  
Term(String fld, String txt, boolean intern)

    field = intern ? fld.intern() : fld;	  // field names are interned
    text = txt;					  // unless already known to be
  
Methods Summary
public intcompareTo(java.lang.Object other)

    return compareTo((Term)other);
  
public final intcompareTo(org.apache.lucene.index.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.

    if (field == other.field)			  // fields are interned
      return text.compareTo(other.text);
    else
      return field.compareTo(other.field);
  
public org.apache.lucene.index.TermcreateTerm(java.lang.String text)
Optimized construction of new Terms by reusing same field as this Term - avoids field.intern() overhead

param
text The text of the new term (field is implicitly same as this Term instance)
return
A new Term

      return new Term(field,text,false);
  
public final booleanequals(java.lang.Object o)
Compares two terms, returning true iff they have the same field and text.

    if (o == null)
      return false;
    Term other = (Term)o;
    return field == other.field && text.equals(other.text);
  
public final java.lang.Stringfield()
Returns the field of this term, an interned string. The field indicates the part of a document which this term came from.

 return field; 
public final inthashCode()
Combines the hashCode() of the field and the text.

    return field.hashCode() + text.hashCode();
  
private voidreadObject(java.io.ObjectInputStream in)

      in.defaultReadObject();
      field = field.intern();
  
final voidset(java.lang.String fld, java.lang.String txt)
Resets the field and text of a Term.

    field = fld;
    text = txt;
  
public final java.lang.Stringtext()
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.

 return text; 
public final java.lang.StringtoString()

 return field + ":" + text;