管理Android通信錄

      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;
	}

}