JoinSpec Classe

Definizione

[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

Ereditarietà

Object

JavaObject

Object

JoinSpec

Attributi

RegisterAttribute

Implementazioni

IParcelable IJavaObject IJavaPeerable IDisposable

Commenti

Questa classe rappresenta le specifiche per l'operazione di unione nella ricerca.

I join sono possibili solo per la corrispondenza sull'ID completo di un documento esterno e un valore di proprietà all'interno di un documento sottoquery. Nei documenti della sottoquery è possibile fare riferimento a questi valori con un percorso di proprietà, ad esempio "email.recipient.id" o "entityId" o un'espressione di proprietà. Una di queste espressioni di proprietà è "this.qualifiedId()", che fa riferimento al pacchetto combinato, al database, allo spazio dei nomi e all'ID del documento.

Si noti che per eseguire il join, la proprietà a #getChildPropertyExpression cui si fa riferimento deve essere una proprietà con AppSearchSchema.StringPropertyConfig#getJoinableValueType impostato su AppSearchSchema.StringPropertyConfig#JOINABLE_VALUE_TYPE_QUALIFIED_ID. In caso contrario, nessun documento verrà unito a alcun SearchResultoggetto .

Eseguire queste query esterne e i risultati della sottoquery, ad esempio:

{@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 questo esempio, il risultato della sottoquery 1 contiene una proprietà "entityId" il cui valore è "pkg$db/ns#id1", che fa riferimento al risultato esterno. Se si chiama Builder con "entityId", il valore della proprietà "entityId" verrà recuperato dal documento figlio, ovvero "pkg$db#ns/id1". Si supponga che l'ID completo del risultato esterno sia "pkg$db#ns/id1". Ciò significa che il documento risultante dalla sottoquery 1 verrà confrontato con il documento padre. A tale scopo, aggiungere un oggetto SearchResult contenente il documento figlio all'elemento padre di SearchResult#getJoinedResultsprimo livello.

Se #getChildPropertyExpression è "notes", verranno controllati i valori della proprietà notes nei risultati della sottoquery. Nel risultato della sottoquery 1, questi valori sono "Questo è un documento", che non corrisponde all'ID completo del risultato della query esterna. Di conseguenza, il risultato della sottoquery 1 non verrà unito al risultato della query esterna.

È possibile definire una strategia di classificazione avanzata nell'oggetto annidato e usarla SearchSpecSearchSpec#RANKING_STRATEGY_JOIN_AGGREGATE_SCORE anche nell'esterno SearchSpec. In questo caso, i genitori verranno classificati in base a un'aggregazione, ad esempio la somma, dei segnali calcolati assegnando un punteggio ai documenti uniti con la strategia di classificazione avanzata.

In termini di assegnazione dei punteggi, se SearchSpec#RANKING_STRATEGY_JOIN_AGGREGATE_SCORE è impostato in SearchSpec#getRankingStrategy, i punteggi di SearchResults esterni possono essere influenzati dai segnali di classificazione dei risultati della sottoquery. Ad esempio, se è JoinSpec#getAggregationScoringStrategy impostato su:

<ul><li>JoinSpec#AGGREGATION_SCORING_MIN_RANKING_SIGNAL, il segnale di classificazione dell'esterno SearchResult verrà impostato sul minimo dei segnali di classificazione dei risultati della sottoquery. In questo caso, sarà il minimo di 2 e 3, ovvero 2. <li>JoinSpec#AGGREGATION_SCORING_MAX_RANKING_SIGNAL, il segnale di classifica dell'esterno SearchResult sarà 3. <li>JoinSpec#AGGREGATION_SCORING_AVG_RANKING_SIGNAL, il segnale di classificazione dell'esterno SearchResult sarà 2,5. <li>JoinSpec#AGGREGATION_SCORING_RESULT_COUNT, il segnale di classifica dell'esterno SearchResult sarà 2 in quanto ci sono due risultati uniti. <li>JoinSpec#AGGREGATION_SCORING_SUM_RANKING_SIGNAL, il segnale di classificazione dell'esterno SearchResult sarà 5, la somma di 2 e 3. <li>JoinSpec#AGGREGATION_SCORING_OUTER_RESULT_RANKING_SIGNAL, il segnale di classificazione dell'esterno SearchResult rimarrà così come è. </ul>

Facendo riferimento a "this.childrenRankingSignals()" nel segnale di classificazione della query esterna verranno restituiti i segnali calcolati assegnando un punteggio ai documenti uniti usando la strategia di assegnazione dei punteggi in SearchSpec, come in SearchResult#getRankingSignal.

per android.app.appsearch.JoinSpec.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.