|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.lucene.search.DocIdSet
public abstract class DocIdSet
A DocIdSet contains a set of doc ids. Implementing classes must
only implement iterator()
to provide access to the set.
Constructor Summary | |
---|---|
DocIdSet()
|
Method Summary | |
---|---|
Bits |
bits()
Optionally provides a Bits interface for random access
to matching documents. |
boolean |
isCacheable()
This method is a hint for CachingWrapperFilter , if this DocIdSet
should be cached without copying it into a BitSet. |
abstract DocIdSetIterator |
iterator()
Provides a DocIdSetIterator to access the set. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public DocIdSet()
Method Detail |
---|
public abstract DocIdSetIterator iterator() throws IOException
DocIdSetIterator
to access the set.
This implementation can return null
if there
are no docs that match.
IOException
public Bits bits() throws IOException
Bits
interface for random access
to matching documents.
null
, if this DocIdSet
does not support random access.
In contrast to iterator()
, a return value of null
does not imply that no documents match the filter!
The default implementation does not provide random access, so you
only need to implement this method if your DocIdSet can
guarantee random access to every docid in O(1) time without
external disk access (as Bits
interface cannot throw
IOException
). This is generally true for bit sets
like FixedBitSet
, which return
itself if they are used as DocIdSet
.
IOException
public boolean isCacheable()
CachingWrapperFilter
, if this DocIdSet
should be cached without copying it into a BitSet. The default is to return
false
. If you have an own DocIdSet
implementation
that does its iteration very effective and fast without doing disk I/O,
override this method and return true
.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |