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

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