Package org.hibernate.search.engine.search.query.dsl.spi

Class AbstractExtendedSearchQueryOptionsStep<SR,S extends SearchQueryOptionsStep<SR,S,H,LOS,SF,AF>,H,R extends SearchResult<H>,SCR extends SearchScroll<H>,LOS,PDF extends TypedSearchPredicateFactory<SR>,SF extends TypedSearchSortFactory<SR>,AF extends TypedSearchAggregationFactory<SR>,SC extends SearchQueryIndexScope<SR,?>>

java.lang.Object

org.hibernate.search.engine.search.query.dsl.spi.AbstractSearchQueryOptionsStep<SR,S,H,LOS,PDF,SF,AF,SC>

org.hibernate.search.engine.search.query.dsl.spi.AbstractExtendedSearchQueryOptionsStep<SR,S,H,R,SCR,LOS,PDF,SF,AF,SC>

All Implemented Interfaces:

SearchQueryFinalStep<H>, SearchQueryOptionsStep<SR,S,H,LOS,SF,AF>, SearchQueryWhereStep<SR,S,H,LOS,PDF>, SearchFetchable<H>

public abstract class AbstractExtendedSearchQueryOptionsStep<SR,S extends SearchQueryOptionsStep<SR,S,H,LOS,SF,AF>,H,R extends SearchResult<H>,SCR extends SearchScroll<H>,LOS,PDF extends TypedSearchPredicateFactory<SR>,SF extends TypedSearchSortFactory<SR>,AF extends TypedSearchAggregationFactory<SR>,SC extends SearchQueryIndexScope<SR,?>>
extends AbstractSearchQueryOptionsStep<SR,S,H,LOS,PDF,SF,AF,SC>

Field Summary

Fields inherited from class org.hibernate.search.engine.search.query.dsl.spi.AbstractSearchQueryOptionsStep

scope

Constructor Summary

Constructors

Constructor	Description
AbstractExtendedSearchQueryOptionsStep(SC scope, SearchQueryBuilder<H> searchQueryBuilder, SearchLoadingContextBuilder<?,LOS> loadingContextBuilder)

Method Summary

Modifier and Type	Method	Description
R	fetch(Integer limit)	Execute the query and return the SearchResult, limiting to limit hits.
R	fetch(Integer offset, Integer limit)	Execute the query and return the SearchResult, skipping offset hits and limiting to limit hits.
R	fetchAll()	Execute the query and return the SearchResult, including all hits, without any sort of limit.
SCR	scroll(int chunkSize)	Execute the query continuously to deliver results in small chunks through a SearchScroll.
abstract ExtendedSearchQuery<H,R,SCR>	toQuery()	Create a SearchQuery instance matching the definition given in the previous DSL steps.

Methods inherited from class org.hibernate.search.engine.search.query.dsl.spi.AbstractSearchQueryOptionsStep

aggregation, aggregation, aggregationFactory, failAfter, fetchAllHits, fetchHits, fetchHits, fetchSingleHit, fetchTotalHitCount, highlighter, highlighter, highlighter, highlighter, highlighterFactory, loading, param, predicateFactory, routing, routing, sort, sort, sortFactory, thisAsS, totalHitCountThreshold, truncateAfter, where, where, where

Methods inherited from class java.lang.Object

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

Constructor Details

AbstractExtendedSearchQueryOptionsStep

public AbstractExtendedSearchQueryOptionsStep(SC scope,
 SearchQueryBuilder<H> searchQueryBuilder,
 SearchLoadingContextBuilder<?,LOS> loadingContextBuilder)

Method Details

toQuery

public abstract ExtendedSearchQuery<H,R,SCR> toQuery()

Description copied from interface: SearchQueryFinalStep

Create a SearchQuery instance matching the definition given in the previous DSL steps.

Calling this method is generally not necessary as most query execution methods are also implemented by this DSL step, so for example .toQuery().fetch() can be replaced with simply .fetch().

Specified by:

toQuery in interface SearchQueryFinalStep<SR>

Overrides:

toQuery in class AbstractSearchQueryOptionsStep<SR,S extends SearchQueryOptionsStep<SR,S,H,LOS,SF,AF>,H,LOS,PDF extends TypedSearchPredicateFactory<SR>,SF extends TypedSearchSortFactory<SR>,AF extends TypedSearchAggregationFactory<SR>,SC extends SearchQueryIndexScope<SR,?>>

Returns:

The SearchQuery resulting from the previous DSL steps.

fetchAll

public R fetchAll()

Description copied from interface: SearchFetchable

Execute the query and return the SearchResult, including all hits, without any sort of limit.

SearchFetchable.fetch(Integer) or SearchFetchable.fetch(Integer, Integer) should generally be preferred, for performance reasons.

Specified by:

fetchAll in interface SearchFetchable<SR>

Overrides:

fetchAll in class AbstractSearchQueryOptionsStep<SR,S extends SearchQueryOptionsStep<SR,S,H,LOS,SF,AF>,H,LOS,PDF extends TypedSearchPredicateFactory<SR>,SF extends TypedSearchSortFactory<SR>,AF extends TypedSearchAggregationFactory<SR>,SC extends SearchQueryIndexScope<SR,?>>

Returns:

The SearchResult.

fetch

public R fetch(Integer limit)

Description copied from interface: SearchFetchable

Execute the query and return the SearchResult, limiting to limit hits.

Specified by:

fetch in interface SearchFetchable<SR>

Overrides:

fetch in class AbstractSearchQueryOptionsStep<SR,S extends SearchQueryOptionsStep<SR,S,H,LOS,SF,AF>,H,LOS,PDF extends TypedSearchPredicateFactory<SR>,SF extends TypedSearchSortFactory<SR>,AF extends TypedSearchAggregationFactory<SR>,SC extends SearchQueryIndexScope<SR,?>>

Parameters:

limit - The maximum number of hits to be included in the SearchResult. null means no limit.

Returns:

The SearchResult.

fetch

public R fetch(Integer offset,
 Integer limit)

Description copied from interface: SearchFetchable

Execute the query and return the SearchResult, skipping offset hits and limiting to limit hits.

Specified by:

fetch in interface SearchFetchable<SR>

Overrides:

fetch in class AbstractSearchQueryOptionsStep<SR,S extends SearchQueryOptionsStep<SR,S,H,LOS,SF,AF>,H,LOS,PDF extends TypedSearchPredicateFactory<SR>,SF extends TypedSearchSortFactory<SR>,AF extends TypedSearchAggregationFactory<SR>,SC extends SearchQueryIndexScope<SR,?>>

Parameters:

offset - The number of hits to skip before adding the hits to the SearchResult. null means no offset.

limit - The maximum number of hits to be included in the SearchResult. null means no limit.

Returns:

The SearchResult.

scroll

public SCR scroll(int chunkSize)

Description copied from interface: SearchFetchable

Execute the query continuously to deliver results in small chunks through a SearchScroll.

Useful to process large datasets.

Specified by:

scroll in interface SearchFetchable<SR>

Overrides:

scroll in class AbstractSearchQueryOptionsStep<SR,S extends SearchQueryOptionsStep<SR,S,H,LOS,SF,AF>,H,LOS,PDF extends TypedSearchPredicateFactory<SR>,SF extends TypedSearchSortFactory<SR>,AF extends TypedSearchAggregationFactory<SR>,SC extends SearchQueryIndexScope<SR,?>>

Parameters:

chunkSize - The maximum number of hits to be returned for each call to SearchScroll.next()

Returns:

The SearchScroll.