使用 ContentProvider 管理联系人（包括每人有多个电话号码）
Android 系统提供了 Contacts 应用来管理联系人，而且 Android 系统还为联系人管理提供了 ContentProvider，这就允许其他应用程序以 ContentResolver 来管理联系人数据。
Android 系统用于管理联系人的 ContentProvider 的几个 Uri：
-----> ContactsContract.Contacts.CONTENT_URI：管理联系人的 Uri。
-----> ContactsContract.CommonDataKinds.Phone.CONTENT_URI：管理联系人电话的 Uri。
-----> ContactsContract.CommonDataKinds.Email.CONTENT_URI：管理联系人 E-mail 的 Uri。
下面的内容摘自某书籍，效果如下：
一个按钮用于查询已有的联系人的名字，电话号码一个或者多个，Email 一个或者多个，查询结果在列表上显示出来；一个按钮用于添加联系人的信息，允许使用空值。
MainActivity.java :
package com.crazy.picturememory0ptimization;
import android.app.Activity;
import android.app.AlertDialog;
import android.content.ContentUris;
import android.content.ContentValues;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.provider.ContactsContract;
import android.provider.ContactsContract.CommonDataKinds.Email;
import android.provider.ContactsContract.CommonDataKinds.Phone;
import android.provider.ContactsContract.CommonDataKinds.StructuredName;
import android.provider.ContactsContract.RawContacts.Data;
import android.view.Gravity;
import android.view.View;
import android.view.View.OnClickListener;
import android.view.ViewGroup;
import android.widget.AbsListView;
import android.widget.BaseExpandableListAdapter;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ExpandableListAdapter;
import android.widget.ExpandableListView;
import android.widget.TextView;
import android.widget.Toast;
import java.util.ArrayList;
public class MainActivity extends Activity {
Button search;
Button add;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 获取系统界面中查找、添加两个按钮
search = (Button) findViewById(R.id.search);
add = (Button) findViewById(R.id.add);
search.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View source) {
// 定义两个List来封装系统的联系人信息、指定联系人的电话号码、Email等详情
final ArrayList names = new ArrayList<>();
final ArrayList> details = new ArrayList<>();
// 使用ContentResolver查找联系人数据
Cursor cursor = getContentResolver().query(
ContactsContract.Contacts.CONTENT_URI, null, null,
null, null);
// 遍历查询结果，获取系统中所有联系人
while (cursor.moveToNext()) {
// 获取联系人ID
String contactId = cursor.getString(cursor
.getColumnIndex(ContactsContract.Contacts._ID));
// 获取联系人的名字
String name = cursor.getString(cursor.getColumnIndex(
ContactsContract.Contacts.DISPLAY_NAME));
names.add(name);
// 使用ContentResolver查找联系人的电话号码
Cursor phones = getContentResolver().query(
ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
null, ContactsContract.CommonDataKinds.Phone.CONTACT_ID
+ " = " + contactId, null, null);
ArrayList detail = new ArrayList<>();
// 遍历查询结果，获取该联系人的多个电话号码
while (phones.moveToNext()) {
// 获取查询结果中电话号码列中数据
String phoneNumber = phones.getString(phones
.getColumnIndex(ContactsContract
.CommonDataKinds.Phone.NUMBER));
detail.add("电话号码：" + phoneNumber);
}
phones.close();
// 使用ContentResolver查找联系人的E-mail地址
Cursor emails = getContentResolver().query(
ContactsContract.CommonDataKinds.Email.CONTENT_URI,
null, ContactsContract.CommonDataKinds.Email
.CONTACT_ID + " = " + contactId, null, null);
// 遍历查询结果，获取该联系人的多个E-mail地址
while (emails.moveToNext()) {
// 获取查询结果中E-mail地址列中数据
String emailAddress = emails.getString(emails
.getColumnIndex(ContactsContract
.CommonDataKinds.Email.DATA));
detail.add("邮件地址：" + emailAddress);
}
emails.close();
details.add(detail);
}
cursor.close();
// 加载result.xml界面布局代表的视图
View resultDialog = getLayoutInflater().inflate(
R.layout.result, null);
// 获取resultDialog中ID为list的ExpandableListView
ExpandableListView list = (ExpandableListView) resultDialog
.findViewById(R.id.list);
// 创建一个ExpandableListAdapter对象
ExpandableListAdapter adapter =
new BaseExpandableListAdapter() {
// 获取指定组位置、指定子列表项处的子列表项数据
@Override
public Object getChild(int groupPosition,
int childPosition) {
return details.get(groupPosition).get(
childPosition);
}
@Override
public long getChildId(int groupPosition,
int childPosition) {
return childPosition;
}
@Override
public int getChildrenCount(int groupPosition) {
return details.get(groupPosition).size();
}
private TextView getTextView() {
AbsListView.LayoutParams lp = new AbsListView
.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT
, 64);
TextView textView = new TextView(
MainActivity.this);
textView.setLayoutParams(lp);
textView.setGravity(Gravity.CENTER_VERTICAL
| Gravity.LEFT);
textView.setPadding(36, 0, 0, 0);
textView.setTextSize(20);
return textView;
}
// 该方法决定每个子选项的外观
@Override
public View getChildView(int groupPosition,
int childPosition, boolean isLastChild,
View convertView, ViewGroup parent) {
TextView textView = getTextView();
textView.setText(getChild(groupPosition,
childPosition).toString());
return textView;
}
// 获取指定组位置处的组数据
@Override
public Object getGroup(int groupPosition) {
return names.get(groupPosition);
}
@Override
public int getGroupCount() {
return names.size();
}
@Override
public long getGroupId(int groupPosition) {
return groupPosition;
}
// 该方法决定每个组选项的外观
@Override
public View getGroupView(int groupPosition,
boolean isExpanded, View convertView,
ViewGroup parent) {
TextView textView = getTextView();
textView.setText(getGroup(groupPosition)
.toString());
return textView;
}
@Override
public boolean isChildSelectable(int groupPosition,
int childPosition) {
return true;
}
@Override
public boolean hasStableIds() {
return true;
}
};
// 为ExpandableListView设置Adapter对象
list.setAdapter(adapter);
// 使用对话框来显示查询结果
new AlertDialog.Builder(MainActivity.this)
.setView(resultDialog).setPositiveButton("确定", null)
.create()
.show();
}
});
// 为add按钮的单击事件绑定监听器
add.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
// 获取程序界面中的三个文本框的内容
String name = ((EditText) findViewById(R.id.name))
.getText().toString();
String phone = ((EditText) findViewById(R.id.phone))
.getText().toString();
String email = ((EditText) findViewById(R.id.email))
.getText().toString();
// 创建一个空的ContentValues
ContentValues values = new ContentValues();
// 向RawContacts.CONTENT_URI执行一个空值插入
// 目的是获取系统返回的rawContactId
Uri rawContactUri = getContentResolver().insert(
ContactsContract.RawContacts.CONTENT_URI, values);
long rawContactId = ContentUris.parseId(rawContactUri);
values.clear();
values.put(Data.RAW_CONTACT_ID, rawContactId);
// 设置内容类型
values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);
// 设置联系人名字
values.put(StructuredName.GIVEN_NAME, name);
// 向联系人URI添加联系人名字
getContentResolver().insert(android.provider.ContactsContract
.Data.CONTENT_URI, values);
values.clear();
values.put(Data.RAW_CONTACT_ID, rawContactId);
values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
// 设置联系人的电话号码
values.put(Phone.NUMBER, phone);
// 设置电话类型
values.put(Phone.TYPE, Phone.TYPE_MOBILE);
// 向联系人电话号码URI添加电话号码
getContentResolver().insert(android.provider.ContactsContract
.Data.CONTENT_URI, values);
values.clear();
values.put(Data.RAW_CONTACT_ID, rawContactId);
values.put(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE);
// 设置联系人的E-mail地址
values.put(Email.DATA, email);
// 设置该电子邮件的类型
values.put(Email.TYPE, Email.TYPE_WORK);
// 向联系人E-mail URI添加E-mail数据
getContentResolver().insert(android.provider.ContactsContract
.Data.CONTENT_URI, values);
Toast.makeText(MainActivity.this, "联系人数据添加成功",
Toast.LENGTH_SHORT).show();
}
});
}
}
activity_main.xml ：
result.xml :
在 strings.xml 中加入相应内容：
查询
添加
联系人姓名
电话
Email
在 AndroidManifest.xml 中加入相应的权限：