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

Interface SearchPredicateFactory

All Known Subinterfaces:

ElasticsearchSearchPredicateFactory, ExtendedSearchPredicateFactory<S>, LuceneSearchPredicateFactory

All Known Implementing Classes:

AbstractSearchPredicateFactory, ElasticsearchSearchPredicateFactoryImpl, LuceneSearchPredicateFactoryImpl

public interface SearchPredicateFactory

A factory for search predicates.

This is the main entry point to the predicate DSL.

Field paths

By default, field paths passed to this DSL are interpreted as absolute, i.e. relative to the index root.

However, a new, "relative" factory can be created with withRoot(String): the new factory interprets paths as relative to the object field passed as argument to the method.

This can be useful when calling reusable methods that can apply the same predicate on different object fields that have same structure (same sub-fields).

Such a factory can also transform relative paths into absolute paths using toAbsolutePath(String); this can be useful for native predicates in particular.

Method Summary

Modifier and Type	Method	Description
SimpleBooleanPredicateClausesStep<?>	and()	Match documents if they match all inner clauses.
SimpleBooleanPredicateOptionsStep<?>	and(PredicateFinalStep firstSearchPredicate, PredicateFinalStep... otherSearchPredicates)	Match documents if they match all clauses.
SimpleBooleanPredicateOptionsStep<?>	and(SearchPredicate firstSearchPredicate, SearchPredicate... otherSearchPredicates)	Match documents if they match all previously-built SearchPredicate.
BooleanPredicateClausesStep<?>	bool()	Match documents if they match a combination of boolean clauses.
PredicateFinalStep	bool(Consumer<? super BooleanPredicateClausesStep<?>> clauseContributor)	Deprecated. Use .bool().with(...) instead.
ExistsPredicateFieldStep<?>	exists()	Match documents where a given field exists.
SearchPredicateFactoryExtensionIfSupportedStep	extension()	Create a DSL step allowing multiple attempts to apply extensions one after the other, failing only if none of the extensions is supported.
<T> T	extension(SearchPredicateFactoryExtension<T> extension)	Extend the current factory with the given extension, resulting in an extended factory offering different types of predicates.
MatchIdPredicateMatchingStep<?>	id()	Match documents where the identifier is among the given values.
MatchPredicateFieldStep<?>	match()	Match documents where targeted fields have a value that "matches" a given single value.
MatchAllPredicateOptionsStep<?>	matchAll()	Match all documents.
MatchNonePredicateFinalStep	matchNone()	Match none of the documents.
NamedPredicateOptionsStep	named(String path)	Match documents if they match a combination of defined named predicate clauses.
NestedPredicateFieldStep<?>	nested()	Deprecated. Use nested(String) instead.
NestedPredicateClausesStep<?>	nested(String objectFieldPath)	Match documents where a nested object matches inner predicates to be defined in the next steps.
NotPredicateFinalStep	not(PredicateFinalStep searchPredicate)	Match documents that do not satisfy the passed in predicate.
NotPredicateFinalStep	not(SearchPredicate searchPredicate)	Match documents that do not satisfy the passed in previously-built SearchPredicate.
SimpleBooleanPredicateClausesStep<?>	or()	Match documents if they match any inner clause.
SimpleBooleanPredicateOptionsStep<?>	or(PredicateFinalStep firstSearchPredicate, PredicateFinalStep... otherSearchPredicates)	Match documents if they match any clause.
SimpleBooleanPredicateOptionsStep<?>	or(SearchPredicate firstSearchPredicate, SearchPredicate... otherSearchPredicates)	Match documents if they match any previously-built SearchPredicate.
PhrasePredicateFieldStep<?>	phrase()	Match documents where targeted fields have a value that contains a given phrase.
RangePredicateFieldStep<?>	range()	Match documents where targeted fields have a value within lower and upper bounds.
RegexpPredicateFieldStep<?>	regexp()	Match documents where targeted fields contain a term that matches a given regular expression.
SimpleQueryStringPredicateFieldStep<?>	simpleQueryString()	Match documents according to a given query string, with a simple query language adapted to end users.
SpatialPredicateInitialStep	spatial()	Access the different types of spatial predicates.
TermsPredicateFieldStep<?>	terms()	Match documents where targeted fields contain a term that matches some terms of a given series of terms.
String	toAbsolutePath(String relativeFieldPath)
WildcardPredicateFieldStep<?>	wildcard()	Match documents where targeted fields contain a term that matches a given pattern, such as inter*on or pa?t.
SearchPredicateFactory	withRoot(String objectFieldPath)	Create a new predicate factory whose root for all paths passed to the DSL will be the given object field.

Method Detail

matchAll

MatchAllPredicateOptionsStep<?> matchAll()

Match all documents.

Returns:

The initial step of a DSL where the "match all" predicate can be defined.

See Also:

MatchAllPredicateOptionsStep

matchNone

MatchNonePredicateFinalStep matchNone()

Match none of the documents.

Returns:

The initial step of a DSL where the "match none" predicate can be defined.

See Also:

MatchNonePredicateFinalStep

id

MatchIdPredicateMatchingStep<?> id()

Match documents where the identifier is among the given values.

Returns:

The initial step of a DSL allowing the definition of an "id" predicate.

See Also:

MatchIdPredicateMatchingStep

bool

BooleanPredicateClausesStep<?> bool()

Match documents if they match a combination of boolean clauses.

Returns:

The initial step of a DSL where the "boolean" predicate can be defined.

See Also:

BooleanPredicateClausesStep

bool

@Deprecated
PredicateFinalStep bool(Consumer<? super BooleanPredicateClausesStep<?>> clauseContributor)

Deprecated.

Use .bool().with(...) instead.

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 step passed in parameter. Should generally be a lambda expression.

Returns:

The final step of the boolean predicate definition.

See Also:

GenericBooleanPredicateClausesStep.with(Consumer)

and

SimpleBooleanPredicateClausesStep<?> and()

Match documents if they match all inner clauses.

Returns:

The initial step of a DSL where predicates that must match can be added and options can be set.

See Also:

GenericSimpleBooleanPredicateClausesStep

and

SimpleBooleanPredicateOptionsStep<?> and(SearchPredicate firstSearchPredicate,
                                         SearchPredicate... otherSearchPredicates)

Match documents if they match all previously-built SearchPredicate.

Returns:

The step of a DSL where options can be set.

and

SimpleBooleanPredicateOptionsStep<?> and(PredicateFinalStep firstSearchPredicate,
                                         PredicateFinalStep... otherSearchPredicates)

Match documents if they match all clauses.

Returns:

The step of a DSL where options can be set.

or

SimpleBooleanPredicateClausesStep<?> or()

Match documents if they match any inner clause.

Returns:

The initial step of a DSL where predicates that should match can be added and options can be set.

See Also:

GenericSimpleBooleanPredicateClausesStep

or

SimpleBooleanPredicateOptionsStep<?> or(SearchPredicate firstSearchPredicate,
                                        SearchPredicate... otherSearchPredicates)

Match documents if they match any previously-built SearchPredicate.

Returns:

The step of a DSL where options can be set.

or

SimpleBooleanPredicateOptionsStep<?> or(PredicateFinalStep firstSearchPredicate,
                                        PredicateFinalStep... otherSearchPredicates)

Match documents if they match any clause.

Returns:

The step of a DSL where options can be set.

not

NotPredicateFinalStep not(SearchPredicate searchPredicate)

Match documents that do not satisfy the passed in previously-built SearchPredicate.

Can be used to negate a predicate.

Returns:

The initial and final step of a DSL where the "not" predicate can be defined.

See Also:

NotPredicateFinalStep

not

NotPredicateFinalStep not(PredicateFinalStep searchPredicate)

Match documents that do not satisfy the passed in predicate.

Can be used to negate a predicate.

Returns:

The initial and final step of a DSL where the "not" predicate can be defined.

See Also:

NotPredicateFinalStep

match

MatchPredicateFieldStep<?> 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:

The initial step of a DSL where the "match" predicate can be defined.

See Also:

MatchPredicateFieldStep

range

RangePredicateFieldStep<?> range()

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

Returns:

The initial step of a DSL where the "range" predicate can be defined.

See Also:

RangePredicateFieldStep

phrase

PhrasePredicateFieldStep<?> phrase()

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

Returns:

The initial step of a DSL where the "phrase" predicate can be defined.

See Also:

PhrasePredicateFieldStep

wildcard

WildcardPredicateFieldStep<?> 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:

The initial step of a DSL where the "wildcard" predicate can be defined.

See Also:

WildcardPredicateFieldStep

regexp

RegexpPredicateFieldStep<?> regexp()

Match documents where targeted fields contain a term that matches a given regular expression.

Returns:

The initial step of a DSL where the "regexp" predicate can be defined.

See Also:

RegexpPredicateFieldStep

terms

TermsPredicateFieldStep<?> terms()

Match documents where targeted fields contain a term that matches some terms of a given series of terms.

Returns:

The initial step of a DSL where the "terms" predicate can be defined.

See Also:

TermsPredicateFieldStep

nested

@Deprecated
NestedPredicateFieldStep<?> nested()

Deprecated.

Use nested(String) instead.

Match documents where a nested object matches a given predicate.

Returns:

The initial step of a DSL where the "nested" predicate can be defined.

See Also:

NestedPredicateFieldStep

nested

NestedPredicateClausesStep<?> nested(String objectFieldPath)

Match documents where a nested object matches inner predicates to be defined in the next steps.

The resulting nested predicate must match all inner clauses, similarly to an "and" predicate.

Parameters:

objectFieldPath - The path to the (nested) object field that must match.

Returns:

The initial step of a DSL where the "nested" predicate can be defined.

See Also:

NestedPredicateFieldStep

simpleQueryString

SimpleQueryStringPredicateFieldStep<?> 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 SimpleQueryStringPredicateOptionsStep.defaultOperator(BooleanOperator) to change this behavior.

Returns:

The initial step of a DSL where the "simple query string" predicate can be defined.

See Also:

SimpleQueryStringPredicateFieldStep

exists

ExistsPredicateFieldStep<?> 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:

The initial step of a DSL where the "exists" predicate can be defined.

See Also:

ExistsPredicateFieldStep

spatial

SpatialPredicateInitialStep spatial()

Access the different types of spatial predicates.

Returns:

The initial step of a DSL where spatial predicates can be defined.

See Also:

SpatialPredicateInitialStep

named

@Incubating
NamedPredicateOptionsStep named(String path)

Match documents if they match a combination of defined named predicate clauses.

Parameters:

path - The path to the named predicate, formatted as <object field path>.<predicate name>, or just <predicate name> if the predicate was declared at the root.

Returns:

The initial step of a DSL where named predicate predicates can be defined.

See Also:

NamedPredicateOptionsStep

extension

<T> T extension(SearchPredicateFactoryExtension<T> extension)

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

Type Parameters:

T - The type of factory provided by the extension.

Parameters:

extension - The extension to the predicate DSL.

Returns:

The extended factory.

Throws:

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

extension

SearchPredicateFactoryExtensionIfSupportedStep extension()

Create a DSL step allowing multiple attempts to apply 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(SearchPredicateFactoryExtension) method instead.

Returns:

A DSL step.

withRoot

@Incubating
SearchPredicateFactory withRoot(String objectFieldPath)

Create a new predicate factory whose root for all paths passed to the DSL will be the given object field.

This is used to call reusable methods that apply the same predicate on different object fields that have same structure (same sub-fields).

Parameters:

objectFieldPath - The path from the current root to an object field that will become the new root.

Returns:

A new predicate factory using the given object field as root.

toAbsolutePath

@Incubating
String toAbsolutePath(String relativeFieldPath)

Parameters:

relativeFieldPath - The path to a field, relative to the root of this factory.

Returns:

The absolute path of the field, for use in native predicates for example. Note the path is returned even if the field doesn't exist.