狂刷Android范例之5：读取手机通讯录

说明

狂刷Android范例系列文章开张了。每篇学习一个Android范例，将一个范例单独生成一个可运行的app，并对重点源代码进行简要分析。然后提供打包好的源代码下载。

功能

提供完整代码，通过ContenResolver，读取手机通讯录的内容。

代码包在此，无需下载分：

http://download.csdn.net/detail/logicteamleader/8806135

来源

例子来自于Android-20的com.example.android.apis.content.PickContact。

环境

代码运行环境：

1.ADT2014版本；

2.android:minSdkVersion=”8”；android:targetSdkVersion=”20”

3.workspace中已经生成了appcompatv7，它的版本是android-22；

代码

本范例有两个重要的技术点：

第一个知识点，通过设置Intent的Action和Type，使用隐式方式启动相关的app，来读取手机上的内容。这里使用的Action是Intent.ACTION_GET_CONTENT，意思就是要读取手机上的各种内容。这里的Type有四个，分别是：

1. ContactsContract.Contacts.CONTENT_ITEM_TYPE

2. “vnd.android.cursor.item/person”

3. ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE

4. ContactsContract.CommonDataKinds.StructuredPostal.CONTENT_ITEM_TYPE

其真实值分别是：

1. “vnd.android.cursor.item/contact”

2. “vnd.android.cursor.item/person”

3. “vnd.android.cursor.item/phone_v2”

4. “vnd.android.cursor.item/postal-address_v2”

代表了通讯录、人、手机、地址四种内容的Type。

根据Intent.ACTION_GET_CONTENT和这四种Type的组合，启动Intent就可获取这四种内容，并在void onActivityResult(int requestCode, int resultCode, Intent data)函数中通过data变量返回。

第二个知识点，通过ContentResolver从返回的Intent中查询所需的内容。使用的方法是Cursor android.content.ContentResolver.query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)，其参数含义如下：

1. uri是指查询所需的uri，其schema必须是content://；

2. projection是查询结果项的数组，如果输入null则返回所有的项；

3. selection是条件语句，如同sql语言中的where子句；

4. selectionArgs，是条件语句的真实值数组；

5. sortOrder是排序参数，如同SQL语言中的order by子句。

查询返回结果是一个Cursor，然后通过getInt或者getString等方法从Cursor中取出所需的值。

本例子中仅取出了ID和Name两个值，要获取其他值，请设置projection参数，并从Cursor中读出。

/*
 * Copyright (C) 2010 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.example.pickcontact;

// Need the following import to get access to the app resources, since this
// class is in a sub-package.
import android.app.Activity;
import android.content.Intent;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.provider.BaseColumns;
import android.provider.ContactsContract;
import android.provider.ContactsContract.CommonDataKinds.Phone;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.Toast;

/**
 * Demonstrates launching the contacts app to pick a contact. Does not require
 * permission to read contacts, as that permission will be granted when the
 * selected contact is returned.
 */
public class PickContact extends Activity {
    Toast mToast;
    ResultDisplayer mPendingResult;

    class ResultDisplayer implements OnClickListener {
        String mMsg;
        String mMimeType;

        ResultDisplayer(String msg, String mimeType) {
            mMsg = msg;
            mMimeType = mimeType;
        }

        public void onClick(View v) {
            // 通过设置Intent的action为ACTION_GET_CONTENT，同时设置Type为mMimeType
            // 启动手机上可读取通讯录的app，读取通讯录内容
            Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
            intent.setType(mMimeType);
            mPendingResult = this;
            startActivityForResult(intent, 1);
        }
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        setContentView(R.layout.pick_contact);

        // Watch for button clicks.
        ((Button) findViewById(R.id.pick_contact))
                .setOnClickListener(new ResultDisplayer("Selected contact",
                        ContactsContract.Contacts.CONTENT_ITEM_TYPE));

        ((Button) findViewById(R.id.pick_person))
                .setOnClickListener(new ResultDisplayer("Selected person",
                        "vnd.android.cursor.item/person"));

        ((Button) findViewById(R.id.pick_phone))
                .setOnClickListener(new ResultDisplayer(
                        "Selected phone",
                        ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE));

        ((Button) findViewById(R.id.pick_address))
                .setOnClickListener(new ResultDisplayer(
                        "Selected address",
                        ContactsContract.CommonDataKinds.StructuredPostal.CONTENT_ITEM_TYPE));
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        if (data != null) {
            Uri uri = data.getData();
            if (uri != null) {
                Cursor c = null;
                try {
                    //若要获取更多信息，请查询并设置projection参数
                    String[] projection = new String[] { BaseColumns._ID, Phone.DISPLAY_NAME};

                    c = getContentResolver().query(uri, projection, null, null,
                            null);
                    if (c != null && c.moveToFirst()) {
                        int id = c.getInt(0);
                        String name = c.getString(1);
                        if (mToast != null) {
                            mToast.cancel();
                        }
                        String txt = mPendingResult.mMsg + ":\n" + uri
                                + "\nid: " + id+"\nname:"+name;
                        mToast = Toast.makeText(this, txt, Toast.LENGTH_LONG);
                        mToast.show();
                    }
                } finally {
                    if (c != null) {
                        c.close();
                    }
                }
            }
        }
    }
}