Android源码——通讯录联系人(一)：Contacts数据库初识

下边讲讲我前段时间在公司做通讯录联系人所学习到的一些知识，跟大家分享一下。



一、Contacts数据库存放位置：

cmd->adb remount(如果remount succeeded)->adb shell ->cd data/data/com.android.providers.contacts ->cd databases ->会显示contacts的数据库名，例如contacts2.db ->sqlite3 contacts2.db ->

C:Documents and SettingsAdministrator>adb remount

remount succeeded

C:Documents and SettingsAdministrator>adb shell

# cd data/data/com.android.providers.contacts

cd data/data/com.android.providers.contacts

# cd databases

cd databases

# ls

ls

contacts2.db

# sqlite3 contacts2.db

sqlite3 contacts2.db

SQLite version 3.6.22

Enter “.help” for instructions

Enter SQL statements terminated with a “;”

二、contacts数据库初识：

1、.tables (显示contacts2数据库中所有的表)：

sqlite> .tables

.tables

_sync_state settings

_sync_state_metadata status_updates

accounts v1_settings

activities view_contacts

agg_exceptions view_contacts_restricted

android_metadata view_data

calls view_data_restricted

contact_entities_view view_groups

contact_entities_view_restricted view_raw_contacts

contacts view_raw_contacts_restricted

data view_v1_contact_methods

groups view_v1_extensions

mimetypes view_v1_group_membership

name_lookup view_v1_groups

nickname_lookup view_v1_organizations

packages view_v1_people

phone_lookup view_v1_phones

properties view_v1_photos

raw_contacts

在通讯录中主要用到的是：contacts表，raw_contacts表，data表 以及其他附表：groups(用于存储通讯录按字母排序时的分批信息)，name_lookup(仅存储名字信息的表)，phone_lookup(仅存储电话号码信息的表)等。最重要的是contacts、raw_contacts、data这三个表。

2、用.schema [tablename] 查看表结构

sqlite> .schema data

.schema data

CREATE TABLE data (_id INTEGER PRIMARY KEY AUTOINCREMENT,package_id INTEGER REFE

RENCES package(_id),mimetype_id INTEGER REFERENCES mimetype(_id) NOT NULL,raw_co

ntact_id INTEGER REFERENCES raw_contacts(_id) NOT NULL,is_primary INTEGER NOT NU

LL DEFAULT 0,is_super_primary INTEGER NOT NULL DEFAULT 0,data_version INTEGER NO

T NULL DEFAULT 0,data1 TEXT,data2 TEXT,data3 TEXT,data4 TEXT,data5 TEXT,data6 TE

XT,data7 TEXT,data8 TEXT,data9 TEXT,data10 TEXT,data11 TEXT,data12 TEXT,data13 T

EXT,data14 TEXT,data15 TEXT,data_sync1 TEXT, data_sync2 TEXT, data_sync3 TEXT, d

ata_sync4 TEXT );

CREATE INDEX data_mimetype_data1_index ON data (mimetype_id,data1);

CREATE INDEX data_raw_contact_id ON data (raw_contact_id);

CREATE TRIGGER data_deleted BEFORE DELETE ON data BEGIN UPDATE raw_contacts

SET version=version+1 WHERE _id=OLD.raw_contact_id; DELETE FROM phone_

lookup WHERE data_id=OLD._id; DELETE FROM status_updates WHERE status_

update_data_id=OLD._id; DELETE FROM name_lookup WHERE data_id=OLD._id; END

;

CREATE TRIGGER data_updated AFTER UPDATE ON data BEGIN UPDATE data SET da

ta_version=OLD.data_version+1 WHERE _id=OLD._id; UPDATE raw_contacts

SET version=version+1 WHERE _id=OLD.raw_contact_id; END;

字段注解：

_id：data一条记录的id号，自增

package_id:

mimetype_id：决定当条记录的数据类型，在raw_contacts表中单挑记录即单个联系人只有一行记录，但是该联系人包含了名字、电话、地址等信息，每一种信息在data表中都是单一的一条记录插入，而mimetype_id的值就决定了该条data记录是什么类型的数据，比如插入的是电话类型的数据，那么此时的mimetype_id=5；mimetype_id的值对应的类型如下：

_id mimetype

1 vnd.android.cursor.item/email_v2

2 vnd.android.cursor.item/im

3 vnd.android.cursor.item/postal-address_v2

4 vnd.android.cursor.item/photo

5 vnd.android.cursor.item/phone_v2

6 vnd.android.cursor.item/name

7 vnd.android.cursor.item/organization

8 vnd.android.cursor.item/nickname

9 vnd.android.cursor.item/group_membership

这里特别注意，当你查询data表需要返回mimetype_id这一列结果时，字段名称应该为”mimetype”,而不是“mimetype_id”，否则会数据库查询会报错，因为在view_data表中的字段值为”mimetype”，而不是“mimetype_id”，view_data是data表的一个视图，比如你查询data表，实际查询的是view_data表，返回的结果可能并不是data表中的字段内容以及顺序；同时，这里返回的mimetype字段的值，我们在data表中看到的定义的是整形，但在view_data表中的类型时text类型，所以从查询得到Cursor结果中去取mimetype字段的值时，应该用getString()，而不应该用getInt(),否则得到的值并不是你想要的值，用getString()得到的值就是上表中的mimetype字段对应的这九种字串，如果需要转换成_id值，还需对该字串按照上面的表进行一一匹配。

raw_contact_id：即该条data记录与之关联的raw_contacts表的id

is_primary:

is_super_primary:

data_version:data的版本号，如果该条data记录有改动，则会刷新data_version的值，在前一个版本上加1；

data1-> data15:可存放任意类型的数据，每个字段应存放什么类型的数据根据mimetype_id的值来确定，比如如果是mimetype_id=5,即电话类型的数据，那么data1存放电话号码字串，data2存放电话号码类型，比如说是住宅电话，那么data2存”2”,data3存放电话号码的反字串，等等。。。

data_sync1：

data_sync2：

data_sync3：

data_sync4：

sqlite> .schema raw_contacts

.schema raw_contacts

CREATE TABLE raw_contacts (_id INTEGER PRIMARY KEY AUTOINCREMENT,is_restricted I

NTEGER DEFAULT 0,account_name STRING DEFAULT NULL, account_type STRING DEFAULT N

ULL, sourceid TEXT,version INTEGER NOT NULL DEFAULT 1,dirty INTEGER NOT NULL DEF

AULT 0,deleted INTEGER NOT NULL DEFAULT 0,contact_id INTEGER REFERENCES 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,display_name TEXT,display_name_alt TEXT,display_name

_source INTEGER NOT NULL DEFAULT 0,phonetic_name TEXT,phonetic_name_style TEXT,s

ort_key TEXT COLLATE PHONEBOOK,sort_key_alt TEXT COLLATE PHONEBOOK,name_verified

INTEGER NOT NULL DEFAULT 0,contact_in_visible_group INTEGER NOT NULL DEFAULT 0,

sync1 TEXT, sync2 TEXT, sync3 TEXT, sync4 TEXT, raw_contact_type INTEGER NOT NUL

L DEFAULT 0 );

CREATE INDEX raw_contact_sort_key1_index ON raw_contacts (contact_in_visible_gro

up,sort_key);

CREATE INDEX raw_contact_sort_key2_index ON raw_contacts (contact_in_visible_gro

up,sort_key_alt);

CREATE INDEX raw_contacts_contact_id_index ON raw_contacts (contact_id);

CREATE INDEX raw_contacts_source_id_index ON raw_contacts (sourceid, account_typ

e, account_name);

CREATE TRIGGER raw_contacts_deleted BEFORE DELETE ON raw_contacts BEGIN DE

LETE FROM data WHERE raw_contact_id=OLD._id; DELETE FROM agg_exceptions

WHERE raw_contact_id1=OLD._id OR raw_contact_id2=OLD._id; DELETE FROM

contacts WHERE _id=OLD.contact_id AND (SELECT COUNT(*) FROM raw_conta

cts WHERE contact_id=OLD.contact_id )=1; END;

CREATE TRIGGER raw_contacts_marked_deleted AFTER UPDATE ON raw_contacts BEGIN

UPDATE raw_contacts SET version=OLD.version+1 WHERE _id=OLD._id

AND NEW.deleted!= OLD.deleted; END;

字段注解：

_id:raw_contacts表的id，自增

is_restricted：

account_name：

account_type：

sourceid：

version：

dirty：

deleted：

contact_id：该条记录对应的关联的contacts表的id

aggregation_mode：集成模型，有四种类型，

0：

1：

2：

3：

aggregation_needed：

custom_ringtone：

send_to_voicemail：

times_contacted：

last_time_contacted：

sqlite> .schema contacts

.schema contacts

CREATE TABLE contacts (_id INTEGER PRIMARY KEY AUTOINCREMENT,name_raw_contact_id

INTEGER REFERENCES raw_contacts(_id),photo_id INTEGER REFERENCES data(_id),cust

om_ringtone TEXT,send_to_voicemail INTEGER NOT NULL DEFAULT 0,times_contacted IN

TEGER NOT NULL DEFAULT 0,last_time_contacted INTEGER,starred INTEGER NOT NULL DE

FAULT 0,in_visible_group INTEGER NOT NULL DEFAULT 1,has_phone_number INTEGER NOT

NULL DEFAULT 0,lookup TEXT,status_update_id INTEGER REFERENCES data(_id),single

_is_restricted INTEGER NOT NULL DEFAULT 0,contact_type INTEGER NOT NULL DEFAULT

0);

CREATE INDEX contacts_has_phone_index ON contacts (has_phone_number);

CREATE INDEX contacts_name_raw_contact_id_index ON contacts (name_raw_contact_id

);

CREATE INDEX contacts_restricted_index ON contacts (single_is_restricted);

CREATE INDEX contacts_visible_index ON contacts (in_visible_group);

sqlite>

字段注解：

_id，当前记录contacts表中的id,通常表示为contact_id,对应raw_contacts表中的contact_id;

name_raw_contact_id:从name_lookup表中取到的raw_contact_id，基本上就是对应raw_contacts表中的id

photo_id:

custom_ringtone:

send_to_voicemail:

times_contacted:

last_time_contacted:

in_visible_group:

has_phone_number:

lookup:

status_update_id:

single_is_restricted:

contact_type:

3、查看表中的数据：select * from [tablename];

sqlite> select * from data;

select * from data;

62||5|34|0|0|0|112|1||211|||||||||||||||

63||6|34|0|0|0|dhdh||dhdh|||||||1|0||||||||

sqlite> select * from raw_contacts;

select * from raw_contacts;

34|0||||2|1|0|34|0|0||0|0||0|dhdh|dhdh|40||0|dhdh|dhdh|0|1|||||0

sqlite> select * from contacts;

select * from contacts;

34|34|||0|0|0|0|1|1|0r34-323A323A||0|0

sqlite>