Android联系人数据库全解析（2）

Android联系人数据库全解析（2）

Android 1.6以及以前的版本API

本节的开头跟上一节的开头很相似。本节所要介绍的内容将是独立的介绍1.6以及以前版本的API

权限的授予

在操作联系人记录之前，你必须在AndroidManifest.xml中声明权限。这样你才能被授权查看联系人。增加下述权限：



查询联系人数据库

查询联系人详细信息

为了规范信息，基本的联系人信息放在联系人表里，而其他的详细信息则被储存在独立的数据表中。在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();