Fieldable (Lucene 2.4.1 API)
Keywords: org.apache.lucene.document.Fieldable interface

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.apache.lucene.document
Interface Fieldable

All Superinterfaces:
  Serializable

All Known Implementing Classes:
  AbstractField, Field

    public interface Fieldable

extends Serializable

Synonymous with `Field`.

WARNING: This interface may change within minor versions, despite Lucene's backward compatibility requirements. This means new methods may be added from version to version. This change only affects the Fieldable API; other backwards compatibility promises remain intact. For example, Lucene can still read and write indices created within the same major version.

Method Summary
`byte[]` | `binaryValue()` The value of the field in Binary, or null.
`int` | `getBinaryLength()` Returns length of byte[] segment that is used as value, if Field is not binary returned value is undefined
`int` | `getBinaryOffset()` Returns offset into byte[] segment that is used as value, if Field is not binary returned value is undefined
`byte[]` | `getBinaryValue()` Return the raw byte[] for the binary field.
`byte[]` | `getBinaryValue(byte[] result)` Return the raw byte[] for the binary field.
`float` | `getBoost()` Returns the boost factor for hits for this field.
`boolean` | `getOmitNorms()` True if norms are omitted for this indexed field
`boolean` | `getOmitTf()` True if tf is omitted for this indexed field
`boolean` | `isBinary()` True iff the value of the filed is stored as binary
`boolean` | `isCompressed()` True if the value of the field is stored and compressed within the index
`boolean` | `isIndexed()` True iff the value of the field is to be indexed, so that it may be searched on.
`boolean` | `isLazy()` Indicates whether a Field is Lazy or not.
`boolean` | `isStored()` True iff the value of the field is to be stored in the index for return with search hits.
`boolean` | `isStoreOffsetWithTermVector()` True iff terms are stored as term vector together with their offsets (start and end positon in source text).
`boolean` | `isStorePositionWithTermVector()` True iff terms are stored as term vector together with their token positions.
`boolean` | `isTermVectorStored()` True iff the term or terms used to index this field are stored as a term vector, available from `IndexReader.getTermFreqVector(int,String)`.
`boolean` | `isTokenized()` True iff the value of the field should be tokenized as text prior to indexing.
`String` | `name()` Returns the name of the field as an interned string.
`Reader` | `readerValue()` The value of the field as a Reader, or null.
`void` | `setBoost(float boost)` Sets the boost factor hits on this field.
`void` | `setOmitNorms(boolean omitNorms)` Expert: If set, omit normalization factors associated with this indexed field.
`void` | `setOmitTf(boolean omitTf)` Expert: If set, omit term freq, positions and payloads from postings for this field.
`String` | `stringValue()` The value of the field as a String, or null.
`TokenStream` | `tokenStreamValue()` The value of the field as a TokenStream, or null.

Method Detail

### setBoost

    void setBoost(float boost)

  Sets the boost factor hits on this field. This value will be multiplied into the score of all hits on this this field of this document.

  The boost is multiplied by `Document.getBoost()` of the document containing this field. If a document has multiple fields with the same name, all such values are multiplied together. This product is then multipled by the value `Similarity.lengthNorm(String,int)`, and rounded by `Similarity.encodeNorm(float)` before it is stored in the index. One should attempt to ensure that this product does not overflow the range of that encoding.

  See Also:
    `Document.setBoost(float)`, `Similarity.lengthNorm(String, int)`, `Similarity.encodeNorm(float)`

### getBoost

    float getBoost()

  Returns the boost factor for hits for this field.

  The default value is 1.0.

  Note: this value is not stored directly with the document in the index. Documents returned from `IndexReader.document(int)` and `Hits.doc(int)` may thus not have the same value present as when this field was indexed.

  See Also:
    `setBoost(float)`

### name

    String name()

  Returns the name of the field as an interned string. For example "date", "title", "body", ...

### stringValue

    String stringValue()

  The value of the field as a String, or null. If null, the Reader value, binary value, or TokenStream value is used. Exactly one of stringValue(), readerValue(), binaryValue(), and tokenStreamValue() must be set.

### readerValue

    Reader readerValue()

  The value of the field as a Reader, or null. If null, the String value, binary value, or TokenStream value is used. Exactly one of stringValue(), readerValue(), binaryValue(), and tokenStreamValue() must be set.

### binaryValue

    byte[] binaryValue()

  The value of the field in Binary, or null. If null, the Reader value, String value, or TokenStream value is used. Exactly one of stringValue(), readerValue(), binaryValue(), and tokenStreamValue() must be set.

### tokenStreamValue

    TokenStream tokenStreamValue()

  The value of the field as a TokenStream, or null. If null, the Reader value, String value, or binary value is used. Exactly one of stringValue(), readerValue(), binaryValue(), and tokenStreamValue() must be set.

### isStored

    boolean isStored()

  True iff the value of the field is to be stored in the index for return with search hits. It is an error for this to be true if a field is Reader-valued.

### isIndexed

    boolean isIndexed()

  True iff the value of the field is to be indexed, so that it may be searched on.

### isTokenized

    boolean isTokenized()

  True iff the value of the field should be tokenized as text prior to indexing. Un-tokenized fields are indexed as a single word and may not be Reader-valued.

### isCompressed

    boolean isCompressed()

  True if the value of the field is stored and compressed within the index

### isTermVectorStored

    boolean isTermVectorStored()

  True iff the term or terms used to index this field are stored as a term vector, available from `IndexReader.getTermFreqVector(int,String)`. These methods do not provide access to the original content of the field, only to terms used to index it. If the original content must be preserved, use the `stored` attribute instead.

  See Also:
    `IndexReader.getTermFreqVector(int, String)`

### isStoreOffsetWithTermVector

    boolean isStoreOffsetWithTermVector()

  True iff terms are stored as term vector together with their offsets (start and end positon in source text).

### isStorePositionWithTermVector

    boolean isStorePositionWithTermVector()

  True iff terms are stored as term vector together with their token positions.

### isBinary

    boolean isBinary()

  True iff the value of the filed is stored as binary

### getOmitNorms

    boolean getOmitNorms()

  True if norms are omitted for this indexed field

### setOmitNorms

    void setOmitNorms(boolean omitNorms)

  Expert: If set, omit normalization factors associated with this indexed field. This effectively disables indexing boosts and length normalization for this field.

### setOmitTf

    void setOmitTf(boolean omitTf)

  Expert: If set, omit term freq, positions and payloads from postings for this field.

### getOmitTf

    boolean getOmitTf()

  True if tf is omitted for this indexed field

### isLazy

    boolean isLazy()

  Indicates whether a Field is Lazy or not. The semantics of Lazy loading are such that if a Field is lazily loaded, retrieving it's values via `stringValue()` or `binaryValue()` is only valid as long as the `IndexReader` that retrieved the `Document` is still open.

  Returns:
    true if this field can be loaded lazily

### getBinaryOffset

    int getBinaryOffset()

  Returns offset into byte[] segment that is used as value, if Field is not binary returned value is undefined

  Returns:
    index of the first character in byte[] segment that represents this Field value

### getBinaryLength

    int getBinaryLength()

  Returns length of byte[] segment that is used as value, if Field is not binary returned value is undefined

  Returns:
    length of byte[] segment that represents this Field value

### getBinaryValue

    byte[] getBinaryValue()

  Return the raw byte[] for the binary field. Note that you must also call `getBinaryLength()` and `getBinaryOffset()` to know which range of bytes in this returned array belong to the field.

  Returns:
    reference to the Field value as byte[].

### getBinaryValue

    byte[] getBinaryValue(byte[] result)

  Return the raw byte[] for the binary field. Note that you must also call `getBinaryLength()` and `getBinaryOffset()` to know which range of bytes in this returned array belong to the field.

  About reuse: if you pass in the result byte[] and it is used, likely the underlying implementation will hold onto this byte[] and return it in future calls to `binaryValue()` or `getBinaryValue()`. So if you subsequently re-use the same byte[] elsewhere it will alter this Fieldable's value.

  Parameters:
    `result` - User defined buffer that will be used if possible. If this is null or not large enough, a new buffer is allocated
  Returns:
    reference to the Field value as byte[].

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2000-2009 Apache Software Foundation. All Rights Reserved.