ContactsContract.Directory Classe

Definição

[Android.Runtime.Register("android/provider/ContactsContract$Directory", DoNotGenerateAcw=true)]
public sealed class ContactsContract.Directory : Java.Lang.Object

[<Android.Runtime.Register("android/provider/ContactsContract$Directory", DoNotGenerateAcw=true)>]
type ContactsContract.Directory = class
    inherit Object

Herança

Object

JavaObject

Object

ContactsContract.Directory

Atributos

RegisterAttribute

Comentários

Um Diretório representa um corpus de contatos, por exemplo, contatos locais, Lista de Endereços Global do Google Apps ou Lista de Endereços Globais Corporativos.

Um diretório é implementado como um provedor de conteúdo com sua autoridade exclusiva e a mesma API que o provedor de contatos principal. No entanto, não há nenhuma expectativa de que todos os provedores de diretório implementem esse Contrato em sua totalidade. Se um provedor de diretório não tiver uma implementação para uma solicitação específica, ele deverá gerar um UnsupportedOperationException.

O caso de uso mais importante para Diretórios é a pesquisa. Espera-se que um provedor de diretório dê suporte pelo menos ContactsContract.Contacts#CONTENT_FILTER_URI Contacts.CONTENT_FILTER_URI. Se um provedor de Diretório quiser participar das funcionalidades de pesquisa de email e telefone, ele também deverá implementar CommonDataKinds.Email#CONTENT_FILTER_URI CommonDataKinds.Email.CONTENT_FILTER_URI e CommonDataKinds.Phone#CONTENT_FILTER_URI CommonDataKinds.Phone.CONTENT_FILTER_URI.

Um provedor de diretório deve retornar NULL para cada campo de projeção que não reconhece, em vez de gerar uma exceção. Dessa forma, ele não será interrompido se ContactsContract for estendido com novos campos no futuro.

O cliente interage com um diretório por meio do Provedor de Contatos fornecendo um parâmetro de consulta opcional directory= .

Quando o Provedor de Contatos recebe a solicitação, ele transforma o URI e encaminha a solicitação para o provedor de conteúdo de diretório correspondente. O URI é transformado da seguinte maneira: <ul><li>A autoridade de URI é substituída pelo correspondente#DIRECTORY_AUTHORITY.</li><li>O accountName= parâmetro e os accountType= parâmetros são adicionados ou substituídos usando os valores e #ACCOUNT_TYPE os correspondentes#ACCOUNT_NAME.</li></ul>

Os clientes devem enviar solicitações de diretório para o Provedor de Contatos e deixá-lo encaminhá-los para os respectivos provedores em vez de construir URIs do provedor de diretório sozinhos. Esse nível de indireção permite que o Provedor de Contatos implemente recursos e otimizações adicionais no nível do sistema. O acesso ao Provedor de Contatos é protegido pela permissão READ_CONTACTS, mas o acesso ao provedor de diretório é protegido por BIND_DIRECTORY_SEARCH. Essa permissão foi introduzida no nível 17 da API, para versões anteriores da plataforma, o provedor deve executar a seguinte verificação para verificar se a chamada está vindo do ContactsProvider:

private boolean isCallerAllowed() {
              PackageManager pm = getContext().getPackageManager();
              for (String packageName: pm.getPackagesForUid(Binder.getCallingUid())) {
                if (packageName.equals("com.android.providers.contacts")) {
                  return true;
                }
              }
              return false;
            }

</p>

A tabela Diretório é somente leitura e é mantida pelo Provedor de Contatos automaticamente.

Ele sempre tem pelo menos essas duas linhas: <ul><li> O diretório local. Ele tem Directory#_ID Directory._ID = Directory#DEFAULT Directory.DEFAULT. Esse diretório pode ser usado para acessar contatos armazenados localmente. O mesmo pode ser obtido omitindo o directory= parâmetro completamente. </li><li> Os contatos invisíveis locais. A ID do diretório correspondente é Directory#LOCAL_INVISIBLE Directory.LOCAL_INVISIBLE. </li></ul>

Os Diretórios Personalizados são descobertos pelo Provedor de Contatos seguindo este procedimento: <ul><li>Ele localiza todos os provedores de conteúdo instalados com metadados identificando-os como provedores de diretório no AndroidManifest.xml: <meta-data android:name="android.content.ContactDirectory" android:value="true" />

Essa marca deve ser colocada dentro da declaração do provedor de conteúdo correspondente.

</li li><> Em seguida, o Provedor de Contatos envia uma consulta para cada uma Directory#CONTENT_URI Directory.CONTENT_URI das autoridades de diretório. Um provedor de diretório deve implementar essa consulta e retornar uma lista de diretórios. Cada diretório retornado pelo provedor deve ter uma combinação exclusiva para as #ACCOUNT_NAME colunas ( #ACCOUNT_TYPE nulos são permitidos). Como as IDs de diretório são atribuídas automaticamente, o campo _ID não fará parte da projeção de consulta. </li li><>Contacts Provider compila listas de diretórios recebidas de todos os provedores de diretório em um, atribui a cada diretório individual uma ID global exclusiva e armazena todos os registros de diretório na tabela Diretório. </li></ul></p>

O Provedor de Contatos interroga automaticamente pacotes recém-instalados ou substituídos. Portanto, simplesmente instalar um pacote que contém um provedor de diretório é suficiente para que esse provedor seja registrado. Um pacote que fornece um provedor de diretório não precisa conter atividades inicializáveis.

Cada linha na tabela Diretório é automaticamente associada ao pacote correspondente (apk). Se o pacote for desinstalado posteriormente, todas as linhas de diretório correspondentes serão removidas automaticamente do Provedor de Contatos.

Quando a lista de diretórios tratados por um provedor de diretório é alterada (por exemplo, quando o usuário adiciona uma nova conta de Diretório), o provedor de diretório deve chamar #notifyDirectoryChange para notificar o Provedor de Contatos da alteração. Em resposta, o Provedor de Contatos requer o provedor de diretório para obter a nova lista de diretórios.

Uma linha de diretório pode ser opcionalmente associada a uma conta existente (consulte android.accounts.AccountManager). Se a conta for removida posteriormente, as linhas de diretório correspondentes serão removidas automaticamente do Provedor de Contatos.

Java documentação para android.provider.ContactsContract.Directory.

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.