Android通讯录查询篇--ContactsContract.Data
Android通讯录查询篇--ContactsContract.Data开篇
正在学习Android，想先找个简单点的东西练习一下，先想到的是通讯录，不过关于手机通讯录方面的资料在我现有的书和视频上都很少看到。没办法只有自己看SDK Docs了。
不管怎么说还是先赞Google的Android Docs，确实很全面，只要你想找就一定能找到你要的东西。不过我感觉想把里面的各个类的关系联系起来还是有点困难，特别是像英文水平过于一般的我，看的那叫个累呀。
好了，还是来说一下正题吧。Android刚开始在通讯录方面好像是提供的Contacts这个类，又在SDK2.0发布后新加了一个ContactsContract，然后就不建议用Contacts这个旧的类了。有新的东西，当然要用新的了。
对于ContactsContact官方文档里面说它是基于一个三层的数据模型存储的，由于本人不是专门搞软件，什么意思我也说不出来，个人的一个大致的理解就是，它是由三个主要的数据库组成的。这三个数据模型就是以ContactsContact.Data，ContactsContact.RawContacts，ContactsContact.Contacts。
三个模型的功能大致为，
Data：存储通讯录中每个人的全部信息，什么名字，电话，E-mail等一些乱七八糟和东西全在里面。
RawContacts：这个里面好像是说存储的是个人描述信息和一些唯一确定的相关的帐号
Contacts：这个好像是通讯录里面的一个人的基本描述，像什么显示的名字，分组情况，有没有电话号码之类的了。
反正后面两个搞的真是懵懵的，我先不管这两个了。因为Data里面说它包括通讯录里每个人的全部信息，以理论上说对通讯录的全部操作都可以用这个来搞定。所以我也是选的它，降低难度嘛。
关于Data，看一下文档里面的详细内容，里面主要说了一个“数据类型”(Data kinds)，对应的是Data.MIMETYPE这个列。我们还是先不管这个，之后再说。我刚用的时候对它还很是纠结了一把。
Data里面也是含有对数据的“增删改查”四个基本操作，看到这里基本可以确定它肯定是一个数据库了。官方每个操作都提供了一些事例代码。第一次玩当然是从简单的“查”来入手了。
官方给的代码有两个，我主要看的第二个，因在后面的官方描述中CONTACT_ID好像就是RAW_CONTACT_ID：
|
1
2
3
4
5
|
Cursor c = getContentResolver().query(Data.CONTENT_URI, new String[] {Data._ID, Phone.NUMBER, Phone.TYPE, Phone.LABEL}, Data.RAW_CONTACT_ID + "=?" + " AND " + Data.MIMETYPE + "='" + Phone.CONTENT_ITEM_TYPE + "'", new String[] {String.valueOf(rawContactId)}, null); |
这个代码里面一般至少都能意会出它是在做什么。就是通过联系人ID查找他的电话号码，电话类型，和电话标签。像里的Data._ID中的Data就是ContactsContact.Data，Phone.TYPE里面的Phone就是ContactsContract.CommonDataKinds.Phone。
通过上面的代码我们可以知道，要查找一个通讯录可以通过ContentResolver的query()方法来查找，最终返回一个游标Cursor，通过Cursor的get***方法就可以把想要的数据读出来了。关于query方法，可以说就一个生成一相格式化SQL语句的方法。它有五个参数，简单的理解就是(uri相当于要查询的表名，你要查询哪几个字段用String数组表示，查询条类似Where后面的部分，如果前面的参数里面有?的点位符这个参数就是它对应的值，排序)。
看了这个代码有点查询通讯录的概念了，不过现在可能有人就有问题要问了，官方的代码里面怎么不把联系人的姓名查出来，因为就算我们不懂代码，单看英文怎么也没有Name这类的单词啊。查联系人怎么说也要有名字有电话，不然要它干什么。是不是官方太懒了多加个字段不行么？
我这个外行人花了点时间的学习后，发现官方的这个代码好像还真查不了名字，或者说是专门来查电话的……
但是要同时得到姓名还对应的电话号码，我们才能算的上有点成果吧，现在的东西似乎还没多大用。
要完成这套流程，就要说一下我刚开始提到的那个所谓的“数据类型”Data.MIMETYPE了。
由于本人水平有限，如有错误，请尽量指正，共同学习嘛！
上次说Data.MIMETYPE这个玩意很重要，官方的文档中描述了一大段的话。里面比较重要的几点是：
1、在Data中有一大段的公共数据段，DATA1~DATA15。这名子咋一看，真搞笑，哪有这样为数据命名的，神也记不住是干什么的的啊！
2、上面说的那些公共数据段所存的数据类型是由这个MIMETYPE决定的。
虽说这两个重要，不过刚看到这里，我还是懵了，这到底是个什么玩意嘛。（当然这很有可能是因为英文水平差，没看完全懂的原因。）
再看看官方文档，上面有个例子说，如果MIMETYPE的值是Phone.CONTENT_ITEM_TYPE，则DATA1就是电话号码，如果MIMETYPE的值是Email.CONTENT_ITEM_TYPE则DATA1的值就是E-mail地址。这样一说，又似乎明白了点。（还是举实例子来的实在！）
在上次说的那个官方代码里面不就有将MIMETYPE赋值为Phone.CONTENT_ITEM_TYPE的么。所以那个查询就用来查电话了。
在MIMETYPE的描述里面说，它可以被赋许多值：
StructuredName.CONTENT_ITEM_TYPE
Phone.CONTENT_ITEM_TYPE
Email.CONTENT_ITEM_TYPE
Photo.CONTENT_ITEM_TYPE
Organization.CONTENT_ITEM_TYPE
Im.CONTENT_ITEM_TYPE
Nickname.CONTENT_ITEM_TYPE
Note.CONTENT_ITEM_TYPE
StructuredPostal.CONTENT_ITEM_TYPE
GroupMembership.CONTENT_ITEM_TYPE
Website.CONTENT_ITEM_TYPE
Event.CONTENT_ITEM_TYPE
Relation.CONTENT_ITEM_TYPE
现在我们知道的有用Phone那个可以查电话，那用哪个查姓名呢？
再之后看文档时候可以明白把StructuredName.CONTENT_ITEM_TYPE给MINETYPE就行了。(但刚开始的时候可能是因为看英文，怎么都没把它们好的联系起来。)
所将官方的代码改成这样的话就可以查询姓名了。
|
1
2
3
4
|
Cursor c = getContentResolver().query(Data.CONTENT_URI, new String[]{Data._ID,StructuredName.DISPLAY_NAME, }, Data.MIMETYPE + "='" + StructuredName.CONTENT_ITEM_TYPE + "'", null, null); |
其中游标C的结果的第二个字段（StructuredName.DISPLAY_NAME）就是姓名，准确的说应该是“显示姓名”（因为姓名也以再细分为姓和名）。
如果还没有理解的话，也不要紧，之后我会把它讲的形像一点。
通讯录虽然不是一个什么难的东西，不过我想还是理顺一点好，免得过些天后又晕了。。
这次主要要做的就是根据姓名来查找电话，并且加强对通讯录的理解。
以前做一些用到数据库的东西的时候，可能光看代码也是不好联系起各个数据之间的关系，所以我先想到的还是数据库。幸运的是，它还真是一个数据库。
Android里面内置的是SQLite的数据库，虽然对数据库不怎么了解，但关系型数据库，基本操作也就那些，而且基本都一样，所以就直接用呗。
用命令行下的adb shell进入Android的模拟器，进入data/data目录下面，这里面就是安装的一些应用程序。找啊找，里面有一个com.android.providers.contacts，怎么看都是一个通讯录相关的程序，进入这个目录下，里面有一个databases，就它了，再进去就可以看到有个contacts2.db的文件。
用sqlite3打开这个数据库文件。查看里面的表。里面表很多，不过看两遍后发现表的名字很熟悉，像什么data,raw_contacts,contacts,minetypes等，前面几个都是我们上次说的那几个所谓的数据模型，它们还真是数据库。
查询一下data表里面的所有信息，可以发现里面的信息联系起来就都是我们通讯录里面的名片。虽然不是一条显示全部，但每个名字每个电话，每个E-mail都有，而且都是分开显示的。现在对于这个应该就有点感觉了。
再看一下表的结构，用”.schema” 命令后会看到，类似如下的信息：
.schema data
CREATE TABLE data (
_id INTEGER PRIMARY KEY AUTOINCREMENT,
package_id INTEGER REFERENCES package(_id),
mimetype_id INTEGER REFERENCES mimetype(_id) NOT NULL,
raw_contact_idINTEGER REFERENCES raw_contacts(_id) NOT NULL,
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 );
下面还有点索引和触发器的信息就不看了，结合查询的数据看一下。其中“_id”就是表的一个自增id字段。第二个package_id暂时没用到，数据里面全是空。第三个字段minetype_id应该就是MIMETYPE了（其实还是有点不一样的）。后的raw_contact_id就是名片的ID。再看后的data1，data2等字段，每条数据中的这几项都不大相同，准确的说，minetype_id字段不同的数据data1,data2等字段的数据就不同。
现在应该就有一个概念了，以前说的MIMETYPE的值确定Data.DATA1等的值的类型的意思就是在data数据库中通过mimetype_id的值就可以确定data1,data2等字段的真正意义。也就是说在data数据库中通过minetype_id的值可以确定那一条数据到底是存储的姓名，还是电话，还是E-mail或者其它。
这样一来，如果我们要查询某个特定的数据的时候就可以直接查询data表里面的data1，data2这类字段的值，而唯一的必要条件就是在where条件语句里面将minetype_id赋为对应的值。这样就有了一个统一的数据访问方法。而且可以通过这个表查到所以想要的数据。
所以如果想要通过姓名查找一个人的电话就可以这样了，先通过设置MIMETYPE 为
ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME ，查找姓名所对应的 RAW_CONTACT_ID 。再将MIMETYPE 设置为
ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE，查找上面找到的 RAW_CONTACT_ID 所对应的电话就可以了。
按这个细路就可以写代码了:
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
|
/** * 通过姓名(uName)来查找通讯录，返回一个list。 其中"display_name"保存姓名,"phone_number"保存电话 */ public List<HashMap<String, String>> getContactsByName(String uName) { List<HashMap<String, String>> list = new ArrayList<HashMap<String, String>>(); boolean isQueryAll = false; // cu姓名游标，cn电话号码游标 Cursor cu, cn = null; // 查询条件，SQL是的Where语句的后部分 String selection = null; uName = uName.trim(); // 是否查询全部通讯录,如果姓名为空则是 isQueryAll = uName.equals("") ? true : false; if (isQueryAll) { // 查询全部时的，查询条件，主要用在cu游标上 selection = ContactsContract.Data.MIMETYPE + "='" + ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE + "'"; //System.out.println("Query For ALl--" + selection); } else { // 根据姓名查询时的，查询条件，主要用在cu游标上 selection = ContactsContract.Data.MIMETYPE + "='" + ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE + "'" + " AND " + ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME + " LIKE " + "'%" + uName + "%'"; //System.out.println("Query For Some--" + selection); } try { // 根据姓名查询出完整姓名和通讯录ID cu = contentReso .query( URI, new String[] { ContactsContract.Data.RAW_CONTACT_ID, ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME }, selection, null, null); // 根据通讯录ID，查找对应的电话号码的查询条件，主要用于cn游标 selection = ContactsContract.Data.MIMETYPE + "='" + ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE + "'" + " AND " + ContactsContract.Data.RAW_CONTACT_ID + "=?"; //System.out.println("Number Query--" + selection); while (cu.moveToNext()) { String contactId = String.valueOf(cu.getInt(0)); // 开始查找电话号码 //System.out.println(" Start Query Num"); cn = contentReso .query( URI, new String[] { ContactsContract.CommonDataKinds.Phone.NUMBER }, selection, new String[] { contactId }, null); while (cn.moveToNext()) { // 将一组通讯录记录在HashMap中 HashMap<String, String> map = new HashMap<String, String>(); map.put("display_name", cu.getString(1)); map.put("phone_number", cn.getString(0)); // 将查到通讯录添加到List中 list.add(map); } } //关闭游标 cu.close(); cn.close(); } catch (Exception e) { // TODO: handle exception } return list; } } |
PS:
最后再说一下那个MIMETYPE ，在data数据库里面它的值是整型，如果看一下官方文档的话，给它所赋的值像
ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME 之类的都字符串，那么这些字符串和data里面的整型是怎么对应的呢。
其实就是通过mimetypes表来对应的。里面的对应列主要就是9个 ：
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
