JoinSpec.Builder

Kotlin |Java

public static final class JoinSpec.Builder
extends Object

java.lang.Object
↳	android.app.appsearch.JoinSpec.Builder

Builder for objects.

Summary

Public constructors
`Builder(String childPropertyExpression)` Create a specification for the joining operation in search.

Public methods
`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(String nestedQuery, SearchSpec nestedSearchSpec)` Sets the query and the SearchSpec for the documents being joined.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeoutMillis, int nanos)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis)` Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait()` Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public constructors

Builder

Added in API level 34
Also in T Extensions 7

public Builder (String childPropertyExpression)

Create a specification for the joining operation in search.

The child property expression 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 from PropertyPath 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`	`String`: the property to match in the child documents. This value cannot be `null`.

Public methods

build

Added in API level 34
Also in T Extensions 7

public JoinSpec build ()

Constructs a new JoinSpec from the contents of this builder.

Returns
`JoinSpec`	This value cannot be `null`.

setAggregationScoringStrategy

Added in API level 34
Also in T Extensions 7

public JoinSpec.Builder setAggregationScoringStrategy (int aggregationScoringStrategy)

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

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

Parameters
`aggregationScoringStrategy`	`int`: Value is `JoinSpec.AGGREGATION_SCORING_OUTER_RESULT_RANKING_SIGNAL`, `JoinSpec.AGGREGATION_SCORING_RESULT_COUNT`, `JoinSpec.AGGREGATION_SCORING_MIN_RANKING_SIGNAL`, `JoinSpec.AGGREGATION_SCORING_AVG_RANKING_SIGNAL`, `JoinSpec.AGGREGATION_SCORING_MAX_RANKING_SIGNAL`, or `JoinSpec.AGGREGATION_SCORING_SUM_RANKING_SIGNAL`

Returns
`JoinSpec.Builder`	This value cannot be `null`.

See also:

SearchSpec.RANKING_STRATEGY_JOIN_AGGREGATE_SCORE

setMaxJoinedResultCount

Added in API level 34
Also in T Extensions 7

public JoinSpec.Builder setMaxJoinedResultCount (int maxJoinedResultCount)

Sets the max amount of SearchResults 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 maxJoinedResultCount results will be returned with each parent document, but all results that are joined with a parent will factor into the score.

Parameters
`maxJoinedResultCount`	`int`

Returns
`JoinSpec.Builder`	This value cannot be `null`.

setNestedSearch

Added in API level 34
Also in T Extensions 7

public JoinSpec.Builder setNestedSearch (String nestedQuery, 
                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.

If SearchSpec.RANKING_STRATEGY_JOIN_AGGREGATE_SCORE is 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 with setAggregationScoringStrategy(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.

Parameters
`nestedQuery`	`String`: This value cannot be `null`.
`nestedSearchSpec`	`SearchSpec`: This value cannot be `null`.

Returns
`JoinSpec.Builder`	This value cannot be `null`.

See also: