public final class ContactsContract
extends Object
| java.lang.Object | |
| ↳ | android.provider.ContactsContract |
联系人提供商与应用程序之间的合同。 包含支持的URI和列的定义。 这些API取代ContactsContract.Contacts 。
ContactsContract定义了与联系人相关的信息的可扩展数据库。 联系人信息存储在三层数据模型中：
Android开发手册ContactsContract.Data table can store any kind of personal data, such as a phone number or email addresses. The set of data kinds that can be stored in this table is open-ended. There is a predefined set of common kinds, but any application can add its own data kinds. ContactsContract.RawContacts table represents a set of data describing a person and associated with a single account (for example, one of the user's Gmail accounts). ContactsContract.Contacts table represents an aggregate of one or more RawContacts presumably describing the same person. When data in or associated with the RawContacts table is changed, the affected aggregate contacts are updated as necessary. 其他表格包括：
ContactsContract.Groups, which contains information about raw contact groups such as Gmail contact groups. The current API does not support the notion of groups spanning multiple accounts. ContactsContract.StatusUpdates, which contains social status updates including IM availability. ContactsContract.AggregationExceptions, which is used for manual aggregation and disaggregation of raw contacts ContactsContract.Settings, which contains visibility and sync settings for accounts and groups. ContactsContract.SyncState, which contains free-form data maintained on behalf of sync adapters ContactsContract.PhoneLookup, which is used for quick caller-ID lookupConstants |
|
|---|---|
String |
AUTHORITY 联系人提供商的权限 |
String |
CALLER_IS_SYNCADAPTER 用于插入，更新或删除查询的可选URI参数，允许调用方指定它是同步适配器。 |
String |
DEFERRED_SNIPPETING 游标“额外”包中布尔值的一个键。 |
String |
DEFERRED_SNIPPETING_QUERY 检索客户端游标原始延迟片段的关键。 |
String |
DIRECTORY_PARAM_KEY 查询参数，客户端应使用该参数来访问特定的 |
String |
LIMIT_PARAM_KEY 限制返回结果数量的查询参数。 |
String |
PRIMARY_ACCOUNT_NAME 查询参数，指定主帐户。 |
String |
PRIMARY_ACCOUNT_TYPE 查询参数，指定主帐户。 |
String |
REMOVE_DUPLICATE_ENTRIES 对于布尔参数 |
String |
STREQUENT_PHONE_ONLY
|
Fields |
|
|---|---|
public static final Uri |
AUTHORITY_URI content：// style uri给联系人提供者的权限 |
Public constructors |
|
|---|---|
ContactsContract() |
|
Public methods |
|
|---|---|
static boolean |
isProfileId(long id) 此方法可用于识别给定ID是否与配置文件数据相关联。 |
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
String CALLER_IS_SYNCADAPTER
用于插入，更新或删除查询的可选URI参数，允许调用方指定它是同步适配器。 默认值是false。 如果真DIRTY不会自动设置和调用当“syncToNetwork”参数设置为false notifyChange(android.net.Uri, android.database.ContentObserver, boolean) 。 这可以防止不必要的额外同步，请参阅ContactsContract.RawContacts中有关删除操作的讨论。
常量值：“caller_is_syncadapter”
String DEFERRED_SNIPPETING
游标“额外”包中布尔值的一个键。 布尔值表示提供者没有创建片段，并且请求片段的客户端应该这样做（true表示片段延迟到客户端）。
常量值：“deferred_snippeting”
String DEFERRED_SNIPPETING_QUERY
检索客户端游标原始延迟片段的关键。
常量值：“deferred_snippeting_query”
String DIRECTORY_PARAM_KEY
查询参数，客户端应使用该参数来访问特定的ContactsContract.Directory 。 参数值应该是相应目录的_ID，例如content://com.android.contacts/data/emails/filter/acme?directory=3
常量值：“目录”
String PRIMARY_ACCOUNT_NAME
查询参数，指定主帐户。 该参数应与PRIMARY_ACCOUNT_TYPE一起使用。 处理查询的联系人提供程序可能依赖此信息来优化其查询结果。 例如，在电子邮件撰写屏幕中，其实施可以在获取可能的收件人时指定帐户，让提供者知道在撰写期间选择了哪个帐户。 提供者可以使用“主帐户”信息来优化搜索结果。
常量值：“name_for_primary_account”
String PRIMARY_ACCOUNT_TYPE
查询参数，指定主帐户。 该参数应与PRIMARY_ACCOUNT_NAME一起使用。 请参阅PRIMARY_ACCOUNT_NAME的文档。
常量值：“type_for_primary_account”
String REMOVE_DUPLICATE_ENTRIES
对于布尔参数Phone.CONTENT_URI ， Email.CONTENT_URI ，并StructuredPostal.CONTENT_URI 。 这使内容提供者能够删除结果中的重复条目。
常量值：“remove_duplicate_entries”
String STREQUENT_PHONE_ONLY
CONTENT_STREQUENT_URI和CONTENT_STREQUENT_FILTER_URI布尔参数，它要求ContactsProvider仅返回与电话相关的结果。 例如，经常联系人列表应该包括通过电话联系的人（不是电子邮件，短信等）
常量值：“strequent_phone_only”
boolean isProfileId (long id)
此方法可用于识别给定ID是否与配置文件数据相关联。 它并不一定表示该ID与有效数据绑定，只是使用此ID访问数据将导致配置文件访问检查，并且只会从配置文件返回数据。
| Parameters | |
|---|---|
id |
long: The ID to check. |
| Returns | |
|---|---|
boolean |
Whether the ID is associated with profile data. |