org.jboss.cache.search
Interface CacheQuery

All Superinterfaces:

Iterable

All Known Implementing Classes:

CacheQueryImpl

public interface CacheQuery
extends Iterable

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

Author:

Manik Surtani (manik@jboss.org)

See Also:

SearchableCache.createQuery(org.apache.lucene.search.Query)

Method Summary

void	disableFullTextFilter(String name) Disable a given filter by its name.
org.hibernate.search.FullTextFilter	enableFullTextFilter(String name) Enable a given filter by its name.
int	getResultSize() Gets the integer number of results.
QueryResultIterator	iterator() Returns the results of a search as a QueryResultIterator.
QueryResultIterator	lazyIterator() Lazily loads the results from the Query as a QueryResultIterator
List<Object>	list() Returns the results of a search as a list.
void	setFetchSize(int size) Defines scrollable result fetch size
void	setFilter(org.apache.lucene.search.Filter f) Allows lucene to filter the results.
void	setFirstResult(int index) Sets a result with a given index to the first result.
void	setMaxResults(int numResults) Sets the maximum number of results to the number passed in as a parameter.
void	setSort(org.apache.lucene.search.Sort s) Allows lucene to sort the results.

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

QueryResultIterator iterator()

Returns the results of a search as a QueryResultIterator.

Specified by:

iterator in interface Iterable

Returns:

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

lazyIterator

QueryResultIterator lazyIterator()

Lazily loads the results from the Query as a QueryResultIterator

Returns:

a QueryResultIterator which can be used to lazily iterate through results.

setFirstResult

void setFirstResult(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.

setMaxResults

void setMaxResults(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.

setFetchSize

void setFetchSize(int size)

Defines scrollable result fetch size

Parameters:

size - to be set

getResultSize

int getResultSize()

Gets the integer number of results.

Returns:

integer number of results.

setSort

void setSort(org.apache.lucene.search.Sort s)

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

Parameters:

s - - lucene sort object

enableFullTextFilter

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

Enable a given filter by its name.

Parameters:

name - of filter.

Returns:

a FullTextFilter object.

disableFullTextFilter

void disableFullTextFilter(String name)

Disable a given filter by its name.

Parameters:

name - of filter.

setFilter

void setFilter(org.apache.lucene.search.Filter f)

Allows lucene to filter the results.

Parameters:

f - - lucene filter