AbstractSearchQueryOptionsStep (Hibernate Search Engine 6.0.0.Alpha9 API)

java.lang.Object
- org.hibernate.search.engine.search.dsl.query.spi.AbstractSearchQueryOptionsStep<S,H,PDF,SF,C>

All Implemented Interfaces:: SearchQueryFinalStep<H>, SearchQueryOptionsStep<S,H,SF>, SearchQueryPredicateStep<S,H,PDF>, SearchFetchable<H>

Direct Known Subclasses:: AbstractExtendedSearchQueryOptionsStep

public abstract class AbstractSearchQueryOptionsStep<S extends SearchQueryOptionsStep<S,H,SF>,H,PDF extends SearchPredicateFactory,SF extends SearchSortFactory,C>
extends Object
implements SearchQueryPredicateStep<S,H,PDF>, SearchQueryOptionsStep<S,H,SF>

Constructor Summary

Constructors
Constructor and Description

AbstractSearchQueryOptionsStep(IndexScope<C> indexScope, SearchQueryBuilder<H,C> searchQueryBuilder)

Constructors
Constructor and Description
`AbstractSearchQueryOptionsStep(IndexScope<C> indexScope, SearchQueryBuilder<H,C> searchQueryBuilder)`

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`protected abstract PDF`	`extendPredicateFactory(SearchPredicateFactory predicateFactory)`
`protected abstract SF`	`extendSortFactory(SearchSortFactory sortFactory)`
`SearchResult<H>`	`fetch()` Execute the query and return the `SearchResult`.
`SearchResult<H>`	`fetch(Integer limit)` Execute the query and return the `SearchResult`.
`SearchResult<H>`	`fetch(Integer limit, Integer offset)` Execute the query and return the `SearchResult`.
`List<H>`	`fetchHits()` Execute the query and return the hits as a `List`.
`List<H>`	`fetchHits(Integer limit)` Execute the query and return the hits as a `List`.
`List<H>`	`fetchHits(Integer limit, Integer offset)` Execute the query and return the hits as a `List`.
`Optional<H>`	`fetchSingleHit()` Execute the query and return the hits as a single, optional element.
`long`	`fetchTotalHitCount()` Execute the query and return the total hit count.
`S`	`predicate(Function<? super PDF,? extends PredicateFinalStep> predicateContributor)` Set the predicate for this query.
`S`	`predicate(SearchPredicate predicate)` Set the predicate for this query.
`S`	`routing(Collection<String> routingKeys)` Configure routing of the search query.
`S`	`routing(String routingKey)` Configure routing of the search query.
`S`	`sort(Function<? super SF,? extends SortFinalStep> sortContributor)` Add a sort to this query.
`S`	`sort(SearchSort sort)` Add a sort to this query.
`protected abstract S`	`thisAsS()`
`SearchQuery<H>`	`toQuery()` Create a `SearchQuery` instance matching the definition given in the previous DSL steps.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - AbstractSearchQueryOptionsStep
```
public AbstractSearchQueryOptionsStep(IndexScope<C> indexScope,
                                      SearchQueryBuilder<H,C> searchQueryBuilder)
```
- Method Detail
  - predicate
```
public S predicate(SearchPredicate predicate)
```
    Description copied from interface: SearchQueryPredicateStep
    
    Set the predicate for this query.
    
    Specified by:
    
    predicate in interface SearchQueryPredicateStep<S extends SearchQueryOptionsStep<S,H,SF>,H,PDF extends SearchPredicateFactory>
    
    Parameters:
    
    predicate - A SearchPredicate object obtained from the search scope.
    
    Returns:
    
    The next step.
  - predicate
```
public S predicate(Function<? super PDF,? extends PredicateFinalStep> predicateContributor)
```
    Description copied from interface: SearchQueryPredicateStep
    
    Set the predicate for this query.
    
    Specified by:
    
    predicate in interface SearchQueryPredicateStep<S extends SearchQueryOptionsStep<S,H,SF>,H,PDF extends SearchPredicateFactory>
    
    Parameters:
    
    predicateContributor - A function that will use the factory passed in parameter to create a predicate, returning the final step in the predicate DSL. Should generally be a lambda expression.
    
    Returns:
    
    The next step.
  - routing
```
public S routing(String routingKey)
```
    Description copied from interface: SearchQueryOptionsStep
    
    Configure routing of the search query.
    Useful when indexes are sharded, to limit the number of shards interrogated by the search query.
    This method may be called multiple times, in which case all submitted routing keys will be taken into account.
    By default, if routing is not configured, all shards will be queried.
    
    Specified by:
    
    routing in interface SearchQueryOptionsStep<S extends SearchQueryOptionsStep<S,H,SF>,H,SF extends SearchSortFactory>
    
    Parameters:
    
    routingKey - A string key. All shards matching this key will be queried.
    
    Returns:
    
    this, for method chaining.
  - routing
```
public S routing(Collection<String> routingKeys)
```
    Description copied from interface: SearchQueryOptionsStep
    
    Configure routing of the search query.
    Similar to SearchQueryOptionsStep.routing(String), but allows passing multiple keys in a single call.
    
    Specified by:
    
    routing in interface SearchQueryOptionsStep<S extends SearchQueryOptionsStep<S,H,SF>,H,SF extends SearchSortFactory>
    
    Parameters:
    
    routingKeys - A collection containing zero, one or multiple string keys.
    
    Returns:
    
    this, for method chaining.
  - sort
```
public S sort(SearchSort sort)
```
    Description copied from interface: SearchQueryOptionsStep
    
    Add a sort to this query.
    
    Specified by:
    
    sort in interface SearchQueryOptionsStep<S extends SearchQueryOptionsStep<S,H,SF>,H,SF extends SearchSortFactory>
    
    Parameters:
    
    sort - A SearchSort object obtained from the search scope.
    
    Returns:
    
    this, for method chaining.
  - sort
```
public S sort(Function<? super SF,? extends SortFinalStep> sortContributor)
```
    Description copied from interface: SearchQueryOptionsStep
    
    Add a sort to this query.
    
    Specified by:
    
    sort in interface SearchQueryOptionsStep<S extends SearchQueryOptionsStep<S,H,SF>,H,SF extends SearchSortFactory>
    
    Parameters:
    
    sortContributor - A function that will use the factory passed in parameter to create a sort, returning the final step in the sort DSL. Should generally be a lambda expression.
    
    Returns:
    
    this, for method chaining.
  - toQuery
```
public SearchQuery<H> 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<H>
    
    Returns:
    
    The SearchQuery resulting from the previous DSL steps.
  - fetch
```
public SearchResult<H> fetch()
```
    Description copied from interface: SearchFetchable
    
    Execute the query and return the SearchResult.
    
    Specified by:
    
    fetch in interface SearchFetchable<H>
    
    Returns:
    
    The SearchResult.
  - fetch
```
public SearchResult<H> fetch(Integer limit)
```
    Description copied from interface: SearchFetchable
    
    Execute the query and return the SearchResult.
    
    Specified by:
    
    fetch in interface SearchFetchable<H>
    
    Parameters:
    
    limit - The maximum number of hits to be included in the SearchResult. null means no limit.
    
    Returns:
    
    The SearchResult.
  - fetch
```
public SearchResult<H> fetch(Integer limit,
                             Integer offset)
```
    Description copied from interface: SearchFetchable
    
    Execute the query and return the SearchResult.
    
    Specified by:
    
    fetch in interface SearchFetchable<H>
    
    Parameters:
    
    limit - The maximum number of hits to be included in the SearchResult. null means no limit.
    
    offset - The number of hits to skip before adding the hits to the SearchResult. null means no offset.
    
    Returns:
    
    The SearchResult.
  - fetchHits
```
public List<H> fetchHits()
```
    Description copied from interface: SearchFetchable
    
    Execute the query and return the hits as a List.
    
    Specified by:
    
    fetchHits in interface SearchFetchable<H>
    
    Returns:
    
    The query hits.
  - fetchHits
```
public List<H> fetchHits(Integer limit)
```
    Description copied from interface: SearchFetchable
    
    Execute the query and return the hits as a List.
    
    Specified by:
    
    fetchHits in interface SearchFetchable<H>
    
    Parameters:
    
    limit - The maximum number of hits to be returned by this method. null means no limit.
    
    Returns:
    
    The query hits.
  - fetchHits
```
public List<H> fetchHits(Integer limit,
                         Integer offset)
```
    Description copied from interface: SearchFetchable
    
    Execute the query and return the hits as a List.
    
    Specified by:
    
    fetchHits in interface SearchFetchable<H>
    
    Parameters:
    
    limit - The maximum number of hits to be returned by this method. null means no limit.
    
    offset - The number of hits to skip. null means no offset.
    
    Returns:
    
    The query hits.
  - fetchSingleHit
```
public Optional<H> fetchSingleHit()
```
    Description copied from interface: SearchFetchable
    
    Execute the query and return the hits as a single, optional element.
    
    Specified by:
    
    fetchSingleHit in interface SearchFetchable<H>
    
    Returns:
    
    The single, optional query hit.
  - fetchTotalHitCount
```
public long fetchTotalHitCount()
```
    Description copied from interface: SearchFetchable
    
    Execute the query and return the total hit count.
    
    Specified by:
    
    fetchTotalHitCount in interface SearchFetchable<H>
    
    Returns:
    
    The total number of matching entities, ignoring pagination settings.
  - thisAsS
```
protected abstract S thisAsS()
```
  - extendPredicateFactory
```
protected abstract PDF extendPredicateFactory(SearchPredicateFactory predicateFactory)
```
  - extendSortFactory
```
protected abstract SF extendSortFactory(SearchSortFactory sortFactory)
```

Class AbstractSearchQueryOptionsStep<S extends SearchQueryOptionsStep<S,H,SF>,H,PDF extends SearchPredicateFactory,SF extends SearchSortFactory,C>

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

AbstractSearchQueryOptionsStep

Method Detail

predicate

predicate

routing

routing

sort

sort

toQuery

fetch

fetch

fetch

fetchHits

fetchHits

fetchHits

fetchSingleHit

fetchTotalHitCount

thisAsS

extendPredicateFactory

extendSortFactory