JoinSpec Klasse

Definition

[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

Vererbung

Object

JavaObject

Object

JoinSpec

Attribute

RegisterAttribute

Implementiert

IParcelable IJavaObject IJavaPeerable IDisposable

Hinweise

Diese Klasse stellt die Spezifikationen für den Verknüpfungsvorgang in der Suche dar.

Verknüpfungen sind nur für den Abgleich mit der qualifizierten ID eines äußeren Dokuments und eines Eigenschaftswerts innerhalb eines Unterabfragedokuments möglich. In den Unterabfragedokumenten können diese Werte mit einem Eigenschaftspfad wie "email.recipient.id" oder "entityId" oder einem Eigenschaftsausdruck bezeichnet werden. Ein solcher Eigenschaftsausdruck ist "this.qualifiedId()", der sich auf das kombinierte Paket, die Datenbank, den Namespace und die ID des Dokuments bezieht.

Beachten Sie, dass die eigenschaft, auf #getChildPropertyExpression die verwiesen wird, um die Verknüpfung durchzuführen, eine Eigenschaft sein muss, auf AppSearchSchema.StringPropertyConfig#getJoinableValueType die festgelegt ist AppSearchSchema.StringPropertyConfig#JOINABLE_VALUE_TYPE_QUALIFIED_ID. Andernfalls werden keine Dokumente mit anderen SearchResultverknüpft.

Führen Sie die folgenden äußeren Abfrage- und Unterabfrageergebnisse aus:

{@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
            }
            }

In diesem Beispiel enthält das Ergebnis der Unterabfrage 1 eine Eigenschaft "entityId", deren Wert "pkg$db/ns#id1" lautet und auf das äußere Ergebnis verweist. Wenn Sie mit "entityId" aufrufen Builder , rufen wir den Wert der Eigenschaft "entityId" aus dem untergeordneten Dokument ab, also "pkg$db#ns/id1". Angenommen, die qualifizierte ID des äußeren Ergebnisses lautet "pkg$db#ns/id1". Dies bedeutet, dass das Ergebnis 1 der Unterabfrage mit diesem übergeordneten Dokument übereinstimmt. Dazu fügen Sie ein SearchResult untergeordnetes Dokument zum übergeordneten Übergeordneten SearchResult#getJoinedResultsElement der obersten Ebene hinzu.

Wenn #getChildPropertyExpression es sich um "Notizen" handelt, überprüfen wir die Werte der Notizeneigenschaft in den Unterabfrageergebnissen. In Unterabfrageergebnis 1 lautet dieser Wert "Dies ist ein Dokument", das nicht der qualifizierten ID des äußeren Abfrageergebnisses entspricht. Das Ergebnis der Unterabfrage 1 wird daher nicht mit dem äußeren Abfrageergebnis verknüpft.

Es ist möglich, eine erweiterte Rangfolgestrategie in der geschachtelten SearchSpec und auch im äußeren SearchSpec#RANKING_STRATEGY_JOIN_AGGREGATE_SCOREzu definierenSearchSpec. In diesem Fall werden die Eltern basierend auf einer Aggregation, z. B. der Summe, der Signale bewertet, die mit der Bewertung der verbundenen Dokumente mit der erweiterten Bewertungsstrategie berechnet werden.

Im Hinblick auf die Bewertung können die SearchSpec#RANKING_STRATEGY_JOIN_AGGREGATE_SCORESearchSpec#getRankingStrategyBewertungen der äußeren SearchResults durch die Bewertungssignale der Unterabfrageergebnisse beeinflusst werden. Wenn die JoinSpec#getAggregationScoringStrategy Einstellung z. B. auf Folgendes festgelegt ist:

<ul><li>JoinSpec#AGGREGATION_SCORING_MIN_RANKING_SIGNAL, das Bewertungssignal des äußeren SearchResult wird auf das Minimum der Bewertungssignale der Unterabfrageergebnisse festgelegt. In diesem Fall wird es mindestens 2 und 3 sein, was 2 ist. <li>JoinSpec#AGGREGATION_SCORING_MAX_RANKING_SIGNAL, das Bewertungssignal des äußeren SearchResult wird 3 sein. <li>JoinSpec#AGGREGATION_SCORING_AVG_RANKING_SIGNAL, das Bewertungssignal des äußeren SearchResult wird 2,5 sein. <li>JoinSpec#AGGREGATION_SCORING_RESULT_COUNT, das Bewertungssignal des äußeren SearchResult wird 2 sein, da es zwei verbundene Ergebnisse gibt. <li>JoinSpec#AGGREGATION_SCORING_SUM_RANKING_SIGNAL, das Bewertungssignal des äußeren SearchResult wird 5, die Summe von 2 und 3. <li>JoinSpec#AGGREGATION_SCORING_OUTER_RESULT_RANKING_SIGNAL, das Bewertungssignal des Äußeren SearchResult bleibt so, wie es ist. </ul>

Wenn Sie im Bewertungssignal der äußeren Abfrage auf "this.childrenRankingSignals()" verweisen, werden die Signale zurückgegeben, die durch die Bewertung der verknüpften Dokumente mithilfe der Bewertungsstrategie im geschachtelten SearchSpec, wie in .SearchResult#getRankingSignal

Java Dokumentation für android.app.appsearch.JoinSpec.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.