Android系列教程之十：Intents and Intent Filters

转自http://flysnow.javaeye.com/blog/961576 飞雪无情原创

 

 

在这里你将会学到：

1. 什么是Intent和Intent Filter
2. Intent和Intent Filter有什么用
3. 怎么启动（传递）一个Intent
4. Intent里包含什么
5. 什么是显式Intent以及什么隐式Intent
6. Intent是怎样匹配的

一：前言

     在正式介绍Intent之前，我们先看下上面说的Activity、Service和Broadcast Receiver是怎样传递Intent。对于这三个组件而言，他们都有自己独立的传递Intent的机制：

1. Activity:对于Activity来说，它主要是通过Context.startActivity() 或Activity.startActivityForRestult() 来启动一个存在的Activity做一些事情。当使用Activity.startActivityForResult() 启动一个Activity时，可以使用Activity.setResult()返回一些结果信息，可以在Activity.onActivityResult() 中得到返回的结果.
2. Service:对于Service来说，它主要是通过Context.startService() 初始化一个Service或者传递消息给正在运行的Service。同样，也可以通过Context.bindService() 建立一个调用组件和目标服务之间的连接。
3. Broadcast Receiver:我们可以通过 Context.sendBroadcast() ， Context.sendOrderedBroadcast() 以及Context.sendStickyBroadcast() 这些方法，传递Intent给感兴趣的广播。

     消息之间的传递是没有重叠的，比如调用startActivity()传播一个Intent，只会传播给Activity，而不会传播给Service和Broadcast Receiver，反过来也是这样的。

二：Intent对象

      一个Intent对象包含了很多数据的信息，比如要执行的动作，类别，数据，附加信息等等，下面就一一列列出一个Intent中包含的信息。

组件名称

      这个组件名称字段其实就是一个ComponentName类，它包含了一个目标组件的全限定名，比如com.flysnow.intent.Activity1，这就是一个全限定名的Activity。组件名字可以通过setComponent()、setClass()或者setClassName()设置，如果设置了Intent目标组件的名字，那么这个Intent就会被传递给特定的组件，也就是我们说的显式Intent.如果不设置，则是隐式的Intent，Android系统将根据Intent Filter中的信息进行匹配.

Action(动作)

       一个Intent的Action在很大程度上说明这个Intent要做什么，是查看(View)、删除(Delete)、编辑(Edit)等等。Action一个字符串命名的动作，Android中预定义了很多Action，可以参考Intent类查看,下面是文档中的几个动作

     当然，我们也可以自定义Action，比如com.flysnow.intent.ACTION_ADD,定义Action的时候最好能表明意思，要做什么，这样我们的Intent中的数据才好填充。Intent对象的getAction()可以获取动作，使用setAction()可以设置动作。

Data（数据）

      Data，其实就是一个URI，用于执行一个Action时所用到的数据的URI和MIME。不同的Action有不同的数据规格，比如ACTION_EDIT动作，数据就可以能包含一个用于编辑文档的URI,如果是一个ACTION_CALL动作，那么数据就是一个包含了tel:6546541的数据字段，所以上面提到的自定义Action时要规范命名。数据的URI和类型对于Intent的匹配是很重要的，Android往往根据数据的URI和MIME找到能处理该Intent的最佳目标组件。

Category(类别)

     Category指定了用于处理Intent的组件的类型信息，一个Intent可以添加多个Category，使用addCategory()方法即可，使用removeCategory()删除一个已经添加的类别。Android的Intent类里定义了很多常用的类别，可以参考使用。

Extras(附加信息)

      有些用于处理Intent的目标组件需要一些额外的信息，那么就可以通过Intent的put..()方法把额外的信息塞入到Intent对象中，用于目标组件的使用，一个附件信息就是一个key-value的键值对..Intent有一系列的put和get方法用于处理附加信息的塞入和取出。

Flag(标识)

     Android有很多标识，用于标记如何启动一个活动，是NEW_TASK还是其他等等，以及启动后怎么对待这个活动。。可以参考Intent类中的FLAG常量字段。

三：Intent的解析

     介绍完了Intent对象的构成，就要介绍Android系统是怎样解析Intent的，Android是怎么传递Intent到目标组件的呢？

Intent分类

      Intent可以分为两类，一类是显式的Intent，一类是隐式的Intent，上面有过提及。显示的Intent就是指定了组件名字的，隐式的就是没有指定Intent的组件名字，需要Android根据Intent中的Action、data、Category等来解析匹配。而目标组件（Activity、Service、Broadcast Receiver）怎通过设置他们的Intent Filter来界定其处理的Intent。如果一个组件没有定义Intent Filter，那么它只能接受处理显示的Intent，只有定义了Intent Filter的组件才能同时处理隐式和显示的Intent。

Action检测

     为了对Action的作用进行检测，我们使用一个例子来演示Action的作用。项目名为Intents,应用名为Intents and Filters，运行在Android2.2版本上.主启动Activity为IntentsTestList

     1.IntentsTestList代码如下：

/** * Intents测试列表类 * @author 飞雪无情 * @since 2011-3-14 */ public class IntentsTestList extends ListActivity { private String ACTION_VIEW="com.flysnow.intent.ACTION_VIEW"; /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); //定义ListAdapter setListAdapter(new SimpleAdapter(this, getData(), android.R.layout.simple_list_item_1, new String[] { "title" },new int[] {android.R.id.text1})); getListView().setTextFilterEnabled(true); //注册一个广播 super.registerReceiver(new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { Toast.makeText(context, "该Broadcast的Intent Filter值只设置了Action", Toast.LENGTH_SHORT).show(); } },new IntentFilter(ACTION_VIEW)); } @Override protected void onListItemClick(ListView l, View v, int position, long id) { Intent intent=(Intent)getData().get(position).get("intent"); Boolean isActivity=(Boolean)getData().get(position).get("isActivity"); if(isActivity){ startActivity(intent); }else{ sendBroadcast(intent); } } /** * 返回ListView需要的数据 * @return ListView需要的数据 */ private List<Map<String,Object>> getData() { List<Map<String,Object>> data=new ArrayList<Map<String,Object>>(); addItem(data, "空Action的Activity", new Intent(),true); addItem(data, "Action检测-Activity", new Intent(ACTION_VIEW),true); addItem(data, "Action检测-Broadcast", new Intent(ACTION_VIEW),false); return data; } /** * 给ListView添加数据 * @param data 存储数据的List * @param name 要显示的Title * @param intent 单击某一项时要启动的Activity * @param isActivity 启动的是否是Activity，true是，false为广播 */ private void addItem(List<Map<String,Object>> data, String name, Intent intent,boolean isActivity) { Map<String, Object> temp = new HashMap<String, Object>(); temp.put("title", name); temp.put("intent", intent); temp.put("isActivity", isActivity); data.add(temp); } } 

 

这里主要是使用ListActivity列出3个测试，一个测试空的Intent,一个测试只有Action的Intent--Activity版，一个测试只有Action的Intent--Broadcast版。。。

1.为了测试startActivity()，我们新建一个Activity名字为ActionActivity代码如下：

/** * @author 飞雪无情 * @since 2011-3-14 */ public class ActionActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); TextView text=new TextView(this); text.setText("该Activity的Intent Filter值只设置了Action"); setContentView(text); } } 

很简单，只有一段文本的展示。

3.AndroidManifest.xml修改如下:

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.flysnow.intent" android:versionCode="1" android:versionName="1.0"> <uses-sdk android:minSdkVersion="8" /> <application android:icon="@drawable/icon" android:label="@string/app_name"> <activity android:name=".IntentsTestList" android:label="@string/app_name"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <activity android:name=".ActionActivity" android:label="Action检测"> <intent-filter> <action android:name="com.flysnow.intent.ACTION_VIEW"></action> <action android:name="android.intent.action.VIEW"></action> <category android:name="android.intent.category.DEFAULT"></category> </intent-filter> </activity> </application> </manifest> 

很简单，为我们的ActionContext加上了两个action标签和一个category标签,加category标签设置成android.intent.category.DEFAULT是为了让这个Activity可以接收隐式的Intent请求，这是Android规定的，对于Activity，使用Context.startActivity()传递隐式Intent，默认是包含了android.intent.category.DEFAULT的，所以定义的Activity要想接收，必须在Intent Filter里添加android.intent.category.DEFAULT这个Category。

4.运行入下图：

当点击“空Action的Activity”的时候，会报异常，因为Intent什么都没有设置，没有任何的Activity能处理它 。当点击“Action检测-Activity”的时候会打开我们的ActionActivity这个Activity，点击“Action检测-Broadcast”会弹出Toast提示，说明已经被接收到。。从上面我们可以看出，当Intent设置了Action时，只要对应的组件的Intent Filter中包含该Action的定义，那么这个组件就会接收该Intent。。。 

 

 

Category（类别）检测

 类别在<intent-filter>中是通过<category>标记定义的,Category和Action一样，他们的名字都是一个字符串定义，但是我们在代码中可以使用对应的类别常量，在xml文件定义中只能使用定义好的字符串。Android的Intent类中提供了很多内置的类别定义，一中类别代表一个意思，可以参考说明使用。。比如android.intent.category.LAUNCHER标表示你的应用会展示在启动列表页面，经常和android.intent.action.MAIN搭配使用

下面通过一个例子来说明Category的检测,项目名为Intents,应用名为Intents and Filters，运行在Android2.2版本上.主启动Activity为IntentsTestList。

IntentsTestList代码如下：

/** * Intents测试列表类 * @author 飞雪无情 * @since 2011-3-14 */ public class IntentsTestList extends ListActivity { private String ACTION_VIEW="com.flysnow.intent.ACTION_VIEW"; private String CATEGORY_MAN="com.flysnow.intent.CATEGORY_MAN"; private String CATEGORY_SHOP="com.flysnow.intent.CATEGORY_SHOP"; /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); //定义ListAdapter setListAdapter(new SimpleAdapter(this, getData(), android.R.layout.simple_list_item_1, new String[] { "title" },new int[] {android.R.id.text1})); getListView().setTextFilterEnabled(true); filter.addCategory(CATEGORY_MAN); //注册一个广播 super.registerReceiver(new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { Toast.makeText(context, "该Broadcast的Intent Filter设置了Category和Action", Toast.LENGTH_SHORT).show(); } },filter); } @Override protected void onListItemClick(ListView l, View v, int position, long id) { Intent intent=(Intent)getData().get(position).get("intent"); Boolean isActivity=(Boolean)getData().get(position).get("isActivity"); if(isActivity){ startActivity(intent); }else{ sendBroadcast(intent); } } /** * 返回ListView需要的数据 * @return ListView需要的数据 */ private List<Map<String,Object>> getData() { List<Map<String,Object>> data=new ArrayList<Map<String,Object>>(); addItem(data, "1个Category检测-Activity", new Intent(ACTION_VIEW).addCategory(CATEGORY_MAN),true); addItem(data, "1个Category检测-Broadcast", new Intent(ACTION_VIEW).addCategory(CATEGORY_MAN),false); addItem(data, "2个Category检测-Activity", new Intent(ACTION_VIEW).addCategory(CATEGORY_MAN).addCategory(CATEGORY_SHOP),true); return data; } /** * 给ListView添加数据 * @param data 存储数据的List * @param name 要显示的Title * @param intent 单击某一项时要启动的Activity * @param isActivity 启动的是否是Activity，true是，false为广播 */ private void addItem(List<Map<String,Object>> data, String name, Intent intent,boolean isActivity) { Map<String, Object> temp = new HashMap<String, Object>(); temp.put("title", name); temp.put("intent", intent); temp.put("isActivity", isActivity); data.add(temp); } private IntentFilter filter=new IntentFilter(ACTION_VIEW); } 

以上代码主要是一个ListView，列出了三个测试项，1个Category的测试和2个Category的测试，注册了一个广播.

为了测试新建了2个Activity，分别是CategoryActivity和Category2Activity,代码如下：

/** * @author 飞雪无情 * @since 2011-3-14 */ public class CategoryActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); TextView text=new TextView(this); text.setText("该Activity的Intent Filter值设置了Action和1个Category，不包含android.intent.category.DEFAULT"); setContentView(text); } } 

/** * @author 飞雪无情 * @since 2011-3-14 */ public class Category2Activity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); TextView text=new TextView(this); text.setText("该Activity的Intent Filter值设置了Action和2个Category，不包含android.intent.category.DEFAULT"); setContentView(text); } }  

很简单只是一段文字的说明

AndroidManiftest.xml修改如下：

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.flysnow.intent" android:versionCode="1" android:versionName="1.0"> <uses-sdk android:minSdkVersion="8" /> <application android:icon="@drawable/icon" android:label="@string/app_name"> <activity android:name=".IntentsTestList" android:label="@string/app_name"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <activity android:name=".CategoryActivity" android:label="1个Category检测"> <intent-filter> <action android:name="com.flysnow.intent.ACTION_VIEW"></action> <category android:name="android.intent.category.DEFAULT"></category> <category android:name="com.flysnow.intent.CATEGORY_MAN"></category> </intent-filter> </activity> <activity android:name=".Category2Activity" android:label="2个Category检测"> <intent-filter> <action android:name="com.flysnow.intent.ACTION_VIEW"></action> <category android:name="android.intent.category.DEFAULT"></category> <category android:name="com.flysnow.intent.CATEGORY_MAN"></category> <category android:name="com.flysnow.intent.CATEGORY_SHOP"></category> </intent-filter> </activity> </application> </manifest> 

为CategoryActivity添加了2个Category，一个是默认的（隐式Intent必须），一个是自定义的。而相应的Category2Activity则有三个Category。

我们运行测试，效果图如下： 

 当点击“1个Category检测-Activity”的时候，会弹出 

 这是，因为我们的Intent定义了一个Category，这个Category在CategoryActivity和Category2Activity里都有，都能匹配上，所以就会弹出这两个Activity供我们选择，而当我们单击《2个Category检测-Activity》的时候就会直接打开Category2Activity，这是因为这个选项里的Intent有2个Category，只有Category2Activity才能匹配上。。。通过例子我们可以总结到：Intent中所包含的所有Category必须在一个组件的intent-filter中有定义，一个都不能少，否则不能通过检测。。但是intent-filter的可以有额外的Category .再次提醒： Android对所有传递给 Context.startActivity()的隐式intent至少包含"android.intent.category.DEFAULT"

 

 

数据(data)检测

data标记也是在intent-filter中定义的，大致格式如下:

<intent-filter> <action android:name="android.intent.action.VIEW"></action> <category android:name="android.intent.category.DEFAULT"></category> <data android:mimeType="text/plain"></data> </intent-filter> 

 

每个data定义一个URI和数据类型(MIME)，URI由4个属性来定义，分别是android:scheme,android:host,android:port,android:path..这个四个属性构成如下格式的URI: scheme://host:port/path    如：content://com.flysnow.intent:8080/show/view。其中content就是scheme，com.flysnow.intent就是host，8080就是port,show/view就是path...如果有经常使用ContentProvider的应该熟悉。。我们经常定义的authority不就是host+port吗？还有这几个元素都是可选的，但是不是随便用就可以的，port要依赖于host，没有host，port就会被忽略，不起作用，同样，如果要使用host+port(authority)就必须指定scheme。而path则依赖于scheme和authority。。

 

       还有一个很重要的类型就是mimeType,这个属性用于指定内容的类型，也就是这个组件可以处理哪些类型的内容。。如text/plain表示无格式文本类型，mimeType也支持通配符，使用text/*则表示所有文本类型。通过使用它，你可以很方便的开发出关联打开诸如txt文件，pdf文件的应用。后面的两个自理将会演示txt文件查看器，图片查看器的例子。。MIME可以参考http://www.w3school.com.cn/media/media_mimeref.asp。这里有所有的内容类型的定义。。

开发实例-拨打电话，text阅读器和图片查看器

下面通过一个例子来演示data的检测,项目名为Intents,应用名为Intents and Filters，运行在Android2.2版本上.主启动Activity为IntentsTestList。例子包括以下演示：

 

1. 通过发送intent的方式“打开拨号界面并输入电话123456”。
2. 创建一个Text文件阅读器
3. 创建一个图片查看器

首先我们实现第一项，修改IntentsTestList类如下：

/** * Intents测试列表类 * @author 飞雪无情 * @since 2011-3-14 */ public class IntentsTestList extends ListActivity { /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); //定义ListAdapter setListAdapter(new SimpleAdapter(this, getData(), android.R.layout.simple_list_item_1, new String[] { "title" },new int[] {android.R.id.text1})); getListView().setTextFilterEnabled(true); } @Override protected void onListItemClick(ListView l, View v, int position, long id) { Intent intent=(Intent)getData().get(position).get("intent"); Boolean isActivity=(Boolean)getData().get(position).get("isActivity"); if(isActivity){ startActivity(intent); }else{ sendBroadcast(intent); } } /** * 返回ListView需要的数据 * @return ListView需要的数据 */ private List<Map<String,Object>> getData() { List<Map<String,Object>> data=new ArrayList<Map<String,Object>>(); addItem(data, "打开拨号界面并输入电话123456", new Intent(Intent.ACTION_DIAL, Uri.parse("tel://123456")), true); return data; } /** * 给ListView添加数据 * @param data 存储数据的List * @param name 要显示的Title * @param intent 单击某一项时要启动的Activity * @param isActivity 启动的是否是Activity，true是，false为广播 */ private void addItem(List<Map<String,Object>> data, String name, Intent intent,boolean isActivity) { Map<String, Object> temp = new HashMap<String, Object>(); temp.put("title", name); temp.put("intent", intent); temp.put("isActivity", isActivity); data.add(temp); } } 

 

这时我们运行程序，单击“打开拨号界面并输入电话123456”就会打开系统的自带的拨号界面，并且默认已经录入了要拨打的号码“123456”。效果图如下：

 

  然后我们实现第二功能-txt文件阅读器

新建TextWatcherActivity代码如下：

/** * 显示文本的Activity * @author 飞雪无情 * @since 2011-3-24 */ public class TextWatcherActivity extends Activity { private TextView mTextView; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); mTextView=new TextView(this); setContentView(mTextView); } @Override protected void onStart() { super.onStart(); Intent txtIntent=getIntent(); Uri data=txtIntent.getData(); String txt; try { txt = readTxt(data); } catch (IOException e) { txt="打开txt文件异常"; } mTextView.setText(txt); } /** * 读取txt文本 * @param txtUri * @return * @throws IOException */ private String readTxt(Uri txtUri) throws IOException{ BufferedReader bufferedReader=new BufferedReader(new InputStreamReader(getContentResolver().openInputStream(txtUri),Charset.forName("GBK"))); StringBuilder txt=new StringBuilder(); String buf=""; while((buf=bufferedReader.readLine())!=null){ txt.append(buf).append("/n"); } return txt.toString(); } } 

然后在AndroidManifest.xml中加入如下定义:

<activity android:name=".TextWatcherActivity" android:label="查看TXT文件"> <intent-filter> <action android:name="android.intent.action.VIEW"></action> <category android:name="android.intent.category.DEFAULT"></category> <data android:mimeType="text/plain"></data> </intent-filter> </activity> 

 

这样在单击txt文件的时候就可以选择我们的这个Activity对txt文件处理，显示其内容.我们新建一个1.txt文件，写上一些内容，放在我们的sd卡中，使用文件管理工具查看这个txt文件，会弹出如下图的提示，看到我们刚刚做的《TXT阅读器》了吧。 

选择“查看TXT文件”，就可以看到我们的txt内容： 

最后实现第三个功能--图片查看器

新建ImageWatcherActivity，代码如下：

/** * 显示文本的Activity * @author 飞雪无情 * @since 2011-3-24 */ public class ImageWatcherActivity extends Activity { private final String IMAGE_URI_KEY="imageUriKey"; private Uri image; private ImageView mImageView; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); mImageView=new ImageView(this); setContentView(mImageView); } @Override protected void onStart() { super.onStart(); Intent txtIntent=getIntent(); image=txtIntent.getData(); //对于大图片未做优化处理 mImageView.setImageURI(image); } @Override protected void onRestoreInstanceState(Bundle savedInstanceState) { super.onRestoreInstanceState(savedInstanceState); image=savedInstanceState.getParcelable(IMAGE_URI_KEY); mImageView.setImageURI(image); } @Override protected void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); outState.putParcelable(IMAGE_URI_KEY,image); } }  

 然后在AndroidManifest.xml中加入如下定义:

<activity android:name=".ImageWatcherActivity" android:label="查看图片文件"> <intent-filter> <action android:name="android.intent.action.VIEW"></action> <category android:name="android.intent.category.DEFAULT"></category> <data android:mimeType="image/*"></data> </intent-filter> </activity> 

这样在单击图片文件的时候就可以选择我们的这个Activity对txt文件处理并且显示。 

 

数据(data)检测小结

对于data的匹配，如果说怎么怎么匹配，在什么情况下通过可能会比较难以理解，这里以一种简单的方式来解说。

假定我们定义的Intent Filter 的data标签为集合A，传递的Intent中包含的data为集合B，当B是A的子集时就通过了（Action和Category也得检测通过）。如果B为空（不配置data），那么A也得为空（不配置data）才能通过 。更详细（繁琐）的介绍请参考doc

 

Intents and Intent Filters总结

Android提供了以Intent的方式调用Android设备的内置Google应用，比如打电话，调用Google浏览器打开网页，搜索等。关于这方便的介绍可以参考Android开发文档《Intents List: Invoking Google Applications on Android Devices》这一节的介绍，很详细。docs/guide/appendix/g-app-intents.html。

Intent是一个很好的设计，它提供了一种在各个组建之间通信的方式，也为我们使用其他的应用的功能提供了可能，这样如果我们想在自己的应用打开一个网页，我们就不用特意迁入一个webview，我们直接调用Android内的浏览器打开即可。。

最后值得一提的是PackageManager这个类中为我们提供了一系列的query...()方法，可以让我们根据我们定义的Intent查询特定的匹配Intent Filter标记的所有组件。。有兴趣的可以研究一下。。