Android提供了Contacts应用程序来管理联系人,并且Android系统还为联系人管理提供了ContentProvider,这就同意其他应用程序以ContentResolver来管理联系人数据。
关于ContentProvider、ContentResolver和Uri具体解释大家能够參考http://blog.csdn.net/fengyuzhengfan/article/details/37743963。这里就不在过多的陈述了。
先送上实例执行效果图:
在对联系人进行操作之前,先让我们了解一下通讯录数据库里面基本的几张表:
1) RawContacts:存放联系人的ID,_id属性为主键,声明为autoincrement。即不须要手动设置,其它属性也不须要手动设置就有默认值;
2) mimetypes:存放数据的类型。比方"vnd.android.cursor.item/name"表示“姓名”类型的数据,"vnd.android.cursor.item/phone_v2"表示“电话”类型的数据;
字段名 |
说明 |
电话 |
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 |
3) 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” |
4) raw_contact_id属性用来连接raw_contacts表,每条记录表示一个详细数据;我们基本的数据(email、phone等)都存放在data表;
5) StructuredName 中主要保存的是联系人姓名。其称呼名和其拼音名。
当我们向通信录数据库中插入联系人的时候。通常是先往RawContacts表插入一行空值以获得返回的rawContactId也就是联系人ID,之后再依据这个ID陆续向Data表中插入联系人的姓名、电话、以及Email等信息。
应用实例:
package com.jph.contactproviderdemo; import java.util.ArrayList; 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.Contacts.Data;
import android.provider.ContactsContract.RawContacts;
import android.app.Activity;
import android.app.AlertDialog;
import android.content.ContentResolver;
import android.content.ContentUris;
import android.content.ContentValues;
import android.database.Cursor;
import android.view.Menu;
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;
/**
* Describe:</br>
* 通过ContenPprovider管理的联系人</br>
* 本实例主要实现了联系人的加入与查询</br>
* @author JPH
* Date:2014.07.15
* */
public class ContactProviderDemo extends Activity {
ContentResolver resolver;
Button btnSelect,btnAdd;
EditText edtName,edtPhone,edtEmail;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
btnAdd=(Button)findViewById(R.id.add);
btnSelect=(Button)findViewById(R.id.search);
edtEmail=(EditText)findViewById(R.id.email);
edtName=(EditText)findViewById(R.id.name);
edtPhone=(EditText)findViewById(R.id.phone);
//获取ContentResolver对象
resolver=getContentResolver();
/*******************************************查询联系人***************************************************/
btnSelect.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
// TODO Auto-generated method stub
//定义两个ArrayList用于存放联系人的信息
final ArrayList<String>username=new ArrayList<String>();
final ArrayList<ArrayList<String>>details=new ArrayList<ArrayList<String>>();
//查询联系人数据
Cursor cursor=resolver.query(ContactsContract.Contacts.CONTENT_URI
, null, null, null, null);
//遍历cursor取出联系人姓名及ID
while (cursor.moveToNext()) {
//获取联系人姓名
String name=cursor.getString(cursor.getColumnIndex
(ContactsContract.Contacts.DISPLAY_NAME));
//获取联系ID
String contactId=cursor.getString(cursor.getColumnIndex
(ContactsContract.Contacts._ID));
username.add(name);
//查询联系人电话号码
Cursor phones=resolver.query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI
, null, ContactsContract.CommonDataKinds.Phone.CONTACT_ID+"="+contactId, null, null);
//定义一个detail列表数组用于存放联系人的电话号码和Email
ArrayList<String>detail=new ArrayList<String>();
//遍历查询结果,获取该联系人的多个电话号码
while (phones.moveToNext()) {
String phonenumber=phones.getString(phones.getColumnIndex(
ContactsContract.CommonDataKinds.Phone.NUMBER));
detail.add("电话号码:"+phonenumber);
}
phones.close();//关闭phones游标回收资源
//查询联系人Email
Cursor emails=resolver.query(ContactsContract.CommonDataKinds.Email.CONTENT_URI
, null, ContactsContract.CommonDataKinds.Email.CONTACT_ID+"="+contactId, null, null);
//遍历查询结果,获取该联系人的多个电话号码
while (emails.moveToNext()) {
String emailAddress=emails.getString(emails.getColumnIndex(
ContactsContract.CommonDataKinds.Email.DATA));
detail.add("Email:"+emailAddress);
}
emails.close();//关闭emails游标回收资源
details.add(detail);
}
cursor.close();
//载入result.xml布局界面代表的视图
View view=getLayoutInflater().inflate(R.layout.result, null);
//获取view中的ExpandableListView组件
ExpandableListView list=(ExpandableListView) view.findViewById(R.id.list);
//创建ExpandableListAdapter为list填充数据
ExpandableListAdapter adapter=new BaseExpandableListAdapter() {
//定义一个显示联系人信息的TextView
TextView geTextView(){
TextView textView=new TextView(ContactProviderDemo.this);
AbsListView.LayoutParams lp=new AbsListView.LayoutParams(
ViewGroup.LayoutParams.MATCH_PARENT,64);
textView.setLayoutParams(lp);
textView.setPadding(36, 0, 0, 0);
textView.setTextSize(20);
return textView;
}
@Override
public boolean isChildSelectable(int groupPosition, int childPosition) {
// TODO Auto-generated method stub
return true;
} @Override
public boolean hasStableIds() {
// TODO Auto-generated method stub
return true;
} @Override
public View getGroupView(int groupPosition, boolean isExpanded,
View convertView, ViewGroup parent) {
// TODO Auto-generated method stub
TextView textView=geTextView();
textView.setText(getGroup(groupPosition).toString());
return textView;
} @Override
public long getGroupId(int groupPosition) {
// TODO Auto-generated method stub
return groupPosition;
} @Override
public int getGroupCount() {
// TODO Auto-generated method stub
return username.size();
} @Override
public Object getGroup(int groupPosition) {
// TODO Auto-generated method stub
return username.get(groupPosition);
} @Override
public int getChildrenCount(int groupPosition) {
// TODO Auto-generated method stub
return details.get(groupPosition).size();
} @Override
public View getChildView(int groupPosition, int childPosition,
boolean isLastChild, View convertView, ViewGroup parent) {
// TODO Auto-generated method stub
TextView textView=geTextView();
textView.setText(getChild(groupPosition, childPosition).toString());
return textView;
} @Override
public long getChildId(int groupPosition, int childPosition) {
// TODO Auto-generated method stub
return childPosition;
} @Override
public Object getChild(int groupPosition, int childPosition) {
// TODO Auto-generated method stub
return details.get(groupPosition).get(childPosition);
}
};
//为ExpandableListView设置ExpandableListAdapter
list.setAdapter(adapter);
//创建对话框显示查询结果
new AlertDialog.Builder(ContactProviderDemo.this).
setView(view).setPositiveButton("确定", null).show();
}
});
/*******************************************加入联系人***************************************************/
btnAdd.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
// TODO Auto-generated method stub
//获取用户输入的联系人信息
String name=edtName.getText().toString();
String phone=edtPhone.getText().toString();
String email=edtEmail.getText().toString();
//定义一个ContentValues
ContentValues values=new ContentValues();
//向RawContacts.CONTENT_URI插入空值以获得返回的rawContactId
Uri uri=resolver.insert(RawContacts.CONTENT_URI, values);
//解析出rawContactId
long rawContactId=ContentUris.parseId(uri);
values.clear();
/**********加入联系人的姓名*************/
//设置联系人Id
values.put(Data.RAW_CONTACT_ID, rawContactId);
//设置内容类型
values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);
//设置联系人姓名(StructuredName中保存的是联系人姓名,其称呼名和其拼音名)
values.put(StructuredName.DISPLAY_NAME, name);
//向联系人URi加入联系人姓名
resolver.insert(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加入电话号码
resolver.insert(ContactsContract.Data.CONTENT_URI, values);
values.clear();
/**********加入联系人Email*************/
//设置联系人Id
values.put(Data.RAW_CONTACT_ID, rawContactId);
//设置内容类型
values.put(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE);
//设置联系人Email
values.put(Email.DATA,email);
//向联系人URi加入联系人姓名
resolver.insert(ContactsContract.Data.CONTENT_URI, values);
Toast.makeText(ContactProviderDemo.this, "加入联系人成功", Toast.LENGTH_SHORT).show();
}
});
} @Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflate the menu; this adds items to the action bar if it is present.
getMenuInflater().inflate(R.menu.contact_provider_demo, menu);
return true;
} }