StoredField (Lucene 10.5.1 core API)
Description: declaration: package: org.apache.lucene.document, class: StoredField

Package org.apache.lucene.document

# Class StoredField

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

All Implemented Interfaces:
  `IndexableField`

public class StoredField extends Field
A field whose value is stored so that `IndexSearcher.storedFields()` and `IndexReader.storedFields()` will return the field and its value.

- ## Nested Class Summary

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

  `Field.Store`

- ## Field Summary

  Fields
  Modifier and Type
  Field
  Description
  `static final FieldType`
  `TYPE`
  Type for a stored-only field.

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

  `fieldsData, name, type`

- ## Constructor Summary

  Constructors
  Modifier
  Constructor
  Description
  ``
  `StoredField(String name, byte[] value)`
  Create a stored-only field with the given binary value.
  ``
  `StoredField(String name, byte[] value, int offset, int length)`
  Create a stored-only field with the given binary value.
  ``
  `StoredField(String name, double value)`
  Create a stored-only field with the given double value.
  ``
  `StoredField(String name, float value)`
  Create a stored-only field with the given float value.
  ``
  `StoredField(String name, int value)`
  Create a stored-only field with the given integer value.
  ``
  `StoredField(String name, long value)`
  Create a stored-only field with the given long value.
  ``
  `StoredField(String name, CharSequence value, FieldType type)`
  Expert: allows you to customize the `FieldType`.
  ``
  `StoredField(String name, String value)`
  Create a stored-only field with the given string value.
  ``
  `StoredField(String name, String value, FieldType type)`
  Expert: allows you to customize the `FieldType`.
  `protected`
  `StoredField(String name, FieldType type)`
  Expert: allows you to customize the `FieldType`.
  ``
  `StoredField(String name, StoredFieldDataInput value)`
  Create a stored-only field with the given data input value.
  ``
  `StoredField(String name, BytesRef value)`
  Create a stored-only field with the given binary value.
  ``
  `StoredField(String name, BytesRef bytes, FieldType type)`
  Expert: allows you to customize the `FieldType`.

- ## Method Summary

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

  `binaryValue, fieldType, getCharSequenceValue, invertableType, name, numericValue, readerValue, setBytesValue, setBytesValue, setByteValue, setDoubleValue, setFloatValue, setIntValue, setLongValue, setReaderValue, setShortValue, setStringValue, setTokenStream, storedValue, stringValue, tokenStream, tokenStreamValue, toString`

  ### Methods inherited from class java.lang.Object

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

- ## Field Details

  - ### TYPE

    public static final FieldType TYPE
    Type for a stored-only field.

- ## Constructor Details

  - ### StoredField

    protected StoredField(String name, FieldType type)
    Expert: allows you to customize the `FieldType`.
    Parameters:
      `name` - field name
      `type` - custom `FieldType` for this field
    Throws:
      `IllegalArgumentException` - if the field name or type is null.

  - ### StoredField

    public StoredField(String name, BytesRef bytes, FieldType type)
    Expert: allows you to customize the `FieldType`.

    NOTE: the provided byte[] is not copied so be sure not to change it until you're done with this field.

    Parameters:
      `name` - field name
      `bytes` - byte array pointing to binary content (not copied)
      `type` - custom `FieldType` for this field
    Throws:
      `IllegalArgumentException` - if the field name, value or type is null.

  - ### StoredField

    public StoredField(String name, byte[] value)
    Create a stored-only field with the given binary value.

    NOTE: the provided byte[] is not copied so be sure not to change it until you're done with this field.

    Parameters:
      `name` - field name
      `value` - byte array pointing to binary content (not copied)
    Throws:
      `IllegalArgumentException` - if the field name or value is null.

  - ### StoredField

    public StoredField(String name, byte[] value, int offset, int length)
    Create a stored-only field with the given binary value.

    NOTE: the provided byte[] is not copied so be sure not to change it until you're done with this field.

    Parameters:
      `name` - field name
      `value` - byte array pointing to binary content (not copied)
      `offset` - starting position of the byte array
      `length` - valid length of the byte array
    Throws:
      `IllegalArgumentException` - if the field name or value is null.

  - ### StoredField

    public StoredField(String name, BytesRef value)
    Create a stored-only field with the given binary value.

    NOTE: the provided BytesRef is not copied so be sure not to change it until you're done with this field.

    Parameters:
      `name` - field name
      `value` - BytesRef pointing to binary content (not copied)
    Throws:
      `IllegalArgumentException` - if the field name or value is null.

  - ### StoredField

    public StoredField(String name, StoredFieldDataInput value)
    Create a stored-only field with the given data input value.
    Parameters:
      `name` - field name
      `value` - BytesRef pointing to binary content (not copied)
    Throws:
      `IllegalArgumentException` - if the field name or value is null.

  - ### StoredField

    public StoredField(String name, String value)
    Create a stored-only field with the given string value.
    Parameters:
      `name` - field name
      `value` - string value
    Throws:
      `IllegalArgumentException` - if the field name or value is null.

  - ### StoredField

    public StoredField(String name, String value, FieldType type)
    Expert: allows you to customize the `FieldType`.
    Parameters:
      `name` - field name
      `value` - string value
      `type` - custom `FieldType` for this field
    Throws:
      `IllegalArgumentException` - if the field name, value or type is null.

  - ### StoredField

    public StoredField(String name, CharSequence value, FieldType type)
    Expert: allows you to customize the `FieldType`.
    Parameters:
      `name` - field name
      `value` - CharSequence value
      `type` - custom `FieldType` for this field
    Throws:
      `IllegalArgumentException` - if the field name, value or type is null.

  - ### StoredField

    public StoredField(String name, int value)
    Create a stored-only field with the given integer value.
    Parameters:
      `name` - field name
      `value` - integer value
    Throws:
      `IllegalArgumentException` - if the field name is null.

  - ### StoredField

    public StoredField(String name, float value)
    Create a stored-only field with the given float value.
    Parameters:
      `name` - field name
      `value` - float value
    Throws:
      `IllegalArgumentException` - if the field name is null.

  - ### StoredField

    public StoredField(String name, long value)
    Create a stored-only field with the given long value.
    Parameters:
      `name` - field name
      `value` - long value
    Throws:
      `IllegalArgumentException` - if the field name is null.

  - ### StoredField

    public StoredField(String name, double value)
    Create a stored-only field with the given double value.
    Parameters:
      `name` - field name
      `value` - double value
    Throws:
      `IllegalArgumentException` - if the field name is null.