从Intent.ACTION_PICK返回的URI中获取特定的联系信息

Question

我正在编写一个Android应用程序,其数据类型代表一个人(特别是孩子的父母或监护人).我希望能够从Android设备的"联系人"数据库​​中"导入"相关数据字段.(这应该是可选的;也就是说,不要求父/监护人已经在联系人数据库中,如果他们添加新的父母/监护人,也不会更新联系人数据库.)

到目前为止,我已经编写了代码来启动一个新的Intent来选择特定的Contact(使用Intent.ACTION_PICK).然后,我获得一个表示数据库中特定联系人的URI.

不幸的是,我不知道下一步是什么.看起来这应该是世界上最简单的事情,但显然不是.我已经阅读了Android开发者网站上的文档,并查看了多本Android手册.没有快乐.

我想得到的具体信息是:

1. 联系人的姓名(如果可能的话,首先和最后一个)

2. 联系人(主要)电子邮件地址

3. 联系人的手机号码

我想通过查询使用ContentResolver可以实现这一点,但我不知道如何使用Intent返回的URI来做到这一点.大多数文档假定您具有联系人ID,而不是联系人的URI.此外,我不知道我可以在查询的投影中添加哪种字段,假设这甚至是我想要的正确方法.

这是我的起始代码:

// In a button's onClick event handler:
Intent intent = new Intent(Intent.ACTION_PICK, ContactsContract.Contacts.CONTENT_URI);
startActivityForResult(intent, PICK_CONTACT);

// In onActivityResult:
if (resultCode == RESULT_OK) {
    if (requestCode == PICK_CONTACT) {
        contactURI = data.getData();
        // NOW WHAT?
    }
}

Answer 1

好吧,经过大量的挖掘,我发现了我认为的答案.我发现的解决方案根据您使用的Android API级别而有所不同.然而,它们根本不是很漂亮,所以如果有更好的解决方案,我很想知道.

在任何情况下,第一步是通过对从Intent.ACTION_PICK返回的URI进行查询来获取联系人的ID.当我们在这里时,我们还应该获取显示名称,以及表示联系人是否有电话号码的字符串.(我们不需要它们用于现代解决方案,但我们将需要它们用于传统解决方案.)

String id, name, phone, hasPhone;
int idx;
Cursor cursor = getContentResolver().query(contactUri, null, null, null, null);
if (cursor.moveToFirst()) {
    idx = cursor.getColumnIndex(ContactsContract.Contacts._ID);
    id = cursor.getString(idx);

    idx = cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME);
    name = cursor.getString(idx);

    idx = cursor.getColumnIndex(ContactsContract.Contacts.HAS_PHONE_NUMBER);
    hasPhone = cursor.getString(idx);
}

对于记录,从此URI返回的列是ContactsContract.Profile类中常量表示的大多数字段(包括从其他接口继承的常量).不包括的是PHOTO_FILE_ID,PHOTO_THUMBNAIL_URI,或PHOTO_URI(但PHOTO_ID 被包括在内).

现在我们有了ID,我们需要获取相关数据.第一个(也是最简单的)解决方案是查询实体.实体查询一次检索联系人或原始联系人的所有联系人数据.每行代表一个Raw Contact,使用ContactsContract.Contacts.Entity中的常量访问.通常,您只关心RAW_CONTACT_ID,DATA1和MIMETYPE.但是,如果您希望单独使用名字和姓氏,则名称MIME类型将保留DATA2中的第一个名称和DATA3中的姓氏.

通过将MIMETYPE列与ContactsContract.CommonDataKinds常量匹配来加载变量; 例如,电子邮件MIME类型位于ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE中.

// Build the Entity URI.
Uri.Builder b = Uri.withAppendedPath(ContactsContract.Contacts.CONTENT_URI, id).buildUpon();
b.appendPath(ContactsContract.Contacts.Entity.CONTENT_DIRECTORY);
URI contactUri = b.build();

// Create the projection (SQL fields) and sort order.
String[] projection = {
        ContactsContract.Contacts.Entity.RAW_CONTACT_ID,
        ContactsContract.Contacts.Entity.DATA1,
        ContactsContract.Contacts.Entity.MIMETYPE };
String sortOrder = ContactsContract.Contacts.Entity.RAW_CONTACT_ID + " ASC";
cursor = getContentResolver().query(contactUri, projection, null, null, sortOrder);

String mime;
int mimeIdx = cursor.getColumnIndex(ContactsContract.Contacts.Entity.MIMETYPE);
int dataIdx = cursor.getColumnIndex(ContactsContract.Contacts.Entity.DATA1);
if (cursor.moveToFirst()) {
    do {
        mime = cursor.getString(mimeIdx);
        if (mime.equalsIgnoreCase(ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE)) {
            email = cursor.getString(dataIdx);
        }
        if (mime.equalsIgnoreCase(ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE)) {
            phone = cursor.getString(dataIdx);
        }
        // ...etc.
    } while (cursor.moveToNext());
}

遗憾的是,实体并未引入unti API 11(Android 3.0,Honeycomb),这意味着此代码与市场上大约65%的Android设备不兼容(截至撰写本文时).如果您尝试它,您将从URI 获得IllegalArgumentException.

第二种解决方案是构建查询字符串,并为要使用的每种数据类型进行一次查询:

// Get phone number - if they have one
if ("1".equalsIgnoreCase(hasPhone)) {
    cursor = getContentResolver().query(
            ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
            null,
            ContactsContract.CommonDataKinds.Phone.CONTACT_ID + " = "+ id, 
            null, null);
    if (cursor.moveToFirst()) {
        colIdx = cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER);
        phone = cursor.getString(colIdx);
    }
    cursor.close();
}

// Get email address
cursor = getContentResolver().query(
        ContactsContract.CommonDataKinds.Email.CONTENT_URI,
        null,
        ContactsContract.CommonDataKinds.Email.CONTACT_ID + " = " + id,
        null, null);
if (cursor.moveToFirst()) {
    colIdx = cursor.getColumnIndex(ContactsContract.CommonDataKinds.Email.ADDRESS);
    email = cursor.getString(colIdx);
}
cursor.close();

// ...etc.

显然,这种方式会导致大量单独的数据库查询,因此不建议出于效率原因.

我提出的解决方案是尝试使用实体查询的版本,捕获IllegalArgumentException,并将遗留代码放在catch块中:

try {
    // Build the Entity URI.
    Uri.Builder b = Uri.withAppendedPath(ContactsContract.Contacts.CONTENT_URI, id).buildUpon();
    b.appendPath(ContactsContract.Contacts.Entity.CONTENT_DIRECTORY);
        // ...etc...
} catch (IllegalArgumentException e) {
    // Get phone number - if they have one
    if ("1".equalsIgnoreCase(hasPhone)) {   
        // ...etc...
} finally {
    // If you want to display the info in GUI objects, put the code here
}

我希望这可以帮助别人.而且,如果有更好的方法可以做到这一点,我全都听见了.

Answer 2

事实证明,有是一个更好的方式来做到这一点.

正如我所提到的,ContactsContract.Contacts.Entity类在API 11之前不可用.但是,ContactsContract.Data类在API 5中可用,并且您可以使用该类与使用Entity类的方式大致相同.

我已经更新了我的代码.它与Entity类的代码非常相似,并且工作方式基本相同.但是,我用我的手机运行Gingerbread测试了它,它运行得很好.

一个变化我不得不做出的是:似乎没有成为一个办法让ContactsContract.Data.RAW_CONTACT_ID从最初的查询,该ID是不一样的,你从如获得ID ContactsContract.Contacts._ID.相反,我查询了ContactsContract.Contacts.DISPLAY_NAME常量,这在几乎每个ContactsContract类中都是一致的.

这是工作代码:

        Cursor cursor;  // Cursor object
        String mime;    // MIME type
        int dataIdx;    // Index of DATA1 column
        int mimeIdx;    // Index of MIMETYPE column
        int nameIdx;    // Index of DISPLAY_NAME column

        // Get the name
        cursor = getContentResolver().query(params[0],
                new String[] { ContactsContract.Contacts.DISPLAY_NAME },
                null, null, null);
        if (cursor.moveToFirst()) {
            nameIdx = cursor.getColumnIndex(
                    ContactsContract.Contacts.DISPLAY_NAME);
            name = cursor.getString(nameIdx);

            // Set up the projection
            String[] projection = {
                    ContactsContract.Data.DISPLAY_NAME,
                    ContactsContract.Contacts.Data.DATA1,
                    ContactsContract.Contacts.Data.MIMETYPE };

            // Query ContactsContract.Data
            cursor = getContentResolver().query(
                    ContactsContract.Data.CONTENT_URI, projection,
                    ContactsContract.Data.DISPLAY_NAME + " = ?",
                    new String[] { name },
                    null);

            if (cursor.moveToFirst()) {
                // Get the indexes of the MIME type and data
                mimeIdx = cursor.getColumnIndex(
                        ContactsContract.Contacts.Data.MIMETYPE);
                dataIdx = cursor.getColumnIndex(
                        ContactsContract.Contacts.Data.DATA1);

                // Match the data to the MIME type, store in variables
                do {
                    mime = cursor.getString(mimeIdx);
                    if (ContactsContract.CommonDataKinds.Email
                            .CONTENT_ITEM_TYPE.equalsIgnoreCase(mime)) {
                        email = cursor.getString(dataIdx);
                    }
                    if (ContactsContract.CommonDataKinds.Phone
                            .CONTENT_ITEM_TYPE.equalsIgnoreCase(mime)) {
                        phone = cursor.getString(dataIdx);
                        phone = PhoneNumberUtils.formatNumber(phone);
                    }
                } while (cursor.moveToNext());
            }
        }