org.apache.lucene.document
Class StraightBytesDocValuesField

java.lang.Object
  org.apache.lucene.document.Field
      org.apache.lucene.document.StraightBytesDocValuesField

All Implemented Interfaces:

IndexableField

public class StraightBytesDocValuesField
extends Field

Field that stores a per-document BytesRef value. The values are stored directly with no sharing, which is a good fit when the fields don't share (many) values, such as a title field. If values may be shared it's better to use DerefBytesDocValuesField. Here's an example usage:

   document.add(new StraightBytesDocValuesField(name, new BytesRef("hello")));
 

If you also need to store the value, you should add a separate StoredField instance.

See Also:

DocValues

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.lucene.document.Field

Field.Index, Field.Store, Field.TermVector

Field Summary

static FieldType	TYPE_FIXED_LEN Type for direct bytes DocValues: all with the same length
static FieldType	TYPE_VAR_LEN Type for direct bytes DocValues: can have variable lengths

Fields inherited from class org.apache.lucene.document.Field

boost, fieldsData, name, tokenStream, type

Constructor Summary

StraightBytesDocValuesField(String name, BytesRef bytes)
Create a new variable-length direct DocValues field.

StraightBytesDocValuesField(String name, BytesRef bytes, boolean isFixedLength)
Create a new fixed or variable length direct DocValues field.

Method Summary

Methods inherited from class org.apache.lucene.document.Field

binaryValue, boost, fieldType, name, numericValue, readerValue, setBoost, setBytesValue, setBytesValue, setByteValue, setDoubleValue, setFloatValue, setIntValue, setLongValue, setReaderValue, setShortValue, setStringValue, setTokenStream, stringValue, tokenStream, tokenStreamValue, toString, translateFieldType

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

TYPE_FIXED_LEN

public static final FieldType TYPE_FIXED_LEN

Type for direct bytes DocValues: all with the same length

TYPE_VAR_LEN

public static final FieldType TYPE_VAR_LEN

Type for direct bytes DocValues: can have variable lengths

Constructor Detail

StraightBytesDocValuesField

public StraightBytesDocValuesField(String name,
                                   BytesRef bytes)

Create a new variable-length direct DocValues field.

This calls StraightBytesDocValuesField(name, bytes, false, meaning by default it allows for values of different lengths. If your values are all the same length, use that constructor instead.

Parameters:

name - field name

bytes - binary content

Throws:

IllegalArgumentException - if the field name is null

StraightBytesDocValuesField

public StraightBytesDocValuesField(String name,
                                   BytesRef bytes,
                                   boolean isFixedLength)

Create a new fixed or variable length direct DocValues field.

Parameters:

name - field name

bytes - binary content

isFixedLength - true if all values have the same length.

Throws:

IllegalArgumentException - if the field name is null