org.hibernate.search.engine.search.query

Interface SearchQueryExtension<Q,H>

Type Parameters:

Q - The type of search queries wrappers created by this extension.

H - The type of hits in the query to be wrapped.

public interface SearchQueryExtension<Q,H>

An extension to the search query, allowing to wrap 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:

SearchQuery.extension(SearchQueryExtension)

Method Summary

Modifier and Type	Method and Description
Optional<Q>	extendOptional(SearchQuery<H> original, LoadingContext<?,?> loadingContext) Attempt to extend a given query, returning an empty Optional in case of failure.

Method Detail

extendOptional

Optional<Q> extendOptional(SearchQuery<H> original,
                           LoadingContext<?,?> loadingContext)

Attempt to extend a given query, 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 SearchQuery.

loadingContext - The LoadingContext used by the original query.

Returns:

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