引言

上篇我们介绍了Intents和Intent Filters的理论部分,主要是介绍了:activitiesservicesbroadcast 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, nullnullnullnull);   
  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,它的actionandroid.intent.action.PICKcategoryandroid.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即启动列表中。

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

Android开发之旅: Intents和Intent Filters(实例部分)_Intent Filters

图1、主界面

Android开发之旅: Intents和Intent Filters(实例部分)_Intent Filters_02

图2、点击contact按钮之后

Android开发之旅: Intents和Intent Filters(实例部分)_实践_03

图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(理论部分)