ContactsContract.Data Klasse

Definition

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

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

Vererbung

Object

JavaObject

Object

ContactsContract.Data

Attribute

RegisterAttribute

Hinweise

Konstanten für die Datentabelle, die Datenpunkte enthält, die an einen unformatierten Kontakt gebunden sind. Jede Zeile der Datentabelle wird in der Regel verwendet, um ein einzelnes Element von Kontaktinformationen (z. B. eine Telefonnummer) und die zugehörigen Metadaten (z. B. ob es sich um eine geschäftliche oder private Nummer handelt) zu speichern.

<h3>Datentypen</h3>

Daten sind eine generische Tabelle, die jede Art von Kontaktdaten enthalten kann. Die Art der in einer bestimmten Zeile gespeicherten Daten wird durch den Wert der Zeile #MIMETYPE angegeben, der die Bedeutung der generischen Spalten #DATA1 durch #DATA15bestimmt. Wenn der Datentyp beispielsweise lautet CommonDataKinds.Phone Phone.CONTENT_ITEM_TYPE, speichert die Spalte #DATA1 die Telefonnummer, aber wenn die Datentyp ist CommonDataKinds.Email Email.CONTENT_ITEM_TYPE, speichert #DATA1 die Spalte die E-Mail-Adresse. Synchronisierungsadapter und Anwendungen können eigene Datentypen einführen.

ContactsContract definiert eine kleine Anzahl vordefinierter Datentypen, z. B. CommonDataKinds.Phone, CommonDataKinds.Email usw. Aus Gründen der Einfachheit definieren diese Klassen datentypspezifische Aliase für DATA1 usw. Ist z. B CommonDataKinds.Phone Phone.NUMBER . identisch mit ContactsContract.Data Data.DATA1.

#DATA1 ist eine indizierte Spalte und sollte für das Datenelement verwendet werden, das voraussichtlich am häufigsten in Abfrageauswahlen verwendet wird. Beispielsweise sollte bei einer Zeile, die E-Mail-Adressen #DATA1 darstellt, wahrscheinlich für die E-Mail-Adresse selbst verwendet werden, während #DATA2 usw. für Hilfsinformationen wie den Typ der E-Mail-Adresse verwendet werden kann.

In der Konvention #DATA15 wird zum Speichern von BLOBs (Binärdaten) verwendet.

Der Synchronisierungsadapter für einen bestimmten Kontotyp muss jeden Datentyp, der in den entsprechenden rohen Kontakten verwendet wird, ordnungsgemäß verarbeiten. Andernfalls kann dies zu verlorenen oder beschädigten Daten führen.

Ebenso sollten Sie nicht neue Arten von Daten für die Kontotypen einer anderen Partei einführen. Wenn Sie z. B. eine Datenzeile für "Lieblingstitel" zu einem unformatierten Kontakt hinzufügen, der sich im Besitz eines Google-Kontos befindet, wird sie nicht mit dem Server synchronisiert, da der Google-Synchronisierungsadapter nicht weiß, wie diese Datentyp behandelt werden kann. Daher werden in der Regel neue Datentypen zusammen mit neuen Kontotypen eingeführt, d. h. neue Synchronisierungsadapter.

<h3>Batchvorgänge</h3>

Datenzeilen können mithilfe der herkömmlichen ContentResolver#insertContentResolver#update Methoden ContentResolver#delete eingefügt/aktualisiert/gelöscht werden. Der neuere Mechanismus, der auf einem Batch ContentProviderOperation basiert, ist jedoch in fast allen Fällen eine bessere Wahl. Alle Vorgänge in einem Batch werden in einer einzelnen Transaktion ausgeführt, wodurch sichergestellt wird, dass der telefonseitige und serverseitige Zustand eines unformatierten Kontakts immer konsistent ist. Außerdem ist der batchbasierte Ansatz wesentlich effizienter: Nicht nur die Datenbankvorgänge werden schneller ausgeführt, wenn sie in einer einzelnen Transaktion ausgeführt werden, sondern auch das Senden einer Reihe von Befehlen an den Inhaltsanbieter spart viel Zeit beim Wechseln zwischen Ihrem Prozess und dem Prozess, in dem der Inhaltsanbieter ausgeführt wird.

Die Flip-Seite der Verwendung von Batchvorgängen besteht darin, dass ein großer Batch die Datenbank für eine lange Zeit sperren kann, um zu verhindern, dass andere Anwendungen auf Daten zugreifen und möglicherweise ANRs verursachen ("Dialogfelder nicht reagierende Anwendung").

Um solche Sperren der Datenbank zu vermeiden, stellen Sie sicher, dass Sie "Ertragspunkte" in den Batch einfügen. Ein Ertragspunkt gibt an, dass der Inhaltsanbieter vor dem Ausführen des nächsten Vorgangs die bereits vorgenommenen Änderungen übernehmen kann, andere Anforderungen zurückgibt, eine andere Transaktion öffnen und die Verarbeitung fortsetzen kann. Ein Renditepunkt führt nicht automatisch einen Commit für die Transaktion durch, sondern nur, wenn eine andere Anforderung auf die Datenbank wartet. Normalerweise sollte ein Synchronisierungsadapter am Anfang jeder rohen Kontaktvorgangssequenz in den Batch einen Ertragspunkt einfügen. Siehe ContentProviderOperation.Builder#withYieldAllowed(boolean).

<h3>Operations</h3><dl><dt><b>Insert</b></dt><dd>

Eine einzelne Datenzeile kann mithilfe der herkömmlichen ContentResolver#insert(Uri, ContentValues) Methode eingefügt werden. Mehrere Zeilen sollten immer als Batch eingefügt werden.

Ein Beispiel für ein herkömmliches Einfügen:

ContentValues values = new ContentValues();
            values.put(Data.RAW_CONTACT_ID, rawContactId);
            values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
            values.put(Phone.NUMBER, "1-800-GOOG-411");
            values.put(Phone.TYPE, Phone.TYPE_CUSTOM);
            values.put(Phone.LABEL, "free directory assistance");
            Uri dataUri = getContentResolver().insert(Data.CONTENT_URI, values);

Identisch mit ContentProviderOperations:

ArrayList<ContentProviderOperation> ops =
                     new ArrayList<ContentProviderOperation>();

            ops.add(ContentProviderOperation.newInsert(Data.CONTENT_URI)
                     .withValue(Data.RAW_CONTACT_ID, rawContactId)
                     .withValue(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE)
                     .withValue(Phone.NUMBER, "1-800-GOOG-411")
                     .withValue(Phone.TYPE, Phone.TYPE_CUSTOM)
                     .withValue(Phone.LABEL, "free directory assistance")
                     .build());
            getContentResolver().applyBatch(ContactsContract.AUTHORITY, ops);

</p><dt><b>Update</b></dt><dd>

Genau wie beim Einfügen kann die Aktualisierung inkrementell oder als Batch erfolgen, wobei der Batchmodus die bevorzugte Methode ist:

ArrayList<ContentProviderOperation> ops =
                     new ArrayList<ContentProviderOperation>();

            ops.add(ContentProviderOperation.newUpdate(Data.CONTENT_URI)
                     .withSelection(Data._ID + "=?", new String[]{String.valueOf(dataId)})
                     .withValue(Email.DATA, "somebody@android.com")
                     .build());
            getContentResolver().applyBatch(ContactsContract.AUTHORITY, ops);

</p></dd><dt b><>Delete</b></dt><dd>

Genau wie beim Einfügen und Aktualisieren kann das Löschen entweder mithilfe der ContentResolver#delete Methode oder mithilfe einer ContentProviderOperation erfolgen:

ArrayList<ContentProviderOperation> ops =
                     new ArrayList<ContentProviderOperation>();

            ops.add(ContentProviderOperation.newDelete(Data.CONTENT_URI)
                     .withSelection(Data._ID + "=?", new String[]{String.valueOf(dataId)})
                     .build());
            getContentResolver().applyBatch(ContactsContract.AUTHORITY, ops);

</p></dd><dt><b>Query</b></dt><dd>

<dl><dt suchen>alle Daten eines bestimmten Typs für einen bestimmten Kontakt</dt><dd>

Cursor c = getContentResolver().query(Data.CONTENT_URI,
                     new String[] {Data._ID, Phone.NUMBER, Phone.TYPE, Phone.LABEL},
                     Data.CONTACT_ID + "=?" + " AND "
                             + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'",
                     new String[] {String.valueOf(contactId)}, null);

</p>

</dd><dt>Suchen aller Daten eines bestimmten Typs für einen bestimmten rohen Kontakt</dtd><>

Cursor c = getContentResolver().query(Data.CONTENT_URI,
                     new String[] {Data._ID, Phone.NUMBER, Phone.TYPE, Phone.LABEL},
                     Data.RAW_CONTACT_ID + "=?" + " AND "
                             + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'",
                     new String[] {String.valueOf(rawContactId)}, null);

</dd><dt>Suchen aller Daten für einen bestimmten rohen Kontakt</dt><dd> Die meisten Synchronisierungsadapter möchten alle Datenzeilen für einen rohen Kontakt zusammen mit dem rohen Kontakt selbst lesen. Dafür sollten Sie die RawContactsEntity. Siehe auch RawContacts. </dd></dl></p></dd></dl><h2>Columns</h2>

Viele Spalten sind über eine Data#CONTENT_URI Abfrage verfügbar. Um eine optimale Leistung zu erzielen, sollten Sie explizit eine Projektion nur für die benötigten Spalten angeben.

<table class="jd-sumtable"><tr><th colspan='4'Data></th></tr td><><style="width: 7em;">long</td td><style="width: 20em;">#_ID</td td><style="width: 5em;">read-only</td td><>Row ID. Der Synchronisierungsadapter sollte versuchen, Zeilen-IDs während Updates beizubehalten. Mit anderen Worten, es wäre eine schlechte Idee, eine Datenzeile zu löschen und erneut einzugeben. Ein Synchronisierungsadapter sollte stattdessen immer ein Update durchführen.</td></tr td><><>String</td td><>#MIMETYPE</td td td><>read/write-once</td td><>

Der MIME-Typ des Elements, das durch diese Zeile dargestellt wird. Beispiele für gängige MIME-Typen sind: <ul><li>CommonDataKinds.StructuredName StructuredName.CONTENT_ITEM_TYPE</li><>CommonDataKinds.Phone Phone.CONTENT_ITEM_TYPE</li/li><>CommonDataKinds.Email Email.CONTENT_ITEM_TYPE</li><>CommonDataKinds.Photo Photo.CONTENT_ITEM_TYPE</li/><>CommonDataKinds.Organization Organization.CONTENT_ITEM_TYPE<li/><>CommonDataKinds.Im Im.CONTENT_ITEM_TYPE<li/li/><>CommonDataKinds.Nickname Nickname.CONTENT_ITEM_TYPE<li/><>CommonDataKinds.Note Note.CONTENT_ITEM_TYPE<li/><>CommonDataKinds.StructuredPostal StructuredPostal.CONTENT_ITEM_TYPE<li/li/><>CommonDataKinds.GroupMembership GroupMembership.CONTENT_ITEM_TYPE<><>CommonDataKinds.Website Website.CONTENT_ITEM_TYPE<li/><>CommonDataKinds.Event Event.CONTENT_ITEM_TYPE<><li>CommonDataKinds.Relation Relation.CONTENT_ITEM_TYPE</li><>CommonDataKinds.SipAddress SipAddress.CONTENT_ITEM_TYPE</li/li/ul><>

</td></tr td><><>long</td><td>#RAW_CONTACT_ID</td><td>read/write-once</td td td td td td><>Die ID der Zeile in der Tabelle, zu der RawContacts diese Daten gehören.</td></tr td><><>int</td><td>#IS_PRIMARY< td td><>read/write</td td td><>Ob dies der primäre Eintrag seiner Art für den rohen Kontakt ist, zu dem er gehört. "1", wenn wahr, "0", wenn falsch. </td></tr td><><>int</td><td>#IS_SUPER_PRIMARY< td td><read/write>/td td td td<td><>Ob dies der primäre Eintrag seiner Art für den Aggregatkontakt ist, zu dem er gehört. Jeder Datensatz, der "super primär" ist, muss auch "primär" sein. Beispielsweise kann der Haupteintrag als Standardkontaktwert seiner Art interpretiert werden (z. B. die standardtelefonnummer, die für den Kontakt verwendet werden soll).</td></tr td><><>int</td><td>#DATA_VERSION< td td><read-only/td td td td>read-only</td td td td td><>Die Version dieses Datensatzes. Wenn die Datenzeile die Version ändert, wird die Version aktualisiert. Dieser Wert nimmt monoton zu.</td></tr td><><>Any type</td td><>#DATA1<br>#DATA2<>#DATA3<>#DATA4<>#DATA5<>#DATA6<>#DATA7<>#DATA8<>#DATA9<>#DATA10<>#DATA11<>#DATA12<>#DATA13<>#DATA14</>#DATA15<td td><>read/write</td td td><>

Generische Datenspalten. Die Bedeutung jeder Spalte wird durch die #MIMETYPE. In der Konvention #DATA15 wird zum Speichern von BLOBs (Binärdaten) verwendet.

Datenspalten, deren Bedeutung für einen bestimmten MIMETYPE nicht explizit definiert ist, sollten nicht verwendet werden. Es besteht keine Garantie dafür, dass alle Synchronisierungsadapter sie beibehalten. Synchronisierungsadapter selbst sollten diese Spalten nicht verwenden, sondern stattdessen verwenden #SYNC1-#SYNC4.

</td></tr td><><>Any type</td td><>#SYNC1<br>#SYNC2<br br>#SYNC3<br>#SYNC4</td td td><>read/write</td td td><>Generic columns for use by sync adapters. Beispielsweise kann eine Fotozeile die Bild-URL in SYNC1 speichern, einen Status (nicht geladen, geladen, geladen, geladen, fehler) in SYNC2, serverseitige Versionsnummer in SYNC3 und Fehlercode in SYNC4.</td></tr></table>

Einige Spalten aus der neuesten zugeordneten Statusaktualisierung sind auch über eine implizite Verknüpfung verfügbar.

<table class="jd-sumtable"><tr><th colspan='4'Join> withStatusUpdates< /th></tr td><><style="width: 7em;">int</td td><style="width: 20em;">#PRESENCE</td td><style="width: 5em;">read-only</td td><>Chat-Anwesenheitsstatus, der mit dieser Datenzeile verknüpft ist. Vergleichen Mit #CONTACT_PRESENCE, die die Anwesenheit des Kontakts in allen Chatzeilen enthält. Siehe StatusUpdates einzelne Statusdefinitionen. Der Anbieter kann sich entscheiden, diesen Wert nicht im beständigen Speicher zu speichern. Es wird erwartet, dass der Anwesenheitsstatus regelmäßig aktualisiert wird. </td></tr td><><>String</td td><>#STATUS</td td><>read-only</td td td><>Latest status update linked with this data row.</td></tr td><><>long</td><td>#STATUS_TIMESTAMP< td td><read-only>/td td td<td><>Die absolute Zeit in Millisekunden, als der letzte Status für diese Datenzeile eingefügt/aktualisiert wurde.</td></tr td><><>String</td td><>#STATUS_RES_PACKAGE</td td><read-only>/td td td<><td>The package containing resources for this status: label and icon.</td></tr td><><>long</td><td>#STATUS_LABEL< td td><read-only>/td td td td<><>The resource ID of the label describing the source of status update linked to this data row. Diese Ressource wird von der #STATUS_RES_PACKAGE.</td></tr td><><>long</td><td>#STATUS_ICON< td><td read-only>/td td td td<><>The resource ID of the icon of the source of the status update linked to this data row. Diese Ressource wird von der #STATUS_RES_PACKAGE.</td></tr></table>

Einige Spalten aus dem zugeordneten unformatierten Kontakt sind auch über eine implizite Verknüpfung verfügbar. Die anderen Spalten werden in diesem Kontext als uninteressant ausgeschlossen.

<table class="jd-sumtable"><tr><th colspan='4'Join> withContactsContract.RawContacts< /th></tr td><><style="width: 7em;">long</td td><style="width: 20em;">#CONTACT_ID</td td><style="width: 5em;">read-only</td td><>Die ID der Zeile in der Tabelle, zu der Contacts diese Daten gehören.</td></tr td><><>int</td td><>#AGGREGATION_MODE</td td td><>read-only</td td td.><>RawContacts</td></tr td><><>int</td td><>#DELETED</td td td><>read-only</td td td.><>RawContacts</td></tr></table>

Die ID-Spalte für die zugeordnete aggregierte Kontakttabelle ContactsContract.Contacts ist über die implizite Verknüpfung zur RawContacts Tabelle verfügbar, siehe oben. Die verbleibenden Spalten aus dieser Tabelle sind auch über eine implizite Verknüpfung verfügbar. Dies erleichtert die Suche nach dem Wert eines einzelnen Datenelements, z. B. der E-Mail-Adresse.

<table class="jd-sumtable"><tr><th colspan='4'Join> withContactsContract.Contacts< /th></tr td><><style="width: 7em;">String</td td><style="width: 20em;">#LOOKUP_KEY</td td><style="width: 5em;">read-only</td><td>See ContactsContract.Contacts</td></tr><><td>String</td td><td>#DISPLAY_NAME<>< td>read-only</td><td td>See ContactsContract.Contacts</td></tr><><td>long</td><>#PHOTO_ID<>< td td>read-only</td><td td>See .ContactsContract.Contacts</td></tr td><><>int</td td><>#IN_VISIBLE_GROUP</td td td><>read-only</td td td.><>ContactsContract.Contacts</td></tr td><><>int</td td><>#HAS_PHONE_NUMBER</td td td><>read-only</td td td.><>ContactsContract.Contacts</td></tr td><><>int</td td><>#STARRED</td td td><>read-only</td td td.><>ContactsContract.Contacts</td></tr td><><>String</td td><>#CUSTOM_RINGTONE</td td td><>read-only</td td><>See .ContactsContract.Contacts</td></tr td><><>int</td td><>#SEND_TO_VOICEMAIL</td td td><>read-only</td td td.><>ContactsContract.Contacts</td></tr td><><>int</td td><>#CONTACT_PRESENCE</td td td><>read-only</td td td.><>ContactsContract.Contacts</td></tr td><><>String</td td><>#CONTACT_STATUS</td td td><>read-only</td td><>See .ContactsContract.Contacts</td></tr td><><>long</td td><>#CONTACT_STATUS_TIMESTAMP</td td td><>read-only</td td><td td>See .ContactsContract.Contacts</td></tr td><><>String</td td><>#CONTACT_STATUS_RES_PACKAGE</td td td><>read-only</td td><>See .ContactsContract.Contacts</td></tr td><><>long</td td><>#CONTACT_STATUS_LABEL</td td td><>read-only</td td><td td>See .ContactsContract.Contacts</td></tr td><><>long</td td><>#CONTACT_STATUS_ICON</td td td><>read-only</td td><td td>See .ContactsContract.Contacts</td></tr></table>

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

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.