android: 通过内容提供器读取系统联系人

读取系统联系人

 由于我们之前一直使用的都是模拟器，电话簿里面并没有联系人存在，所以现在需要自 己手动添加几个，以便稍后进行读取。打开电话簿程序，界面如图 7.1 所示。

图   7.1

可以看到，目前电话簿里是没有任何联系人的，我们可以通过点击 Create a new contact按钮来对联系人进行创建。这里就先创建两个联系人吧，分别填入他们的姓名和手机号，如 图 7.2 所示。

图   7.2

这样准备工作就做好了，现在新建一个 ContactsTest 项目，让我们开始动手吧。 首先还是来编写一下布局文件，这里我们希望读取出来的联系人信息能够在 ListView 中

显示，因此，修改 activity_main.xml 中的代码，如下所示：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent" >

<ListView android:id="@+id/contacts_view" android:layout_width="match_parent" android:layout_height="match_parent" >

</ListView>

</LinearLayout>

如下所示：

public class MainActivity extends Activity { ListView contactsView; ArrayAdapter<String> adapter;

List<String> contactsList = new ArrayList<String>();

@Override

protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main);

contactsView = (ListView) findViewById(R.id.contacts_view);

adapter = new ArrayAdapter<String>(this, android.R.layout. simple_list_item_1, contactsList);

contactsView.setAdapter(adapter);

readContacts();

}

private void readContacts() { Cursor cursor = null;

try {

// 查询联系人数据

cursor = getContentResolver().query( ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null, null, null, null);

while (cursor.moveToNext()) {

// 获取联系人姓名

String displayName = cursor.getString(cursor.getColumnIndex( ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));

// 获取联系人手机号

String number = cursor.getString(cursor.getColumnIndex( ContactsContract.CommonDataKinds.Phone.NUMBER));

contactsList.add(displayName + "\n" + number);

}

} catch (Exception e) {

e.printStackTrace();

} finally {

if (cursor != null) {

cursor.close();

}

}

}

}

在 onCreate()方法中，我们首先获取了 ListView 控件的实例，并给它设置好了适配器， 然后就去调用 readContacts()方法。下面重点看下 readContacts()方法，可以看到，这里使用 了 ContentResolver 的 query()方法来查询系统的联系人数据。不过传入的 Uri 参数怎么有些奇 怪 啊 ， 为 什 么 没 有 调 用 Uri.parse() 方 法 去 解 析 一 个 内 容 URI 字 符 串 呢 ？ 这 是 因 为 ContactsContract.CommonDataKinds.Phone 类已经帮我们做好了封装，提供了一个CONTENT_URI 常量，而这个常量就是使用 Uri.parse()方法解析出来的结果。接着我们对 Cursor 对象进行遍 历 ， 将 联 系 人 姓 名 和 手 机 号 这 些 数 据 逐 个 取 出 ， 联 系 人 姓 名 这 一 列 对 应 的 常 量 ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME，联系人手机号这一列对应的常 量是 ContactsContract.CommonDataKinds.Phone.NUMBER。两个数据都取出之后，将它们进 行拼接，并且中间加上换行符，然后将拼接后的数据添加到 ListView 里。最后千万不要忘记 将 Cursor 对象关闭掉。

这样就结束了吗？还差一点点，读取系统联系人也是需要声明权限的，因此修改AndroidManifest.xml 中的代码，如下所示：

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.contactstest"

android:versionCode="1"

android:versionName="1.0" >

……

<uses-permission android:name="android.permission.READ_CONTACTS" />

……

</manifest>

加入了 android.permission.READ_CONTACTS 权限，这样我们的程序就可以访问到系统 的联系人数据了。现在才算是大功告成，让我们来运行一下程序吧，效果如图 7.3 所示。