Package org.apache.lucene.search
Class FieldValueFilter
- java.lang.Object
-
- org.apache.lucene.search.Filter
-
- org.apache.lucene.search.FieldValueFilter
-
public class FieldValueFilter extends Filter
AFilter
that accepts all documents that have one or more values in a given field. ThisFilter
requestBits
from theFieldCache
and build the bits if not present.
-
-
Constructor Summary
Constructors Constructor Description FieldValueFilter(java.lang.String field)
Creates a newFieldValueFilter
FieldValueFilter(java.lang.String field, boolean negate)
Creates a newFieldValueFilter
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
equals(java.lang.Object obj)
java.lang.String
field()
Returns the field this filter is applied on.DocIdSet
getDocIdSet(AtomicReaderContext context, Bits acceptDocs)
Creates aDocIdSet
enumerating the documents that should be permitted in search results.int
hashCode()
boolean
negate()
Returnstrue
iff this filter is negated, otherwisefalse
java.lang.String
toString()
-
-
-
Constructor Detail
-
FieldValueFilter
public FieldValueFilter(java.lang.String field)
Creates a newFieldValueFilter
- Parameters:
field
- the field to filter
-
FieldValueFilter
public FieldValueFilter(java.lang.String field, boolean negate)
Creates a newFieldValueFilter
- Parameters:
field
- the field to filternegate
- ifftrue
all documents with no value in the given field are accepted.
-
-
Method Detail
-
field
public java.lang.String field()
Returns the field this filter is applied on.- Returns:
- the field this filter is applied on.
-
negate
public boolean negate()
Returnstrue
iff this filter is negated, otherwisefalse
- Returns:
true
iff this filter is negated, otherwisefalse
-
getDocIdSet
public DocIdSet getDocIdSet(AtomicReaderContext context, Bits acceptDocs) throws java.io.IOException
Description copied from class:Filter
Creates aDocIdSet
enumerating the documents that should be permitted in search results. NOTE: null can be returned if no documents are accepted by this Filter.Note: This method will be called once per segment in the index during searching. The returned
DocIdSet
must refer to document IDs for that segment, not for the top-level reader.- Specified by:
getDocIdSet
in classFilter
- Parameters:
context
- aAtomicReaderContext
instance opened on the index currently searched on. Note, it is likely that the provided reader info does not represent the whole underlying index i.e. if the index has more than one segment the given reader only represents a single segment. The provided context is always an atomic context, so you can callAtomicReader.fields()
on the context's reader, for example.acceptDocs
- Bits that represent the allowable docs to match (typically deleted docs but possibly filtering other documents)- Returns:
- a DocIdSet that provides the documents which should be permitted or
prohibited in search results. NOTE:
null
should be returned if the filter doesn't accept any documents otherwise internal optimization might not apply in the case an emptyDocIdSet
is returned. - Throws:
java.io.IOException
-
hashCode
public int hashCode()
- Overrides:
hashCode
in classjava.lang.Object
-
equals
public boolean equals(java.lang.Object obj)
- Overrides:
equals
in classjava.lang.Object
-
toString
public java.lang.String toString()
- Overrides:
toString
in classjava.lang.Object
-
-