狂刷Android范例之5：读取手机通讯录说明
狂刷Android范例系列文章开张了。每篇学习一个Android范例，将一个范例单独生成一个可运行的app，并对重点源代码进行简要分析。然后提供打包好的源代码下载。
功能
提供完整代码，通过ContenResolver，读取手机通讯录的内容。 代码包在此，无需下载分：
来源
例子来自于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 * * * * 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;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. */{Toast mToast;ResultDisplayer mPendingResult;class ResultDisplayer implements OnClickListener {String mMsg;String mMimeType;ResultDisplayer(String msg, String mimeType) {mMsg = msg;mMimeType = mimeType;}(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);}}(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));}(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();}}}}}}
当我要取的时候，你淘气的躲开了，
