public static final class ContactsContract.Contacts.Entity
extends Object
implements BaseColumns, ContactsContract.ContactsColumns, ContactsContract.ContactNameColumns, ContactsContract.RawContactsColumns, ContactsContract.BaseSyncColumns, ContactsContract.SyncColumns, ContactsContract.DataColumns, ContactsContract.StatusColumns, ContactsContract.ContactOptionsColumns, ContactsContract.ContactStatusColumns, ContactsContract.DataUsageStatColumns
java.lang.Object | |
↳ | android.provider.ContactsContract.Contacts.Entity |
包含所有ContactsContract.RawContacts
以及ContactsContract.Data
行的ContactsContract.Data
。 要访问此目录,请将CONTENT_DIRECTORY
附加到联系人URI。
实体有三个ID字段: CONTACT_ID
为RAW_CONTACT_ID
,原始联系人为DATA_ID
,数据DATA_ID
。 即使没有实际的数据行,实体始终每个组成原始联系至少包含一行。 在这种情况下, DATA_ID
字段将为空。
实体在一次交易中读取整个联系人的所有数据,以确保一致性。 实体中存在重要的数据重复(每行重复所有联系人列和所有RawContact列),因此应该权衡事务一致性的好处与从提供程序传输大量非规范化数据的成本。
为了减少数据重复的数量,实现此协议的联系人提供程序和目录提供程序被允许在仅为每个原始联系人返回的第一行中提供常用联系人和RawContacts字段,并在后续行中将它们留空。
Constants |
|
---|---|
String |
CONTENT_DIRECTORY 该子表的目录分支 |
String |
DATA_ID 数据行的ID。 |
String |
RAW_CONTACT_ID 原始联系人行的ID。 |
Inherited constants |
---|
From interface android.provider.BaseColumns
|
From interface android.provider.ContactsContract.ContactsColumns
|
From interface android.provider.ContactsContract.ContactNameColumns
|
From interface android.provider.ContactsContract.RawContactsColumns
|
From interface android.provider.ContactsContract.BaseSyncColumns
|
From interface android.provider.ContactsContract.SyncColumns
|
From interface android.provider.ContactsContract.DataColumns
|
From interface android.provider.ContactsContract.StatusColumns
|
From interface android.provider.ContactsContract.ContactOptionsColumns
|
From interface android.provider.ContactsContract.ContactStatusColumns
|
From interface android.provider.ContactsContract.DataUsageStatColumns
|
Inherited methods |
|
---|---|
From class java.lang.Object
|
String RAW_CONTACT_ID
原始联系人行的ID。
类型:INTEGER
常量值:“raw_contact_id”