org.hibernate.search.query.hibernate.impl

Class FullTextQueryImpl<R>

java.lang.Object

org.hibernate.query.internal.AbstractProducedQuery<R>

org.hibernate.search.query.hibernate.impl.FullTextQueryImpl<R>

All Implemented Interfaces:

javax.persistence.Query, javax.persistence.TypedQuery<R>, org.hibernate.BasicQueryContract, org.hibernate.query.CommonQueryContract, org.hibernate.query.spi.QueryImplementor<R>, ProjectionConstants, FullTextQuery<R>

public class FullTextQueryImpl<R>
extends org.hibernate.query.internal.AbstractProducedQuery<R>
implements FullTextQuery<R>

Implementation of FullTextQuery.

Author:

Emmanuel Bernard, Hardy Ferentschik

Field Summary

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
FullTextQueryImpl(HSQuery hSearchQuery, org.hibernate.engine.spi.SessionImplementor session, org.hibernate.query.ParameterMetadata parameterMetadata) Constructs a FullTextQueryImpl instance.

Method Summary

Modifier and Type	Method and Description
void	disableFullTextFilter(String name) Disable a given filter by its name.
FullTextFilter	enableFullTextFilter(String name) Enable a given filter by its name.
int	executeUpdate()
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
FacetManager	getFacetManager()
protected Map	getLockModes()
org.hibernate.LockOptions	getLockOptions()
String	getQueryString()
List<R>	getResultList()
int	getResultSize()
String[]	getReturnAliases()
org.hibernate.type.Type[]	getReturnTypes()
boolean	hasPartialResults() Experimental API, subject to change or removal
FullTextQuery	initializeObjectsWith(ObjectLookupMethod lookupMethod, DatabaseRetrievalMethod retrievalMethod) Refine the strategies used to load entities.
protected boolean	isNativeQuery()
Iterator	iterate() Return an iterator on the results.
FullTextQuery	limitExecutionTimeTo(long timeout, TimeUnit timeUnit) *Experimental* API, subject to change or removal Limit the time used by Hibernate Search to execute the query.
List	list()
ScrollableResultsImpl	scroll()
org.hibernate.query.spi.ScrollableResultsImplementor	scroll(org.hibernate.ScrollMode scrollMode)
FullTextQuery	setCriteriaQuery(org.hibernate.Criteria criteria) Defines the Database Query used to load the Lucene results.
org.hibernate.Query	setEntity(int position, Object val)
org.hibernate.Query	setEntity(String name, Object val)
FullTextQuery	setFetchSize(int fetchSize) Defines scrollable result fetch size as well as the JDBC fetch size
FullTextQuery	setFilter(org.apache.lucene.search.Filter filter) Allows to set a single Lucene filter.
FullTextQuery	setFirstResult(int firstResult) Query.setFirstResult(int)
org.hibernate.query.spi.QueryImplementor	setLockMode(String alias, org.hibernate.LockMode lockMode)
org.hibernate.query.spi.QueryImplementor	setLockOptions(org.hibernate.LockOptions lockOptions)
FullTextQuery	setMaxResults(int maxResults) Query.setMaxResults(int)
FullTextQuery	setProjection(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).
FullTextQuery	setResultTransformer(org.hibernate.transform.ResultTransformer transformer) defines a result transformer used during projection, the Aliases provided are the projection aliases.
FullTextQuery	setSort(org.apache.lucene.search.Sort sort) Allows to let lucene sort the results.
FullTextQuery	setSpatialParameters(Coordinates center, String fieldName) Defines the center of the spatial search for this query to project distance in results
FullTextQuery	setSpatialParameters(double latitude, double longitude, String fieldName) Defines the center of the spatial search for this query to project distance in results
FullTextQuery	setTimeout(int timeout)
FullTextQuery	setTimeout(long timeout, TimeUnit timeUnit) Define a timeout period for a given unit of time.
String	toString()
<T> T	unwrap(Class<T> type)

Methods inherited from class org.hibernate.query.internal.AbstractProducedQuery

addQueryHint, afterQuery, applyAliasSpecificLockModeHint, applyCacheableHint, applyCacheModeHint, applyCacheRegionHint, applyCommentHint, applyEntityGraphQueryHint, applyFetchSizeHint, applyFlushModeHint, applyFollowOnLockingHint, applyHibernateLockModeHint, applyJpaCacheRetrieveMode, applyJpaCacheStoreMode, applyLockModeTypeHint, applyLockTimeoutHint, applyNativeQueryLockMode, applyReadOnlyHint, applyTimeoutHint, beforeQuery, canApplyAliasSpecificLockModeHints, collectBaselineHints, collectHints, determineProperBooleanType, determineProperBooleanType, determineType, doExecuteUpdate, doIterate, doList, doScroll, getCacheMode, getCacheRegion, getComment, getExceptionConverter, getFetchSize, getFirstResult, getFlushMode, getHibernateFlushMode, getHints, getLockMode, getMaxResults, getNamedParameterMap, getNamedParameters, getParameter, getParameter, getParameter, getParameter, getParameterMetadata, getParameters, getParameterValue, getParameterValue, getParameterValue, getPositionalParameterTypes, getPositionalParameterValues, getProducer, getQueryOptions, getQueryParameterBindings, getQueryParameters, getSingleResult, getSupportedHints, getTimeout, isBound, isCacheable, isCallable, isReadOnly, putIfNotNull, putIfNotNull, resolveEntityName, setCacheable, setCacheMode, setCacheRegion, setComment, setFlushMode, setFlushMode, setHibernateFlushMode, setHint, setLockMode, setOptionalEntityName, setOptionalId, setOptionalObject, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameterList, setParameterList, setParameterList, setParameterList, setParameterList, setProperties, setProperties, setReadOnly, stream, uniqueElement, uniqueResult, uniqueResultOptional

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.hibernate.query.spi.QueryImplementor

getProducer, setOptionalEntityName, setOptionalId, setOptionalObject

Methods inherited from interface org.hibernate.query.Query

getQueryOptions, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, stream, uniqueResultOptional

Methods inherited from interface org.hibernate.Query

determineProperBooleanType, determineProperBooleanType, getCacheMode, getCacheRegion, getComment, getFetchSize, getFlushMode, getHibernateFlushMode, getNamedParameters, getParameterMetadata, getSingleResult, getTimeout, isCacheable, isReadOnly, setBigDecimal, setBigDecimal, setBigInteger, setBigInteger, setBinary, setBinary, setBoolean, setBoolean, setByte, setByte, setCalendar, setCalendar, setCalendarDate, setCalendarDate, setCharacter, setCharacter, setDate, setDate, setDouble, setDouble, setFloat, setFloat, setInteger, setInteger, setLocale, setLocale, setLong, setLong, setParameter, setParameter, setParameter, setParameter, setParameter, setParameter, setParameterList, setParameterList, setParameterList, setParameterList, setParameterList, setParameters, setProperties, setProperties, setSerializable, setSerializable, setShort, setShort, setString, setString, setText, setText, setTime, setTime, setTimestamp, setTimestamp, uniqueResult

Methods inherited from interface javax.persistence.Query

getFirstResult, getHints, getLockMode, getMaxResults, getParameter, getParameter, getParameter, getParameter, getParameters, getParameterValue, getParameterValue, getParameterValue, isBound

Constructor Detail

FullTextQueryImpl

public FullTextQueryImpl(HSQuery hSearchQuery,
                         org.hibernate.engine.spi.SessionImplementor session,
                         org.hibernate.query.ParameterMetadata parameterMetadata)

Constructs a FullTextQueryImpl instance.

Parameters:

hSearchQuery - The query, with the targeted entities already set if necessary.

session - Access to the Hibernate session.

parameterMetadata - Additional query metadata.

Method Detail

setSort

public FullTextQuery setSort(org.apache.lucene.search.Sort sort)

Description copied from interface: FullTextQuery

Allows to let lucene sort the results. This is useful when you have additional sort requirements on top of the default lucene ranking. Without lucene sorting you would have to retrieve the full result set and order the hibernate objects.

Specified by:

setSort in interface FullTextQuery<R>

Parameters:

sort - The lucene sort object.

Returns:

this for method chaining

setFilter

public FullTextQuery setFilter(org.apache.lucene.search.Filter filter)

Description copied from interface: FullTextQuery

Allows to set a single Lucene filter.

Specified by:

setFilter in interface FullTextQuery<R>

Parameters:

filter - The Lucene filter.

Returns:

this for method chaining

See Also:

Filter

getResultList

public List<R> getResultList()

Specified by:

getResultList in interface javax.persistence.Query

Specified by:

getResultList in interface javax.persistence.TypedQuery<R>

iterate

public Iterator iterate()

Return an iterator on the results. Retrieve the object one by one (initialize it during the next() operation)

Overrides:

iterate in class org.hibernate.query.internal.AbstractProducedQuery<R>

scroll

public ScrollableResultsImpl scroll()

Overrides:

scroll in class org.hibernate.query.internal.AbstractProducedQuery<R>

scroll

public org.hibernate.query.spi.ScrollableResultsImplementor scroll(org.hibernate.ScrollMode scrollMode)

Overrides:

scroll in class org.hibernate.query.internal.AbstractProducedQuery<R>

list

public List list()

Overrides:

list in class org.hibernate.query.internal.AbstractProducedQuery<R>

explain

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

Description copied from interface: FullTextQuery

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

Specified by:

explain in interface FullTextQuery<R>

Parameters:

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

Returns:

An Lucene Explanation instance

getResultSize

public int getResultSize()

Specified by:

getResultSize in interface FullTextQuery<R>

Returns:

the number of hits for this search.

Caution: The number of results might be slightly different from list().size() because list() if the index is not in sync with the database at the time of query.

setCriteriaQuery

public FullTextQuery setCriteriaQuery(org.hibernate.Criteria criteria)

Description copied from interface: FullTextQuery

Defines the Database Query used to load the Lucene results. Useful to load a given object graph by refining the fetch modes.

• No projection (criteria.setProjection()) allowed, the root entity must be the only returned type
• No where restriction can be defined either

Specified by:

setCriteriaQuery in interface FullTextQuery<R>

Parameters:

criteria - Hibernate criteria query used to load results

Returns:

this for method chaining

setProjection

public FullTextQuery setProjection(String... fields)

Description copied from interface: FullTextQuery

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:

setProjection in interface FullTextQuery<R>

Parameters:

fields - list of field names to project on

Returns:

this for method chaining

setSpatialParameters

public FullTextQuery setSpatialParameters(Coordinates center,
                                          String fieldName)

Description copied from interface: FullTextQuery

Defines the center of the spatial search for this query to project distance in results

Specified by:

setSpatialParameters in interface FullTextQuery<R>

Parameters:

center - the search center

fieldName - name of the spatial field

Returns:

this for method chaining

setSpatialParameters

public FullTextQuery setSpatialParameters(double latitude,
                                          double longitude,
                                          String fieldName)

Description copied from interface: FullTextQuery

Defines the center of the spatial search for this query to project distance in results

Specified by:

setSpatialParameters in interface FullTextQuery<R>

Parameters:

latitude - latitude of the search center

longitude - longitude of the search center

fieldName - name of the spatial field

Returns:

this for method chaining

setFirstResult

public FullTextQuery setFirstResult(int firstResult)

Description copied from interface: FullTextQuery

Query.setFirstResult(int)

Specified by:

setFirstResult in interface javax.persistence.Query

Specified by:

setFirstResult in interface javax.persistence.TypedQuery<R>

Specified by:

setFirstResult in interface FullTextQuery<R>

Overrides:

setFirstResult in class org.hibernate.query.internal.AbstractProducedQuery<R>

setMaxResults

public FullTextQuery setMaxResults(int maxResults)

Description copied from interface: FullTextQuery

Query.setMaxResults(int)

Specified by:

setMaxResults in interface javax.persistence.Query

Specified by:

setMaxResults in interface javax.persistence.TypedQuery<R>

Specified by:

setMaxResults in interface FullTextQuery<R>

Overrides:

setMaxResults in class org.hibernate.query.internal.AbstractProducedQuery<R>

setFetchSize

public FullTextQuery setFetchSize(int fetchSize)

Description copied from interface: FullTextQuery

Defines scrollable result fetch size as well as the JDBC fetch size

Specified by:

setFetchSize in interface org.hibernate.BasicQueryContract

Specified by:

setFetchSize in interface FullTextQuery<R>

Overrides:

setFetchSize in class org.hibernate.query.internal.AbstractProducedQuery<R>

setLockOptions

public org.hibernate.query.spi.QueryImplementor setLockOptions(org.hibernate.LockOptions lockOptions)

Overrides:

setLockOptions in class org.hibernate.query.internal.AbstractProducedQuery<R>

setResultTransformer

public FullTextQuery setResultTransformer(org.hibernate.transform.ResultTransformer transformer)

Description copied from interface: FullTextQuery

defines a result transformer used during projection, the Aliases provided are the projection aliases.

Specified by:

setResultTransformer in interface FullTextQuery<R>

Overrides:

setResultTransformer in class org.hibernate.query.internal.AbstractProducedQuery<R>

unwrap

public <T> T unwrap(Class<T> type)

Specified by:

unwrap in interface javax.persistence.Query

Specified by:

unwrap in interface FullTextQuery<R>

Overrides:

unwrap in class org.hibernate.query.internal.AbstractProducedQuery<R>

Type Parameters:

T - the type of the unwrapped object

Parameters:

type - the type to unwrap

Returns:

the underlying type if possible. If not possible to unwrap to the given type an IllegalArgumentException is thrown. Supported types are:

• org.apache.lucene.search.Query the underlying lucene query

getLockOptions

public org.hibernate.LockOptions getLockOptions()

Overrides:

getLockOptions in class org.hibernate.query.internal.AbstractProducedQuery<R>

executeUpdate

public int executeUpdate()

Specified by:

executeUpdate in interface javax.persistence.Query

Overrides:

executeUpdate in class org.hibernate.query.internal.AbstractProducedQuery<R>

setLockMode

public org.hibernate.query.spi.QueryImplementor setLockMode(String alias,
                                                            org.hibernate.LockMode lockMode)

Overrides:

setLockMode in class org.hibernate.query.internal.AbstractProducedQuery<R>

getLockModes

protected Map getLockModes()

enableFullTextFilter

public FullTextFilter enableFullTextFilter(String name)

Description copied from interface: FullTextQuery

Enable a given filter by its name.

Specified by:

enableFullTextFilter in interface FullTextQuery<R>

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: FullTextQuery

Disable a given filter by its name.

Specified by:

disableFullTextFilter in interface FullTextQuery<R>

Parameters:

name - the name of the filter to disable.

getFacetManager

public FacetManager getFacetManager()

Specified by:

getFacetManager in interface FullTextQuery<R>

Returns:

return the manager for all faceting related operations

setTimeout

public FullTextQuery setTimeout(int timeout)

Specified by:

setTimeout in interface org.hibernate.BasicQueryContract

Overrides:

setTimeout in class org.hibernate.query.internal.AbstractProducedQuery<R>

setTimeout

public FullTextQuery setTimeout(long timeout,
                                TimeUnit timeUnit)

Description copied from interface: FullTextQuery

Define a timeout period for a given unit of time. Note that this is time out is on a best effort basis. When the query goes beyond the timeout, a QueryTimeoutException is raised.

Specified by:

setTimeout in interface FullTextQuery<R>

Parameters:

timeout - time out period

timeUnit - time out unit

Returns:

this to allow method chaining

limitExecutionTimeTo

public FullTextQuery limitExecutionTimeTo(long timeout,
                                          TimeUnit timeUnit)

Description copied from interface: FullTextQuery

*Experimental* API, subject to change or removal Limit the time used by Hibernate Search to execute the query. When the limit is reached, results already fetched are returned. This time limit is a best effort. The query will likely run for longer than the provided time. The time limit only applies to the interactions between Hibernate Search and Lucene. In other words, a query to the database will not be limited. If the limit is reached and all results are not yet fetched, FullTextQuery.hasPartialResults() returns true.

Specified by:

limitExecutionTimeTo in interface FullTextQuery<R>

Parameters:

timeout - time out period

timeUnit - time out unit

Returns:

this to allow method chaining

hasPartialResults

public boolean hasPartialResults()

Description copied from interface: FullTextQuery

Experimental API, subject to change or removal

Specified by:

hasPartialResults in interface FullTextQuery<R>

Returns:

When using FullTextQuery.limitExecutionTimeTo(long, java.util.concurrent.TimeUnit) }, returns true if partial results are returned (ie if the time limit has been reached and the result fetching process has been terminated.

initializeObjectsWith

public FullTextQuery initializeObjectsWith(ObjectLookupMethod lookupMethod,
                                           DatabaseRetrievalMethod retrievalMethod)

Description copied from interface: FullTextQuery

Refine the strategies used to load entities. The lookup method defines whether or not to lookup first in the second level cache or the persistence context before trying to initialize objects from the database. Defaults to SKIP. The database retrieval method defines how objects are loaded from the database. Defaults to QUERY. Note that Hibernate Search can deviate from these choices when it makes sense.

Specified by:

initializeObjectsWith in interface FullTextQuery<R>

Parameters:

lookupMethod - the lookuip strategy

retrievalMethod - the retrieval strategy

Returns:

this to allow method chaining

getQueryString

public String getQueryString()

isNativeQuery

protected boolean isNativeQuery()

Specified by:

isNativeQuery in class org.hibernate.query.internal.AbstractProducedQuery<R>

getReturnTypes

public org.hibernate.type.Type[] getReturnTypes()

Specified by:

getReturnTypes in interface org.hibernate.BasicQueryContract

getReturnAliases

public String[] getReturnAliases()

setEntity

public org.hibernate.Query setEntity(int position,
                                     Object val)

setEntity

public org.hibernate.Query setEntity(String name,
                                     Object val)

toString

public String toString()

Overrides:

toString in class Object