Android（java）学习笔记250：ContentProvider使用之获得系统联系人信息02（掌握）

1.重要:

系统删除一个联系人，默认情况下并不是把这个联系人直接删除掉了，只是做了一个标记，标记为被删除。

2.前面一讲说过了如何获取系统联系人信息（通过ContentProvider），获取联系人信息是经常使用，下面封装成工具类，方便以后调用：

下面通过案例说明一下：

（1）Android工程如下图：





（2）其中工具类ContactInfoUtils.java，如下：

 package com.himi.readcontacts.utils;

import java.util.ArrayList;
import java.util.List;

import android.content.ContentResolver;
import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.net.Uri;
import android.provider.ContactsContract.Data;

import com.himi.readcontacts.domain.ContactInfo;

/**
* 联系人信息的工具类
* @author Administrator
*
*/
public class ContactsInfoUtils {

/**
* 根据电话号码查询姓名
* @param context 上下文
* @return 返回
*/
public static String getContactByPhone(Context context,String phone)throws Exception{
//uri=  content://com.android.contacts/data/phones/filter/#
Uri uri = Uri.parse("content://com.android.contacts/data/phones/filter/"+phone);
ContentResolver resolver = context.getContentResolver();
Cursor cursor = resolver.query(uri, new String[]{Data.DISPLAY_NAME}, null, null, null); //从raw_contact表中返回display_name
if(cursor.moveToFirst()){
System.out.println("name="+cursor.getString(0));
}
String result = cursor.getString(0);
return result;
}

/**
* 查询所有联系人信息
* @param context 上下文
* @return
*/
public static List<ContactInfo> getAllContactInfos(Context context)  {
List<ContactInfo> infos = new ArrayList<ContactInfo>();
ContentResolver resolver = context.getContentResolver();
Uri uri = Uri.parse("content://com.android.contacts/raw_contacts");
Uri datauri = Uri.parse("content://com.android.contacts/data");
Cursor cursor = resolver.query(uri, new String[] { "contact_id" },
null, null, null);
while (cursor.moveToNext()) {
String id = cursor.getString(0);
ContactInfo info = new ContactInfo();
info.setId(id);

System.out.println("id"+id);
if (id != null) {
// 根据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);
if (data1 != null && mimetype != null) {
if ("vnd.android.cursor.item/email_v2".equals(mimetype)) {// email
info.setEmail(data1);
} else if ("vnd.android.cursor.item/im"
.equals(mimetype)) {// QQ
info.setQQ(data1);
} else if ("vnd.android.cursor.item/name"
.equals(mimetype)) {// name
info.setName(data1);
} else if ("vnd.android.cursor.item/phone_v2"
.equals(mimetype)) {// phone
info.setPhone(data1);
}
}
}
infos.add(info);
dataCursor.close();
}
}
cursor.close();
return infos;
}

/**
* 添加一个联系人
* @param context  上下文
* @param phone 添加联系人的电话
* @param name  添加联系人的姓名
* @param email 添加联系人的email
*/
public static  void AddContact(Context context, String phone, String name, String email)throws Exception {
Uri uri = Uri.parse("content://com.android.contacts/raw_contacts");
Uri datauri = Uri.parse("content://com.android.contacts/data");
ContentResolver resolver = context.getContentResolver();
//1.在raw_contace表里面添加一条新的id        _id desc:表示按照id降序排列
Cursor cursor = resolver.query(uri, new String[]{"_id"}, null, null, "_id desc");
cursor.moveToFirst();
int _id = cursor.getInt(0);//之前，降序排列，这里获得表中最大id值
//计算出来新添加的条目的id
int newId = _id+1;
ContentValues values = new ContentValues();
values.put("contact_id", newId);
resolver.insert(uri, values);

//2.在data表中添加对应的数据
//添加电话号码phone
ContentValues phoneValue = new ContentValues();
phoneValue.put("raw_contact_id", newId);
phoneValue.put("mimetype", "vnd.android.cursor.item/phone_v2");
phoneValue.put("data1", phone);
resolver.insert(datauri, phoneValue);
//添加姓名
ContentValues nameValue = new ContentValues();
nameValue.put("raw_contact_id", newId);
nameValue.put("mimetype", "vnd.android.cursor.item/name");
nameValue.put("data1", name);
resolver.insert(datauri, nameValue);
//添加email
ContentValues emailValue = new ContentValues();
emailValue.put("raw_contact_id", newId);
emailValue.put("mimetype", "vnd.android.cursor.item/email_v2");
emailValue.put("data1", email);
resolver.insert(datauri, emailValue);

}

/**
* 删除一个联系人
*
* 核心思想：
*      (1)先在raw_contacts表根据姓名(此处的姓名为name记录的data2的数据而不是data1的数据)查出id；
*      (2)在data表中只要raw_contact_id匹配的都删除；
* @param context  上下文
* @param name   删除用户的姓名
*/
public static boolean DeleteContact(Context context,String name)throws Exception{
boolean status = false;
//根据姓名求id
Uri uri = Uri.parse("content://com.android.contacts/raw_contacts");
ContentResolver resolver = context.getContentResolver();
Cursor cursor = resolver.query(uri, new String[]{Data._ID},"display_name=?", new String[]{name}, null);
if(cursor.moveToFirst()){
int id = cursor.getInt(0);
//根据id删除data中的相应数据
resolver.delete(uri, "display_name=?", new String[]{name});
uri = Uri.parse("content://com.android.contacts/data");
//根据id清空raw_contact_id
resolver.delete(uri, "raw_contact_id=?", new String[]{id+""});
status = true;
}
return status;
}

/**
* 更新联系人
* 核心思想：
*      (1)不需要更新raw_contacts，只需要更新data表；
*      (2)uri=content://com.android.contacts/data 表示对data表进行操作；
* @param context
* @throws Exception
*/
public static void UpdateContact(Context context) throws Exception{
int id = 1;
String phone = "999999";
Uri uri = Uri.parse("content://com.android.contacts/data");//对data表的所有数据操作
ContentResolver resolver = context.getContentResolver();
ContentValues values = new ContentValues();
values.put("data1", phone);
resolver.update(uri, values, "mimetype=? and raw_contact_id=?", new String[]{"vnd.android.cursor.item/phone_v2",id+""}) ;
}

}

用户domain信息类ContactInfo.java，如下：

 package com.himi.readcontacts.domain;

/**
*
* 联系人的业务bean
*
*/
public class ContactInfo {
private String id;
private String name;
private String email;
private String phone;
private String qq;
public String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getEmail() {
return email;
}
public void setEmail(String email) {
this.email = email;
}
public String getPhone() {
return phone;
}
public void setPhone(String phone) {
this.phone = phone;
}
public String getQQ() {
return qq;
}
public void setQQ(String qq) {
this.qq = qq;
}
@Override
public String toString() {//方便System.out.println()打印日志
return "ContactInfo [id=" + id + ", name=" + name + ", email=" + email
+ ", phone=" + phone + ", qq=" + qq + "]";
}

}

读取ContentProvider之联系人信息，需要添加权限（查看源码可以获知），如下：

 <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.himi.readcontacts"
android:versionCode="1"
android:versionName="1.0" >

<uses-sdk
android:minSdkVersion="15"
android:targetSdkVersion="17" />
<uses-permission android:name="android.permission.WRITE_CONTACTS"/>
<uses-permission android:name="android.permission.READ_CONTACTS"/>

<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<activity
android:name=".MainActivity"
android:label="@string/app_name" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />

<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>

</manifest>

（3）回到MainActivity.java，如下：

 package com.himi.readcontacts;

import java.util.List;

import android.app.Activity;
import android.os.Bundle;
import android.view.View;

import com.himi.readcontacts.domain.ContactInfo;
import com.himi.readcontacts.utils.ContactsInfoUtils;

public class MainActivity extends Activity {

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

/**
*
* 读取联系人数据库，获取联系人信息
*/
public void click(View view) {
List<ContactInfo> infos = ContactsInfoUtils.getAllContactInfos(this);
for(ContactInfo info:infos) {
System.out.println(info.toString());
}

}

}

（4）布署到模拟器上，运行的效果如下：





观察logcat打印的日志，如下：

09-15 01:36:12.498: I/System.out(911): id1
09-15 01:36:12.549: I/System.out(911): id2
09-15 01:36:12.867: I/System.out(911): ContactInfo [id=1, name=Yjg, email=221112@163.com, phone=34555555555, qq=null]
09-15 01:36:12.867: I/System.out(911): ContactInfo [id=2, name=Yty, email=22222222@163.com, phone=355-5555, qq=null]