org.infinispan.query

Interface CacheQuery

All Superinterfaces:

Iterable<Object>

All Known Implementing Classes:

CacheQueryImpl, ClusteredCacheQueryImpl

public interface CacheQuery
extends Iterable<Object>

A cache-query is what will be returned when the getQuery() method is run on SearchManagerImpl. This object can have methods such as list, setFirstResult,setMaxResults, setFetchSize, getResultSize and setSort.

Author:

Manik Surtani, Navin Surtani, Sanne Grinovero (C) 2011 Red Hat Inc., Marko Luksa

See Also:

SearchManagerImpl#getQuery(org.apache.lucene.search.Query)

Method Summary

Methods

Modifier and Type	Method and Description
CacheQuery	disableFullTextFilter(String name) Disable a given filter by its name.
org.hibernate.search.FullTextFilter	enableFullTextFilter(String name) Enable a given filter by its name.
org.apache.lucene.search.Explanation	explain(int documentId) Return the Lucene Explanation object describing the score computation for the matching object/document in the current query
CacheQuery	filter(org.apache.lucene.search.Filter f) Allows lucene to filter the results.
CacheQuery	firstResult(int index) Sets a result with a given index to the first result.
org.hibernate.search.query.engine.spi.FacetManager	getFacetManager()
int	getResultSize() Gets the integer number of results.
ResultIterator	iterator() Returns the results of a search as a ResultIterator.
ResultIterator	iterator(FetchOptions fetchOptions) Returns the results of a search as a ResultIterator.
List<Object>	list() Returns the results of a search as a list.
CacheQuery	maxResults(int numResults) Sets the maximum number of results to the number passed in as a parameter.
CacheQuery	projection(String... fields) Defines the Lucene field names projected and returned in a query result Each field is converted back to it's object representation, an Object[] being returned for each "row" A projectable field must be stored in the Lucene index and use a TwoWayFieldBridge Unless notified in their JavaDoc, all built-in bridges are two-way.
CacheQuery	sort(org.apache.lucene.search.Sort s) Allows lucene to sort the results.
CacheQuery	timeout(long timeout, TimeUnit timeUnit) Set the timeout for this query.

Method Detail

list

List<Object> list()

Returns the results of a search as a list.

Returns:

list of objects that were found from the search.

iterator

ResultIterator iterator(FetchOptions fetchOptions)

Returns the results of a search as a ResultIterator. Warning: the return type is an extension of Iterator which introduces a ResultIterator.close() method. This close method needs to be invoked when the iteration is complete to avoid resource leakage.

Parameters:

fetchOptions - how to fetch results (see @link FetchOptions)

Returns:

a QueryResultIterator which can be used to iterate through the results that were found.

iterator

ResultIterator iterator()

Returns the results of a search as a ResultIterator. This calls iterator(FetchOptions fetchOptions) with default FetchOptions; this implies eager loading of all results.

Specified by:

iterator in interface Iterable<Object>

Returns:

a ResultIterator which can be used to iterate through the results that were found.

firstResult

CacheQuery firstResult(int index)

Sets a result with a given index to the first result.

Parameters:

index - of result to be set to the first.

Throws:

IllegalArgumentException - if the index given is less than zero.

maxResults

CacheQuery maxResults(int numResults)

Sets the maximum number of results to the number passed in as a parameter.

Parameters:

numResults - that are to be set to the maxResults.

getFacetManager

org.hibernate.search.query.engine.spi.FacetManager getFacetManager()

Returns:

return the manager for all faceting related operations

getResultSize

int getResultSize()

Gets the integer number of results.

Returns:

integer number of results.

explain

org.apache.lucene.search.Explanation explain(int documentId)

Return the Lucene Explanation object describing the score computation for the matching object/document in the current query

Parameters:

documentId - Lucene Document id to be explain. This is NOT the object key

Returns:

Lucene Explanation

sort

CacheQuery sort(org.apache.lucene.search.Sort s)

Allows lucene to sort the results. Integers are sorted in descending order.

Parameters:

s - - lucene sort object

projection

CacheQuery projection(String... fields)

Defines the Lucene field names projected and returned in a query result Each field is converted back to it's object representation, an Object[] being returned for each "row"

A projectable field must be stored in the Lucene index and use a TwoWayFieldBridge Unless notified in their JavaDoc, all built-in bridges are two-way. All @DocumentId fields are projectable by design.

If the projected field is not a projectable field, null is returned in the object[]

Parameters:

fields - the projected field names

Returns:

this to allow for method chaining

enableFullTextFilter

org.hibernate.search.FullTextFilter enableFullTextFilter(String name)

Enable a given filter by its name.

Parameters:

name - of filter.

Returns:

a FullTextFilter object.

disableFullTextFilter

CacheQuery disableFullTextFilter(String name)

Disable a given filter by its name.

Parameters:

name - of filter.

filter

CacheQuery filter(org.apache.lucene.search.Filter f)

Allows lucene to filter the results.

Parameters:

f - - lucene filter

timeout

CacheQuery timeout(long timeout,
                 TimeUnit timeUnit)

Set the timeout for this query. If the query hasn't finished processing before the timeout, an exception will be thrown.

Parameters:

timeout - the timeout duration

timeUnit - the time unit of the timeout parameter

Returns: