Android（java）学习笔记193：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

 

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