JoinSpec.Builder

public static final classJoinSpec.BuilderextendsObject

Builder forobjects.

Public Constructor Summary

Builder(String childPropertyExpression)

Create a specification for the joining operation in search.

Public Method Summary

JoinSpec	build() Constructs a new`JoinSpec` from the contents of this builder.
JoinSpec.Builder	setAggregationScoringStrategy(int aggregationScoringStrategy) Sets how we derive a single score from a list of joined documents.
JoinSpec.Builder	setMaxJoinedResultCount(int maxJoinedResultCount) Sets the max amount of`SearchResults` to return with the parent document, with a default of 10 SearchResults.
JoinSpec.Builder	setNestedSearch(StringnestedQuery, SearchSpec nestedSearchSpec) Sets the query and the SearchSpec for the documents being joined.

Inherited Method Summary

From class java.lang.Object

Object	clone()
boolean	equals(Objectarg0)
void	finalize()
finalClass<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Constructors

publicBuilder(String childPropertyExpression)

Create a specification for the joining operation in search.

The child property expressions Specifies how to join documents. Documents with a child property expression equal to the qualified id of the parent will be retrieved.

Property expressions differ fromPropertyPath as property expressions may refer to document properties or nested document properties such as "person.business.id" as well as a property expression. Currently the only property expression is "this.qualifiedId()".PropertyPath objects may only reference document properties and nested document properties.

In order to join a child document to a parent document, the child document must contain the parent's qualified id at the property expression specified by this method.

Parameters

childPropertyExpression	the property to match in the child documents.

Public Methods

publicJoinSpec build()

Constructs a newJoinSpec from the contents of this builder.

publicJoinSpec.Builder setAggregationScoringStrategy(int aggregationScoringStrategy)

Sets how we derive a single score from a list of joined documents.

The default scoring strategy isJoinSpec.AGGREGATION_SCORING_OUTER_RESULT_RANKING_SIGNAL,which specifies that the ranking signal of the outer parent document will be used.

publicJoinSpec.Builder setMaxJoinedResultCount(int maxJoinedResultCount)

Sets the max amount ofSearchResults to return with the parent document, with a default of 10 SearchResults.

This does NOT limit the number of results that are joined with the parent document for scoring. This means that, when set, only a maximum of maxJoinedResultCountresults will be returned with each parent document, but all results that are joined with a parent will factor into the score.

publicJoinSpec.Builder setNestedSearch(StringnestedQuery,SearchSpec nestedSearchSpec)

Sets the query and the SearchSpec for the documents being joined. This will score and rank the joined documents as well as filter the joined documents.

IfSearchSpec.RANKING_STRATEGY_JOIN_AGGREGATE_SCOREis set in the outer SearchSpec, the resulting signals will be used to rank the parent documents. Note that the aggregation strategy also needs to be set withsetAggregationScoringStrategy(int),otherwise the default will be JoinSpec.AGGREGATION_SCORING_OUTER_RESULT_RANKING_SIGNAL,which will just use the parent documents ranking signal.

If this method is never called,JoinSpec.getNestedQuery() will return an empty string, meaning we will join with every possible document that matches the equality constraints and hasn't been filtered out by the type or namespace filters.