联系人合同。数据

课程概述

数据表的常量，其中包含绑定到原始联系人。数据表的每一行通常用于存储单个接触件信息（如电话号码）及其关联的元数据（例如它是工作号码还是家庭号码）。

数据类型

数据是一个通用表，可以保存任何类型的联系人数据。存储在给定行中的数据类型由行的MIMETYPE公司值，它决定常规列数据A1通过数据15.例如，如果数据类型为电话。目录_ TEM_TYPE，然后是列数据A1存储电话号码，但如果数据类型是电子邮件。目录_ TEM_TYPE，然后数据A1存储电子邮件地址。同步适配器和应用程序可以引入自己的数据类型。

ContactsContract定义了少量预定义的数据类型，例如。联系人合同。通用数据种类。电话，联系人合同。通用数据种类。电子邮件等作为这些类为DATA1等定义了特定于数据类型的别名，非常方便。例如，电话。编号与相同数据。数据A1.

数据A1是索引列，应用于预期在查询选择中使用最频繁。例如，在表示电子邮件地址的行大小写数据A1应该很可能用于电子邮件地址本身，而数据A2等可以是用于电子邮件地址类型等辅助信息。

按照惯例，数据15用于存储BLOB（二进制数据）。

给定帐户类型的同步适配器必须正确处理每种数据类型用于相应的原始触点。否则可能导致丢失或损坏的数据。

同样，您应该避免为其他人引入新类型的数据参与方的帐户类型。例如，如果为添加数据行谷歌账户拥有的原始联系人的“最喜欢的歌曲”，不会同步到服务器，因为Google同步适配器不知道如何处理这种数据类型。因此，新的数据类型通常是引入了新的帐户类型，即新的同步适配器。

批处理操作

可以使用传统的插入（Uri，ContentValues），更新（Uri，ContentValues，String，String[]）和delete（Uri，String，String[]）方法，但基于更新的机制在一批内容提供者操作将证明是更好的几乎在所有情况下都有选择。批处理中的所有操作都在单个事务，确保电话端和服务器端原始触点的状态总是一致的。此外，基于批处理的这种方法要有效得多：不仅是数据库操作在单个事务中执行时速度更快，但也可以发送一批向内容提供者发送命令可以节省大量上下文切换时间在您的进程和内容提供程序运行的进程之间。

使用批处理操作的另一方面是，大批处理可能会锁定长时间关闭数据库，防止其他应用程序访问数据并可能导致ANR（“应用程序没有响应”）对话框。）

为了避免数据库被锁定，请确保插入“屈服点”在批次中。屈服点向内容提供商指示执行下一个操作可以提交已经发生的更改已发出，屈服于其他请求，打开另一个事务并继续处理操作。屈服点不会自动提交事务，但仅当有另一个请求等待数据库。通常，同步适配器应在批次中每个原始接触操作序列的开始。请参阅允许产量（布尔值）.

操作

插入

可以使用传统的插入（Uri，ContentValues）方法。多行应始终作为批插入。

传统插件示例：

ContentValues值=新ContentValues（）；values.put（Data.RAW_CONTACT_ID，rawContactId）；values.put（Data.MMETYPE，Phone.CONTENT_ITEM_TYPE）；values.put（电话号码，“1-800-GOOG-411”）；values.put（Phone.TYPE，Phone.TypeE_CUSTOM）；values.put（Phone.LABEL，“免费目录帮助”）；Uri数据Uri=getContentResolver（）.insert（Data.CONTENT_Uri，values）；

使用ContentProviderOperations也是如此：

阵列列表<ContentProviderOperation>ops=new ArrayList<ContentProviderOperation>（）；ops.add（ContentProviderOperation.newInsert（Data.CONTENT_URI）.withValue（数据.RAW_CONTACT_ID，原始联系人ID）.withValue（数据.MMETYPE，电话.CONTENT_ITEM_TYPE）.withValue（电话号码，“1-800-GOOG-411”）.withValue（电话.TYPE，电话.TYPE_CUSTOM）.withValue（电话.LABEL，“免费目录帮助”）.build（））；getContentResolver（）.applyBatch（ContactsContract.AUTHORITY，操作）；

更新

与插入一样，更新可以增量完成，也可以成批完成，批处理模式是首选方法：

阵列列表<ContentProviderOperation>ops=new ArrayList<ContentProviderOperation>（）；ops.add（ContentProviderOperation.newUpdate（Data.CONTENT_URI）.withSelection（Data.ID+“=？”，新字符串[]{String.valueOf（dataId）}）.withValue（电子邮件.DATA，“somebody@android.com").build（））；getContentResolver（）.applyBatch（ContactsContract.AUTHORITY，操作）；

删除

就像插入和更新一样，可以使用delete（Uri，String，String[]）方法或使用ContentProviderOperation：

阵列列表<ContentProviderOperation>ops=new ArrayList<ContentProviderOperation>（）；ops.add（ContentProviderOperation.newDelete（Data.CONTENT_URI）.withSelection（Data.ID+“=？”，新字符串[]{String.valueOf（dataId）}）.build（））；getContentResolver（）.applyBatch（ContactsContract.AUTHORITY，操作）；

查询

查找给定联系人的给定类型的所有数据

光标c=getContentResolver（）.query（Data.CONTENT_URI，new String[]{数据_ID，电话号码，电话类型，电话标签}，数据。CONTACT_ID+“=？”+“AND”+数据。MIMETYPE+“='”+电话。CONTENT_ITEM_TYPE+“”，new String[]{String.valueOf（contactId）}，null）；

查找给定原始联系人的给定类型的所有数据

光标c=getContentResolver（）.query（Data.CONTENT_URI，new String[]{数据_ID，电话号码，电话类型，电话标签}，数据。原始联系人ID+“=？”+“AND”+数据。MIMETYPE+“='”+电话。CONTENT_ITEM_TYPE+“”，new String[]{String.valueOf（rawContactId）}，null）；

查找给定原始联系人的所有数据

大多数同步适配器都希望读取原始联系人的所有数据行以及原始接触本身。为此，您应该使用联系人合同。原始联系人实体。另请参阅联系人合同。原始联系人.

柱

许多列通过内容_ URI查询。为了您的最佳表现应该显式地指定只对您需要的那些列的投影。

最近关联状态更新中的一些列也可用通过隐式联接。

关联原始联系人中的一些列也可以通过隐式联接。其他列在此中被排除在外，因为它们不感兴趣上下文。

关联的聚合联系人表的ID列联系人合同。联系人可用通过隐式联接联系人合同。原始联系人表，参见上文。此表中的其余列还包括可用，通过隐式联接。这个方便查找单个数据元素的值，例如电子邮件地址。

总结

[展开] 继承的常量
来自接口android.provider。基础列 字符串 _计数 目录中的行数。 字符串 _身份证 行的唯一ID。
来自接口android.provider。联系人合同。联系人姓名列 字符串 显示名称_长期 显示名称的另一种表示形式，例如“姓氏优先”而不是西方名字的“名字优先”。 字符串 显示_名称_主要 显示为联系人显示名称的标准文本，基于最佳联系人的可用信息（例如，可能是电子邮件地址如果名称不可用）。 字符串 显示名称源 用作联系人显示名称的数据类型，例如结构化名称或电子邮件地址。 字符串 电话_姓名 指定的拼音字母表中全名的发音电话_姓名_款式. 字符串 电话_姓名_款式 用于表示电话_姓名. 字符串 分拣_钥匙_长期 基于全名的替代表示的排序键，显示名称_长期. 字符串 排序_关键_主要 考虑到基于本地的排序传统的排序键通讯簿中的姓名。
来自接口android.provider。联系人合同。联系人选项列 字符串 自定义RINGTONE 与联系人关联的自定义铃声的URI。 字符串 上次联系时间 上次联系联系人的时间。 字符串 发送给发票 联系人是否应始终发送到语音邮件。 字符串 已启动 联系人有星号吗？ 类型：INTEGER（布尔） 字符串 时间_已连接 联系联系人的次数 类型：整数
来自接口android.provider。联系人合同。联系人状态列 字符串 联系人_角色_能力 联系聊天功能。 字符串 联系人姓名 联系人状态。 字符串 联系人状态 联系人的最新状态更新。 字符串 联系人_状态_ICON 联系人状态源图标的资源ID。 字符串 联系人_状态_标签 描述联系人来源的标签的资源ID状态，例如。 字符串 联系人状态资源包 包含此状态资源的包：标签和图标。 字符串 联系人状态时间戳 最新状态为插入/更新。
来自接口android.provider。联系人合同。联系人栏 字符串 CONTACT_LAST_UPDATED_TIMESTAMP联系方式 上次更新此联系人的时间戳（自epoch以来的毫秒数）。 字符串 显示_名称 联系人的显示名称。 字符串 HAS_电话_号码 指示此联系人是否至少有一个电话号码的指示器。 字符串 IN_VISIBLE_组 反映组_可用任何状态联系人合同。通用数据种类。组成员身份用于此联系人。 字符串 IS_用户_处理文件 反映此联系人是否代表用户的个人配置文件条目。 字符串 LOOKUP_键 一个不透明的值，包含如何查找联系人的提示，如果由于同步或聚合，其行id发生了更改。 字符串 照片文件ID 全尺寸照片的照片文件ID。 字符串 照片_ID 对数据表中保存照片的行的引用。 字符串 照片_ HUMBNAIL_URI 可用于检索联系人照片缩略图的URI。 字符串 照片_ URI 可用于检索联系人的全尺寸照片的URI。
来自接口android.provider。联系人合同。数据列 字符串 数据A1 通用数据列，其含义为MIMETYPE公司具体的 字符串 数据A10 通用数据列，含义是模拟型具体的 字符串 数据11 通用数据列，含义是模拟型具体的 字符串 数据12 通用数据列，含义是MIMETYPE公司具体的 字符串 数据13 通用数据列，含义是MIMETYPE公司具体的 字符串 数据14 通用数据列，含义是MIMETYPE公司具体的 字符串 数据15 通用数据列，含义是MIMETYPE公司具体而言。 字符串 数据A2 通用数据列，含义是MIMETYPE公司具体的 字符串 数据3 通用数据列，含义是MIMETYPE公司具体的 字符串 数据4 通用数据列，其含义为MIMETYPE公司具体的 字符串 数据5 通用数据列，含义是MIMETYPE公司具体的 字符串 数据A6 通用数据列，含义是MIMETYPE公司具体的 字符串 数据7 通用数据列，含义是MIMETYPE公司具体的 字符串 数据8 通用数据列，含义是MIMETYPE公司具体的 字符串 数据A9 通用数据列，含义是MIMETYPE公司具体的 字符串 数据_版本 此数据记录的版本。 字符串 IS_主要 这是否是其所属原始触点的主要条目。 字符串 IS_只读 “只读”标志：默认为“0”，如果无法修改行或已删除，同步适配器除外。 字符串 IS_上游_主要 这是否是骨料的主要分录它所属的联系人。 字符串 MIMETYPE公司 此行表示的项的MIME类型。 字符串 原始合同ID 对_ID编号此数据所属的。 字符串 同步1 供同步适配器使用的通用列。 字符串 同步2 供同步适配器使用的通用列。 字符串 同步3 供同步适配器使用的通用列。 字符串 同步4 供同步适配器使用的通用列。
来自接口android.provider。联系人合同。数据使用状态列 字符串 上次使用时间 上次执行此操作的时间（毫秒）联系人合同。联络。数据已使用。 字符串 时间（_USED） 引用的次数联系人合同。联络。数据已使用。
来自接口android.provider。联系人合同。原始联系人列 字符串 聚合模式 此联系人的聚合模式。 字符串 联系人ID 对_ID编号这个数据属于。 字符串 数据_设置 此行所属帐户中的数据集。 字符串 删除 “已删除”标志：默认为“0”，如果行已标记为“1”删除。 字符串 仅原始接触 “只读”标志：默认为“0”，如果无法修改行或已删除，同步适配器除外。 字符串 原始联系人_IS_USER_PROFILE 反映此原始联系人是否属于用户的个人配置文件条目。
来自接口android.provider。联系人合同。状态列 整数 可用 允许值为在场. 整数 远离 允许值为出席. 整数 能力_HAS_CAMERA 允许的标志图表_能力. 整数 能力_HAS_VIDEO 允许的标志图表_能力. 整数 能力_HAS_VOICE 允许的标志图表_能力. 字符串 图表_能力 联系人的音频/视频聊天功能级别。 整数 DO_NOT_DISTURB公司 允许值为出席. 整数 怠速 允许值为出席. 整数 无形 允许的值出席. 整数 离线 允许值为出席. 字符串 出席 联系人的最新状态级别。 字符串 当前_自定义_状态 此常量已弃用API级别8。使用状态 字符串 存在_状态 此常量已弃用空气污染指数第8级。使用出席 字符串 状态 联系最新状态更新。 字符串 状态_图标 状态更新源的图标的资源ID。 字符串 状态_标签 描述状态更新源的标签的资源ID，例如。 字符串 状态_资源_包 包含此状态资源的包：标签和图标。 字符串 状态_时间戳 插入/更新最新状态的绝对时间（毫秒）。

[展开] 继承的方法

来自班级java.lang.Object（java.lang.对象） 对象 克隆() 创建并返回此对象. 布尔值 等于(对象o） 将此实例与指定对象进行比较，并指示它们是否都是平等的。 空隙 最后确定() 当垃圾收集器检测到此实例不再可访问时调用。 最终的等级<?> 获取类() 返回的唯一实例等级代表这一点的对象的类。 整数 哈希代码() 返回此对象的整数哈希代码。 最终的空隙 通知() 导致线程等待此对象的监视器（通过呼叫其中一个wait（）方法）被唤醒。 最终的空隙 通知全部() 导致所有等待此对象监视器的线程（通过呼叫其中一个wait（）方法）被唤醒。 字符串 toString（字符串）() 返回一个字符串，该字符串包含此对象。 最终的空隙 等待() 使调用线程等待另一个线程调用通知（）或notifyAll（）方法。 最终的空隙 等待（长毫微秒，整数纳米） 使调用线程等待另一个线程调用通知（）或notifyAll（）方法或直到指定的超时过期。 最终的空隙 等待（长毫） 使调用线程等待另一个线程调用通知（）或notifyAll（）方法或直到指定的超时过期。