java.lang.Object | ||
↳ | org.apache.lucene.index.IndexReader | |
↳ | org.apache.lucene.index.SegmentReader |
NOTE: This API is new and still experimental (subject to change suddenly in the next release)
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
readOnly |
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.lucene.index.IndexReader
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Clones the IndexReader and optionally changes readOnly.
| |||||||||||
Efficiently clones the IndexReader (sharing most
internal state).
| |||||||||||
Returns the directory this index resides in.
| |||||||||||
Returns the number of documents containing the term
t . | |||||||||||
Get the
Document at the n
th position. | |||||||||||
Expert.
| |||||||||||
Expert
| |||||||||||
Get a list of unique field names that exist in this index and have the specified
field option information.
| |||||||||||
Return the name of the segment this reader is reading.
| |||||||||||
Load the Term Vector into a user-defined data structure instead of relying on the parallel arrays of
the
TermFreqVector . | |||||||||||
Map all the term vectors for all fields in a Document
| |||||||||||
Return a term frequency vector for the specified document and field.
| |||||||||||
Return an array of term frequency vectors for the specified document.
| |||||||||||
For IndexReader implementations that use
TermInfosReader to read terms, this returns the
current indexDivisor as specified when the reader was
opened.
| |||||||||||
Returns the number of unique terms (across all fields)
in this reader.
| |||||||||||
Returns true if any documents have been deleted
| |||||||||||
Returns true if there are norms stored for this field.
| |||||||||||
Returns true if document n has been deleted
| |||||||||||
Returns one greater than the largest possible document number.
| |||||||||||
Returns the byte-encoded normalization factor for the named field of
every document.
| |||||||||||
Read norms into a pre-allocated array.
| |||||||||||
Returns the number of documents in this index.
| |||||||||||
Returns an unpositioned
TermDocs enumerator. | |||||||||||
Returns an enumeration of all the documents which contain
term . | |||||||||||
Returns an unpositioned
TermPositions enumerator. | |||||||||||
Returns an enumeration of all terms starting at a given term.
| |||||||||||
Returns an enumeration of all the terms in the index.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Clones the deleteDocs BitVector.
| |||||||||||
Clones the norm bytes.
| |||||||||||
Implements close.
| |||||||||||
Implements commit.
| |||||||||||
Implements deletion of the document numbered
docNum . | |||||||||||
Implements setNorm in subclass.
| |||||||||||
Implements actual undeleteAll() in subclass.
| |||||||||||
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.lucene.index.IndexReader
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
java.io.Closeable
|
Clones the IndexReader and optionally changes readOnly. A readOnly reader cannot open a writeable reader.
CorruptIndexException | |
---|---|
IOException |
Efficiently clones the IndexReader (sharing most internal state).
On cloning a reader with pending changes (deletions, norms), the original reader transfers its write lock to the cloned reader. This means only the cloned reader may make further changes to the index, and commit the changes to the index on close, but the old reader still reflects all changes made up until it was cloned.
Like reopen()
, it's safe to make changes to
either the original or the cloned reader: all shared
mutable state obeys "copy on write" semantics to ensure
the changes are not seen by other readers.
Returns the number of documents containing the term t
.
IOException |
---|
Get the Document
at the n
th position. The FieldSelector
may be used to determine
what Field
s to load and how they should
be loaded. NOTE: If this Reader (more specifically, the underlying
FieldsReader
) is closed before the lazy
Field
is loaded an exception may be
thrown. If you want the value of a lazy
Field
to be available after closing you
must explicitly load it or fetch the Document again with a new loader.
NOTE: for performance reasons, this method does not check if the
requested document is deleted, and therefore asking for a deleted document
may yield unspecified results. Usually this is not required, however you
can call isDeleted(int)
with the requested document ID to verify
the document is not deleted.
n | Get the document at the n th position |
---|---|
fieldSelector | The FieldSelector to use to determine what
Fields should be loaded on the Document. May be null, in which case
all Fields will be loaded. |
Document
at the nth positionCorruptIndexException | |
---|---|
IOException |
CorruptIndexException | if the index is corrupt |
---|---|
IOException | if there is a low-level IO error |
CorruptIndexException | if the index is corrupt |
---|---|
IOException | if there is a low-level IO error |
Expert. Warning: this returns null if the reader has no deletions
Get a list of unique field names that exist in this index and have the specified field option information.
fieldOption | specifies which field option should be available for the returned fields |
---|
Load the Term Vector into a user-defined data structure instead of relying on the parallel arrays of
the TermFreqVector
.
docNumber | The number of the document to load the vector for |
---|---|
field | The name of the field to load |
mapper | The TermVectorMapper to process the vector. Must not be null |
IOException |
---|
Map all the term vectors for all fields in a Document
docNumber | The number of the document to load the vector for |
---|---|
mapper | The TermVectorMapper to process the vector. Must not be null |
IOException |
---|
Return a term frequency vector for the specified document and field. The vector returned contains term numbers and frequencies for all terms in the specified field of this document, if the field had storeTermVector flag set. If the flag was not set, the method returns null.
docNumber | document for which the term frequency vector is returned |
---|---|
field | field for which the term frequency vector is returned. |
IOException |
---|
Return an array of term frequency vectors for the specified document. The array contains a vector for each vectorized field in the document. Each vector vector contains term numbers and frequencies for all terms in a given vectorized field. If no such fields existed, the method returns null.
docNumber | document for which term frequency vectors are returned |
---|
IOException |
---|
For IndexReader implementations that use TermInfosReader to read terms, this returns the current indexDivisor as specified when the reader was opened.
Returns the number of unique terms (across all fields) in this reader. This method returns long, even though internally Lucene cannot handle more than 2^31 unique terms, for a possible future when this limitation is removed.
Returns true if any documents have been deleted
Returns true if there are norms stored for this field.
Returns true if document n has been deleted
Returns one greater than the largest possible document number. This may be used to, e.g., determine how big to allocate an array which will have an element for every document number in an index.
Returns the byte-encoded normalization factor for the named field of every document. This is used by the search code to score documents.
IOException |
---|
Read norms into a pre-allocated array.
IOException |
---|
Returns the number of documents in this index.
Returns an enumeration of all the documents which contain
term
. For each document, the document number, the frequency of
the term in that document is also provided, for use in
search scoring. If term is null, then all non-deleted
docs are returned with freq=1.
Thus, this method implements the mapping:
The enumeration is ordered by document number. Each document number is greater than all that precede it in the enumeration.
IOException |
---|
Returns an unpositioned TermPositions
enumerator.
IOException |
---|
Returns an enumeration of all terms starting at a given term. If the given term does not exist, the enumeration is positioned at the first term greater than the supplied term. The enumeration is ordered by Term.compareTo(). Each term is greater than all that precede it in the enumeration.
IOException |
---|
Clones the deleteDocs BitVector. May be overridden by subclasses. New and experimental.
bv | BitVector to clone |
---|
Clones the norm bytes. May be overridden by subclasses. New and experimental.
bytes | Byte array to clone |
---|
Implements deletion of the document numbered docNum
.
Applications should call deleteDocument(int)
or deleteDocuments(Term)
.
Implements setNorm in subclass.
IOException |
---|
Implements actual undeleteAll() in subclass.