Android －－－ 取得电话簿信息，并保存为Vcard格式

Android PhoneBook

1.权限

<uses-permission android:name="android.permission.READ_CONTACTS"/>

2.通过ContentResolver.query取得电话簿的信息

CONTENT_URI

Contacts URI:

ContactsContract.Contacts.CONTENT_URI

Phone URI:

ContactsContract.CommonDataKinds.Phone.CONTENT_URI

Email URI:

ContactsContract.CommonDataKinds.Email.CONTENT_URI

2-1.通过取得Contacts信息

2-2.根据ContactsContract.Contacts._ID匹配ContactsContract.CommonDataKinds.Phone.CONTACT_ID来找到Phone Number等信息

2-3.根据ContactsContract.Contacts._ID匹配ContactsContract.CommonDataKinds.Email.CONTACT_ID来找到Email信息

注意：还可以更加内置的VCARD情报来取得Vcard信息。

a.取得ContactsContract.Contacts.LOOKUP_KEY

b.通过以下方式取得Vcard信息

Uri uri = Uri.withAppendedPath(ContactsContract.Contacts.CONTENT_VCARD_URI, lookkey);

AssetFileDescriptor afd = cResolver.openAssetFileDescriptor(uri, "r");

FileInputStream fis = afd.createInputStream();

byte[] buf = new byte[(int) afd.getDeclaredLength()];

3.VCard 格式：

----------------------------------------------------------

BEGIN:VCARD

VERSION:2.1

N:Gump;Forrest

FN:Forrest Gump

ORG:Bubba Gump Shrimp Co.

TITLE:Shrimp Man

TEL;WORK;VOICE:(111) 555-1212

TEL;HOME;VOICE:(404) 555-1212

ADR;WORK:;;100 Waters Edge;Baytown;LA;30314;United States of America

LABEL;WORK;ENCODING=QUOTED-PRINTABLE:100 Waters Edge=0D=0ABaytown, LA 30314=0D=0AUnited States of America

ADR;HOME:;;42 Plantation St.;Baytown;LA;30314;United States of America

LABEL;HOME;ENCODING=QUOTED-PRINTABLE:42 Plantation St.=0D=0ABaytown, LA 30314=0D=0AUnited States of America

EMAIL;PREF;INTERNET:forrestgump@example.com

REV:20080424T195243Z

END:VCARD

----------------------------------------------------------

源代码:

Vcard.java

package com.jumper.android.demos.model;

import java.util.ArrayList;
import java.util.HashMap;

import android.provider.ContactsContract;
import android.util.Log;

public class VCard {
private static final String LOG_TAG = VCard.class.getName();
private static final String VCARD_BEGIN = "BEGIN:VCARD\n\n";
private static final String VCARD_VERSION = "VERSION:2.1\n\n";
private static final String VCARD_END = "END:VCARD\n\n";
public static final String TEL_TYPE = "TYPE";
public static final String TEL_NUM = "NUM";

public static final String EMAIL_TYPE = "TYPE";
public static final String EMAIL_ADDR = "ADDR";

private StringBuilder vcard = null;
private ArrayList<HashMap<String, String>> mTels = null;
private ArrayList<HashMap<String, String>> mEmail = null;
private String mName = "";
private String mRawInfo = "";
public VCard() {
vcard = new StringBuilder();
mTels = new ArrayList<HashMap<String, String>>();
mEmail = new ArrayList<HashMap<String,String>>();
vcard.append(VCARD_BEGIN);
vcard.append(VCARD_VERSION);
}

public void setRawInfo(String cardinfo) {
mRawInfo = cardinfo;
}
public String getRawInfo() {
return mRawInfo;
}

public void setName(String name) {
String nName = "N:" + name + "\n\n";
vcard.append(nName);
String fnName = "FN:" + name + "\n\n";
vcard.append(fnName);
mName = name;
Log.v(LOG_TAG, "Name=" + name);
}
public String getName() {
return mName;
}
public void setTel(int type, String number) {
String tel = "TEL;";
switch(type) {
case ContactsContract.CommonDataKinds.Phone.TYPE_HOME:
tel += "HOME:" + number;
break;
case ContactsContract.CommonDataKinds.Phone.TYPE_MOBILE:
tel += "CELL:" + number;
break;
case ContactsContract.CommonDataKinds.Phone.TYPE_WORK:
tel += "WORK:" + number;
break;
default:
tel += "OTHER:" + number;
break;
}
tel += "\n\n";
HashMap<String, String> item = new HashMap<String, String>();
item.put(TEL_TYPE, Integer.toString(type));
item.put(TEL_NUM, number);
mTels.add(item);
vcard.append(tel);
Log.v(LOG_TAG, "tel=" + tel);
}

public ArrayList<HashMap<String, String>> getTels() {
return mTels;
}
public void setEmail(int type, String address) {
String email = "EMAIL;";
switch(type) {
case ContactsContract.CommonDataKinds.Email.TYPE_HOME:
email += "HOME:" + address;
break;
case ContactsContract.CommonDataKinds.Email.TYPE_MOBILE:
email += "CELL:" + address;
break;
case ContactsContract.CommonDataKinds.Email.TYPE_WORK:
email += "WORK:" + address;
break;
default:
email += "OTHER:" + address;
break;
}
email += "\n\n";
HashMap<String, String> item = new HashMap<String, String>();
item.put(EMAIL_TYPE, Integer.toString(type));
item.put(EMAIL_ADDR, address);
mEmail.add(item);
vcard.append(email);
Log.v(LOG_TAG, "email=" + email);
}
public ArrayList<HashMap<String, String>> getEmail() {
return mEmail;
}
public String toString() {
String ret = "";
if(mRawInfo.equals("")) {
vcard.append(VCARD_END);
ret = vcard.toString();
}
else {
ret = mRawInfo;
}
//Log.v(LOG_TAG, "Vcard=" + ret);
return ret;
}
}

PhoneBook.java

package com.jumper.android.demos.call;

import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.util.ArrayList;

import com.jumper.android.demos.model.VCard;

import android.content.ContentResolver;
import android.content.Context;
import android.database.Cursor;
import android.provider.ContactsContract;

public class PhoneBook {
private Context mContext = null;

public PhoneBook(Context context) {
mContext = context;
}

/**
* If the input parameter is null or space, return all contacts info.
* @param name
* @return vcard string
*/
public ArrayList<VCard> getPerson(String name){
ArrayList<VCard> vcardList = null;

String selection = null;
if(name != null && !"".equals(name.trim())) {
selection = ContactsContract.Contacts.DISPLAY_NAME + " like \'%" + name + "%\'";
}

ContentResolver cResolver = mContext.getContentResolver();
Cursor cursor = cResolver.query(ContactsContract.Contacts.CONTENT_URI, null, selection, null, null);
if(cursor != null) {
vcardList = new ArrayList<VCard>();

while(cursor.moveToNext()) {
VCard vcard = new VCard();

int colIdx = cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME);
String disname = cursor.getString(colIdx);
vcard.setName(disname);

colIdx = cursor.getColumnIndex(ContactsContract.Contacts._ID);
String _id = cursor.getString(colIdx);

colIdx = cursor.getColumnIndex(ContactsContract.Contacts.LOOKUP_KEY);
String lookkey = cursor.getString(colIdx);

// Telephone Number
colIdx = cursor.getColumnIndex(ContactsContract.Contacts.HAS_PHONE_NUMBER);
int has_phone_num = cursor.getInt(colIdx);
if(has_phone_num > 0) {
selection = ContactsContract.CommonDataKinds.Phone.CONTACT_ID + " = ?";
Cursor telCursor = cResolver.query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null, selection, new String[]{_id}, null);
if(telCursor != null) {
while(telCursor.moveToNext()) {
colIdx = telCursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.TYPE);
int type = telCursor.getInt(colIdx);
colIdx = telCursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER);
String telno = telCursor.getString(colIdx);
vcard.setTel(type, telno);
}
telCursor.close();
}
}

// Email Address
selection = ContactsContract.CommonDataKinds.Email.CONTACT_ID + " = ?";;
Cursor emailCursor = cResolver.query(ContactsContract.CommonDataKinds.Email.CONTENT_URI, null, selection, new String[]{_id}, null);
if(emailCursor != null) {
while(emailCursor.moveToNext()) {
colIdx = emailCursor.getColumnIndex(ContactsContract.CommonDataKinds.Email.TYPE);
int type = emailCursor.getInt(colIdx);
colIdx = emailCursor.getColumnIndex(ContactsContract.CommonDataKinds.Email.DATA);
String address = emailCursor.getString(colIdx);
vcard.setEmail(type, address);
}
emailCursor.close();
}

vcardList.add(vcard);

// Get Embedded Vcard Info
//				Uri uri = Uri.withAppendedPath(ContactsContract.Contacts.CONTENT_VCARD_URI, lookkey);
//				try {
//					AssetFileDescriptor afd = cResolver.openAssetFileDescriptor(uri, "r");
//					FileInputStream fis = afd.createInputStream();
//					byte[] buf = new byte[(int) afd.getDeclaredLength()];
//					if (fis.read(buf) > 0) {
//						String rawinfo = new String(buf);
//						vcard.setRawInfo(rawinfo);
//					}
//				} catch (FileNotFoundException e) {
//					e.printStackTrace();
//				} catch (IOException e) {
//					e.printStackTrace();
//				}

}
}
return vcardList;
}
}