org.apache.jackrabbit.core.query.lucene
Class JackrabbitIndexReader

java.lang.Object
  org.apache.lucene.index.IndexReader
      org.apache.lucene.index.FilterIndexReader
          org.apache.jackrabbit.core.query.lucene.JackrabbitIndexReader

All Implemented Interfaces:

HierarchyResolver, MultiIndexReader, ReleaseableIndexReader

public final class JackrabbitIndexReader
extends org.apache.lucene.index.FilterIndexReader
implements HierarchyResolver, MultiIndexReader

JackrabbitIndexReader wraps an index reader and releases the underlying reader when a client calls IndexReader.close() on this reader. This allows reusing of the underlying index reader instance.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.lucene.index.FilterIndexReader

org.apache.lucene.index.FilterIndexReader.FilterTermDocs, org.apache.lucene.index.FilterIndexReader.FilterTermEnum, org.apache.lucene.index.FilterIndexReader.FilterTermPositions

Nested classes/interfaces inherited from class org.apache.lucene.index.IndexReader

org.apache.lucene.index.IndexReader.FieldOption

Field Summary

Fields inherited from class org.apache.lucene.index.FilterIndexReader

in

Fields inherited from class org.apache.lucene.index.IndexReader

hasChanges

Constructor Summary

JackrabbitIndexReader(org.apache.lucene.index.IndexReader in)
Creates a new JackrabbitIndexReader.

Method Summary

org.apache.jackrabbit.core.query.lucene.ForeignSegmentDocId	createDocId(UUID uuid) Creates a document id for the given uuid.
protected void	doClose() Calls release on the underlying MultiIndexReader instead of closing it.
int	getDocumentNumber(org.apache.jackrabbit.core.query.lucene.ForeignSegmentDocId docId) Returns the document number for the passed docId.
org.apache.lucene.index.IndexReader[]	getIndexReaders()
int	getParent(int n) Returns the document number of the parent of n or -1 if n does not have a parent (n is the root node).
void	release() Releases this index reader and potentially frees resources.

Methods inherited from class org.apache.lucene.index.FilterIndexReader

directory, docFreq, doCommit, document, doDelete, doSetNorm, doUndeleteAll, getFieldNames, getTermFreqVector, getTermFreqVector, getTermFreqVector, getTermFreqVectors, getVersion, hasDeletions, hasNorms, isCurrent, isDeleted, isOptimized, maxDoc, norms, norms, numDocs, termDocs, termPositions, terms, terms

Methods inherited from class org.apache.lucene.index.IndexReader

acquireWriteLock, close, commit, decRef, deleteDocument, deleteDocuments, document, ensureOpen, flush, getCurrentVersion, getCurrentVersion, getCurrentVersion, getIndexCommit, getTermInfosIndexDivisor, incRef, indexExists, indexExists, indexExists, isLocked, isLocked, lastModified, lastModified, lastModified, listCommits, main, numDeletedDocs, open, open, open, open, open, open, open, open, open, reopen, setNorm, setNorm, setTermInfosIndexDivisor, termDocs, termPositions, undeleteAll, unlock

Methods inherited from class java.lang.Object

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

Constructor Detail

JackrabbitIndexReader

public JackrabbitIndexReader(org.apache.lucene.index.IndexReader in)

Creates a new JackrabbitIndexReader. The passed index reader must also implement the interfaces HierarchyResolver and MultiIndexReader.

Parameters:

in - the underlying index reader.

Throws:

java.lang.IllegalArgumentException - if in does not implement HierarchyResolver and MultiIndexReader.

Method Detail

doClose

protected void doClose()
                throws java.io.IOException

Calls release on the underlying MultiIndexReader instead of closing it.

Overrides:

doClose in class org.apache.lucene.index.FilterIndexReader

Throws:

java.io.IOException - if an error occurs while releaseing the underlying index reader.

getParent

public int getParent(int n)
              throws java.io.IOException

Returns the document number of the parent of n or -1 if n does not have a parent (n is the root node).

Specified by:

getParent in interface HierarchyResolver

Parameters:

n - the document number.

Returns:

the document number of n's parent.

Throws:

java.io.IOException - if an error occurs while reading from the index.

getIndexReaders

public org.apache.lucene.index.IndexReader[] getIndexReaders()

Specified by:

getIndexReaders in interface MultiIndexReader

Returns:

the IndexReaders that are contained in this MultiIndexReader.

createDocId

public org.apache.jackrabbit.core.query.lucene.ForeignSegmentDocId createDocId(UUID uuid)
                                                                        throws java.io.IOException

Creates a document id for the given uuid.

Specified by:

createDocId in interface MultiIndexReader

Parameters:

uuid - the uuid of the node.

Returns:

a foreign segment doc id or null if there is no node with the given uuid.

Throws:

java.io.IOException - if an error occurs while reading from the index.

getDocumentNumber

public int getDocumentNumber(org.apache.jackrabbit.core.query.lucene.ForeignSegmentDocId docId)
                      throws java.io.IOException

Returns the document number for the passed docId. If the id is invalid -1 is returned.

Specified by:

getDocumentNumber in interface MultiIndexReader

Parameters:

docId - the document id to resolve.

Returns:

the document number or -1 if it is invalid (e.g. does not exist).

Throws:

java.io.IOException - if an error occurs while reading from the index.

release

public void release()
             throws java.io.IOException

Releases this index reader and potentially frees resources. In contrast to IndexReader.close() this method does not necessarily close the index reader, but gives the implementation the opportunity to do reference counting.

Specified by:

release in interface ReleaseableIndexReader

Throws:

java.io.IOException - if an error occurs while releasing the index reader.