org.hibernate.search.query.engine.impl

Class AbstractHSQuery

java.lang.Object

org.hibernate.search.query.engine.impl.AbstractHSQuery

All Implemented Interfaces:

Serializable, ProjectionConstants, HSQuery

Direct Known Subclasses:

LuceneHSQuery

public abstract class AbstractHSQuery
extends Object
implements HSQuery, Serializable

Base class for HSQuery implementations, exposing basic state needed by all implementations.

Author:

Gunnar Morling

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected ExtendedSearchIntegrator	extendedIntegrator
protected Map<String,FullTextFilterImpl>	filterDefinitions The map of currently active/enabled filters.
protected int	firstResult
protected Set<Class<?>>	indexedTargetedEntities
protected Integer	maxResults
protected String[]	projectedFields
protected org.apache.lucene.search.Sort	sort
protected String	spatialFieldName
protected Coordinates	spatialSearchCenter
protected List<Class<?>>	targetedEntities
protected String	tenantId
protected TimeoutExceptionFactory	timeoutExceptionFactory
protected TimeoutManagerImpl	timeoutManager
protected org.apache.lucene.search.Filter	userFilter User specified filters.

Fields inherited from interface org.hibernate.search.engine.ProjectionConstants

DOCUMENT, DOCUMENT_ID, EXPLANATION, ID, OBJECT_CLASS, SCORE, SPATIAL_DISTANCE, THIS

Constructor Summary

Constructors

Constructor and Description
AbstractHSQuery(ExtendedSearchIntegrator extendedIntegrator)

Method Summary

Modifier and Type	Method and Description
void	afterDeserialise(SearchIntegrator extendedIntegrator) afterDeserialise.
protected abstract TimeoutManagerImpl	buildTimeoutManager()
protected abstract void	clearCachedResults()
void	disableFullTextFilter(String name) Disable a given filter by its name.
FullTextFilter	enableFullTextFilter(String name) Enable a given filter by its name.
HSQuery	filter(org.apache.lucene.search.Filter filter) Allows to use lucene filters.
HSQuery	firstResult(int firstResult) Set the first element to retrieve.
ExtendedSearchIntegrator	getExtendedSearchIntegrator() getExtendedSearchIntegrator.
Set<Class<?>>	getIndexedTargetedEntities() Set of indexed entities corresponding to the class hierarchy of the targeted entities
String[]	getProjectedFields()
List<Class<?>>	getTargetedEntities() List of targeted entities as described by the user
TimeoutManagerImpl	getTimeoutManager()
HSQuery	maxResults(int maxResults) Set the maximum number of elements to retrieve.
HSQuery	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" (similar to an HQL or a Criteria API projection).
HSQuery	setSpatialParameters(Coordinates center, String fieldName) setSpatialParameters.
HSQuery	sort(org.apache.lucene.search.Sort sort) Lets Lucene sort the results.
HSQuery	targetedEntities(List<Class<?>> classes) Defines the targeted entities.
HSQuery	tenantIdentifier(String tenantId)
HSQuery	timeoutExceptionFactory(TimeoutExceptionFactory exceptionFactory) Define the timeout exception factory to customize the exception returned by the user.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.hibernate.search.query.engine.spi.HSQuery

explain, getFacetManager, getLuceneQuery, luceneQuery, queryDocumentExtractor, queryEntityInfos, queryResultSize

Field Detail

extendedIntegrator

protected transient ExtendedSearchIntegrator extendedIntegrator

timeoutExceptionFactory

protected transient TimeoutExceptionFactory timeoutExceptionFactory

timeoutManager

protected transient TimeoutManagerImpl timeoutManager

targetedEntities

protected List<Class<?>> targetedEntities

indexedTargetedEntities

protected Set<Class<?>> indexedTargetedEntities

sort

protected org.apache.lucene.search.Sort sort

tenantId

protected String tenantId

projectedFields

protected String[] projectedFields

firstResult

protected int firstResult

maxResults

protected Integer maxResults

spatialSearchCenter

protected Coordinates spatialSearchCenter

spatialFieldName

protected String spatialFieldName

userFilter

protected org.apache.lucene.search.Filter userFilter

User specified filters. Will be combined into a single chained filter filter(org.apache.lucene.search.Filter).

filterDefinitions

protected final Map<String,FullTextFilterImpl> filterDefinitions

The map of currently active/enabled filters.

Constructor Detail

AbstractHSQuery

public AbstractHSQuery(ExtendedSearchIntegrator extendedIntegrator)

Method Detail

afterDeserialise

public void afterDeserialise(SearchIntegrator extendedIntegrator)

Description copied from interface: HSQuery

afterDeserialise.

Specified by:

afterDeserialise in interface HSQuery

Parameters:

extendedIntegrator - a SearchIntegrator object.

setSpatialParameters

public HSQuery setSpatialParameters(Coordinates center,
                                    String fieldName)

Description copied from interface: HSQuery

setSpatialParameters.

Specified by:

setSpatialParameters in interface HSQuery

Parameters:

center - center of the spatial search

fieldName - name ot the spatial field

Returns:

this to allow for method chaining

tenantIdentifier

public HSQuery tenantIdentifier(String tenantId)

Specified by:

tenantIdentifier in interface HSQuery

targetedEntities

public HSQuery targetedEntities(List<Class<?>> classes)

Description copied from interface: HSQuery

Defines the targeted entities. This helps to reduce the number of targeted indexes.

Specified by:

targetedEntities in interface HSQuery

Parameters:

classes - the list of classes (indexes) targeted by this query

Returns:

this to allow for method chaining

sort

public HSQuery sort(org.apache.lucene.search.Sort sort)

Description copied from interface: HSQuery

Lets Lucene sort the results. This is useful when you have different sort requirements than the default Lucene ranking. Without Lucene sorting you would have to retrieve the full result set and order the Hibernate objects.

Specified by:

sort in interface HSQuery

Parameters:

sort - The Lucene sort object.

Returns:

this to allow for method chaining

filter

public HSQuery filter(org.apache.lucene.search.Filter filter)

Description copied from interface: HSQuery

Allows to use lucene filters. Semi-deprecated? a preferred way is to use the @FullTextFilterDef approach

Specified by:

filter in interface HSQuery

Parameters:

filter - The Lucene filter.

Returns:

this to allow for method chaining

timeoutExceptionFactory

public HSQuery timeoutExceptionFactory(TimeoutExceptionFactory exceptionFactory)

Description copied from interface: HSQuery

Define the timeout exception factory to customize the exception returned by the user. Defaults to returning QueryTimeoutException

Specified by:

timeoutExceptionFactory in interface HSQuery

Parameters:

exceptionFactory - the timeout exception factory to use

Returns:

this to allow for method chaining

projection

public HSQuery projection(String... fields)

Description copied from interface: HSQuery

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" (similar to an HQL or a Criteria API projection).

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[]

Specified by:

projection in interface HSQuery

Parameters:

fields - the projected field names

Returns:

this to allow for method chaining

firstResult

public HSQuery firstResult(int firstResult)

Description copied from interface: HSQuery

Set the first element to retrieve. If not set, elements will be retrieved beginning from element 0.

Specified by:

firstResult in interface HSQuery

Parameters:

firstResult - a element number, numbered from 0

Returns:

this to allow for method chaining

maxResults

public HSQuery maxResults(int maxResults)

Description copied from interface: HSQuery

Set the maximum number of elements to retrieve. If not set, there is no limit to the number of elements retrieved.

Specified by:

maxResults in interface HSQuery

Parameters:

maxResults - the maximum number of elements

Returns:

this in order to allow method chaining

enableFullTextFilter

public FullTextFilter enableFullTextFilter(String name)

Description copied from interface: HSQuery

Enable a given filter by its name.

Specified by:

enableFullTextFilter in interface HSQuery

Parameters:

name - the name of the filter to enable

Returns:

Returns a FullTextFilter object that allows filter parameter injection

disableFullTextFilter

public void disableFullTextFilter(String name)

Description copied from interface: HSQuery

Disable a given filter by its name.

Specified by:

disableFullTextFilter in interface HSQuery

Parameters:

name - the name of the filter to disable.

getTargetedEntities

public List<Class<?>> getTargetedEntities()

List of targeted entities as described by the user

Specified by:

getTargetedEntities in interface HSQuery

Returns:

the targeted entity types

getIndexedTargetedEntities

public Set<Class<?>> getIndexedTargetedEntities()

Set of indexed entities corresponding to the class hierarchy of the targeted entities

Specified by:

getIndexedTargetedEntities in interface HSQuery

Returns:

a set of indexed entities corresponding to the class hierarchy of the targeted entities

getProjectedFields

public String[] getProjectedFields()

Specified by:

getProjectedFields in interface HSQuery

Returns:

the projected field names

getTimeoutManager

public TimeoutManagerImpl getTimeoutManager()

Specified by:

getTimeoutManager in interface HSQuery

Returns:

the timeout manager. Make sure to wrap your HSQuery usage around a timeoutManager.start() and timeoutManager.stop().

getExtendedSearchIntegrator

public ExtendedSearchIntegrator getExtendedSearchIntegrator()

Description copied from interface: HSQuery

getExtendedSearchIntegrator.

Specified by:

getExtendedSearchIntegrator in interface HSQuery

Returns:

the ExtendedSearchintegrator instance

clearCachedResults

protected abstract void clearCachedResults()

buildTimeoutManager

protected abstract TimeoutManagerImpl buildTimeoutManager()