转自:http://blog.csdn.net/yuzhu2008/article/details/6227246
Android 1.6以及以前的版本API
本节的开头跟上一节的开头很相似。本节所要介绍的内容将是独立的介绍1.6以及以前版本的API
权限的授予
在操作联系人记录之前,你必须在AndroidManifest.xml中声明权限。这样你才能被授权查看联系人。增加下述权限:
<uses-permission android:name="android.permission.READ_CONTACTS" />
查询联系人数据库
查询联系人详细信息
为了规范信息,基本的联系人信息放在联系人表里,而其他的详细信息则被储存在独立的数据表中。在Android1.x中,要查询基本的联系人记录,URI被指定在People.CONTENT_URI变量中。
- package higherpass.TestContacts;
- import android.app.Activity;
- import android.content.ContentResolver;
- import android.database.Cursor;
- import android.os.Bundle;
- import android.provider.Contacts;
- import android.provider.Contacts.People;
- public class TestContacts extends Activity {
- /** Called when the activity is first created. */
- @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));
- }
- }
- }
- }
这段代码从试图加载中启动后,我们建立了一个ContentResolver实例来查询储存了联系人的SQLite数据库。这个 ContentResolver查询返回了一个包含了联系人记录的Cursor实例。分别把ID和DISPLAY_NAME存入字符串 id与name中。更多信息,请参照android cursor指导
手机号码
手机号码保存在它们自己的表里并且需要进行独立的查询。想要查询手机号码,要用到SDK变量Contacts.Phones.CONTENT_URI。用一个WHERE条件去获得指定联系人的号码
- if (Integer.parseInt(cur.getString(
- 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++;
- }
- }
查询手机表并得到存储与pCur中的Cursor。因为联系人数据库每个联系人可以有多个号码,所以我们要循环遍历结果。除了手机好码之外,我们还会得到手机号码的类型(家庭,工作,移动手机,等等)。
邮件地址
查询邮件地址跟查询手机号码是类似的。要建立一个额外的查询从数据库获取邮件地址。查询邮件地址要用到这个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();
简单查询Contacts.ContactMethods.CONTENT_EMAIL_URI用一个条件限制,即联系人记录的ID要在 Contacts.ContactMethods.PERSON_ID中。就像手机号码一样,联系人也可以包含多个邮件地址。所以我们仍然要循环遍历数据 记录。
备注
自定义的备注被附加在每个联系人的记录中。备注既包含在主联系人记录中也可以简单的从People.NOTES的数据中读出。
- cur.getString(cur.getColumnIndex(People.NOTES));
邮政地址
Android允许给联系人存储多个邮政地址。地址存储在联系人方法表中,我们需要加上附加的条件来查询数据。增加一个 Contacts.ContactMethods.KIND为 Contacts.ContactMethods.CONTENT_POSTAL_ITEM_TYPE的条件可以仅仅从 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();
查询联系人方法表,外加两个条件从句,一个限制联系人ID,一个指定Contacts.ContactMethods.KIND与 Contacts.ContactMethods.CONTENT_POSTAL_ITEM_TYPE对应以确保查询的为邮件地址。Andoird可以给 联系人存储多个邮件地址。所以要循环遍历返回的结果。Android还存储地址的类型。在1.6以及以前的版本,地址被存储为包含信息的随意的字符串。在 2.0以后,地址被分割为地址的各个部分。
即时消息(IM)
即时消息查询查询工作跟之前的两个差不多。数据从Contacts.ContactMethods.CONTENT_URI中查出并附加ID和 Contacts.ContactMethods.KIND 为Contacts.ContactMethods.CONTENT_IM_ITEM_TYPE的条件从句。
- 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();
组织机构
联系人的最后一个要讲述的部分是组织数据。Android联系人包含了职务,专业,社会关系和角色以及标题。这些记录可以通过URI:Contacts.Organizations.CONTENT_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();