Pro Android学习笔记（一六十）：联系人API（3）：联系人数据

文章转载只能用于非商业性质，且不能带有虚拟货币、积分、注册等附加条件。转载须注明出处http://blog.csdn.net/flowingflying/以及作者@恺风Wei。

联系人信息

查看reference中android.provider.ContactsContract.CommonDataKinds可以知道该版本的Android API联系人中带有哪些信息。在API level 19中，我们看到有以下的信息：

而各个信息，例如Email，又有着他的结构，我们可以继续查看ContactsContract.CommondataKinds.Email。

联系人数据库

一个账号account拥有其自己的联系人，这些联系人称为raw contacts，具有自己的数据信息，例如email，phone号码，地址等。Android在people应用中提供了raw contacts的整合，不同账号的raw contact进行整合，只在列表中出现一次。

联系人信息存放在/data/data/com.android.providers.contacts/databases中。

在profile.db中存放的是personal profile账号的下属联系人。我们将contacts2.db和profile.db导出来，通过SQLiteManager看看里面的内容，也可以用SDK中的platform-tools/sqlite3.exe命令，具体的参见Pro Android学习笔记（五）：了解Content Provider（上）。

sqlite> .schema raw_contacts;
sqlite> .tables
_sync_state               phone_lookup              view_data_usage_stat
_sync_state_metadata      photo_files               view_entities
accounts                  properties                view_groups
agg_exceptions            raw_contacts              view_raw_contacts
android_metadata          search_index              view_raw_entities
calls                     search_index_content      view_stream_items
contacts                  search_index_docsize      view_v1_contact_methods
data                      search_index_segdir       view_v1_extensions
data_usage_stat           search_index_segments     view_v1_group_membership
default_directory         search_index_stat         view_v1_groups
deleted_contacts          settings                  view_v1_organizations
directories               status_updates            view_v1_people
groups                    stream_item_photos        view_v1_phones
mimetypes                 stream_items              view_v1_photos
name_lookup               v1_settings               visible_contacts
nickname_lookup           view_contacts             voicemail_status
packages                  view_data

raw contacts

每个账号下面有raw contacts表格，记录各自的raw contacts信息。通过图形工具，我们来查看raw_contacts的定义：

CREATE TABLE raw_contacts (
    _id INTEGER PRIMARY KEY AUTOINCREMENT, 
    account_id INTEGER REFERENCES accounts(_id),表明raw contact属于哪个account，可以在accounts的表中，根据_id查到account_name和account_type。
    sourceid TEXT, 表明这个raw contact在这个account中是唯一的，例如account为Google email账号，这里是用户的email ID。如何组织管理账号以及里面联系人和手机制造商有关，这里也可能weiNull。
    raw_contact_is_read_only INTEGER NOT NULL DEFAULT 0,
    version INTEGER NOT NULL DEFAULT 1,
    dirty INTEGER NOT NULL DEFAULT 0,
    deleted INTEGER NOT NULL DEFAULT 0,
    contact_id INTEGER REFERENCES contacts(_id),表格contacts中是整合的账号表，这里是对应整合表contacts中的_id。
    aggregation_mode INTEGER NOT NULL DEFAULT 0,
    aggregation_needed INTEGER NOT NULL DEFAULT 1,
    custom_ringtone TEXT,
    send_to_voicemail INTEGER NOT NULL DEFAULT 0,
    times_contacted INTEGER NOT NULL DEFAULT 0,
    last_time_contacted INTEGER,
    starred INTEGER NOT NULL DEFAULT 0,
    pinned INTEGER NOT NULL DEFAULT 2147483647,
    display_name TEXT,这是只读，有表格data中的的data列触发生成。
    display_name_alt TEXT,
    display_name_source INTEGER NOT NULL DEFAULT 0,
    phonetic_name TEXT,
    phonetic_name_style TEXT,
    sort_key TEXT COLLATE PHONEBOOK,
    phonebook_label TEXT,
    phonebook_bucket INTEGER,
    sort_key_alt TEXT COLLATE PHONEBOOK,
    phonebook_label_alt TEXT,
    phonebook_bucket_alt INTEGER,
    name_verified INTEGER NOT NULL DEFAULT 0,
    sync1 TEXT,  sync2 TEXT,  sync3 TEXT, sync4 TEXT )sync用于设备上contact与服务器之间的同步。

我们也可以在android.providers.ContactsContact.RawContact中查看相关信息。

使用SDK的定义可以特别在不同SDK版本表格出现列的增删改情况，仍可以安全地使用。但是SDK中看起来很复杂和繁琐，不容易理清，所以我们直接看表格定义。自开放式，我们将使用SDK里面的定义。

data表

在raw_contacts表格并没有存放contact的所有信息，例如电话号码、邮件等，是存放在data表中。

CREATE TABLE data (
_id INTEGER PRIMARY KEY AUTOINCREMENT,
package_id INTEGER REFERENCES package(_id),
mimetype_id INTEGER REFERENCES mimetype(_id) NOT NULL,表明是哪个信息，例如名字、电话号码等等，mimetype也将决定信息存储data1~data15的含义 。
raw_contact_id INTEGER REFERENCES raw_contacts(_id) NOT NULL,data表和raw_contacts表之间相互索引。raw_contact_id是可以重复的，用于分别存放不同的信息。
is_read_only INTEGER NOT NULL DEFAULT 0,
is_primary INTEGER NOT NULL DEFAULT 0,
is_super_primary INTEGER NOT NULL DEFAULT 0,
data_version INTEGER NOT NULL DEFAULT 0,
data1 TEXT,data2 TEXT,data3 TEXT,data4 TEXT,data5 TEXT,data6 TEXT,data7 TEXT,data8 TEXT,data9 TEXT,data10 TEXT,data11 TEXT,data12 TEXT,data13 TEXT,data14 TEXT,data15 TEXT,
data_sync1 TEXT, data_sync2 TEXT, data_sync3 TEXT, data_sync4 TEXT )

我们看一个查询的结果：

下面是表mimetype的内容，通过data中的mime_type_id可以检索具体的类型。用表格来存储类型，而不是进行固化，这可以灵活地增加、删除和修改定义，是个好的设计。

data表的各列也可以查看ContactsContract.Data，具体的某个mimetype对应的data1~data15各标识什么，可以查阅ContactsContract.CommonDataKinds.*，例如ContactsContract.CommonDataKinds.Phone。

整合联系人：表contacts

在不同的账号下面可以会有相同的联系人，Android进行了整合，存放在可读表contacts中，raw_contacts和data表有trigger可以触发来填写或者修改contacts表的数据。

CREATE TABLE contacts (
    _id INTEGER PRIMARY KEY AUTOINCREMENT,
    name_raw_contact_id INTEGER REFERENCES raw_contacts(_id),
    photo_id INTEGER REFERENCES data(_id),  
    photo_file_id INTEGER REFERENCES photo_files(_id),
    custom_ringtone TEXT,
    send_to_voicemail INTEGER NOT NULL DEFAULT 0,
    times_contacted INTEGER NOT NULL DEFAULT 0,
    last_time_contacted INTEGER,
    starred INTEGER NOT NULL DEFAULT 0,
    has_phone_number INTEGER NOT NULL DEFAULT 0,
    has_valid_sip_account INTEGER NOT NULL DEFAULT 0,
    lookup TEXT, contacts表格数据是系统根据raw contacts的数据进行生成和修改，这个表的数据会根据raw contacts的变化而变化，采用 将_id代表某个联系人，并将之作为索引，在某些情况下并不合适，因此引入了lookup，lookup是进行过编码，含有account以及其下的raw_contact联系人ID，可将之作为生成LookUpURI进行查询，获取最新整合联合人的信息。我们在下一学习的小例子进行演示。
    status_update_id INTEGER REFERENCES data(_id))

Andriod如何判断是否可以进行判断。如果两个raw_contacts名字相同，或者first name和last name的顺序不同，但内容一致，或者是缩写或昵称（例如Bob和Robert）；如果name只有first name或者last name，将查找其他属性，例如电话号码、邮件，如果其他属性也匹配，可以进行整合；如果raw contact没有name，那么将查询其他属性。

基于这些判断进行整合是可能出现误判的。在raw_contacts中aggregation_mode列，有三个值：AGGEREGATION_MODE_DEFAULT，AGGERGATION_MODE_DISABLED（禁止整合，如果已经整合，将从整合中分离出来，为其分配一个新的contact ID），以及AGGEREGATION_MODE_SUSPENDED（当属性变化是，并不整合到整合联系人中）。

视图：view_contacts

API并不直接暴露contacts表，而是通过视图view_contacts读取。当通过URI：ContactsContract.Contacts.CONTENT_URI来查询时，实际查询的是view_contacts。

CREATE VIEW view_contacts AS

SELECT contacts._id AS _id,
contacts.custom_ringtone AS custom_ringtone,
name_raw_contact.display_name_source AS display_name_source,
name_raw_contact.display_name AS display_name,
name_raw_contact.display_name_alt AS display_name_alt,
name_raw_contact.phonetic_name AS phonetic_name,
name_raw_contact.phonetic_name_style AS phonetic_name_style,
name_raw_contact.sort_key AS sort_key,
name_raw_contact.sort_key_alt AS sort_key_alt,
has_phone_number,
has_valid_sip_account,
name_raw_contact_id,
lookup,
photo_id,
photo_file_id,
CAST(EXISTS (SELECT _id FROM visible_contacts WHERE contacts._id=visible_contacts._id) AS INTEGER) AS in_visible_group,
status_update_id,
contacts.last_time_contacted AS last_time_contacted,
contacts.send_to_voicemail AS send_to_voicemail,
contacts.starred AS starred,
contacts.times_contacted AS times_contacted,
(CASE WHEN photo_file_id IS NULL    
    THEN (
        CASE WHEN photo_id IS NULL OR photo_id=0
            THEN NULL
        ELSE 'content://com.android.contacts/contacts/'||contacts._id|| '/photo' END)
    ELSE 'content://com.android.contacts/display_photo/'||photo_file_id END) AS photo_uri,
(CASE WHEN photo_id IS NULL OR photo_id=0
    THEN NULL
    ELSE 'content://com.android.contacts/contacts/'||contacts._id|| '/photo' END) AS photo_thumb_uri,
0 AS is_user_profile,
name_raw_contact.view_mode AS view_mode,
name_raw_contact.sim_index AS sim_index

FROM contacts JOIN raw_contacts AS name_raw_contact ON(name_raw_contact_id=name_raw_contact._id)

视图：view_entities

合并raw_contacts和data，可以获得每个raw contacts的全部信息。

CREATE VIEW view_entities AS

SELECT raw_contacts.contact_id AS _id,
raw_contacts.contact_id AS contact_id,
raw_contacts.deleted AS deleted,
is_primary,
is_super_primary,
data_version,
data.package_id,
package AS res_package,
data.mimetype_id,
mimetype AS mimetype,
is_read_only,
data1, data2, data3, data4, data5, data6, data7, data8, data9, data10, data11, data12, data13, data14, data15,
data_sync1, data_sync2, data_sync3, data_sync4,
raw_contacts.account_id,
accounts.account_name AS account_name,
accounts.account_type AS account_type,
accounts.data_set AS data_set,

(CASE WHEN accounts.data_set IS NULL
    THEN accounts.account_type
    ELSE accounts.account_type||'/'||accounts.data_set END) AS account_type_and_data_set,

raw_contacts.sourceid AS sourceid,
raw_contacts.name_verified AS name_verified,
raw_contacts.version AS version,
raw_contacts.dirty AS dirty,
raw_contacts.sync1 AS sync1,raw_contacts.sync2 AS sync2,raw_contacts.sync3 AS sync3,raw_contacts.sync4 AS sync4,
contacts.custom_ringtone AS custom_ringtone,
name_raw_contact.display_name_source AS display_name_source,
name_raw_contact.display_name AS display_name,
name_raw_contact.display_name_alt AS display_name_alt,
name_raw_contact.phonetic_name AS phonetic_name,
name_raw_contact.phonetic_name_style AS phonetic_name_style,
name_raw_contact.sort_key AS sort_key,
name_raw_contact.phonebook_label AS phonebook_label,
name_raw_contact.phonebook_bucket AS phonebook_bucket,
name_raw_contact.sort_key_alt AS sort_key_alt,
name_raw_contact.phonebook_label_alt AS phonebook_label_alt,
name_raw_contact.phonebook_bucket_alt AS phonebook_bucket_alt,
has_phone_number,
name_raw_contact_id,
lookup,
photo_id,
photo_file_id,
CAST(EXISTS (SELECT _id FROM visible_contacts WHERE contacts._id=visible_contacts._id) AS INTEGER) AS in_visible_group,
status_update_id,
contacts.contact_last_updated_timestamp,
contacts.last_time_contacted AS last_time_contacted,
contacts.send_to_voicemail AS send_to_voicemail,
contacts.starred AS starred,
contacts.pinned AS pinned,
contacts.times_contacted AS times_contacted,
(CASE WHEN photo_file_id IS NULL
    THEN (CASE WHEN photo_id IS NULL OR photo_id=0
        THEN NULL
        ELSE 'content://com.android.contacts/contacts/'||raw_contacts.contact_id|| '/photo' END)
    ELSE 'content://com.android.contacts/display_photo/'||photo_file_id END) AS photo_uri,
(CASE WHEN photo_id IS NULL OR photo_id=0
    THEN NULL ELSE 'content://com.android.contacts/contacts/'||raw_contacts.contact_id|| '/photo' END)
    AS photo_thumb_uri,
0 AS is_user_profile,
data_sync1, data_sync2, data_sync3, data_sync4,
raw_contacts._id AS raw_contact_id,
data._id AS data_id,
groups.sourceid AS group_sourceid  FROM raw_contacts
    JOIN accounts ON (raw_contacts.account_id=accounts._id)
    JOIN contacts ON (raw_contacts.contact_id=contacts._id)
    JOIN raw_contacts AS name_raw_contact ON(name_raw_contact_id=name_raw_contact._id)
    LEFT OUTER JOIN data ON (data.raw_contact_id=raw_contacts._id)
    LEFT OUTER JOIN packages ON (data.package_id=packages._id)
    LEFT OUTER JOIN mimetypes ON (data.mimetype_id=mimetypes._id)
    LEFT OUTER JOIN groups ON (mimetypes.mimetype='vnd.android.cursor.item/group_membership' AND groups._id=data.data1)

相关链接：我的Android开发相关文章