# Package org.apache.lucene.document

The logical representation of a `Document` for indexing and searching.

See: Description

Class Summary
BinaryDocValuesField: Field that stores a per-document `BytesRef` value.
BinaryPoint: An indexed binary field for fast range filters.
DateTools: Provides support for converting dates to strings and vice-versa.
Document: Documents are the unit of indexing and search.
DocumentStoredFieldVisitor: A `StoredFieldVisitor` that creates a `Document` from stored fields.
DoubleDocValuesField: Syntactic sugar for encoding doubles as NumericDocValues via `Double.doubleToRawLongBits(double)`.
DoublePoint: An indexed `double` field for fast range filters.
DoubleRange: An indexed Double Range field.
DoubleRangeDocValuesField: DocValues field for DoubleRange.
FeatureField: `Field` that can be used to store static scoring factors into documents.
Field: Expert: directly create a field for a document.
FieldType: Describes the properties of a field.
FloatDocValuesField: Syntactic sugar for encoding floats as NumericDocValues via `Float.floatToRawIntBits(float)`.
FloatPoint: An indexed `float` field for fast range filters.
FloatRange: An indexed Float Range field.
FloatRangeDocValuesField: DocValues field for FloatRange.
IntPoint: An indexed `int` field for fast range filters.
IntRange: An indexed Integer Range field.
IntRangeDocValuesField: DocValues field for IntRange.
LatLonDocValuesField: An per-document location field.
LatLonDocValuesPointInPolygonQuery: Polygon query for `LatLonDocValuesField`.
LatLonPoint: An indexed location field.
LatLonShape: An geo shape utility class for indexing and searching gis geometries whose vertices are latitude, longitude values (in decimal degrees).
LongPoint: An indexed `long` field for fast range filters.
LongRange: An indexed Long Range field.
LongRangeDocValuesField: DocValues field for LongRange.
NumericDocValuesField: Field that stores a per-document `long` value for scoring, sorting or value retrieval.
ShapeField: A base shape utility class used for both LatLon (spherical) and XY (cartesian) shape fields.
ShapeField.DecodedTriangle: Represents a encoded triangle using `ShapeField.decodeTriangle(byte[], DecodedTriangle)`.
ShapeField.Triangle: polygons are decomposed into tessellated triangles using `Tessellator` these triangles are encoded and inserted as separate indexed POINT fields
SortedDocValuesField: Field that stores a per-document `BytesRef` value, indexed for sorting.
SortedNumericDocValuesField: Field that stores a per-document `long` values for scoring, sorting or value retrieval.
SortedSetDocValuesField: Field that stores a set of per-document `BytesRef` values, indexed for faceting,grouping,joining.
StoredField: A field whose value is stored so that `IndexSearcher.doc(int)` and `IndexReader.document()` will return the field and its value.
StringField: A field that is indexed but not tokenized: the entire String value is indexed as a single token.
TextField: A field that is indexed and tokenized, without term vectors.
XYDocValuesField: An per-document location field.
XYDocValuesPointInGeometryQuery: XYGeometry query for `XYDocValuesField`.
XYPointField: An indexed XY position field.
XYShape: A cartesian shape utility class for indexing and searching geometries whose vertices are unitless x, y values.

Enum Summary
DateTools.Resolution: Specifies the time granularity.
Field.Store: Specifies whether and how a field should be stored.
ShapeField.DecodedTriangle.TYPE: type of triangle
ShapeField.QueryRelation: Query Relation Types

## Package org.apache.lucene.document Description

The logical representation of a `Document` for indexing and searching.

The document package provides the user level logical representation of content to be indexed and searched. The package also provides utilities for working with `Document`s and `IndexableField`s.

## Document and IndexableField

A `Document` is a collection of `IndexableField`s. A `IndexableField` is a logical representation of a user's content that needs to be indexed or stored. `IndexableField`s have a number of properties that tell Lucene how to treat the content (like indexed, tokenized, stored, etc.) See the `Field` implementation of `IndexableField` for specifics on these properties.

Note: it is common to refer to `Document`s having `Field`s, even though technically they have `IndexableField`s.

## Working with Documents

First and foremost, a `Document` is something created by the user application. It is your job to create Documents based on the content of the files you are working with in your application (Word, txt, PDF, Excel or any other format.) How this is done is completely up to you. That being said, there are many tools available in other projects that can make the process of taking a file and converting it into a Lucene `Document`.

The `DateTools` is a utility class to make dates and times searchable. `IntPoint`, `LongPoint`, `FloatPoint` and `DoublePoint` enable indexing of numeric values (and also dates) for fast range queries using `PointRangeQuery`