ContactsContract.Directory Klasse

Definition

[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

Vererbung

Object

JavaObject

Object

ContactsContract.Directory

Attribute

RegisterAttribute

Hinweise

Ein Verzeichnis stellt einen Kontaktkorpus dar, z. B. lokale Kontakte, Globale Adressliste von Google Apps oder globale Unternehmensadressenliste.

Ein Verzeichnis wird als Inhaltsanbieter mit seiner eindeutigen Autorität und derselben API wie der Hauptkontaktanbieter implementiert. Es besteht jedoch keine Erwartung, dass jeder Verzeichnisanbieter diesen Vertrag vollständig implementiert. Wenn ein Verzeichnisanbieter nicht über eine Implementierung für eine bestimmte Anforderung verfügt, sollte ein UnsupportedOperationException ausgelöst werden.

Der wichtigste Anwendungsfall für Verzeichnisse ist die Suche. Es wird erwartet, dass ein Verzeichnisanbieter mindestens ContactsContract.Contacts#CONTENT_FILTER_URI Contacts.CONTENT_FILTER_URIunterstützt wird. Wenn ein Verzeichnisanbieter an E-Mail- und Telefon-Nachschlagefunktionen teilnehmen möchte, sollte er auch implementiert und implementiert CommonDataKinds.Email#CONTENT_FILTER_URI CommonDataKinds.Email.CONTENT_FILTER_URI werden CommonDataKinds.Phone#CONTENT_FILTER_URI CommonDataKinds.Phone.CONTENT_FILTER_URI.

Ein Verzeichnisanbieter sollte NULL für jedes Projektionsfeld zurückgeben, das nicht erkannt wird, anstatt eine Ausnahme zu auslösen. Auf diese Weise wird es nicht unterbrochen, wenn ContactsContract in Zukunft mit neuen Feldern erweitert wird.

Der Client interagiert über den Kontaktanbieter mit einem Verzeichnis, indem er einen optionalen directory= Abfrageparameter angibt.

Wenn der Kontaktanbieter die Anforderung empfängt, transformiert er den URI und leitet die Anforderung an den entsprechenden Verzeichnisinhaltsanbieter weiter. Der URI wird in folgender Weise transformiert: <ul><li>Die URI-Autorität wird durch die entsprechende #DIRECTORY_AUTHORITYersetzt.</li li><>Die accountName= und accountType= die Parameter werden mithilfe der entsprechenden #ACCOUNT_TYPE Werte #ACCOUNT_NAME hinzugefügt oder ersetzt.</li></ul>

Clients sollten Verzeichnisanforderungen an den Kontaktanbieter senden und sie an die jeweiligen Anbieter weiterleiten lassen, anstatt Verzeichnisanbieter-URIs selbst zu erstellen. Diese Dereferenzierungsstufe ermöglicht es dem Kontaktanbieter, zusätzliche Funktionen und Optimierungen auf Systemebene zu implementieren. Der Zugriff auf den Kontaktanbieter ist durch die READ_CONTACTS Berechtigung geschützt, der Zugriff auf den Verzeichnisanbieter ist jedoch durch BIND_DIRECTORY_SEARCH geschützt. Diese Berechtigung wurde auf API-Ebene 17 eingeführt, für frühere Plattformversionen sollte der Anbieter die folgende Überprüfung durchführen, um sicherzustellen, dass der Aufruf vom ContactsProvider stammt:

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>

Die Verzeichnistabelle ist schreibgeschützt und wird vom Kontaktanbieter automatisch verwaltet.

Es hat immer mindestens diese beiden Zeilen: <ul><li> Das lokale Verzeichnis. Es hat Directory#_ID Directory._ID = Directory#DEFAULT Directory.DEFAULT. Dieses Verzeichnis kann verwendet werden, um auf lokal gespeicherte Kontakte zuzugreifen. Dasselbe kann erreicht werden, indem der directory= Parameter vollständig weggelassen wird. </li li><> Die lokalen unsichtbaren Kontakte. Die entsprechende Verzeichnis-ID lautet Directory#LOCAL_INVISIBLE Directory.LOCAL_INVISIBLE. </li></ul>

Benutzerdefinierte Verzeichnisse werden vom Kontaktanbieter anhand dieses Verfahrens ermittelt: <ul><li>Es findet alle installierten Inhaltsanbieter mit Metadaten, die sie als Verzeichnisanbieter in AndroidManifest.xmlidentifizieren: <meta-data android:name="android.content.ContactDirectory" android:value="true" />

Dieses Tag sollte in der entsprechenden Inhaltsanbieterdeklaration platziert werden.

</li><> Then Contacts Provider sendet eine Directory#CONTENT_URI Directory.CONTENT_URI Abfrage an jede der Verzeichnisautoren. Ein Verzeichnisanbieter muss diese Abfrage implementieren und eine Liste von Verzeichnissen zurückgeben. Jedes vom Anbieter zurückgegebene Verzeichnis muss über eine eindeutige Kombination für die #ACCOUNT_NAME Und #ACCOUNT_TYPE Spalten verfügen (Nullen sind zulässig). Da Verzeichnis-IDs automatisch zugewiesen werden, ist das feld _ID nicht Teil der Abfrageprojektion. </li li><>Contacts Provider kompiliert Verzeichnislisten, die von allen Verzeichnisanbietern empfangen werden, jedem einzelnen Verzeichnis eine global eindeutige ID zuweist und alle Verzeichniseinträge in der Verzeichnistabelle speichert. </li></ul></p>

Der Kontaktanbieter fragt automatisch neu installierte oder ersetzte Pakete ab. Daher reicht einfach die Installation eines Pakets mit einem Verzeichnisanbieter aus, um diesen Anbieter registriert zu haben. Ein Paket, das einen Verzeichnisanbieter liefert, muss keine startbaren Aktivitäten enthalten.

Jede Zeile in der Verzeichnistabelle wird automatisch dem entsprechenden Paket (apk) zugeordnet. Wenn das Paket später deinstalliert wird, werden alle entsprechenden Verzeichniszeilen automatisch aus dem Kontaktanbieter entfernt.

Wenn sich die Liste der Verzeichnisse ändert, die von einem Verzeichnisanbieter verarbeitet werden (z. B. wenn der Benutzer ein neues Verzeichniskonto hinzufügt), sollte der Verzeichnisanbieter aufrufen #notifyDirectoryChange , um den Kontaktanbieter über die Änderung zu benachrichtigen. Als Antwort ruft der Kontaktanbieter den Verzeichnisanbieter erneut ab, um die neue Liste der Verzeichnisse abzurufen.

Eine Verzeichniszeile kann optional einem vorhandenen Konto zugeordnet werden (siehe android.accounts.AccountManager). Wenn das Konto später entfernt wird, werden die entsprechenden Verzeichniszeilen automatisch aus dem Kontaktanbieter entfernt.

Java Dokumentation für android.provider.ContactsContract.Directory.

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.