org.hibernate.search.engine.search.dsl.predicate

Interface SearchPredicateFactoryContext

All Known Implementing Classes:

DelegatingSearchPredicateFactoryContext

public interface SearchPredicateFactoryContext

A context allowing to specify the type of a predicate.

This is the main entry point to the predicate DSL.

Method Summary

Modifier and Type	Method and Description
BooleanJunctionPredicateContext	bool() Match documents if they match a combination of boolean clauses.
SearchPredicateTerminalContext	bool(Consumer<? super BooleanJunctionPredicateContext> clauseContributor) Match documents if they match a combination of boolean clauses, which will be defined by the given consumer.
ExistsPredicateContext	exists() Match documents where a given field exists.
SearchPredicateFactoryExtensionContext	extension() Create a context allowing to try to apply multiple extensions one after the other, failing only if none of the extensions is supported.
<T> T	extension(SearchPredicateFactoryContextExtension<T> extension) Extend the current context with the given extension, resulting in an extended context offering different types of predicates.
MatchIdPredicateContext	id() Match documents where the identifier is among the given values.
MatchPredicateContext	match() Match documents where targeted fields have a value that "matches" a given single value.
MatchAllPredicateContext	matchAll() Match all documents.
NestedPredicateContext	nested() Match documents where a nested object matches a given predicate.
PhrasePredicateContext	phrase() Match documents where targeted fields have a value that contains a given phrase.
RangePredicateContext	range() Match documents where targeted fields have a value within lower and upper bounds.
SimpleQueryStringPredicateContext	simpleQueryString() Match documents according to a given query string, with a simple query language adapted to end users.
SpatialPredicateContext	spatial() Access the different types of spatial predicates.
WildcardPredicateContext	wildcard() Match documents where targeted fields contain a term that matches a given pattern, such as inter*on or pa?t.

Method Detail

matchAll

MatchAllPredicateContext matchAll()

Match all documents.

Returns:

A context allowing to define the predicate more precisely and ultimately get the resulting predicate.

See Also:

MatchAllPredicateContext

id

MatchIdPredicateContext id()

Match documents where the identifier is among the given values.

Returns:

A context allowing to define the predicate more precisely and ultimately get the resulting predicate.

See Also:

MatchIdPredicateContext

bool

BooleanJunctionPredicateContext bool()

Match documents if they match a combination of boolean clauses.

Returns:

A context allowing to define the predicate more precisely and ultimately get the resulting predicate.

See Also:

BooleanJunctionPredicateContext

bool

SearchPredicateTerminalContext bool(Consumer<? super BooleanJunctionPredicateContext> clauseContributor)

Match documents if they match a combination of boolean clauses, which will be defined by the given consumer.

Best used with lambda expressions.

Parameters:

clauseContributor - A consumer that will add clauses to the context passed in parameter. Should generally be a lambda expression.

Returns:

The resulting SearchPredicate

See Also:

BooleanJunctionPredicateContext

match

MatchPredicateContext match()

Match documents where targeted fields have a value that "matches" a given single value.

Note that "value matching" may be exact or approximate depending on the type of the targeted fields: numeric fields in particular imply exact matches, while analyzed, full-text fields imply approximate matches depending on how they are analyzed.

Returns:

A context allowing to define the predicate more precisely and ultimately get the resulting predicate.

See Also:

MatchPredicateContext

range

RangePredicateContext range()

Match documents where targeted fields have a value within lower and upper bounds.

Returns:

A context allowing to define the predicate more precisely and ultimately get the resulting predicate.

See Also:

RangePredicateContext

phrase

PhrasePredicateContext phrase()

Match documents where targeted fields have a value that contains a given phrase.

Returns:

A context allowing to define the predicate more precisely and ultimately get the resulting predicate.

See Also:

PhrasePredicateContext

wildcard

WildcardPredicateContext wildcard()

Match documents where targeted fields contain a term that matches a given pattern, such as inter*on or pa?t.

Note that such patterns are not analyzed, thus any character that is not a wildcard must match exactly the content of the index (including uppercase letters, diacritics, ...).

Returns:

A context allowing to define the predicate more precisely and ultimately get the resulting predicate.

See Also:

WildcardPredicateContext

nested

NestedPredicateContext nested()

Match documents where a nested object matches a given predicate.

Returns:

A context allowing to define the predicate more precisely and ultimately get the resulting predicate.

See Also:

NestedPredicateContext

simpleQueryString

SimpleQueryStringPredicateContext simpleQueryString()

Match documents according to a given query string, with a simple query language adapted to end users.

Note that by default, unless the query string contains explicit operators, documents will match if any term mentioned in the query string is present in the document (OR operator). This makes sense when sorting results by relevance, but is not ideal otherwise. See SimpleQueryStringPredicateTerminalContext.withAndAsDefaultOperator() to change this behavior.

Returns:

A context allowing to define the predicate more precisely and ultimately get the resulting predicate.

See Also:

SimpleQueryStringPredicateContext

exists

ExistsPredicateContext exists()

Match documents where a given field exists.

Fields are considered to exist in a document when they have at least one non-null value in this document.

Returns:

A context allowing to define the predicate more precisely and ultimately get the resulting predicate.

See Also:

ExistsPredicateContext

spatial

SpatialPredicateContext spatial()

Access the different types of spatial predicates.

Returns:

A context allowing to define the type of spatial predicate.

See Also:

SpatialPredicateContext

extension

<T> T extension(SearchPredicateFactoryContextExtension<T> extension)

Extend the current context with the given extension, resulting in an extended context offering different types of predicates.

Type Parameters:

T - The type of context provided by the extension.

Parameters:

extension - The extension to the predicate DSL.

Returns:

The extended context.

Throws:

SearchException - If the extension cannot be applied (wrong underlying backend, ...).

extension

SearchPredicateFactoryExtensionContext extension()

Create a context allowing to try to apply multiple extensions one after the other, failing only if none of the extensions is supported.

If you only need to apply a single extension and fail if it is not supported, use the simpler extension(SearchPredicateFactoryContextExtension) method instead.

Returns:

A context allowing to define the extensions to attempt, and the corresponding predicates.