JoinSpec Classe

Definição

[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

Herança

Object

JavaObject

Object

JoinSpec

Atributos

RegisterAttribute

Implementações

IParcelable IJavaObject IJavaPeerable IDisposable

Comentários

Essa classe representa as especificações da operação de junção na pesquisa.

As junções só são possíveis para correspondência na ID qualificada de um documento externo e um valor de propriedade em um documento de subconsulta. Nos documentos de subconsulta, esses valores podem ser referenciados com um caminho de propriedade, como "email.recipient.id" ou "entityId" ou uma expressão de propriedade. Uma dessas expressões de propriedade é "this.qualifiedId()", que se refere ao pacote, banco de dados, namespace e id combinados do documento.

Observe que, para executar a junção, a propriedade referenciada deve #getChildPropertyExpression ser uma propriedade com AppSearchSchema.StringPropertyConfig#getJoinableValueType definido como AppSearchSchema.StringPropertyConfig#JOINABLE_VALUE_TYPE_QUALIFIED_ID. Caso contrário, nenhum documento será associado a nenhum SearchResult.

Veja estes resultados externos de consulta e subconsulta, por exemplo:

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

Neste exemplo, o resultado da subconsulta 1 contém uma propriedade "entityId" cujo valor é "pkg$db/ns#id1", referindo-se ao resultado externo. Se você chamar Builder com "entityId", recuperaremos o valor da propriedade "entityId" do documento filho, que é "pkg$db#ns/id1". Digamos que a ID qualificada do resultado externo seja "pkg$db#ns/id1". Isso significaria que o documento 1 do resultado da subconsulta será correspondido a esse documento pai. Isso é feito adicionando um SearchResult documento filho ao pai SearchResult#getJoinedResultsde nível superior.

Se #getChildPropertyExpression for "anotações", verificaremos os valores da propriedade notes nos resultados da subconsulta. No resultado da subconsulta 1, esses valores são "This is some doc", que não é igual à ID qualificada do resultado da consulta externa. Dessa forma, o resultado da subconsulta 1 não será unido ao resultado da consulta externa.

É possível definir uma estratégia de classificação avançada no aninhado SearchSpec e também usar SearchSpec#RANKING_STRATEGY_JOIN_AGGREGATE_SCORE no exterior SearchSpec. Nesse caso, os pais serão classificados com base em uma agregação, como a soma, dos sinais calculados pontuando os documentos unidos com a estratégia de classificação avançada.

Em termos de pontuação, se SearchSpec#RANKING_STRATEGY_JOIN_AGGREGATE_SCORE estiver definido, SearchSpec#getRankingStrategyas pontuações dos SearchResults externos podem ser influenciadas pelos sinais de classificação dos resultados da subconsulta. Por exemplo, se o JoinSpec#getAggregationScoringStrategy valor for definido como:

<ul><li>JoinSpec#AGGREGATION_SCORING_MIN_RANKING_SIGNAL, o sinal de classificação do exterior SearchResult será definido como o mínimo dos sinais de classificação dos resultados da subconsulta. Nesse caso, será o mínimo de 2 e 3, que é 2. <li>JoinSpec#AGGREGATION_SCORING_MAX_RANKING_SIGNAL, o sinal de classificação do exterior SearchResult será 3. <li>JoinSpec#AGGREGATION_SCORING_AVG_RANKING_SIGNAL, o sinal de classificação do exterior SearchResult será 2.5. <li>JoinSpec#AGGREGATION_SCORING_RESULT_COUNT, o sinal de classificação do exterior SearchResult será 2, pois há dois resultados unidos. <li>JoinSpec#AGGREGATION_SCORING_SUM_RANKING_SIGNAL, o sinal de classificação do exterior SearchResult será 5, a soma de 2 e 3. <li>JoinSpec#AGGREGATION_SCORING_OUTER_RESULT_RANKING_SIGNAL, o sinal de classificação do exterior SearchResult permanecerá como está. </ul>

Referindo-se a "this.childrenRankingSignals()" no sinal de classificação da consulta externa retornará os sinais calculados pontuando os documentos unidos usando a estratégia de pontuação no aninhado SearchSpec, como em SearchResult#getRankingSignal.

Java documentação para android.app.appsearch.JoinSpec.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.