JoinSpec 類別

定義

[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

繼承

Object

JavaObject

Object

JoinSpec

屬性

RegisterAttribute

實作

IParcelable IJavaObject IJavaPeerable IDisposable

備註

此類別代表搜尋中連接操作的規範。

連接僅適用於外層文件的限定 ID 與子查詢文件中的屬性值匹配。 在子查詢文件中，這些值可能會以屬性路徑（如「email.recipient.id」）或「entityId」或屬性表達式來引用。 其中一個屬性表達式是「this.qualifiedId（）」，它指的是文件中組合的套件、資料庫、命名空間與 ID。

注意，為了執行該連接，所 #getChildPropertyExpression 指的性質必須是設定 AppSearchSchema.StringPropertyConfig#getJoinableValueType 為 AppSearchSchema.StringPropertyConfig#JOINABLE_VALUE_TYPE_QUALIFIED_ID的性質。 否則，任何文件都不會被連結到任何 SearchResult。

以這些外部查詢和子查詢結果為例：

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

在此範例中，子查詢結果 1 包含一個屬性「entityId」，其值為「pkg$db/ns#id1」，指的是外部結果。 如果你用「entityId」呼叫 Builder ，我們會從子文件中取得屬性「entityId」的值，該屬性為「pkg$db#ns/id1」。 假設外部結果的合格 ID 是「pkg$db#ns/id1」。 這表示子查詢結果 1 文件會與該父文件匹配。 這是透過將包含子文件的 加入 SearchResult 頂層父 SearchResult#getJoinedResults文件 來完成的。

如果 #getChildPropertyExpression 是「註記」，我們會在子查詢結果中檢查註解屬性的值。 在子查詢結果 1 中，這個值是「This is some doc」，這與外部查詢結果的合格 id 不相符。 因此，子查詢結果 1 不會與外部查詢結果結合。

可以在巢SearchSpec狀結構中定義進階排名策略，也可以在外部SearchSpec#RANKING_STRATEGY_JOIN_AGGREGATE_SCORE層使用SearchSpec。 此時，父檔案將根據透過進階排序策略評分所計算出的訊號總和（如總和）進行排序。

在評分方面，若 SearchSpec#RANKING_STRATEGY_JOIN_AGGREGATE_SCORE 設於 SearchSpec#getRankingStrategy，則外圍 SearchResults 的分數可受子查詢結果排名訊號影響。 例如，若 設定 JoinSpec#getAggregationScoringStrategy 為：

<UL><LI>JoinSpec#AGGREGATION_SCORING_MIN_RANKING_SIGNAL，外部 SearchResult 的排名訊號會設定為子查詢結果排名訊號的最小值。 在這種情況下，最低會是2和3，也就是2。 <李>JoinSpec#AGGREGATION_SCORING_MAX_RANKING_SIGNAL，外層 SearchResult 的排名信號會是3。 <李>JoinSpec#AGGREGATION_SCORING_AVG_RANKING_SIGNAL，外層 SearchResult 的排名信號是2.5。 <李>JoinSpec#AGGREGATION_SCORING_RESULT_COUNT，外 SearchResult 層的排名信號會是2，因為有兩個結果合併。 <李>JoinSpec#AGGREGATION_SCORING_SUM_RANKING_SIGNAL，外 SearchResult 層的排名信號是5,2和3的和。 <李>JoinSpec#AGGREGATION_SCORING_OUTER_RESULT_RANKING_SIGNAL，外層 SearchResult 的排名信號保持不變。 </ul>

在外部查詢的排名訊號中引用「this.childrenRankingSignals（）」，將回傳透過巢狀 SearchSpec結構中評分策略對合併文件進行評分計算出的訊號，如 SearchResult#getRankingSignal。

Java 文件 android.app.appsearch.JoinSpec。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。