Android（java）学习笔记249：ContentProvider使用之获得系统联系人信息01

1.系统联系人的数据库（3张最重要的表）

（1）raw_contacts 联系人表

保存联系人的id contact_id

（2）data 数据表

保存联系人的数据

（3）mimetypes

MIME数据类型表

2.因为如果要访问ContentProvider，必须要了解URI的设置（authority，path等）；只有查看源代码才能够知道；AndroidManifest.xml为清单文件，列出了ContactProvider的authorities，以及要访问通讯录需要的权限；

3.通讯录数据库结构介绍：

表结构如下：









通讯录是存放在/data/data/com.android.providers.contacts/databases/contacts2.db，里面主要的表有：

(1)raw_contacts：存放联系人的ID，

_id属性为主键，声明为autoincrement，即不需要手动设置，其他属性也不需要手动设置就有默认值；

display_name属性为姓名；

(2)mimetypes：存放数据的类型，比如"vnd.android.cursor.item/name"表示“姓名”类型的数据，"vnd.android.cursor.item/phone_v2"表示“电话”类型的数据；

(3)data：存放具体的数据；

raw_contact_id属性用来连接raw_contacts表，每条记录表示一个具体数据；我们主要的数据（email、phone等)都存放在data表；

data1属性存放总数据；

data2属性：

-如果此记录存放姓名，则data2存放名；

-如果此记录存放电话，则data2存放类型，比如手机、家电；

-如果此记录存放组织，则data2存放类型，比如公司、其他；

-如果此记录存放地址，则data2存放类型，比如住宅，单位等；

4. 编程提示：

URI

对raw_contacts表添加、删除、更新操作：

URI = content://com.android.contacts/raw_contacts;

对data表添加、删除、更新操作：
URI = content://com.android.contacts/data;

根据email对data表查询：
URI = content://com.android.contacts/data/emails/filter/*

根据电话号码对data表查询

URI = content://com.android.contacts/data/phone/filter/*

如果要根据ID查询电话，可以
URI = content://com.android.contacts/data；
然后where条件为：raw_contact_id=? and mimetype = ?

MIMETYPE

电话：vnd.android.cursor.item/phone_v2
姓名：vnd.android.cursor.item/name
邮件：vnd.android.cursor.item/email_v2
通信地址：vnd.android.cursor.item/postal-address_v2
组织：vnd.android.cursor.item/organization
照片：vnd.android.cursor.item/photo

Data中的常量

Data._ID： "_id"

Data.DISPLAY_NAME：“display_name”

Data.DATA1：“data1”

Data.DATA2：“data2”

Data.RAW_CONTACT_ID：“raw_contact_id”

Data.MIMETYPE：“mimetype”

5.思考? 如何获取联系人的数据。

（1） 查询raw_contacts 获取所有的联系人的id ；

（2) 根据id查询data表，获取当前联系人的数据 ；

6.下面通过一个案例说明如何获取联系人信息

（1）activity_main.xml文件，如下：

 <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
tools:context="com.himi.readcontacts.MainActivity" >

<Button
android:onClick="click"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerHorizontal="true"
android:layout_centerVertical="true"
android:text="读取联系人数据" />

</RelativeLayout>

布局效果，如下：





（2）MainActivity.java，如下：

 package com.himi.readcontacts;

import android.app.Activity;
import android.content.ContentResolver;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.view.View;

public class MainActivity extends Activity {

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}

/**
*
* 读取联系人数据库，获取联系人信息
*/
public void click(View view) {
ContentResolver resolver = getContentResolver();
Uri uri = Uri.parse("content://com.android.contacts/raw_contacts");
Uri datauri = Uri.parse("content://com.android.contacts/data");
//1.查询raw_contacts表格，获取用户id
Cursor cursor = resolver.query(uri, new String[]{"contact_id"}, null, null, null);
while(cursor.moveToNext()) {
String id =cursor.getString(0);
System.out.println(id);
//2.根据id查询data表,把这个联系人的数据获取出来
Cursor dataCursor = resolver.query(datauri, new String[]{"data1","mimetype"}, "raw_contact_id=?",
new String[]{id}, null);
while(dataCursor.moveToNext()) {
String data1 = dataCursor.getString(0);
String mimetype = dataCursor.getString(1);
System.out.println("data:"+data1);
System.out.println("mimetype:"+mimetype);
}
dataCursor.close();

}
cursor.close();
}

}

当然上面观察源码，可以获取访问的权限，如下：

<uses-permission android:name="android.permission.READ_CONTACTS"/>
<uses-permission android:name="android.permission.WRITE_CONTACTS"/>

添加到AndroidMainfest.xml文件之中。

（3）布署到模拟器上，运行如下：





点击" 读取联系人数据"，观察logcat打印的日志：

09-15 00:49:13.538: I/System.out(744): id1
09-15 01:17:25.688: I/System.out(841): 1
09-15 01:17:26.018: I/System.out(841): data:221112@163.com
09-15 01:17:26.018: I/System.out(841): mimetype:vnd.android.cursor.item/email_v2
09-15 01:17:26.018: I/System.out(841): data:34555555555
09-15 01:17:26.028: I/System.out(841): mimetype:vnd.android.cursor.item/phone_v2
09-15 01:17:26.028: I/System.out(841): data:Yjg
09-15 01:17:26.028: I/System.out(841): mimetype:vnd.android.cursor.item/name
09-15 01:17:26.048: I/System.out(841): 2
09-15 01:17:26.108: I/System.out(841): data:22222222@163.com
09-15 01:17:26.108: I/System.out(841): mimetype:vnd.android.cursor.item/email_v2
09-15 01:17:26.108: I/System.out(841): data:355-5555
09-15 01:17:26.108: I/System.out(841): mimetype:vnd.android.cursor.item/phone_v2
09-15 01:17:26.118: I/System.out(841): data:Yty
09-15 01:17:26.118: I/System.out(841): mimetype:vnd.android.cursor.item/name

打印的日志表明，已经获取了联系人的信息，下面是通信录中保存的联系人，如下：