Class SolrIndexSearcher
- java.lang.Object
-
- org.apache.lucene.search.IndexSearcher
-
- org.apache.solr.search.SolrIndexSearcher
-
- All Implemented Interfaces:
Closeable
,AutoCloseable
,SolrInfoBean
,SolrMetricProducer
public class SolrIndexSearcher extends org.apache.lucene.search.IndexSearcher implements Closeable, SolrInfoBean
SolrIndexSearcher adds schema awareness and caching functionality overIndexSearcher
.- Since:
- solr 0.9
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
SolrIndexSearcher.DocsEnumState
static class
SolrIndexSearcher.ProcessedFilter
INTERNAL: The response object fromgetProcessedFilter(DocSet, List)
.-
Nested classes/interfaces inherited from class org.apache.lucene.search.IndexSearcher
org.apache.lucene.search.IndexSearcher.LeafSlice, org.apache.lucene.search.IndexSearcher.TooManyClauses, org.apache.lucene.search.IndexSearcher.TooManyNestedClauses
-
Nested classes/interfaces inherited from interface org.apache.solr.core.SolrInfoBean
SolrInfoBean.Category, SolrInfoBean.Group
-
-
Field Summary
Fields Modifier and Type Field Description static int
GET_DOCLIST
static int
GET_DOCSET
static int
GET_SCORES
static int
NO_CHECK_QCACHE
static AtomicLong
numCloses
static AtomicLong
numOpens
static String
STATISTICS_KEY
static String
STATS_SOURCE
static int
TERMINATE_EARLY
-
Constructor Summary
Constructors Constructor Description SolrIndexSearcher(SolrCore core, String path, IndexSchema schema, String name, org.apache.lucene.index.DirectoryReader r, boolean closeReader, boolean enableCache, boolean reserveDirectory, DirectoryFactory directoryFactory)
SolrIndexSearcher(SolrCore core, String path, IndexSchema schema, SolrIndexConfig config, String name, boolean enableCache, DirectoryFactory directoryFactory)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description void
bootstrapFirstSearcher()
Called on the initial searcher for each core, immediately beforefirstSearcherListeners
are called for the searcher.void
cacheDocSet(org.apache.lucene.search.Query query, DocSet optionalAnswer, boolean mustCache)
Compute and cache the DocSet that matches a query.Object
cacheInsert(String cacheName, Object key, Object val)
insert an entry in a generic cacheObject
cacheLookup(String cacheName, Object key)
lookup an entry in a generic cachevoid
close()
Free's resources associated with this searcher.org.apache.lucene.search.CollectionStatistics
collectionStatistics(String field)
org.apache.lucene.document.Document
doc(int docId)
Deprecated.org.apache.lucene.document.Document
doc(int i, Set<String> fields)
Deprecated.void
doc(int docId, org.apache.lucene.index.StoredFieldVisitor visitor)
Deprecated.int
docFreq(org.apache.lucene.index.Term term)
org.apache.lucene.search.Explanation
explain(org.apache.lucene.search.Query query, int doc)
SolrCache
getCache(String cacheName)
return the named generic cacheSolrInfoBean.Category
getCategory()
Category of this componentSolrCore
getCore()
String
getDescription()
Simple one or two line descriptionSolrDocumentFetcher
getDocFetcher()
DocList
getDocList(org.apache.lucene.search.Query query, List<org.apache.lucene.search.Query> filterList, org.apache.lucene.search.Sort lsort, int offset, int len, int flags)
Deprecated.DocList
getDocList(org.apache.lucene.search.Query query, org.apache.lucene.search.Query filter, org.apache.lucene.search.Sort lsort, int offset, int len)
Deprecated.DocList
getDocList(org.apache.lucene.search.Query query, DocSet filter, org.apache.lucene.search.Sort lsort, int offset, int len)
Deprecated.DocListAndSet
getDocListAndSet(org.apache.lucene.search.Query query, List<org.apache.lucene.search.Query> filterList, org.apache.lucene.search.Sort lsort, int offset, int len)
Deprecated.DocListAndSet
getDocListAndSet(org.apache.lucene.search.Query query, List<org.apache.lucene.search.Query> filterList, org.apache.lucene.search.Sort lsort, int offset, int len, int flags)
Deprecated.DocListAndSet
getDocListAndSet(org.apache.lucene.search.Query query, org.apache.lucene.search.Query filter, org.apache.lucene.search.Sort lsort, int offset, int len)
Deprecated.DocListAndSet
getDocListAndSet(org.apache.lucene.search.Query query, org.apache.lucene.search.Query filter, org.apache.lucene.search.Sort lsort, int offset, int len, int flags)
Deprecated.DocListAndSet
getDocListAndSet(org.apache.lucene.search.Query query, DocSet filter, org.apache.lucene.search.Sort lsort, int offset, int len)
Deprecated.DocListAndSet
getDocListAndSet(org.apache.lucene.search.Query query, DocSet filter, org.apache.lucene.search.Sort lsort, int offset, int len, int flags)
Deprecated.DocSet
getDocSet(List<org.apache.lucene.search.Query> queries)
Returns the set of document ids matching all queries.DocSet
getDocSet(org.apache.lucene.search.Query query)
Returns the set of document ids matching both the query.DocSet
getDocSet(org.apache.lucene.search.Query query, DocSet filter)
Returns the set of document ids matching both the query and the filter.DocSet
getDocSet(SolrIndexSearcher.DocsEnumState deState)
BitDocSet
getDocSetBits(org.apache.lucene.search.Query q)
protected DocSet
getDocSetNC(org.apache.lucene.search.Query query, DocSet filter)
org.apache.lucene.index.FieldInfos
getFieldInfos()
Iterable<String>
getFieldNames()
Returns a collection of all field names the index reader knows about.SolrCache<String,UnInvertedField>
getFieldValueCache()
expert: internal API, subject to changeSolrCache<org.apache.lucene.search.Query,DocSet>
getFilterCache()
int
getFirstMatch(org.apache.lucene.index.Term t)
Returns the first document number containing the termt
Returns -1 if no document was found.IndexFingerprint
getIndexFingerprint(long maxVersion)
org.apache.lucene.index.DirectoryReader
getIndexReader()
org.apache.lucene.util.Bits
getLiveDocsBits()
Returns an efficient random-accessBits
of the live docs.BitDocSet
getLiveDocSet()
Returns an efficient random-accessDocSet
of the live docs.String
getName()
Simple common usage name, e.g.long
getOpenNanoTime()
Date
getOpenTimeStamp()
String
getPath()
SolrIndexSearcher.ProcessedFilter
getProcessedFilter(DocSet setFilter, List<org.apache.lucene.search.Query> queries)
INTERNAL: Processes conjunction (AND) of both args into aSolrIndexSearcher.ProcessedFilter
result.org.apache.lucene.index.DirectoryReader
getRawReader()
Raw reader (no fieldcaches etc).IndexSchema
getSchema()
Direct access to the IndexSchema for use with this searcherorg.apache.lucene.index.LeafReader
getSlowAtomicReader()
Not recommended to call this method unless there is some particular reason due to internally callingSlowCompositeReaderWrapper
.SolrMetricsContext
getSolrMetricsContext()
Implementations should return the context used inSolrMetricProducer.initializeMetrics(SolrMetricsContext, String)
to ensure proper cleanup of metrics at the end of the life-cycle of this component.StatsCache
getStatsCache()
long
getWarmupTime()
void
initializeMetrics(SolrMetricsContext parentContext, String scope)
Initialize metrics specific to this producer.static void
initRegenerators(SolrConfig solrConfig)
<T> T
interrogateDocFetcher(Function<SolrDocumentFetcher,T> func)
Allows interrogation ofdocFetcher
template (checking field names, etc.) without forcing it to be cloned (as it would be if an instance were retrieved viagetDocFetcher()
).boolean
intersects(DocSet a, SolrIndexSearcher.DocsEnumState deState)
boolean
isCachingEnabled()
org.apache.lucene.search.CollectionStatistics
localCollectionStatistics(String field)
org.apache.lucene.search.TermStatistics
localTermStatistics(org.apache.lucene.index.Term term, int docFreq, long totalTermFreq)
long
lookupId(org.apache.lucene.util.BytesRef idBytes)
lookup the docid by the unique key field, and return the id *within* the leaf reader in the low 32 bits, and the index of the leaf reader in the high 32 bits.int
maxDoc()
int
numDocs()
int
numDocs(org.apache.lucene.search.Query a, org.apache.lucene.search.Query b)
Returns the number of documents that match botha
andb
.int
numDocs(org.apache.lucene.search.Query a, DocSet b)
Returns the number of documents that match botha
andb
.int
numDocs(DocSet a, SolrIndexSearcher.DocsEnumState deState)
BitDocSet
offerLiveDocs(Supplier<DocSet> docSetSupplier, int suppliedSize)
If some process external toSolrIndexSearcher
has produced a DocSet whose cardinality matches that of `liveDocs`, this method provides such caller the ability to offer its own DocSet to be cached in the searcher.void
register()
Register sub-objects such as caches and our own metricsprotected void
search(List<org.apache.lucene.index.LeafReaderContext> leaves, org.apache.lucene.search.Weight weight, org.apache.lucene.search.Collector collector)
QueryResult
search(QueryCommand cmd)
Primary entrypoint for searching, using aQueryCommand
.QueryResult
search(QueryResult qr, QueryCommand cmd)
Deprecated.protected void
sortDocSet(QueryResult qr, QueryCommand cmd)
org.apache.lucene.search.TermStatistics
termStatistics(org.apache.lucene.index.Term term, int docFreq, long totalTermFreq)
String
toString()
void
warm(SolrIndexSearcher old)
Warm this searcher based on an old one (primarily for auto-cache warming).org.apache.lucene.search.Sort
weightSort(org.apache.lucene.search.Sort sort)
Returns a weighted sort according to this searcherSortSpec
weightSortSpec(SortSpec originalSortSpec, org.apache.lucene.search.Sort nullEquivalent)
Returns a weighted sort spec according to this searcher-
Methods inherited from class org.apache.lucene.search.IndexSearcher
count, createWeight, explain, getDefaultQueryCache, getDefaultQueryCachingPolicy, getDefaultSimilarity, getExecutor, getLeafContexts, getMaxClauseCount, getQueryCache, getQueryCachingPolicy, getSimilarity, getSlices, getTaskExecutor, getTimeout, getTopReaderContext, rewrite, search, search, search, search, search, searchAfter, searchAfter, searchAfter, setDefaultQueryCache, setDefaultQueryCachingPolicy, setMaxClauseCount, setQueryCache, setQueryCachingPolicy, setSimilarity, setTimeout, slices, slices, storedFields, timedOut
-
-
-
-
Field Detail
-
STATS_SOURCE
public static final String STATS_SOURCE
- See Also:
- Constant Field Values
-
STATISTICS_KEY
public static final String STATISTICS_KEY
- See Also:
- Constant Field Values
-
numOpens
public static final AtomicLong numOpens
-
numCloses
public static final AtomicLong numCloses
-
NO_CHECK_QCACHE
public static final int NO_CHECK_QCACHE
- See Also:
- Constant Field Values
-
GET_DOCSET
public static final int GET_DOCSET
- See Also:
- Constant Field Values
-
TERMINATE_EARLY
public static final int TERMINATE_EARLY
- See Also:
- Constant Field Values
-
GET_DOCLIST
public static final int GET_DOCLIST
- See Also:
- Constant Field Values
-
GET_SCORES
public static final int GET_SCORES
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
SolrIndexSearcher
public SolrIndexSearcher(SolrCore core, String path, IndexSchema schema, SolrIndexConfig config, String name, boolean enableCache, DirectoryFactory directoryFactory) throws IOException
- Throws:
IOException
-
SolrIndexSearcher
public SolrIndexSearcher(SolrCore core, String path, IndexSchema schema, String name, org.apache.lucene.index.DirectoryReader r, boolean closeReader, boolean enableCache, boolean reserveDirectory, DirectoryFactory directoryFactory) throws IOException
- Throws:
IOException
-
-
Method Detail
-
getDocFetcher
public SolrDocumentFetcher getDocFetcher()
-
interrogateDocFetcher
public <T> T interrogateDocFetcher(Function<SolrDocumentFetcher,T> func)
Allows interrogation ofdocFetcher
template (checking field names, etc.) without forcing it to be cloned (as it would be if an instance were retrieved viagetDocFetcher()
).
-
getStatsCache
public StatsCache getStatsCache()
-
getFieldInfos
public org.apache.lucene.index.FieldInfos getFieldInfos()
-
termStatistics
public org.apache.lucene.search.TermStatistics termStatistics(org.apache.lucene.index.Term term, int docFreq, long totalTermFreq) throws IOException
- Overrides:
termStatistics
in classorg.apache.lucene.search.IndexSearcher
- Throws:
IOException
-
collectionStatistics
public org.apache.lucene.search.CollectionStatistics collectionStatistics(String field) throws IOException
- Overrides:
collectionStatistics
in classorg.apache.lucene.search.IndexSearcher
- Throws:
IOException
-
localTermStatistics
public org.apache.lucene.search.TermStatistics localTermStatistics(org.apache.lucene.index.Term term, int docFreq, long totalTermFreq) throws IOException
- Throws:
IOException
-
localCollectionStatistics
public org.apache.lucene.search.CollectionStatistics localCollectionStatistics(String field) throws IOException
- Throws:
IOException
-
isCachingEnabled
public boolean isCachingEnabled()
-
getPath
public String getPath()
-
toString
public String toString()
- Overrides:
toString
in classorg.apache.lucene.search.IndexSearcher
-
getCore
public SolrCore getCore()
-
maxDoc
public final int maxDoc()
-
numDocs
public final int numDocs()
-
docFreq
public final int docFreq(org.apache.lucene.index.Term term) throws IOException
- Throws:
IOException
-
getSlowAtomicReader
public final org.apache.lucene.index.LeafReader getSlowAtomicReader()
Not recommended to call this method unless there is some particular reason due to internally callingSlowCompositeReaderWrapper
. UseIndexSearcher.leafContexts
to get the sub readers instead of using this method.
-
getRawReader
public final org.apache.lucene.index.DirectoryReader getRawReader()
Raw reader (no fieldcaches etc). Useful for operations like addIndexes
-
getIndexReader
public final org.apache.lucene.index.DirectoryReader getIndexReader()
- Overrides:
getIndexReader
in classorg.apache.lucene.search.IndexSearcher
-
register
public void register()
Register sub-objects such as caches and our own metrics
-
close
public void close() throws IOException
Free's resources associated with this searcher.In particular, the underlying reader and any cache's in use are closed.
- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
- Specified by:
close
in interfaceSolrMetricProducer
- Throws:
IOException
-
getSchema
public IndexSchema getSchema()
Direct access to the IndexSchema for use with this searcher
-
getFieldNames
public Iterable<String> getFieldNames()
Returns a collection of all field names the index reader knows about.
-
initRegenerators
public static void initRegenerators(SolrConfig solrConfig)
-
search
public QueryResult search(QueryCommand cmd) throws IOException
Primary entrypoint for searching, using aQueryCommand
.- Throws:
IOException
-
search
@Deprecated public QueryResult search(QueryResult qr, QueryCommand cmd) throws IOException
Deprecated.- Throws:
IOException
-
search
protected void search(List<org.apache.lucene.index.LeafReaderContext> leaves, org.apache.lucene.search.Weight weight, org.apache.lucene.search.Collector collector) throws IOException
- Overrides:
search
in classorg.apache.lucene.search.IndexSearcher
- Throws:
IOException
-
doc
@Deprecated public org.apache.lucene.document.Document doc(int docId) throws IOException
Deprecated.Retrieve theDocument
instance corresponding to the document id.- Overrides:
doc
in classorg.apache.lucene.search.IndexSearcher
- Throws:
IOException
- See Also:
SolrDocumentFetcher
-
doc
@Deprecated public final void doc(int docId, org.apache.lucene.index.StoredFieldVisitor visitor) throws IOException
Deprecated.Visit a document's fields using aStoredFieldVisitor
. This method does not currently add to the Solr document cache.- Overrides:
doc
in classorg.apache.lucene.search.IndexSearcher
- Throws:
IOException
- See Also:
IndexReader.document(int, StoredFieldVisitor)
,SolrDocumentFetcher
-
doc
@Deprecated public final org.apache.lucene.document.Document doc(int i, Set<String> fields) throws IOException
Deprecated.Retrieve theDocument
instance corresponding to the document id.NOTE: the document will have all fields accessible, but if a field filter is provided, only the provided fields will be loaded (the remainder will be available lazily).
- Overrides:
doc
in classorg.apache.lucene.search.IndexSearcher
- Throws:
IOException
- See Also:
SolrDocumentFetcher
-
getFieldValueCache
public SolrCache<String,UnInvertedField> getFieldValueCache()
expert: internal API, subject to change
-
weightSort
public org.apache.lucene.search.Sort weightSort(org.apache.lucene.search.Sort sort) throws IOException
Returns a weighted sort according to this searcher- Throws:
IOException
-
weightSortSpec
public SortSpec weightSortSpec(SortSpec originalSortSpec, org.apache.lucene.search.Sort nullEquivalent) throws IOException
Returns a weighted sort spec according to this searcher- Throws:
IOException
-
getFirstMatch
public int getFirstMatch(org.apache.lucene.index.Term t) throws IOException
Returns the first document number containing the termt
Returns -1 if no document was found. This method is primarily intended for clients that want to fetch documents using a unique identifier."- Returns:
- the first document number containing the term
- Throws:
IOException
-
lookupId
public long lookupId(org.apache.lucene.util.BytesRef idBytes) throws IOException
lookup the docid by the unique key field, and return the id *within* the leaf reader in the low 32 bits, and the index of the leaf reader in the high 32 bits. -1 is returned if not found.- Throws:
IOException
- NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.
-
cacheDocSet
public void cacheDocSet(org.apache.lucene.search.Query query, DocSet optionalAnswer, boolean mustCache) throws IOException
Compute and cache the DocSet that matches a query. The normal usage is expected to be cacheDocSet(myQuery, null,false) meaning that Solr will determine if the Query warrants caching, and if so, will compute the DocSet that matches the Query and cache it. If the answer to the query is already cached, nothing further will be done.If the optionalAnswer DocSet is provided, it should *not* be modified after this call.
- Parameters:
query
- the lucene query that will act as the keyoptionalAnswer
- the DocSet to be cached - if null, it will be computed.mustCache
- if true, a best effort will be made to cache this entry. if false, heuristics may be used to determine if it should be cached.- Throws:
IOException
-
getDocSetBits
public BitDocSet getDocSetBits(org.apache.lucene.search.Query q) throws IOException
- Throws:
IOException
-
getLiveDocSet
public BitDocSet getLiveDocSet() throws IOException
Returns an efficient random-accessDocSet
of the live docs. It's cached. Never null.- Throws:
IOException
- NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.
- the type of DocSet returned may change in the future
-
getLiveDocsBits
public org.apache.lucene.util.Bits getLiveDocsBits() throws IOException
Returns an efficient random-accessBits
of the live docs. It's cached. Null means all docs are live. Use this likeLeafReader.getLiveDocs()
.- Throws:
IOException
- NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.
-
offerLiveDocs
public BitDocSet offerLiveDocs(Supplier<DocSet> docSetSupplier, int suppliedSize)
If some process external toSolrIndexSearcher
has produced a DocSet whose cardinality matches that of `liveDocs`, this method provides such caller the ability to offer its own DocSet to be cached in the searcher. The caller should then use the returned value (which may or may not be derived from the DocSet instance supplied), allowing more efficient memory use.- NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.
-
getDocSet
public DocSet getDocSet(List<org.apache.lucene.search.Query> queries) throws IOException
Returns the set of document ids matching all queries. This method is cache-aware and attempts to retrieve the answer from the cache if possible. If the answer was not cached, it may have been inserted into the cache as a result of this call. This method can handle negative queries. A null/empty list results ingetLiveDocSet()
.The DocSet returned should not be modified.
- Throws:
IOException
-
getProcessedFilter
public SolrIndexSearcher.ProcessedFilter getProcessedFilter(DocSet setFilter, List<org.apache.lucene.search.Query> queries) throws IOException
INTERNAL: Processes conjunction (AND) of both args into aSolrIndexSearcher.ProcessedFilter
result. Either arg may be null/empty thus doesn't restrict the matching docs. Queries typically are resolved against the filter cache, and populate it.- Throws:
IOException
-
getDocSet
public DocSet getDocSet(SolrIndexSearcher.DocsEnumState deState) throws IOException
- Throws:
IOException
- NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.
-
getDocSetNC
protected DocSet getDocSetNC(org.apache.lucene.search.Query query, DocSet filter) throws IOException
- Throws:
IOException
-
getDocSet
public DocSet getDocSet(org.apache.lucene.search.Query query) throws IOException
Returns the set of document ids matching both the query. This method is cache-aware and attempts to retrieve a DocSet of the query from the cache if possible. If the answer was not cached, it may have been inserted into the cache as a result of this call.- Returns:
- Non-null DocSet meeting the specified criteria. Should not be modified by the caller.
- Throws:
IOException
- See Also:
getDocSet(Query,DocSet)
-
getDocSet
public DocSet getDocSet(org.apache.lucene.search.Query query, DocSet filter) throws IOException
Returns the set of document ids matching both the query and the filter. This method is cache-aware and attempts to retrieve a DocSet of the query from the cache if possible. If the answer was not cached, it may have been inserted into the cache as a result of this call.- Parameters:
filter
- may be null if none- Returns:
- Non-null DocSet meeting the specified criteria. Should not be modified by the caller.
- Throws:
IOException
-
getDocList
@Deprecated public DocList getDocList(org.apache.lucene.search.Query query, org.apache.lucene.search.Query filter, org.apache.lucene.search.Sort lsort, int offset, int len) throws IOException
Deprecated.Returns documents matching bothquery
andfilter
and sorted bysort
.This method is cache aware and may retrieve
filter
from the cache or make an insertion into the cache as a result of this call.FUTURE: The returned DocList may be retrieved from a cache.
- Parameters:
filter
- may be nulllsort
- criteria by which to sort (if null, query relevance is used)offset
- offset into the list of documents to returnlen
- maximum number of documents to return- Returns:
- DocList meeting the specified criteria, should not be modified by the caller.
- Throws:
IOException
- If there is a low-level I/O error.
-
getDocList
@Deprecated public DocList getDocList(org.apache.lucene.search.Query query, List<org.apache.lucene.search.Query> filterList, org.apache.lucene.search.Sort lsort, int offset, int len, int flags) throws IOException
Deprecated.Returns documents matching bothquery
and the intersection of thefilterList
, sorted bysort
.This method is cache aware and may retrieve
filter
from the cache or make an insertion into the cache as a result of this call.FUTURE: The returned DocList may be retrieved from a cache.
- Parameters:
filterList
- may be nulllsort
- criteria by which to sort (if null, query relevance is used)offset
- offset into the list of documents to returnlen
- maximum number of documents to return- Returns:
- DocList meeting the specified criteria, should not be modified by the caller.
- Throws:
IOException
- If there is a low-level I/O error.
-
getDocList
@Deprecated public DocList getDocList(org.apache.lucene.search.Query query, DocSet filter, org.apache.lucene.search.Sort lsort, int offset, int len) throws IOException
Deprecated.Returns documents matching bothquery
andfilter
and sorted bysort
. FUTURE: The returned DocList may be retrieved from a cache.- Parameters:
filter
- may be nulllsort
- criteria by which to sort (if null, query relevance is used)offset
- offset into the list of documents to returnlen
- maximum number of documents to return- Returns:
- DocList meeting the specified criteria, should not be modified by the caller.
- Throws:
IOException
- If there is a low-level I/O error.
-
getDocListAndSet
@Deprecated public DocListAndSet getDocListAndSet(org.apache.lucene.search.Query query, org.apache.lucene.search.Query filter, org.apache.lucene.search.Sort lsort, int offset, int len) throws IOException
Deprecated.Returns documents matching bothquery
andfilter
and sorted bysort
. Also returns the complete set of documents matchingquery
andfilter
(regardless ofoffset
andlen
).This method is cache aware and may retrieve
filter
from the cache or make an insertion into the cache as a result of this call.FUTURE: The returned DocList may be retrieved from a cache.
The DocList and DocSet returned should not be modified.
- Parameters:
filter
- may be nulllsort
- criteria by which to sort (if null, query relevance is used)offset
- offset into the list of documents to returnlen
- maximum number of documents to return- Returns:
- DocListAndSet meeting the specified criteria, should not be modified by the caller.
- Throws:
IOException
- If there is a low-level I/O error.
-
getDocListAndSet
@Deprecated public DocListAndSet getDocListAndSet(org.apache.lucene.search.Query query, org.apache.lucene.search.Query filter, org.apache.lucene.search.Sort lsort, int offset, int len, int flags) throws IOException
Deprecated.Returns documents matching bothquery
andfilter
and sorted bysort
. Also returns the compete set of documents matchingquery
andfilter
(regardless ofoffset
andlen
).This method is cache aware and may retrieve
filter
from the cache or make an insertion into the cache as a result of this call.FUTURE: The returned DocList may be retrieved from a cache.
The DocList and DocSet returned should not be modified.
- Parameters:
filter
- may be nulllsort
- criteria by which to sort (if null, query relevance is used)offset
- offset into the list of documents to returnlen
- maximum number of documents to returnflags
- user supplied flags for the result set- Returns:
- DocListAndSet meeting the specified criteria, should not be modified by the caller.
- Throws:
IOException
- If there is a low-level I/O error.
-
getDocListAndSet
@Deprecated public DocListAndSet getDocListAndSet(org.apache.lucene.search.Query query, List<org.apache.lucene.search.Query> filterList, org.apache.lucene.search.Sort lsort, int offset, int len) throws IOException
Deprecated.Returns documents matching bothquery
and the intersection offilterList
, sorted bysort
. Also returns the compete set of documents matchingquery
andfilter
(regardless ofoffset
andlen
).This method is cache aware and may retrieve
filter
from the cache or make an insertion into the cache as a result of this call.FUTURE: The returned DocList may be retrieved from a cache.
The DocList and DocSet returned should not be modified.
- Parameters:
filterList
- may be nulllsort
- criteria by which to sort (if null, query relevance is used)offset
- offset into the list of documents to returnlen
- maximum number of documents to return- Returns:
- DocListAndSet meeting the specified criteria, should not be modified by the caller.
- Throws:
IOException
- If there is a low-level I/O error.
-
getDocListAndSet
@Deprecated public DocListAndSet getDocListAndSet(org.apache.lucene.search.Query query, List<org.apache.lucene.search.Query> filterList, org.apache.lucene.search.Sort lsort, int offset, int len, int flags) throws IOException
Deprecated.Returns documents matching bothquery
and the intersection offilterList
, sorted bysort
. Also returns the compete set of documents matchingquery
andfilter
(regardless ofoffset
andlen
).This method is cache aware and may retrieve
filter
from the cache or make an insertion into the cache as a result of this call.FUTURE: The returned DocList may be retrieved from a cache.
The DocList and DocSet returned should not be modified.
- Parameters:
filterList
- may be nulllsort
- criteria by which to sort (if null, query relevance is used)offset
- offset into the list of documents to returnlen
- maximum number of documents to returnflags
- user supplied flags for the result set- Returns:
- DocListAndSet meeting the specified criteria, should not be modified by the caller.
- Throws:
IOException
- If there is a low-level I/O error.
-
getDocListAndSet
@Deprecated public DocListAndSet getDocListAndSet(org.apache.lucene.search.Query query, DocSet filter, org.apache.lucene.search.Sort lsort, int offset, int len) throws IOException
Deprecated.Returns documents matching bothquery
andfilter
and sorted bysort
. Also returns the compete set of documents matchingquery
andfilter
(regardless ofoffset
andlen
).FUTURE: The returned DocList may be retrieved from a cache.
- Parameters:
filter
- may be nulllsort
- criteria by which to sort (if null, query relevance is used)offset
- offset into the list of documents to returnlen
- maximum number of documents to return- Returns:
- DocListAndSet meeting the specified criteria, should not be modified by the caller.
- Throws:
IOException
- If there is a low-level I/O error.
-
getDocListAndSet
@Deprecated public DocListAndSet getDocListAndSet(org.apache.lucene.search.Query query, DocSet filter, org.apache.lucene.search.Sort lsort, int offset, int len, int flags) throws IOException
Deprecated.Returns documents matching bothquery
andfilter
and sorted bysort
. Also returns the compete set of documents matchingquery
andfilter
(regardless ofoffset
andlen
).This method is cache aware and may make an insertion into the cache as a result of this call.
FUTURE: The returned DocList may be retrieved from a cache.
The DocList and DocSet returned should not be modified.
- Parameters:
filter
- may be nulllsort
- criteria by which to sort (if null, query relevance is used)offset
- offset into the list of documents to returnlen
- maximum number of documents to returnflags
- user supplied flags for the result set- Returns:
- DocListAndSet meeting the specified criteria, should not be modified by the caller.
- Throws:
IOException
- If there is a low-level I/O error.
-
sortDocSet
protected void sortDocSet(QueryResult qr, QueryCommand cmd) throws IOException
- Throws:
IOException
-
numDocs
public int numDocs(org.apache.lucene.search.Query a, DocSet b) throws IOException
Returns the number of documents that match botha
andb
.This method is cache-aware and may check as well as modify the cache.
- Returns:
- the number of documents in the intersection between
a
andb
. - Throws:
IOException
- If there is a low-level I/O error.
-
numDocs
public int numDocs(DocSet a, SolrIndexSearcher.DocsEnumState deState) throws IOException
- Throws:
IOException
- NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.
-
numDocs
public int numDocs(org.apache.lucene.search.Query a, org.apache.lucene.search.Query b) throws IOException
Returns the number of documents that match botha
andb
.This method is cache-aware and may check as well as modify the cache.
- Returns:
- the number of documents in the intersection between
a
andb
. - Throws:
IOException
- If there is a low-level I/O error.
-
intersects
public boolean intersects(DocSet a, SolrIndexSearcher.DocsEnumState deState) throws IOException
- Throws:
IOException
- NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.
-
bootstrapFirstSearcher
public void bootstrapFirstSearcher()
Called on the initial searcher for each core, immediately beforefirstSearcherListeners
are called for the searcher. This provides the opportunity to perform initialization on the first registered searcher before the searcher begins to see anyfirstSearcher
-triggered events.
-
warm
public void warm(SolrIndexSearcher old)
Warm this searcher based on an old one (primarily for auto-cache warming).
-
cacheLookup
public Object cacheLookup(String cacheName, Object key)
lookup an entry in a generic cache
-
cacheInsert
public Object cacheInsert(String cacheName, Object key, Object val)
insert an entry in a generic cache
-
getOpenTimeStamp
public Date getOpenTimeStamp()
-
getOpenNanoTime
public long getOpenNanoTime()
-
explain
public org.apache.lucene.search.Explanation explain(org.apache.lucene.search.Query query, int doc) throws IOException
- Overrides:
explain
in classorg.apache.lucene.search.IndexSearcher
- Throws:
IOException
-
getIndexFingerprint
public IndexFingerprint getIndexFingerprint(long maxVersion) throws IOException
- Throws:
IOException
- NOTE: This API is for internal purposes only and might change in incompatible ways in the next release.
- gets a cached version of the IndexFingerprint for this searcher
-
getName
public String getName()
Description copied from interface:SolrInfoBean
Simple common usage name, e.g. BasicQueryHandler, or fully qualified class name.- Specified by:
getName
in interfaceSolrInfoBean
-
getDescription
public String getDescription()
Description copied from interface:SolrInfoBean
Simple one or two line description- Specified by:
getDescription
in interfaceSolrInfoBean
-
getCategory
public SolrInfoBean.Category getCategory()
Description copied from interface:SolrInfoBean
Category of this component- Specified by:
getCategory
in interfaceSolrInfoBean
-
getSolrMetricsContext
public SolrMetricsContext getSolrMetricsContext()
Description copied from interface:SolrMetricProducer
Implementations should return the context used inSolrMetricProducer.initializeMetrics(SolrMetricsContext, String)
to ensure proper cleanup of metrics at the end of the life-cycle of this component. This should be the child context if one was created, or null if the parent context was used.- Specified by:
getSolrMetricsContext
in interfaceSolrMetricProducer
-
initializeMetrics
public void initializeMetrics(SolrMetricsContext parentContext, String scope)
Description copied from interface:SolrMetricProducer
Initialize metrics specific to this producer.- Specified by:
initializeMetrics
in interfaceSolrMetricProducer
- Parameters:
parentContext
- parent metrics context. If this component has the same life-cycle as the parent it can simply use the parent context, otherwise it should obtain a child context usingSolrMetricsContext.getChildContext(Object)
passingthis
as the child object.scope
- component scope
-
getWarmupTime
public long getWarmupTime()
-
-