org.hibernate.search.engine.search.dsl.query

Interface SearchQueryDslExtension<T,R,E>

Type Parameters:

T - The type of extended steps in the search query definition DSL. Should generally extend SearchQueryHitTypeStep.

R - The reference type. Users should not have to care about this, as the parameter will automatically take the appropriate value when calling .extension( ElasticsearchExtension.get() .

E - The entity type. Users should not have to care about this, as the parameter will automatically take the appropriate value when calling

public interface SearchQueryDslExtension<T,R,E>

An extension to the search query DSL, allowing to set non-standard options on a query.

WARNING: while this type is API, because instances should be manipulated by users, all of its methods are considered SPIs and therefore should never be called or implemented directly by users. In short, users are only expected to get instances of this type from an API (SomeExtension.get()) and pass it to another API.

See Also:

SearchQueryHitTypeStep.extension(SearchQueryDslExtension), AbstractSearchQueryOptionsStep

Method Summary

Modifier and Type	Method and Description
Optional<T>	extendOptional(SearchQueryHitTypeStep<?,R,E,?,?> original, IndexScope<?> indexScope, SessionContextImplementor sessionContext, LoadingContextBuilder<R,E> loadingContextBuilder) Attempt to extend a given DSL step, returning an empty Optional in case of failure.

Method Detail

extendOptional

Optional<T> extendOptional(SearchQueryHitTypeStep<?,R,E,?,?> original,
                           IndexScope<?> indexScope,
                           SessionContextImplementor sessionContext,
                           LoadingContextBuilder<R,E> loadingContextBuilder)

Attempt to extend a given DSL step, returning an empty Optional in case of failure.

WARNING: this method is not API, see comments at the type level.

Parameters:

original - The original, non-extended SearchQueryHitTypeStep.

indexScope - An IndexScope.

sessionContext - A SessionContextImplementor.

loadingContextBuilder - A LoadingContextBuilder.

Returns:

An optional containing the extended search query DSL step (T) in case of success, or an empty optional otherwise.