我8月份的时候接触过联系人这里，看了很多文章，把我弄蒙了，今天突然发现这篇文章，不错，如果我以后涉及到这方面的业务，会多来学习下，作者博客地址和英文原文地址都放在最下面了。
前阵子搞短信，发现Android 1.x至2.0 版本联系人数据库很多地方做了更改，且关于这方面的资料也比较少，所以找到一篇文章稍作翻译了下，以供大家参考，该文将分三部分发布。
Working With Android Contacts
Learn to work with the Android contacts database. Basic knowledge of accessing SQLite in Android along with using Cursors is expected. See the Android SQLite and Cursor Article for more information. Google changed the contacts database moving from 1.x to 2.0 versions of Android. This tutorial will be broken into 3 sections. First covering accessing contacts in Android 2.0. The second page will deal with accessing the contacts in Android 1.6 and before. Third we'll glue it all together with a class that abstracts specific classes for each version and a set of classes to manage the data from the contact records.
学习使用Android联系人数据库。要求懂得基本的SQLite的知识。可以查看 Android SQLite and Cursor Article相关文章以获取更多信息。从Android 1.x 至 2.0 版本谷歌改变了Android的联系人数据库。该手册主要分为三个部分：一是介绍2.0中访问名片夹；二是介绍1.6之前的版本；三我们综合了为每个版本给出一个抽象类和累积来管理名片记录数据。
Create a new project called TestContacts in Eclipse setup for Android 2.0.
Before an application can query the contact records access must be granted through the AndroidManifest.xml file stored in the root of the project. Add the following uses-permission belows the uses-sdk statement. 在AndroidManifest.xml文件中授予以下权限
<uses-permission android:name="android.permission.READ_CONTACTS" />
Basic contact information stored in Contacts table with detailed information stored in individual tables for normalization. In Android 2.0 to query the base contact records the URI to query is stored in ContactsContract.Contacts.CONTENT_URI.
基本的个人信息存储在名片夹表，而详细的存储在个人表里。在Andoid2.0中查询相应联系记录的URI是ContactsContract.Contacts.CONTENT_URI。
package com.test;
import android.app.Activity;
import android.database.Cursor;
import android.os.Bundle;
import android.provider.ContactsContract;
import android.provider.ContactsContract.Contacts;
public
class TestContacts
extends Activity {
@Override
public
void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
ContentResolver cr = getContentResolver();
Cursor cursor = cr.query(ContactsContract.Contacts.CONTENT_URI,
null,
null,
null,
null);
//
查询通讯录
if(cursor.getCount()>0){
while (cursor.moveToNext()) {
String id = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts._ID));
//
联系人id
String name = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
//
联系人名称
if(cursor.getInt(cursor.getColumnIndex(ContactsContract.Contacts.HAS_PHONE_NUMBER))>0){
//
Query phone here. Covered next 在该处查询电话号码
}
}
}
}
}
This application starts off as any other Android application. First create a ContentResolver isntance in cr. Then use the ContentResolver instance to query the database and return a Cursor with the contacts list. The query is perofrmed against the URI stored in ContactsContract.Contacts.CONTENT_URI. Next check if the cursor contains records and if so loop through them. The record ID field is stored in the id variable. This will be used as a where parameter later. Also the display name field is stored in the string name. For more details about working with cursors see Android Cursors Tutorial.
启动该应用程序时需关闭任何其他Android应用程序。首先，创建一个ContentResolver的实例cr。然后使用ContentResolver的实例查询数据库并返回联系人列表游标。该查询是针对ContactsContract.Contacts.CONTENT_URI 进行存储的URI。下一步检查游标是否包含记录，如果包含记录，侧记录ID字段的值存储在ID变量中。他将作为一个参数在后面的地方使用。也把名称字段的值存储在name变量中。对于游标的更多详细用法可以查看 Android的游标教程 。
Phone numbers are stored in their own table and need to be queried separately. To query the phone number table use the URI stored in the SDK variable ContactsContract.CommonDataKinds.Phone.CONTENT_URI. Use a WHERE conditional to get the phone numbers for the specified contact.
电话号码存储在它们自己的表中，需要单独进行查询。要查询的电话号码表使用的是SDK中的变量ContactsContract.CommonDataKinds.Phone.CONTENT_URI存储的URI。使用WHERE条件得到指定联系人的电话号码。
//
根据ID查询出电话号码
Cursor pCur = cr.query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
null, ContactsContract.CommonDataKinds.Phone.CONTACT_ID +" = ?",
new String[]{id},
null);
while (pCur.moveToNext()) {
//
Do something with phones
}
pCur.close();
Perform a second query against the Android contacts SQLite database. The phone numbers are queried against the URI stored in ContactsContract.CommonDataKinds.Phone.CONTENT_URI. The contact ID is stored in the phone table as ContactsContract.CommonDataKinds.Phone.CONTACT_ID and the WHERE clause is used to limit the data returned.
在Android联系人SQLite数据库中执行第二个查询。查询的电话号码是针对ContactsContract.CommonDataKinds.Phone.CONTENT_URI存储的URI。CONTACT_ID存储在电话表中，ContactsContract.CommonDataKinds.Phone.CONTACT_ID和where子句用于限制返回的数据。
Querying email addresses is similar to phone numbers. A query must be performed to get email addresses from the database. Query the URI stored in ContactsContract.CommonDataKinds.Email.CONTENT_URI to query the email address table.
查询电子邮件地址类似电话号码。必须执行一个查询从数据库中获取电子邮件地址。根据存储在ContactsContract.CommonDataKinds.Email.CONTENT_URI的URI来查询电子邮件地址表。
Cursor emailCur = cr.query(ContactsContract.CommonDataKinds.Email.CONTENT_URI,
null,
ContactsContract.CommonDataKinds.Email.CONTACT_ID + " = ?",
new String[]{id},
null);
while (emailCur.moveToNext()) {
//
如果email地址被保存在一个数组中，你将得到多个邮件地址
String email = emailCur.getString(emailCur.getColumnIndex(ContactsContract.CommonDataKinds.Email.DATA));
String emailType = emailCur.getString(emailCur.getColumnIndex(ContactsContract.CommonDataKinds.Email.TYPE));
}
emailCur.close();
As with the phone query the field names for the email table are also stored under ContactsContract.CommonDataKinds. The email query is performed on the URI in ContactsContract.CommonDataKinds.Email.CONTENT_URI and the WHERE clause has to match the ContactsContract.CommonDataKinds.Email.CONTACT_ID field. Since multiple email addresses can be stored loop through the records returned in the Cursor.
正如手机查询email表中的字段名称也存在ContactsContract.CommonDataKinds。该email执行查询的URI ContactsContract.CommonDataKinds.Email.CONTENT_URI和where子句必须符合ContactsContract.CommonDataKinds.Email.CONTACT_ID领域。多个email地址可以通过存储在游标返回的记录循环。
Custom notes can be attached to each contact record. As before these are stored in a separate table and are related based on the contact ID.
可以为每个联系人记录附加自定义注释。这些注释被存储在一个单独的表中，根据相关的联系人ID查询。
String noteWhere = ContactsContract.Data.CONTACT_ID + " = ? AND " + ContactsContract.Data.MIMETYPE + " = ?";
String[] noteWhereParams =
new String[]{id,ContactsContract.CommonDataKinds.Note.CONTENT_ITEM_TYPE};
Cursor noteCur = cr.query(ContactsContract.Data.CONTENT_URI,
null, noteWhere, noteWhereParams,
null);
if (noteCur.moveToFirst()) {
String note = noteCur.getString(noteCur.getColumnIndex(ContactsContract.CommonDataKinds.Note.NOTE));
}
noteCur.close();
Notes are stored in the Android Contacts generic data table. When accessing specific data the WHERE clause will need 2 conditionals. First the standard contact ID, second a MIMETYPE for the data that is being requested. The Android SDK comes with a series of auto-generated variables that take care of this. Use the ContactsContract.CommonDataKinds.Note.CONTENT_ITEM_TYPE variable to limit the query to note records. The data table URI is stored at ContactsContract.Data.CONTENT_URI. Finally the note field name is stored in ContactsContract.CommonDataKinds.Note.NOTE.
注释存储在Android联系人通用数据表中。当访问指定数据时where子句将需要2个条件。首先是标准的联系人ID,第二个是对那些被请求数据的媒体类型。在Android SDK中有一系列自动生成的变量处理这个。使用ContactsContract.CommonDataKinds.Note.CONTENT_ITEM_TYPE来限要查询的记录。数据表URI存放在ContactsContract.Data.CONTENT_URI。最后，注意字段名称存储在ContactsContract.CommonDataKinds.Note.NOTE。
Android can store multiple postal addresses per contact. Addresses are also stored in the data table like notes and queried via the URI stored in ContactsContract.Data.CONTENT_URI. Similar to the notes query a MIMETYPE must be added to the WHERE conditional. Also in Android 2.0 the Address record was split into multiple fields containing different parts of the address (PO-Box, stree, city, region, postal code). In earlier versions of the Android SDK this was a free-form string storage.
Android的每个联系人都可以多个邮政地址。地址也存储在Notes数据表中，并通过存储在ContactsContract.Data.CONTENT_URI的URI查询。类似于注释查询，媒体类型必须被添加到where条件。另外，在Android2.0中，邮政地址记录被分割成多个小地址（邮政信箱、应力[不知道什么意思]、城市、地区、邮政编码）。在早期的Android SDK版本中，该地址是由一个自由格式的字符串存储。
String addrWhere = ContactsContract.Data.CONTACT_ID + " = ? AND " + ContactsContract.Data.MIMETYPE + " = ?";
String[] addrWhereParams =
new String[]{id,ContactsContract.CommonDataKinds.StructuredPostal.CONTENT_ITEM_TYPE};
Cursor addrCur = cr.query(ContactsContract.Data.CONTENT_URI,
null, addrWhere, addrWhereParams,
null);
while(addrCur.moveToNext()) {
String poBox = addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.POBOX));
String street = addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.STREET));
String city = addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.CITY));
String region = addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.REGION));
String postalCode = addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.POSTCODE));
String country = addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.COUNTRY));
String type = addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.TYPE));
}
addrCur.close();
This code is similar to the previous example. Notice the field names for the address pieces are stored in ContactsContract.CommonDataKinds.StructuredPostal.
此代码类似于前面的示例。请注意该地址块的字段名称都存储在ContactsContract.CommonDataKinds.StructuredPostal。
The instant messenger query performs just as the notes and address queries. Important field names for IM related data are stored in ContactsContract.CommonDataKinds.Im.
即时消息查询仅作为注释及地址查询。IM相关数据的重要字段名称存储在ContactsContract.CommonDataKinds.Im。
String imWhere = ContactsContract.Data.CONTACT_ID + " = ? AND " + ContactsContract.Data.MIMETYPE + " = ?";
String[] imWhereParams =
new String[]{id,ContactsContract.CommonDataKinds.Im.CONTENT_ITEM_TYPE};
Cursor imCur = cr.query(ContactsContract.Data.CONTENT_URI,
null, imWhere, imWhereParams,
null);
if (imCur.moveToFirst()) {
String imName = imCur.getString(imCur.getColumnIndex(ContactsContract.CommonDataKinds.Im.DATA));
String imType = imCur.getString(imCur.getColumnIndex(ContactsContract.CommonDataKinds.Im.TYPE));
}
imCur.close();
The last part of the contact record to be covered is the Organizations data. The Android contact record can contain information about Employment, professional, and social memberships as well as roles and titles. These records are queried from the URI stored in ContactsContract.Data.CONTENT_URI. Important field names for the organization data are stored in ContactsContract.CommonDataKinds.Organization.
联系人记录的最后一部分是组织的数据。Android的联系人记录可以包含有关就业、职业信息、社会成员以及角色和职称。这些记录从ContactsContract.Data.CONTENT_URI存储的URI查询。组织数据的重要字段名称存储在ContactsContract.CommonDataKinds.Organization。
String orgWhere = ContactsContract.Data.CONTACT_ID + " = ? AND " + ContactsContract.Data.MIMETYPE + " = ?";
String[] orgWhereParams =
new String[]{id,ContactsContract.CommonDataKinds.Organization.CONTENT_ITEM_TYPE};
Cursor orgCur = cr.query(ContactsContract.Data.CONTENT_URI,
null, orgWhere, orgWhereParams,
null);
if (orgCur.moveToFirst()) {
String orgName = orgCur.getString(orgCur.getColumnIndex(ContactsContract.CommonDataKinds.Organization.DATA));
String title = orgCur.getString(orgCur.getColumnIndex(ContactsContract.CommonDataKinds.Organization.TITLE));
}
orgCur.close();
If you just read the begining of this article the first bit of this page is going to look familiar. This page is designed to act as a standalone guide to working with the contacts API in Android 1.6 and before. 假如你刚刚阅读了该文的开头是否有种时曾相识的感觉。该文主要是用来介绍1.6以下版本联系人的API。
Before an application can query the contact records access must be granted through the AndroidManifest.xml file stored in the root of the project. Add the following uses-permission belows the uses-sdk statement. 同Android Contacts的使用（一）
<uses-permission android:name="android.permission.READ_CONTACTS" />
Basic contact information stored in Contacts table with detailed information stored in individual tables for normalization. In Android 1.x to query the base contact records the URI to query is stored in People.CONTENT_URI. 基本的联系人信息存储在联系人表中，而详细信息存储在个人表中。在 Android1.x 中查询的联系人记录数据库的URI是People.CONTENT_URI。
package
com.test;
import
android.app.Activity;
import
android.content.ContentResolver;
import
android.database.Cursor;
import
android.os.Bundle;
import
android.provider.Contacts.People;
public
class
TestContacts
extends
Activity {
@Override
public
void
onCreate(Bundle savedInstanceState) {
super
.onCreate(savedInstanceState);
setContentView(R.layout.main);
ContentResolver cr
=
getContentResolver();
Cursor cur
=
cr.query(People.CONTENT_URI,
null
,
null
,
null
,
null
);
if
(cur.getCount()
>
0
){
while
(cur.moveToNext()) {
String id
=
cur.getString(cur.getColumnIndex(People._ID));
String name
=
cur.getString(cur.getColumnIndex(People.DISPLAY_NAME));
}
}
}
}
Start off with the standard view loading. Then we create a ContentResolver instance that will be used to query the SQLite database that stores the contacts. The ContentResolver query returns a Cursor instance that holds the contact records queried from the database. Then take the ID field from the contact record and store it in the string id and take the DISPLAY_NAME field and place it in the string name. For more information about cursors see the Android Cursor Tutorial. 参考Android Contacts的使用（一）
Phone numbers are stored in their own table and need to be queried separately. To query the phone number table use the URI stored in the SDK variable Contacts.Phones.CONTENT_URI. Use a WHERE conditional to get the phone numbers for the specified contact. 同Android Contact的使用（一），查询的URI换成Contacts.Phones.CONTENT_URI。
if
(cur.getInt(cur.getColumnIndex(People.PRIMARY_PHONE_ID))
>
0
) {
Cursor pCur
=
cr.query(Contacts.Phones.CONTENT_URI,
null
,
Contacts.Phones.PERSON_ID
+
"
= ?
"
,
new
String[]{id},
null
);
int
i
=
0
;
int
pCount
=
pCur.getCount();
String[] phoneNum
=
new
String[pCount];
String[] phoneType
=
new
String[pCount];
while
(pCur.moveToNext()) {
phoneNum[i]
=
pCur.getString(pCur.getColumnIndex(Contacts.Phones.NUMBER));
phoneType[i]
=
pCur.getString(pCur.getColumnIndex(Contacts.Phones.TYPE));
i
++
;
}
}
Query the phones table and get a Cursor stored in pCur. Since the Android contacts database can store multiple phone numbers per contact we need to loop through the returned results. In addition to returning the phone number the query also returned the type of number (home, work, mobile, etc). 查询电话表，返回一个游标pCur。由于Android中每个联系人可以存储多个电话号码，我们需要遍历返回的结果。查询除了返回电话号码外还返回了其他（家庭，工作，手机等）类型。
Querying email addresses is similar to phone numbers. A special query must be performed to get email addresses from the database. Query the URI stored in Contacts.ContactMethods.CONTENT_EMAIL_URI to query the email addresses. 同Android Contact的使用（一），查询的URI换成Contacts.ContactMethods.CONTENT_EMAIL_URI。
Cursor emailCur
=
cr.query(Contacts.ContactMethods.CONTENT_EMAIL_URI,
null
,
Contacts.ContactMethods.PERSON_ID
+
"
= ?
"
,
new
String[]{id},
null
);
while
(emailCur.moveToNext()) {
//
This would allow you get several email addresses
}
emailCur.close();
Simple query Contacts.ContactMethods.CONTENT_EMAIL_URI with a conditional limiting the results to numbers that match the ID of the contact record matches the value in the field Contacts.ContactMethods.PERSON_ID. As with phone numbers each contact can contain multiple email addresses so we need to loop through the Cursor records. 查询Contacts.ContactMethods.CONTENT_EMAIL_URI，以联系人记录的ID为条件匹配Contacts.ContactMethods.PERSON_ID的值。正如电话号码每个联系人也可以有多个email地址，同样的我们也需要遍历返回的结果。
Custom notes can be attached to each contact record. Notes though are stored in the main contact record and are simply accessed through the data stored in People.NOTES. 可以为每个联系人附加自定义注释。注释存储在联系人记录中，并通过People.NOTES存储的数据进行访问。
String notes
=
cur.getString(cur.getColumnIndex(People.NOTES));
Android can store multiple postal addresses per contact. Addresses are stored in the contact methods table and need to have a second conditional added to retrieve the data. Add a conditional Contacts.ContactMethods.KIND that matches Contacts.ContactMethods.CONTENT_POSTAL_ITEM_TYPE to only query postal addresses from Contacts.ContactMethods.CONTENT_URI. 每个联系人都可以存储多个邮政地址。地址存储在联系方式表中，要获取数据，需要有次要条件。添加适配Contacts.ContactMethods.CONTENT_POSTAL_ITEM_TYPE的条件Contacts.ContactMethods.KIND来访问Contacts.ContactMethods.CONTENT_URI传递过来的地址。
String addrWhere
=
Contacts.ContactMethods.PERSON_ID
+
"
= ? AND
"
+
Contacts.ContactMethods.KIND
+
"
= ?
"
;
String[] addrWhereParams
=
new
String[]{id,
Contacts.ContactMethods.CONTENT_POSTAL_ITEM_TYPE};
Cursor addrCur
=
cr.query(Contacts.ContactMethods.CONTENT_URI,
null
, addrWhere, addrWhereParams,
null
);
while
(addrCur.moveToNext()) {
String addr
=
addrCur.getString(
addrCur.getColumnIndex(Contacts.ContactMethodsColumns.DATA));
String type
=
addrCur.getString(
addrCur.getColumnIndex(Contacts.ContactMethodsColumns.TYPE));
}
addrCur.close();
Query Contacts.ContactMethods.CONTENT_URI with 2 conditionals, one limiting the contact ID and the second Contacts.ContactMethods.KIND matching Contacts.ContactMethods.CONTENT_POSTAL_ITEM_TYPE to only query postall addresses. Android can store multiple postal addresses so loop through the list of returned results. Android also stores a type record for the address. In Android 1.6 and before the address is stored as a free-form string containing the data. In Android 2.0 and later this has changed to being a series of fields containing parts of the address. 查询Contacts.ContactMethods.CONTENT_URI需要2个条件，一个是联系人的ID另一个是通过Contacts.ContactMethods.CONTENT_POSTAL_ITEM_TYPE来匹配Contacts.ContactMethods.KIND查询postal地址。Android可以通过循环来遍历返回的结果列表中的多个postal地址，他也存储了地址类型的记录。在Android1.6或更早的版本中，该地址是由一个自由格式的字符串存储，在2.0或更高的版本中，已经更改为多个小地址存储。
The instant messenger query works just like the previous 2. The data is queried from Contacts.ContactMethods.CONTENT_URI and needs conditionals for the contact ID and Contacts.ContactMethods.KIND matching Contacts.ContactMethods.CONTENT_IM_ITEM_TYPE. 即时消息查询类似于postal地址查询，查询这些数据也需要联系人的Id和Contacts.ContactMethods.CONTENT_IM_ITEM_TYPE来匹配Contacts.ContactMethods.KIND为条件。
String imWhere
=
Contacts.ContactMethods.PERSON_ID
+
"
= ? AND
"
+
Contacts.ContactMethods.KIND
+
"
= ?
"
;
String[] imWhereParams
=
new
String[]{id,
Contacts.ContactMethods.CONTENT_IM_ITEM_TYPE};
Cursor imCur
=
cr.query(Contacts.ContactMethods.CONTENT_URI,
null
, imWhere, imWhereParams,
null
);
if
(imCur.moveToFirst()) {
String imName
=
imCur.getString(
imCur.getColumnIndex(Contacts.ContactMethodsColumns.DATA));
String imType
=
imCur.getString(
imCur.getColumnIndex(Contacts.ContactMethodsColumns.TYPE));
}
imCur.close();
The last part of the contact record to be covered is the Organizations data. The Android contact record can contain information about Employment, professional, and social memberships as well as roles and titles. These records are queried from the URI stored in Contacts.Organizations.CONTENT_URI. 联系人记录的最后一部分数据组织数据。在Android中联系记录可以包含有关就业、职业信息、社会成员以及角色和职称等信息。这些记录需从Contacts.Organizations.CONTENT_URI存储的URI查询。
String orgWhere
=
Contacts.ContactMethods.PERSON_ID
+
"
= ?
"
;
String[] orgWhereParams
=
new
String[]{id};
Cursor orgCur
=
cr.query(Contacts.Organizations.CONTENT_URI,
null
, orgWhere, orgWhereParams,
null
);
if
(orgCur.moveToFirst()) {
String orgName
=
orgCur.getString(
orgCur.getColumnIndex(Contacts.Organizations.COMPANY));
String title
=
orgCur.getString(
orgCur.getColumnIndex(Contacts.Organizations.TITLE));
}
orgCur.close();
Working With Android Contacts
To put this together into an application there are a few glue pieces that need to be setup along with creating classes to manage accessing the data. First we need to create a set of classes to hold the data. Also we'll create a class to handle 2.0 API calls and a class to handle 1.6 and earlier API calls. There's also a wrapper class that determines and loads the proper class.
需把整合类一起放在程序里，同时创建类来管理访问这些数据。(该处实在是翻译不通)。首先，我们需要创建一个类用来保存数据。此外，我们将创建一个类用来处理2.0API 调用和一个类用来处理1.6 或更早的 API 调用。还有一个包装类，用来确定并加载适当的类。
The contact classes are a series of classes to hold a list of contacts. The list is stored in the class ContactList that maintains an ArrayList of Contacts. The Contact objects are represented in the Contact class. The contact class stores all the data from the Android contact record. In addition to the ContactList and Contact classes there are specialized classes to represent some of the record data.
Contact类是一系列保持名片夹列表的类。该类存储在ContactList类中，此类维护着联系人列表。Contact类表示联系人对象，该类保存着所有从Android查询出的联系人数据。另外，在ContactList和Contact类中，有特定的类来表示某些记录的信息。
We will create classes to represent the address, email, instant messenger, phone number, and organization(s). Most of these classes are mere data storage classes with variables and getter/setters.
我们将创建一个实体类来表示地址、email、即时通讯、电话号码、组织等信息。该类大部分数据是单纯的变量，和一些getter/setters方法。
The ContactList class is a very basic class designed to hold an ArrayList of instances of the Contact class below. We've left this class very plain and ready to be expanded to suit your needs.
ContactList是一个基类，设计一个ArrayList数组用来存储Contact实例。这样降低了耦合度，可以随时扩大以满足需求。
package
com.test;
import
java.util.ArrayList;
public
class
ContactList {
private
ArrayList
<
Contact
>
contacts
=
new
ArrayList
<
Contact
>
();
public
ArrayList
<
Contact
>
getContacts() {
return
contacts;
}
public
void
setContacts(ArrayList
<
Contact
>
contacts) {
this
.contacts
=
contacts;
}
public
void
addContact(Contact contact) {
this
.contacts.add(contact);
}
public
ContactList() {
}
}
The Contact class is used to store the details about each contact. There are a series of private class variables to hold this data. Singular data such as name and database ID are stored as strings. Complex data is stored either as an instance or ArrayList of data specific classes. This class is mainly getters and setters with a few methods to add to the internal ArrayLists.
Contact类用来存储每个联系人的详细信息。该类定义了一些私有变量来保存这些数据。如名称和id定义成String型，而复杂的数据侧定义成数组或实例。这个类主要是生成一个getters和setters方法以便添加到数组中。
package
com.test;
import
java.util.ArrayList;
public
class
Contact {
private
String id;
private
String displayName;
private
ArrayList
<
Phone
>
phone;
private
ArrayList
<
Email
>
email;
private
ArrayList
<
String
>
notes;
private
ArrayList
<
Address
>
addresses
=
new
ArrayList
<
Address
>
();
private
ArrayList
<
IM
>
imAddresses;
private
Organization organization;
public
String getId() {
return
id;
}
public
void
setId(String id) {
this
.id
=
id;
}
public
String getDisplayName() {
return
displayName;
}
public
void
setDisplayName(String displayName) {
this
.displayName
=
displayName;
}
public
ArrayList
<
Phone
>
getPhone() {
return
phone;
}
public
void
setPhone(ArrayList
<
Phone
>
phone) {
this
.phone
=
phone;
}
public
void
addPhone(Phone phone) {
this
.phone.add(phone);
}
public
ArrayList
<
Email
>
getEmail() {
return
email;
}
public
void
setEmail(ArrayList
<
Email
>
email) {
this
.email
=
email;
}
public
void
addEmail(Email email) {
this
.email.add(email);
}
public
ArrayList
<
String
>
getNotes() {
return
notes;
}
public
void
setNotes(ArrayList
<
String
>
notes) {
this
.notes
=
notes;
}
public
void
AddNotes(String notes){
this
.notes.add(notes);
}
public
ArrayList
<
Address
>
getAddresses() {
return
addresses;
}
public
void
setAddresses(ArrayList
<
Address
>
addresses) {
this
.addresses
=
addresses;
}
public
void
addAddress(Address address) {
this
.addresses.add(address);
}
public
ArrayList
<
IM
>
getImAddresses() {
return
imAddresses;
}
public
void
setImAddresses(ArrayList
<
IM
>
imAddresses) {
this
.imAddresses
=
imAddresses;
}
public
void
addImAddresses(IM imAddr) {
this
.imAddresses.add(imAddr);
}
public
Organization getOrganization() {
return
organization;
}
public
void
setOrganization(Organization organization) {
this
.organization
=
organization;
}
}
The Address class is the only class in the ContactList framework that actually does any work. Due to differences in data storage between 1.x and 2.0 versions of Android the Address class has to determine if the input address is free-form from 1.x or was input from the formatted data structure from 2.0. Android 2.0 has individual data columns for PO-Box, street, city, region, postal code, country while 1.x was just a text field with the entire address. This is handled in the toString() method that returns a free-form address from either input type. Unfortunately when using Android 1.x all the individual address getters will return null.
地址类是联系人列表框架中负责所有操作的唯一类。鉴于1.x 和2.0 版本中数据存储不同，Android类必须确认输入的地址是1.x 以上的自由格式还是2.0的格式化数据结构。Android 2.0 有单独的数据列给PO-Box,street,city,region,postal code,country 而1.x整个地址中只是一个文本域，并在toString()方法中处理，该方法返回一个没有格式的地址或者输入类型。不幸的是使用Android1.x 所有的单独地址获取都将返回null 。
package
com.test;
public
class
Address {
private
String poBox;
private
String street;
private
String city;
private
String state;
private
String postalCode;
private
String country;
private
String type;
private
String asString
=
""
;
public
String getType() {
return
type;
}
public
void
setType(String type) {
this
.type
=
type;
}
public
String getPoBox() {
return
poBox;
}
public
void
setPoBox(String poBox) {
this
.poBox
=
poBox;
}
public
String getStreet() {
return
street;
}
public
void
setStreet(String street) {
this
.street
=
street;
}
public
String getCity() {
return
city;
}
public
void
setCity(String city) {
this
.city
=
city;
}
public
String getState() {
return
state;
}
public
void
setState(String state) {
this
.state
=
state;
}
public
String getPostalCode() {
return
postalCode;
}
public
void
setPostalCode(String postalCode) {
this
.postalCode
=
postalCode;
}
public
String getCountry() {
return
country;
}
public
void
setCountry(String country) {
this
.country
=
country;
}
public
String toString() {
if
(
this
.asString.length()
>
0
) {
return
(
this
.asString);
}
else
{
String addr
=
""
;
if
(
this
.getPoBox()
!=
null
) {
addr
=
addr
+
this
.getPoBox()
+
"
n
"
;
}
if
(
this
.getStreet()
!=
null
) {
addr
=
addr
+
this
.getStreet()
+
"
n
"
;
}
if
(
this
.getCity()
!=
null
) {
addr
=
addr
+
this
.getCity()
+
"
,
"
;
}
if
(
this
.getState()
!=
null
) {
addr
=
addr
+
this
.getState()
+
"
"
;
}
if
(
this
.getPostalCode()
!=
null
) {
addr
=
addr
+
this
.getPostalCode()
+
"
"
;
}
if
(
this
.getCountry()
!=
null
) {
addr
=
addr
+
this
.getCountry();
}
return
(addr);
}
}
public
Address(String asString, String type) {
this
.asString
=
asString;
this
.type
=
type;
}
public
Address(String poBox, String street, String city, String state,
String postal, String country, String type) {
this
.setPoBox(poBox);
this
.setStreet(street);
this
.setCity(city);
this
.setState(state);
this
.setPostalCode(postal);
this
.setCountry(country);
this
.setType(type);
}
}
Another getter/setter and data storage class. The email class stores the email address and address type (work, home, etc).
另一个生成getter/setter的数据存储类。该类存储的是email的邮件地址和地址类型（工作、家庭等）。
package
com.test;
public
class
Email {
private
String address;
private
String type;
public
String getAddress() {
return
address;
}
public
void
setAddress(String address) {
this
.address
=
address;
}
public
String getType() {
return
type;
}
public
void
setType(String t) {
this
.type
=
t;
}
public
Email(String a, String t) {
this
.address
=
a;
this
.type
=
t;
}
}
Class to hold instant messenger data. 该类用来保存即时消息数据。
package
com.test;
public
class
IM {
private
String name;
private
String type;
public
String getName() {
return
name;
}
public
void
setName(String name) {
this
.name
=
name;
}
public
String getType() {
return
type;
}
public
void
setType(String type) {
this
.type
=
type;
}
public
IM(String name, String type) {
this
.name
=
name;
this
.type
=
type;
}
}
Class to hold the contacts organizational data. 该类用来保存联系人组织数据。
package
com.test;
public
class
Organization {
private
String organization
=
""
;
private
String title
=
""
;
public
String getOrganization() {
return
organization;
}
public
void
setOrganization(String organization) {
this
.organization
=
organization;
}
public
String getTitle() {
return
title;
}
public
void
setTitle(String title) {
this
.title
=
title;
}
public
Organization() {
}
public
Organization(String org, String title) {
this
.organization
=
org;
this
.title
=
title;
}
}
Class to hold the phone records. 该类用来保存电话记录。
package
com.test;
public
class
Phone {
private
String number;
private
String type;
public
String getNumber() {
return
number;
}
public
void
setNumber(String number) {
this
.number
=
number;
}
public
String getType() {
return
type;
}
public
void
setType(String type) {
this
.type
=
type;
}
public
Phone(String n, String t) {
this
.number
=
n;
this
.type
=
t;
}
}
The wrapper class below is what will be invoked by applications. This class will determine the API level running on the device/emulator and load the correct class created on the next pages. To determine the correct Android API running the Build.VERSION.SDK variable is queried. This version code is then compared against the Eclair (2.0) version code stored in Build.VERSION_CODES.ECLAIR. Finally the proper API class is loaded.
下面的这个封装类是由应用程序所调用的。该类确认运行在设备/模拟器上API的版本。要确认正确的运行着的Android API需要访问VERSION.SDK变量。取得版本号然后跟存于Build.VERSION_CODES.ECLAIR的Eclair(2.0)版本号相比较。最好加载相应的API。
package
com.test;
import
android.content.ContentResolver;
import
android.content.Intent;
import
android.database.Cursor;
import
android.os.Build;
public
abstract
class
ContactAPI {
private
static
ContactAPI api;
public
static
ContactAPI getAPI() {
if
(api
==
null
) {
String apiClass;
if
(Integer.parseInt(Build.VERSION.SDK)
>=
Build.VERSION_CODES.ECLAIR) {
apiClass
=
"
com.highercollaboration.android.ContactAPI.ContactAPISdk5
"
;
}
else
{
apiClass
=
"
com.highercollaboration.android.ContactAPI.ContactAPISdk3
"
;
}
try
{
Class
<?
extends
ContactAPI
>
realClass
=
Class.forName(apiClass).
asSubclass(ContactAPI.
class
);
api
=
realClass.newInstance();
}
catch
(Exception e) {
throw
new
IllegalStateException(e);
}
}
return
api;
}
public
abstract
Intent getContactIntent();
public
abstract
ContactList newContactList();
public
abstract
Cursor getCur();
public
abstract
void
setCur(Cursor cur);
public
abstract
ContentResolver getCr();
public
abstract
void
setCr(ContentResolver cr);
}
This class takes what was covered on page 1 of the tutorial about the Android 2.0 Contact API and turns it into a class. This class extends and will be invoked by the wrapper class created previously.
这个类在前面的Android Contacts的使用（一）中介绍了关于Android 2.0 联系人API 的教程并把他封装成一个类。这个类扩展并由先前建立的封装类调用。
package
com.test;
import
java.util.ArrayList;
import
android.content.ContentResolver;
import
android.content.Intent;
import
android.database.Cursor;
import
android.provider.ContactsContract;
public
class
ContactAPISdk5
extends
ContactAPI {
private
Cursor cur;
private
ContentResolver cr;
public
Cursor getCur() {
return
cur;
}
public
void
setCur(Cursor cur) {
this
.cur
=
cur;
}
public
ContentResolver getCr() {
return
cr;
}
public
void
setCr(ContentResolver cr) {
this
.cr
=
cr;
}
public
Intent getContactIntent() {
return
(
new
Intent(Intent.ACTION_PICK, ContactsContract.Contacts.CONTENT_URI));
}
public
ContactList newContactList() {
ContactList contacts
=
new
ContactList();
String id;
this
.cur
=
this
.cr.query(ContactsContract.Contacts.CONTENT_URI,
null
,
null
,
null
,
null
);
if
(
this
.cur.getCount()
>
0
) {
while
(cur.moveToNext()) {
Contact c
=
new
Contact();
id
=
cur.getString(cur.getColumnIndex(ContactsContract.Contacts._ID));
c.setId(id);
c.setDisplayName(cur.getString(cur.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME)));
if
(Integer.parseInt(cur.getString(cur.getColumnIndex(ContactsContract.Contacts.HAS_PHONE_NUMBER)))
>
0
) {
c.setPhone(
this
.getPhoneNumbers(id));
}
c.setEmail(
this
.getEmailAddresses(id));
c.setNotes(
this
.getContactNotes(id));
c.setAddresses(
this
.getContactAddresses(id));
c.setImAddresses(
this
.getIM(id));
c.setOrganization(
this
.getContactOrg(id));
contacts.addContact(c);
}
}
return
(contacts);
}
public
ArrayList
<
Phone
>
getPhoneNumbers(String id) {
ArrayList
<
Phone
>
phones
=
new
ArrayList
<
Phone
>
();
Cursor pCur
=
this
.cr.query(
ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
null
,
ContactsContract.CommonDataKinds.Phone.CONTACT_ID
+
"
= ?
"
,
new
String[]{id},
null
);
while
(pCur.moveToNext()) {
phones.add(
new
Phone(
pCur.getString(pCur.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER))
, pCur.getString(pCur.getColumnIndex(ContactsContract.CommonDataKinds.Phone.TYPE))
));
}
pCur.close();
return
(phones);
}
public
ArrayList
<
Email
>
getEmailAddresses(String id) {
ArrayList
<
Email
>
emails
=
new
ArrayList
<
Email
>
();
Cursor emailCur
=
this
.cr.query(
ContactsContract.CommonDataKinds.Email.CONTENT_URI,
null
,
ContactsContract.CommonDataKinds.Email.CONTACT_ID
+
"
= ?
"
,
new
String[]{id},
null
);
while
(emailCur.moveToNext()) {
//
This would allow you get several email addresses
Email e
=
new
Email(emailCur.getString(emailCur.getColumnIndex(ContactsContract.CommonDataKinds.Email.DATA))
,emailCur.getString(emailCur.getColumnIndex(ContactsContract.CommonDataKinds.Email.TYPE))
);
emails.add(e);
}
emailCur.close();
return
(emails);
}
public
ArrayList
<
String
>
getContactNotes(String id) {
ArrayList
<
String
>
notes
=
new
ArrayList
<
String
>
();
String where
=
ContactsContract.Data.CONTACT_ID
+
"
= ? AND
"
+
ContactsContract.Data.MIMETYPE
+
"
= ?
"
;
String[] whereParameters
=
new
String[]{id,
ContactsContract.CommonDataKinds.Note.CONTENT_ITEM_TYPE};
Cursor noteCur
=
this
.cr.query(ContactsContract.Data.CONTENT_URI,
null
, where, whereParameters,
null
);
if
(noteCur.moveToFirst()) {
String note
=
noteCur.getString(noteCur.getColumnIndex(ContactsContract.CommonDataKinds.Note.NOTE));
if
(note.length()
>
0
) {
notes.add(note);
}
}
noteCur.close();
return
(notes);
}
public
ArrayList
<
Address
>
getContactAddresses(String id) {
ArrayList
<
Address
>
addrList
=
new
ArrayList
<
Address
>
();
String where
=
ContactsContract.Data.CONTACT_ID
+
"
= ? AND
"
+
ContactsContract.Data.MIMETYPE
+
"
= ?
"
;
String[] whereParameters
=
new
String[]{id,
ContactsContract.CommonDataKinds.StructuredPostal.CONTENT_ITEM_TYPE};
Cursor addrCur
=
this
.cr.query(ContactsContract.Data.CONTENT_URI,
null
, where, whereParameters,
null
);
while
(addrCur.moveToNext()) {
String poBox
=
addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.POBOX));
String street
=
addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.STREET));
String city
=
addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.CITY));
String state
=
addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.REGION));
String postalCode
=
addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.POSTCODE));
String country
=
addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.COUNTRY));
String type
=
addrCur.getString(addrCur.getColumnIndex(ContactsContract.CommonDataKinds.StructuredPostal.TYPE));
Address a
=
new
Address(poBox, street, city, state, postalCode, country, type);
addrList.add(a);
}
addrCur.close();
return
(addrList);
}
public
ArrayList
<
IM
>
getIM(String id) {
ArrayList
<
IM
>
imList
=
new
ArrayList
<
IM
>
();
String where
=
ContactsContract.Data.CONTACT_ID
+
"
= ? AND
"
+
ContactsContract.Data.MIMETYPE
+
"
= ?
"
;
String[] whereParameters
=
new
String[]{id,
ContactsContract.CommonDataKinds.Im.CONTENT_ITEM_TYPE};
Cursor imCur
=
this
.cr.query(ContactsContract.Data.CONTENT_URI,
null
, where, whereParameters,
null
);
if
(imCur.moveToFirst()) {
String imName
=
imCur.getString(imCur.getColumnIndex(ContactsContract.CommonDataKinds.Im.DATA));
String imType;
imType
=
imCur.getString(imCur.getColumnIndex(ContactsContract.CommonDataKinds.Im.TYPE));
if
(imName.length()
>
0
) {
IM im
=
new
IM(imName, imType);
imList.add(im);
}
}
imCur.close();
return
(imList);
}
public
Organization getContactOrg(String id) {
Organization org
=
new
Organization();
String where
=
ContactsContract.Data.CONTACT_ID
+
"
= ? AND
"
+
ContactsContract.Data.MIMETYPE
+
"
= ?
"
;
String[] whereParameters
=
new
String[]{id,
ContactsContract.CommonDataKinds.Organization.CONTENT_ITEM_TYPE};
Cursor orgCur
=
this
.cr.query(ContactsContract.Data.CONTENT_URI,
null
, where, whereParameters,
null
);
if
(orgCur.moveToFirst()) {
String orgName
=
orgCur.getString(orgCur.getColumnIndex(ContactsContract.CommonDataKinds.Organization.DATA));
String title
=
orgCur.getString(orgCur.getColumnIndex(ContactsContract.CommonDataKinds.Organization.TITLE));
if
(orgName.length()
>
0
) {
org.setOrganization(orgName);
org.setTitle(title);
}
}
orgCur.close();
return
(org);
}
}
This class is made up of the code explained covering version 1.x of the Android contact API. As with the 2.0 class this class extends the ContactAPI wrapper class and will be invoked by it if the 1.x version of Android is in use.
这个类由Android 1.0 联系人版本介绍的代码组成。正如2.0中，这个类扩展了ContactAPI封装类，并且封装类调用这个类，当然前提是使用1.x 版本。
package
com.test;
import
java.util.ArrayList;
import
android.content.ContentResolver;
import
android.content.Intent;
import
android.database.Cursor;
import
android.provider.Contacts;
import
android.provider.Contacts.People;
public
class
ContactAPISdk3
extends
ContactAPI {
private
Cursor cur;
private
ContentResolver cr;
public
Cursor getCur() {
return
cur;
}
public
void
setCur(Cursor cur) {
this
.cur
=
cur;
}
public
ContentResolver getCr() {
return
cr;
}
public
void
setCr(ContentResolver cr) {
this
.cr
=
cr;
}
public
Intent getContactIntent() {
return
(
new
Intent(Intent.ACTION_PICK, People.CONTENT_URI));
}
public
ContactList newContactList() {
ContactList contacts
=
new
ContactList();
String id
=
""
;
this
.cur
=
this
.cr.query(People.CONTENT_URI,
null
,
null
,
null
,
null
);
if
(
this
.cur.getCount()
>
0
) {
while
(cur.moveToNext()) {
Contact c
=
new
Contact();
id
=
cur.getString(cur.getColumnIndex(People._ID));
c.setId(id);
c.setDisplayName(cur.getString(cur.getColumnIndex(People.DISPLAY_NAME)));
if
(Integer.parseInt(cur.getString(cur.getColumnIndex(People.PRIMARY_PHONE_ID)))
>
0
) {
c.setPhone(
this
.getPhoneNumbers(id));
}
c.setEmail(
this
.getEmailAddresses(id));
ArrayList
<
String
>
notes
=
new
ArrayList
<
String
>
();
notes.add(cur.getString(cur.getColumnIndex(People.NOTES)));
c.setNotes(notes);
c.setAddresses(
this
.getContactAddresses(id));
c.setImAddresses(
this
.getIM(id));
c.setOrganization(
this
.getContactOrg(id));
contacts.addContact(c);
}
}
return
(contacts);
}
public
ArrayList
<
Phone
>
getPhoneNumbers(String id) {
ArrayList
<
Phone
>
phones
=
new
ArrayList
<
Phone
>
();
Cursor pCur
=
this
.cr.query(
Contacts.Phones.CONTENT_URI,
null
,
Contacts.Phones.PERSON_ID
+
"
= ?
"
,
new
String[]{id},
null
);
while
(pCur.moveToNext()) {
phones.add(
new
Phone(
pCur.getString(pCur.getColumnIndex(Contacts.Phones.NUMBER))
, pCur.getString(pCur.getColumnIndex(Contacts.Phones.TYPE))
));
}
pCur.close();
return
(phones);
}
public
ArrayList
<
Email
>
getEmailAddresses(String id) {
ArrayList
<
Email
>
emails
=
new
ArrayList
<
Email
>
();
Cursor emailCur
=
this
.cr.query(
Contacts.ContactMethods.CONTENT_EMAIL_URI,
null
,
Contacts.ContactMethods.PERSON_ID
+
"
= ?
"
,
new
String[]{id},
null
);
while
(emailCur.moveToNext()) {
//
This would allow you get several email addresses
Email e
=
new
Email(emailCur.getString(emailCur.getColumnIndex(Contacts.ContactMethods.DATA))
,emailCur.getString(emailCur.getColumnIndex(Contacts.ContactMethods.CONTENT_EMAIL_TYPE))
);
emails.add(e);
}
emailCur.close();
return
(emails);
}
public
ArrayList
<
Address
>
getContactAddresses(String id) {
ArrayList
<
Address
>
addrList
=
new
ArrayList
<
Address
>
();
String where
=
Contacts.ContactMethods.PERSON_ID
+
"
= ? AND
"
+
Contacts.ContactMethods.KIND
+
"
= ?
"
;
String[] whereParameters
=
new
String[]{id,
Contacts.ContactMethods.CONTENT_POSTAL_ITEM_TYPE};
Cursor addrCur
=
this
.cr.query(Contacts.ContactMethods.CONTENT_URI,
null
, where, whereParameters,
null
);
while
(addrCur.moveToNext()) {
String addr
=
addrCur.getString(addrCur.getColumnIndex(Contacts.ContactMethodsColumns.DATA));
String type
=
addrCur.getString(addrCur.getColumnIndex(Contacts.ContactMethodsColumns.TYPE));
Address a
=
new
Address(addr, type);
addrList.add(a);
}
addrCur.close();
return
(addrList);
}
public
ArrayList
<
IM
>
getIM(String id) {
ArrayList
<
IM
>
imList
=
new
ArrayList
<
IM
>
();
String where
=
Contacts.ContactMethods.PERSON_ID
+
"
= ? AND
"
+
Contacts.ContactMethods.KIND
+
"
= ?
"
;
String[] whereParameters
=
new
String[]{id,
Contacts.ContactMethods.CONTENT_IM_ITEM_TYPE};
Cursor imCur
=
this
.cr.query(Contacts.ContactMethods.CONTENT_URI,
null
, where, whereParameters,
null
);
if
(imCur.moveToFirst()) {
String imName
=
imCur.getString(imCur.getColumnIndex(Contacts.ContactMethodsColumns.DATA));
String imType
=
imCur.getString(imCur.getColumnIndex(Contacts.ContactMethodsColumns.TYPE));
if
(imName.length()
>
0
) {
IM im
=
new
IM(imName, imType);
imList.add(im);
}
}
imCur.close();
return
(imList);
}
public
Organization getContactOrg(String id) {
Organization org
=
new
Organization();
String where
=
Contacts.ContactMethods.PERSON_ID
+
"
= ?
"
;
String[] whereParameters
=
new
String[]{id};
Cursor orgCur
=
this
.cr.query(Contacts.Organizations.CONTENT_URI,
null
, where, whereParameters,
null
);
if
(orgCur.moveToFirst()) {
String orgName
=
orgCur.getString(orgCur.getColumnIndex(Contacts.Organizations.COMPANY));
String title
=
orgCur.getString(orgCur.getColumnIndex(Contacts.Organizations.TITLE));
if
(orgName.length()
>
0
) {
org.setOrganization(orgName);
org.setTitle(title);
}
}
orgCur.close();
return
(org);
}
}
至此，Android Contacts的使用三大部分已经介绍完成，不得不承认的是有很多地方翻译的很烂很勉强，自己看着都有点头晕。嘿嘿，建议大家多看代码。
作者博客：http://www.cnblogs.com/lycoris/archive/2011/05/13/2037716.html
英文原文地址：http://www.higherpass.com/Android/Tutorials/Working-With-Android-Contacts/
6012
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
