JoinSpec Classe

Définition

[Android.Runtime.Register("android/app/appsearch/JoinSpec", ApiSince=34, DoNotGenerateAcw=true)]
public sealed class JoinSpec : Java.Lang.Object, Android.OS.IParcelable, IDisposable

[<Android.Runtime.Register("android/app/appsearch/JoinSpec", ApiSince=34, DoNotGenerateAcw=true)>]
type JoinSpec = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Héritage

Object

JavaObject

Object

JoinSpec

Attributs

RegisterAttribute

Implémente

IParcelable IJavaObject IJavaPeerable IDisposable

Remarques

Cette classe représente les spécifications de l’opération de jointure dans la recherche.

Les jointures sont uniquement possibles pour la correspondance sur l’ID qualifié d’un document externe et une valeur de propriété dans un document de sous-requête. Dans les documents de sous-requête, ces valeurs peuvent être appelées avec un chemin de propriété tel que « email.recipient.id » ou « entityId » ou une expression de propriété. L’une de ces expressions de propriété est « this.qualifiedId() », qui fait référence au package combiné, à la base de données, à l’espace de noms et à l’ID du document.

Notez que pour effectuer la jointure, la propriété référencée doit #getChildPropertyExpression être une propriété dont AppSearchSchema.StringPropertyConfig#getJoinableValueType la valeur est définie AppSearchSchema.StringPropertyConfig#JOINABLE_VALUE_TYPE_QUALIFIED_ID. Sinon, aucun document n’est joint à un document SearchResult.

Prenez ces résultats de requête externe et de sous-requête, par exemple :

{@code
            Outer result {
              id: id1
              score: 5
            }
            Subquery result 1 {
              id: id2
              score: 2
              entityId: pkg$db/ns#id1
              notes: This is some doc
            }
            Subquery result 2 {
              id: id3
              score: 3
              entityId: pkg$db/ns#id2
              notes: This is another doc
            }
            }

Dans cet exemple, le résultat de sous-requête 1 contient une propriété « entityId » dont la valeur est « pkg$db/ns#id1 », faisant référence au résultat externe. Si vous appelez Builder avec « entityId », nous allons récupérer la valeur de la propriété « entityId » à partir du document enfant, qui est « pkg$db#ns/id1 ». Supposons que l’ID qualifié du résultat externe soit « pkg$db#ns/id1 ». Cela signifie que le résultat de la sous-requête 1 sera mis en correspondance avec ce document parent. Pour ce faire, ajoutez un SearchResult document enfant au parent SearchResult#getJoinedResultsde niveau supérieur.

S’il #getChildPropertyExpression s’agit de « notes », nous allons vérifier les valeurs de la propriété notes dans les résultats de la sous-requête. Dans le résultat de la sous-requête 1, ces valeurs sont « Il s’agit d’un document », ce qui n’est pas égal à l’ID qualifié du résultat de la requête externe. Par conséquent, le résultat de la sous-requête 1 ne sera pas joint au résultat de la requête externe.

Il est possible de définir une stratégie de classement avancée dans l’imbrication SearchSpec et également d’utiliser SearchSpec#RANKING_STRATEGY_JOIN_AGGREGATE_SCORE dans l’extérieur SearchSpec. Dans ce cas, les parents seront classés en fonction d’une agrégation, telle que la somme, des signaux calculés en scoreant les documents joints avec la stratégie de classement avancée.

En termes de scoring, s’il SearchSpec#RANKING_STRATEGY_JOIN_AGGREGATE_SCORE est défini dans SearchSpec#getRankingStrategy, les scores des SearchResults externes peuvent être influencés par les signaux de classement des résultats de la sous-requête. Par exemple, si la JoinSpec#getAggregationScoringStrategy valeur est définie sur :

<ul><li>JoinSpec#AGGREGATION_SCORING_MIN_RANKING_SIGNAL, le signal de classement de l’extérieur SearchResult sera défini sur le minimum des signaux de classement des résultats de la sous-requête. Dans ce cas, il s’agit du minimum de 2 et 3, soit 2. <li>JoinSpec#AGGREGATION_SCORING_MAX_RANKING_SIGNAL, le signal de classement de l’extérieur SearchResult sera 3. <li>JoinSpec#AGGREGATION_SCORING_AVG_RANKING_SIGNAL, le signal de classement de l’extérieur SearchResult sera de 2,5. <li>JoinSpec#AGGREGATION_SCORING_RESULT_COUNT, le signal de classement de l’extérieur SearchResult sera de 2, car il y a deux résultats joints. <li>JoinSpec#AGGREGATION_SCORING_SUM_RANKING_SIGNAL, le signal de classement de l’extérieur SearchResult sera 5, la somme de 2 et 3. <li>JoinSpec#AGGREGATION_SCORING_OUTER_RESULT_RANKING_SIGNAL, le signal de classement de l’extérieur SearchResult restera tel qu’il est. </ul>

La référence à « this.childrenRankingSignals() » dans le signal de classement de la requête externe retourne les signaux calculés en scoring des documents joints à l’aide de la stratégie de scoring dans l’imbrication SearchSpec, comme dans SearchResult#getRankingSignal.

Java documentation pour android.app.appsearch.JoinSpec.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.