引言

上篇我们介绍了Intents和Intent Filters的理论部分，主要是介绍了：activities、services、broadcast receivers三种组件的Intent机制两种Intent（显式和隐式）及它们如何去匹配目的组件、Intent对象包含哪些信息、Intent Filters的action & category & data。

Intent的重要性，我不再着重介绍了，但我还是要说：Intent能够使应用程序突破沙盒与外界交流，者这使得Android的世界变得丰富多彩！本篇将用实例来介绍，如何应用Intent，而且继续用SMS方面的例子来阐述。本文的主要内容如下：

1. 例子（需求）描述
2. STEP1、添加用于显示通讯录的布局文件
3. STEP2、添加Button的点击事件
4. STEP3、添加通讯录活动
5. STEP4、解析通讯录返回的数据
6. STEP5、在清单文件AndroidManifest.xml中注册通讯录活动和读取Contact数据库的权限
7. 总结

例子（需求）描述

用手机发过SMS的人都知道：

1. 用户可以先编辑短信，然后再去通讯录中选择相应的人并发生给他。
2. 用户可以在短信内容中插入通讯录中联系人的号码。

我们的这个例子就是要说明如何实现这个功能。要实现这个功能，即是创建一个新的Activity选择（ACTION_PICK）通讯录中的数据，它会显示通讯录中的所有联系人并让用户选择，然后关闭并返回一个联系人的URI给短信程序。下面介绍如何一步一步实现类似的功能，而且是在之前Android 开发之旅：短信的收发及在android模拟器之间实践（一）中发送SMS的例子（TextMessage）基础上加上从通讯录中选择联系人的功能。

STEP1、添加用于显示通讯录的布局文件

我们用一个ListView来显示整个通讯录，其中用TextView显示每一记录。它们的xml文件分别为contact.xml、listitemlayout，如下所示：

1. ====================================contact.xml   
2.  
3. <?xml version="1.0" encoding="utf-8"?>   
4.  
5. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"   
6.  
7. android:orientation="vertical"   
8.  
9. android:layout_width="fill_parent"   
10.  
11. android:layout_height="fill_parent"   
12.  
13. >   
14.  
15. <ListView android:id="@+id/contactListView"   
16.  
17.     android:layout_width="fill_parent"   
18.  
19.     android:layout_height="wrap_content"   
20.  
21.     />   
22.  
23. </LinearLayout>   
24.  
25. =================================== listitemlayout   
26.  
27. <?xml version="1.0" encoding="utf-8"?>   
28.  
29. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"   
30.  
31.     android:orientation="vertical" android:layout_width="fill_parent"   
32.  
33.     android:layout_height="fill_parent">   
34.  
35.     <TextView android:id="@+id/itemTextView" android:layout_width="wrap_content"   
36.  
37.     android:layout_height="wrap_content" android:padding="10px"   
38.  
39.     android:textSize="16px" android:textColor="#FFF" />   
40.  
41. </LinearLayout>  

为了能够打开通讯录，我们还需要在TextMessage程序中加入一个Button btnContact，通过点击btnContact激活显示通讯录的活动。这只需在main.xml文件中加入如下代码：

1. <Button android:layout_width="wrap_content"   
2.  
3.         android:layout_height="wrap_content" android:text="@string/btnContact"   
4.  
5.    
6.  
7.         android:id="@+id/btnContact"                            /> 

记得还有在values/strings.xml中相应的加入<string name="btnContact">contact</string>。

STEP2、添加Button的点击事件

在上面准备工作做完之后，我们需要监听btnContact的点击事件，当用户点击btnContact时，跳转显示通讯录界面，当用户选择一个联系人之后，返回SMS程序的主界面。这里就要用到了伟大的Intent啦！

1. btnContact = (Button) findViewById(R.id.btnContact);   
2.  
3. btnContact.setOnClickListener(new View.OnClickListener() {   
4.  
5.     @Override   
6.  
7.     public void onClick(View v) {   
8.  
9.         // TODO Auto-generated method stub   
10.  
11.         Intent intent = new Intent(Intent.ACTION_PICK,   
12.  
13.                 ContactsContract.Contacts.CONTENT_URI);   
14.  
15.         startActivityForResult(intent, PICK_CONTACT);   
16.  
17.     }   
18.  
19.    
20.  
21. });  

STEP3、添加通讯录活动

添加一个类文件，类名为ContactPick（表示通讯录活动名）继承Activity。它的主要功能就是获取从SMS主程序传递来的Intent并提取数据；然后去查询通讯录数据库，取出数据并填充到STEP1中定义的ListView；最后，还需要添加当用户选择一个联系人的事件onItemClick，将结果返回给SMS主程序，这里也用到了我们伟大的Intent啦！代码如下：

1. package skynet.com.cnblogs.www;   
2.  
3.    
4.  
5. import android.app.Activity;   
6.  
7. import android.content.Intent;   
8.  
9. import android.database.Cursor;   
10.  
11. import android.net.Uri;   
12.  
13. import android.os.Bundle;   
14.  
15. import android.provider.ContactsContract;   
16.  
17. import android.view.View;   
18.  
19. import android.widget.AdapterView;   
20.  
21. import android.widget.ListView;   
22.  
23. import android.widget.SimpleCursorAdapter;   
24.  
25. import android.widget.AdapterView.OnItemClickListener;   
26.  
27.    
28.  
29. public class ContactPick extends Activity {   
30.  
31.     /** Called when the activity is first created. */   
32.  
33.     @Override   
34.  
35.     public void onCreate(Bundle savedInstanceState) {   
36.  
37.         super.onCreate(savedInstanceState);   
38.  
39.         setContentView(R.layout.main);   
40.  
41.    
42.  
43.         Intent orgIntent=getIntent();   
44.  
45.         Uri queryUri=orgIntent.getData();           
46.  
47.         final Cursor c = managedQuery(queryUri,   
48.  
49.                 null,   
50.  
51.                 null,   
52.  
53.                 null,   
54.  
55.                 null);   
56.  
57.            
58.  
59.         String[] fromColumns=new String[]{ContactsContract.Contacts.DISPLAY_NAME};   
60.  
61.         int[] toLayoutIDs = new int[] { R.id.itemTextView };   
62.  
63.         SimpleCursorAdapter adapter = new SimpleCursorAdapter(this,   
64.  
65.                 R.layout.listitemlayout, c, fromColumns, toLayoutIDs);   
66.  
67.         ListView lv = (ListView) findViewById(R.id.contactListView);   
68.  
69.         lv.setAdapter(adapter);   
70.  
71.         lv.setOnItemClickListener(new OnItemClickListener() {   
72.  
73.             @Override   
74.  
75.             public void onItemClick(AdapterView<?> parent, View view, int pos,   
76.  
77.                     long id) {   
78.  
79.                 c.moveToPosition(pos);       
80.  
81.                 int rowId = c.getInt(c.getColumnIndexOrThrow(ContactsContract.Contacts._ID));   
82.  
83.                 Uri outURI = Uri.parse(ContactsContract.Contacts.CONTENT_URI.toString() + rowId);   
84.  
85.                 Intent outData = new Intent();   
86.  
87.                 outData.setData(outURI);   
88.  
89.                 setResult(Activity.RESULT_OK,outData);   
90.  
91.                 finish();   
92.  
93.             }   
94.  
95.         });   
96.  
97.     }   
98.  
99. }  

STEP4、解析通讯录返回的数据

从通讯录活动返回之后，我们从返回的Intent中提取数据并填充到填写电话号码的EditView中。代码主要如下：

1. @Override   
2.  
3. public void onActivityResult(int reqCode, int resCode, Intent data) {   
4.  
5.     super.onActivityResult(reqCode, resCode, data);   
6.  
7.    
8.  
9.     switch (reqCode) {   
10.  
11.     case (PICK_CONTACT): {   
12.  
13.         if (resCode == Activity.RESULT_OK) {   
14.  
15.             String name;                   
16.  
17.             Uri contactData = data.getData();   
18.  
19.             Cursor c = managedQuery(contactData, null, null, null, null);   
20.  
21.             c.moveToFirst();   
22.  
23.             name = c.getString(c.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));   
24.  
25.             TextView tv;   
26.  
27.             tv = (TextView)findViewById(R.id.edtPhoneNo);   
28.  
29.             tv.setText(name);   
30.  
31.         }   
32.  
33.         break;   
34.  
35.     }   
36.  
37.     }   
38.  
39. }  

STEP5、在清单文件AndroidManifest.xml中注册通讯录活动和读取Contact数据库的权限

主要工作基本做完了，现在我们只需要注册通讯录活动和读取Contact数据的权限了。完整的清单文件代码如下：

1. <?xml version="1.0" encoding="utf-8"?>   
2.  
3. <manifest xmlns:android="http://schemas.android.com/apk/res/android"   
4.  
5.     package="skynet.com.cnblogs.www" android:versionCode="1"   
6.  
7.     android:versionName="1.0">   
8.  
9.     <application>   
10.  
11.         <activity android:name=".TextMessage" android:label="@string/app_name">   
12.  
13.             <intent-filter>   
14.  
15.                 <action android:name="android.intent.action.MAIN" />   
16.  
17.                 <category android:name="android.intent.category.LAUNCHER" />   
18.  
19.             </intent-filter>   
20.  
21.         </activity>   
22.  
23.         <activity android:name=".ContactPick" android:label="@string/app_name">   
24.  
25.             <action android:name="android.intent.action.PICK" />   
26.  
27.             <category android:name="android.intent.category.DEFAULT" />   
28.  
29.         </activity>   
30.  
31.     </application>   
32.  
33.     <uses-permission android:name="android.permission.SEND_SMS" />   
34.  
35.     <uses-permission android:name="android.permission.READ_CONTACTS" />   
36.  
37. </manifest>  

注意通讯录活动的Intent Filters，它的action是android.intent.action.PICK；category是android.intent.category.DEFAULT。现在我们分析一下这个Intent Filter：

1. <action android:name="android.intent.action.PICK" />：使用户能够可以在通讯录列表中选择一个，然后将选择的联系人的 URL返回给调用者。
2. <category android:name="android.intent.category.DEFAULT" />：这是默认的category，如果不知道category系统会自动加上。这个属性是让使其能够被像Context.startActivity()等找到。要说明的的是，如果列举了多个category，这个活动仅会去处理那些Intent中都包含了所有列举的category的组件。

我们还可以在清单文件中看到TextMessage活动的Intent Filter：

1. <intent-filter>   
2.  
3.     <action android:name="android.intent.action.MAIN" />   
4.  
5.     <category android:name="android.intent.category.LAUNCHER" />   
6.  
7. </intent-filter>  

它指TextMessage活动定是真个程序的入口并且TextMessage会列举在Launcher即启动列表中。

程序运行结果如下图所示：

图1、主界面

图2、点击contact按钮之后

图3、选择一个联系人之后

总结

我们用发短信中选择联系人的例子说明Intent和Intent Filter，这里体现了两个活动之间如何通过Intent和Intent Filter来交互，这也是我们在编写Android应用程序的时候经常遇到了。本文除了上述的主要内容之外，还涉及别的知识点，下面列举几个个人认为比较有用的知识点：

1. Cursor类它跟我们平时用的数据库中的游标类似，它提供了对从数据库返回的结果的随机读写操作。如我们例子中用到的，通过managedQuery方法 查询数据库并返回结果，然后利用Cursor对它进行操作。下面介绍Cursor类的几个方法（我们例子中用到的，更多的方法请自行查阅相关资料）：
   1. public abstract int getColumnIndexOrThrow (String columnName)：返回给定列名的索引（注意：从0开始的），或者当列名不存在时抛出llegalArgumentException异常；
   2. public abstract boolean moveToFirst ()：移动到第一行。如果Cursor为空，则返回FALSE
   3. public abstract boolean moveToPosition (int position)：将游标移动到一个指定的位置，它的范围在-1 <= position <= count。如果position位置不可达，返回FALSE
2. managedQuery方法：根据指定的URI路径信息返回包含特定数据的Cursor对象，应用这个方法可以使Activity接管返回数据对象的生命周期。参数：
   URI: Content Provider 需要返回的资源索引
   Projection: 用于标识有哪些columns需要包含在返回数据中
   Selection: 作为查询符合条件的过滤参数，类似于SQL语句中Where之后的条件判断
   SelectionArgs: 同上
   SortOrder: 用于对返回信息进行排序
3. SimpleCursorAdapter允许你绑定一个游标的列到ListView上，并使用自定义的layout显示每个项目。SimpleCursorAdapter的创建，需要传入当前的上下文、一个layout资源，一个游标和两个数组：一个包含使用的列的名字，另一个（相同大小）数组包含View中的资源ID，用于显示相应列的数据值。

本系列的其它文章：

1. Android 开发之旅：环境搭建及HelloWorld
2. Android 开发之旅：HelloWorld项目的目录结构
3. Android 开发之旅：android架构
4. Android 开发之旅：应用程序基础及组件
5. Android 开发之旅：应用程序基础及组件（续）
6. Android 开发之旅：活动与任务
7. Android 开发之旅：进程与线程
8. Android 开发之旅：组件生命周期（一）
9. Android 开发之旅：组件生命周期（二）
10. Android 开发之旅：组件生命周期（三）
11. Android 开发之旅：又见Hello World！
12. Android 开发之旅：深入分析布局文件&又是"Hello World！"
13. Android 开发之旅：view的几种布局方式及实践
14. Android 开发之旅：短信的收发及在android模拟器之间实践（一）
15. Android 开发之旅：短信的收发及在android模拟器之间实践（二）
16. Android开发之旅: Intents和Intent Filters（理论部分）