|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.lucene.index.IndexReader
org.apache.lucene.index.ParallelReader
public class ParallelReader
An IndexReader which reads multiple, parallel indexes. Each index added must have the same number of documents, but typically each contains different fields. Each document contains the union of the fields of all documents with the same document number. When searching, matches for a query term are from the first index added that has the field.
This is useful, e.g., with collections that have large fields which change rarely and small fields that change more frequently. The smaller fields may be re-indexed in a new index and both indexes may be searched together.
Warning: It is up to you to make sure all indexes are created and modified the same way. For example, if you add documents to one index, you need to add the same documents in the same order to the other indexes. Failure to do so will result in undefined behavior.
Nested Class Summary |
---|
Nested classes/interfaces inherited from class org.apache.lucene.index.IndexReader |
---|
IndexReader.FieldOption |
Constructor Summary | |
---|---|
ParallelReader()
Construct a ParallelReader. |
Method Summary | |
---|---|
void |
add(IndexReader reader)
Add an IndexReader. |
void |
add(IndexReader reader,
boolean ignoreStoredFields)
Add an IndexReader whose stored fields will not be returned. |
int |
docFreq(Term term)
Returns the number of documents containing the term t . |
protected void |
doClose()
Implements close. |
protected void |
doCommit()
Implements commit. |
Document |
document(int n)
Returns the stored fields of the n th
Document in this index. |
protected void |
doDelete(int n)
Implements deletion of the document numbered docNum . |
protected void |
doSetNorm(int n,
java.lang.String field,
byte value)
Implements setNorm in subclass. |
protected void |
doUndeleteAll()
Implements actual undeleteAll() in subclass. |
java.util.Collection |
getFieldNames()
Returns a list of all unique field names that exist in the index pointed to by this IndexReader. |
java.util.Collection |
getFieldNames(boolean indexed)
Returns a list of all unique field names that exist in the index pointed to by this IndexReader. |
java.util.Collection |
getFieldNames(IndexReader.FieldOption fieldNames)
Get a list of unique field names that exist in this index and have the specified field option information. |
java.util.Collection |
getIndexedFieldNames(Field.TermVector tvSpec)
Get a list of unique field names that exist in this index, are indexed, and have the specified term vector information. |
TermFreqVector |
getTermFreqVector(int n,
java.lang.String field)
Return a term frequency vector for the specified document and field. |
TermFreqVector[] |
getTermFreqVectors(int n)
Return an array of term frequency vectors for the specified document. |
boolean |
hasDeletions()
Returns true if any documents have been deleted |
boolean |
hasNorms(java.lang.String field)
Returns true if there are norms stored for this field. |
boolean |
isDeleted(int n)
Returns true if document n has been deleted |
int |
maxDoc()
Returns one greater than the largest possible document number. |
byte[] |
norms(java.lang.String field)
Returns the byte-encoded normalization factor for the named field of every document. |
void |
norms(java.lang.String field,
byte[] result,
int offset)
Reads the byte-encoded normalization factor for the named field of every document. |
int |
numDocs()
Returns the number of documents in this index. |
TermDocs |
termDocs()
Returns an unpositioned TermDocs enumerator. |
TermDocs |
termDocs(Term term)
Returns an enumeration of all the documents which contain term . |
TermPositions |
termPositions()
Returns an unpositioned TermPositions enumerator. |
TermPositions |
termPositions(Term term)
Returns an enumeration of all the documents which contain term . |
TermEnum |
terms()
Returns an enumeration of all the terms in the index. |
TermEnum |
terms(Term term)
Returns an enumeration of all terms after a given term. |
Methods inherited from class org.apache.lucene.index.IndexReader |
---|
close, commit, delete, delete, deleteDocument, deleteDocuments, directory, finalize, getCurrentVersion, getCurrentVersion, getCurrentVersion, getIndexedFieldNames, getVersion, indexExists, indexExists, indexExists, isCurrent, isLocked, isLocked, lastModified, lastModified, lastModified, main, open, open, open, setNorm, setNorm, undeleteAll, unlock |
Methods inherited from class java.lang.Object |
---|
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public ParallelReader() throws java.io.IOException
java.io.IOException
Method Detail |
---|
public void add(IndexReader reader) throws java.io.IOException
java.io.IOException
public void add(IndexReader reader, boolean ignoreStoredFields) throws java.io.IOException
java.lang.IllegalArgumentException
- if not all indexes contain the same number
of documents
java.lang.IllegalArgumentException
- if not all indexes have the same value
of IndexReader.maxDoc()
java.io.IOException
public int numDocs()
IndexReader
numDocs
in class IndexReader
public int maxDoc()
IndexReader
maxDoc
in class IndexReader
public boolean hasDeletions()
IndexReader
hasDeletions
in class IndexReader
public boolean isDeleted(int n)
IndexReader
isDeleted
in class IndexReader
protected void doDelete(int n) throws java.io.IOException
IndexReader
docNum
.
Applications should call IndexReader.delete(int)
or IndexReader.delete(Term)
.
doDelete
in class IndexReader
java.io.IOException
protected void doUndeleteAll() throws java.io.IOException
IndexReader
doUndeleteAll
in class IndexReader
java.io.IOException
public Document document(int n) throws java.io.IOException
IndexReader
n
th
Document
in this index.
document
in class IndexReader
java.io.IOException
public TermFreqVector[] getTermFreqVectors(int n) throws java.io.IOException
IndexReader
getTermFreqVectors
in class IndexReader
n
- document for which term frequency vectors are returned
java.io.IOException
- if index cannot be accessedField.TermVector
public TermFreqVector getTermFreqVector(int n, java.lang.String field) throws java.io.IOException
IndexReader
getTermFreqVector
in class IndexReader
n
- document for which the term frequency vector is returnedfield
- field for which the term frequency vector is returned.
java.io.IOException
- if index cannot be accessedField.TermVector
public boolean hasNorms(java.lang.String field) throws java.io.IOException
IndexReader
hasNorms
in class IndexReader
java.io.IOException
public byte[] norms(java.lang.String field) throws java.io.IOException
IndexReader
norms
in class IndexReader
java.io.IOException
Field.setBoost(float)
public void norms(java.lang.String field, byte[] result, int offset) throws java.io.IOException
IndexReader
norms
in class IndexReader
java.io.IOException
Field.setBoost(float)
protected void doSetNorm(int n, java.lang.String field, byte value) throws java.io.IOException
IndexReader
doSetNorm
in class IndexReader
java.io.IOException
public TermEnum terms() throws java.io.IOException
IndexReader
terms
in class IndexReader
java.io.IOException
public TermEnum terms(Term term) throws java.io.IOException
IndexReader
terms
in class IndexReader
java.io.IOException
public int docFreq(Term term) throws java.io.IOException
IndexReader
t
.
docFreq
in class IndexReader
java.io.IOException
public TermDocs termDocs(Term term) throws java.io.IOException
IndexReader
term
. For each document, the document number, the frequency of
the term in that document is also provided, for use in search scoring.
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.
termDocs
in class IndexReader
java.io.IOException
public TermDocs termDocs() throws java.io.IOException
IndexReader
TermDocs
enumerator.
termDocs
in class IndexReader
java.io.IOException
public TermPositions termPositions(Term term) throws java.io.IOException
IndexReader
term
. For each document, in addition to the document number
and frequency of the term in that document, a list of all of the ordinal
positions of the term in the document is available. Thus, this method
implements the mapping:
This positional information faciliates phrase and proximity searching.
The enumeration is ordered by document number. Each document number is greater than all that precede it in the enumeration.
termPositions
in class IndexReader
java.io.IOException
public TermPositions termPositions() throws java.io.IOException
IndexReader
TermPositions
enumerator.
termPositions
in class IndexReader
java.io.IOException
protected void doCommit() throws java.io.IOException
IndexReader
doCommit
in class IndexReader
java.io.IOException
protected void doClose() throws java.io.IOException
IndexReader
doClose
in class IndexReader
java.io.IOException
public java.util.Collection getFieldNames() throws java.io.IOException
IndexReader
getFieldNames
in class IndexReader
java.io.IOException
- if there is a problem with accessing the indexpublic java.util.Collection getFieldNames(boolean indexed) throws java.io.IOException
IndexReader
getFieldNames
in class IndexReader
indexed
- true
if only indexed fields should be returned;
false
if only unindexed fields should be returned.
java.io.IOException
- if there is a problem with accessing the indexpublic java.util.Collection getIndexedFieldNames(Field.TermVector tvSpec)
IndexReader
getIndexedFieldNames
in class IndexReader
tvSpec
- specifies which term vector information should be available for the fields
public java.util.Collection getFieldNames(IndexReader.FieldOption fieldNames)
IndexReader
getFieldNames
in class IndexReader
fieldNames
- specifies which field option should be available for the returned fields
IndexReader.FieldOption
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |