IntentFilter的匹配规则
IntentFilter的匹配规则
- IntentFilter的匹配规则
- 一、Intent简介
- 二、IntentFilter匹配规则
- 1.action的匹配规则
- 2.category的匹配规则
- 3.[data](https://developer.android.google.cn/guide/topics/manifest/data-element)的匹配规则
- 使用案例:
- 参考资料
一、Intent简介
Android中提供了Intent机制来协助应用间的交互与通讯,Intent负责对应用中一次操作的动作、动作涉及数据、附加数据进行描述,Android则根据此Intent的描述,负责找到对应的组件,将 Intent传递给调用的组件,并完成组件的调用。Intent不仅可用于应用程序之间,也可用于应用程序内部的Activity/Service之间的交互。因此,Intent在这里起着一个媒体中介的作用,专门提供组件互相调用的相关信息,实现调用者与被调用者之间的解耦。
- 通过Context.startActivity() orActivity.startActivityForResult()启动一个Activity;
- 通过 Context.startService() 启动一个服务,或者通过Context.bindService() 和后台服务交互;
- 通过广播方法(比如 Context.sendBroadcast(),Context.sendOrderedBroadcast(),
- Context.sendStickyBroadcast()) 发给broadcast receivers。
Intent可分为隐式(implicitly)和显式(explicitly)两种:
启动Activity分为两种,显式调用和隐式调用。二者的区别这里就不多说了,
显式调用需要明确地指定被启动对象的组件信息,包括包名和类名,即在构造Intent对象时就指定接收者,它一般用在知道目标组件名称的前提下,一般是在相同的应用程序内部实现的。
而隐式调用则不需要明确指定组件信息,即Intent的发送者在构造Intent对象时,并不知道也不关心接收者是谁,有利于降低发送者和接收者之间的耦合,它一般用在没有明确指出目标组件名称的前提下,一般是用于在不同应用程序之间。
原则上一个Intent不应该既是显式调用又是隐式调用,如果二者共存的话以显式调用为主。显式调用很简单,这里主要介绍一下隐式调用。
隐式调用需要Intent能够匹配目标组件的IntentFilter中所设置的过滤信息,如果不匹配将无法启动目标Activity。
二、IntentFilter匹配规则
Intent解析机制主要是通过查找已注册在AndroidManifest.xml中的所有IntentFilter及其中定义的Intent,最终找到匹配的Intent。
下面是一个过滤规则的示例:
<activity
android:name="com.ryg.chapter_1.ThirdActivity"
android:configChanges="screenLayout"
android:label="@string/app_name"
android:launchMode="singleTask"
android:taskAffinity="com.ryg.task1" >
<intent-filter >
<action android:name="com.ryg.charpter_1.c"/>
<action android:name="com.ryg.charpter_1.d"/>
<category android:name="com.ryg.category.c"/>
<category android:name="com.ryg.category.d"/>
<category android:name="android.intent.category.DEFAULT"/>
<data android:mimeType="text/plain"/>
</intent-filter>
</activity>
为了匹配过滤列表,需要同时匹配过滤列表中的action、category、data
信息,否则匹配失败。一个过滤列表中的action、category和data
可以有多个
,所有的action、category、data分别构成不同类别,同一类别的信息共同约束当前类别的匹配过程。只有一个Intent同时匹配action类别、category类别、data类别才算完全匹配,只有完全匹配才能成功启动目标Activity。另外,一个Activity中可以有多个Intentfilter
,一个Intent
只要能匹配任何一组Intent Filter
即可成功启动对应的Activity。
1.action的匹配规则
action是一个字符串,系统预定义了一些action,同时我们也可以在应用中定义自己的action。action的匹配规则是Intent中的action必须能够和过滤规则中的action匹配,这里说的匹配是指action的字符串值完全一样。一个Intent Filter中可声明多个action,Intent中的action与其中的任一个action在字符串形式上完全相同,action方面就匹配成功。它和category匹配规则的不同
。另外,action区分大小写。
Android系统预定义了许多action,这些action代表了一些常见的操作。常见action如下(Intent类中的常量):
Intent.ACTION_VIEW Intent.ACTION_DIAL Intent.ACTION_SENDTO Intent.ACTION_SEND Intent.ACTION_WEB_SEARCH
2.category的匹配规则
category是一个字符串。category的匹配规则和action不同,它要求Intent中如果含有category,那么所有的category都必须和过滤规则中的其中一个category相同。 也就是说,Intent中如果出现了category,不管有几个category,对于每个category来说,它必须是过滤规则中已经定义了的category。当然,Intent中可以没有category(若Intent中未指定category,系统会自动为它带上“android.intent.category.DEFAULT”),如果没有category的话,这个Intent仍然可以匹配成功。
category和action的区别在于,action是要求Intent中必须有一个action且必须能够和过滤规则中的某个action相同,而category要求Intent可以没有category,但是一旦发现存在category,不论你有多少,每个都要能够和过滤规则中的任何一个category相同。
为了匹配前面的过滤规则中的category,我们可以写出下面的Intent, intent.addcategory (“com.ryg.category.c”)
或者Intent. addcategory (“com.ryg. category.d”)
亦或者不设置category。
为什么不设置category也可以匹配呢?原因是系统在调用startActivity或者startActivityForResult的时候会默认为Intent加上“android.intent. category.DEFAULT
”这个category,所以这个category就可以匹配前面的过滤规则中的第三个category。同时,为了我们的activity能够接收隐式调用,就必须在intent-filter中指定“android.intent.category.DEFAULT
”这个category,原因刚才已经说明了,也就是说,不含有DEFAULT这个category的Activity是无法接收隐式Intent的。
3.data的匹配规则
data的匹配规则和action类似,只要Intent的data只要与Intent Filter中的任一个data声明完全相同,data方面就完全匹配成功。在介绍data的匹配规则之前,我们需要先了解一下data的结构,data的语法如下所示。
<data android:scheme="string"
android:host="string"
android:port="string"
android:path="string"
android:pathPattern="string"
android:pathPrefix="string"
android:mimeType="string" />
data由两部分组成:mimeType
和URI
。
向 Intent 过滤器(过滤规则)添加数据规范。该规范可以是只有数据类型(mimeType属性),可以是只有 URI,也可以是既有数据类型又有 URI。
**mimeType指媒体类型:**比如image/jpeg、audio/mpeg4-generic
和video/
等,可以表示图片、文本、视频等不同的媒体格式
URI则由scheme、host、port、path | pathPattern | pathPrefix
这4部分组成
<scheme>://<host>:<port>/[<path>|<pathPrefix>|<pathPattern >]
例如:
content://com.example.project:200/folder/subfolder/etc
http://www.baidu.com:80/search/info
还是要介绍一下每个数据的含义。
- Scheme:URI的模式,比如http、file、content等,如果URI中没有指定scheme,那么整个URI的其他参数无效,这也意味着URI是无效的。
- Host:URI的主机名,比如
www.baidu.com
,如果host未指定,那么整个URI中的其他参数无效,这也意味着URI是无效的。 - Port:URI中的端口号,比如80,仅当URI中指定了scheme和host参数的时候port参数才是有意义的。
- Path、pathPattern和pathPrefix:这三个参数表述路径信息,其中
- path表示完整的路径信息;
- pathPattern也表示完整的路径信息,但是它里面可以包含通配符“
”, “
”表示0个或多个任意字符,需要注意的是,由于正则表达式的规范,如果想表示真实的字符串,那么“``”要写成“\\*
”, “\
”要写成“\\\\
”; - pathPrefix表示路径的前缀信息。
Intent的uri可通过setData方法设置,mimetype可通过setType方法设置。
需要注意的是:若Intent Filter的data声明部分未指定uri,则缺省uri为content或file,Intent中的uri的scheme部分需为content或file才能匹配;若要为Intent指定完整的data,必须用setDataAndType
方法,究其原因在,setData和setType方法的源码中我们发现:
public Intent setData(Uri data) {
mData = data;
mType = null;
return this;
}
public Intent setType(String type) {
mData = null;
mType = type;
return this;
}
这两个方法会彼此互相清除对方的值,即setData会把mimeType置为null,setType会把uri置为null。
下面我们来举例说明一下data的匹配。首先我们先来看一下Intent Filter中指定data的语法:
<data android:scheme="String."
android:host="String"
android:port="String"
android:path="String"
android:pathPattern="String"
android:pathPrefix="String"
android:mimeType="String"/>
其中scheme、host等各个部分无需全部指定。
只要Intent的data只要与Intent Filter中的任一个data声明完全相同,data方面就完全匹配成功。下面分情况说明。
(1)如下过滤规则:
<intent-filter>
<data android:mimeType="image/*" />
...
</intent-filter>
这种规则指定了媒体类型为所有类型的图片,那么Intent中的mimeType属性必须为“image/*”才能匹配,这种情况下虽然过滤规则没有指定URI,但是却有默认值,URI的默认值为content和file。也就是说,虽然没有指定URI,但是Intent中的URI部分的schema必须为content或者file才能匹配,这点是需要尤其注意的。为了匹配(1)中规则,我们可以写出如下示例:
intent.setDataAndType(Uri.parse("file://abc"), "image/png")
(2)如下过滤规则:
<intent-filter>
<data android:mimeType="video/mpeg" android:scheme="http" ... />
<data android:mimeType="audio/mpeg" android:scheme="http" ... />
...
</intent-filter>
这种规则指定了两组data规则,且每个data都指定了完整的属性值,既有URI又有mimeType。为了匹配(2)中规则,我们可以写出如下示例:
intent.setDataAndType(Uri.parse("http://abc"), "video/mpeg")
或者
intent. setDataAndType (Uri.parse("http://abc"), "audio/mpeg")
关于data还有一个特殊情况需要说明下,这也是它和action不同的地方,如下两种特殊的写法(写法不同),但它们的作用是一样的:
<intent-filter . . . >
<data android:scheme="file" android:host="www.baidu.com" />
. . .
</intent-filter>
<intent-filter . . . >
<data android:scheme="file" />
<data android:host="www.baidu.com" />
. . .
</intent-filter>
现在我们给出完全匹配前面示例intent-filter的示例的Intent:
Intent intent = new Intent("com.ryg.charpter_1.c");
intent.addCategory("com.ryg.category.c");
intent.setDataAndType(Uri.parse("file://abc"), "text/plain");
startActivity(intent);
还记得URI的schema是有默认值的吗?
如果把上面的intent.setDataAndType (Uri.parse("file://abc"), "text/plain")
这句改成intent.setDataAndType(Uri.parse("http://abc"),"text/plain")
,打开Activity的时候就会报错,提示无法找到Activity。
另外一点,Intent-filter的匹配规则对于Service和BroadcastReceiver也是同样的道理,不过系统对于**Service的建议是尽量使用显式调用
方式来启动。**而且在Android8.0系统之后,所有隐式广播都不允许使用静态注册的方式来接收了。隐式广播指的是那些没有具体制定发送给哪个应用程序的广播,大多数系统广播属于隐式广播,但是极少数特殊的系统广播目前仍然允许使用静态注册的方式来接收。
最后,当我们通过隐式方式启动一个Activity的时候,可以先做一下判断,看是否有Activity能够匹配我们的隐式Intent,如果不做判断就有可能出现上述的错误了。
判断方法有两种:①采用PackageManager的resolveActivity方法或者Intent的resolveActivity方法,如果它们找不到匹配的Activity就会返回null,我们通过判断返回值就可以规避上述错误了。
②PackageManager还提供了queryIntentActivities方法,这个方法和resolveActivity方法不同的是:它不是返回最佳匹配的Activity信息而是返回所有成功匹配的Activity信息。
我们看一下queryIntentActivities和resolveActivity的方法原型:
public abstract List<ResolveInfo> queryIntentActivities(Intent intent, int flags);
public abstract ResolveInfo resolveActivity(Intent intent, int flags);
上述两个方法的第一个参数比较好理解,第二个参数需要注意,我们要使用MATCH_DEFAULT_ONLY
这个标记位,这个标记位的含义是仅仅匹配那些在intent-filter中声明了<category android:name="android.intent.category.DEFAULT"/>
这个category的Activity。
使用这个标记位的意义在于,只要上述两个方法不返回null,那么startActivity一定可以成功。如果不用这个标记位,就可以把intent-filter中category不含DEFAULT的那些Activity给匹配出来,从而导致startActivity可能失败。因为不含有DEFAULT这个category的Activity是无法接收隐式Intent的。在action和category中,有一类action和category比较重要,它们是:
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
这二者共同作用是用来标明这是一个入口Activity并且会出现在系统的应用列表中,二者缺一不可,缺一就无法出现在系统的应用列表中。另外,针对Service和BroadcastReceiver, PackageManager同样提供了类似的方法去获取成功匹配的组件信息。
使用案例:
(1)如果我们想要匹配 http 以 “.pdf” 结尾的路径,使得别的程序想要打开网络 pdf 时,用户能够可以选择我们的程序进行下载查看。
我们可以将 scheme 设置为 “http”,pathPattern 设置为 “.*//.pdf”,整个 intent-filter 设置为:
<intent-filter>
<action android:name="android.intent.action.VIEW"></action>
<category android:name="android.intent.category.DEFAULT"></category>
<data android:scheme="http" android:pathPattern=".*//.pdf"></data>
</intent-filter>
如果你只想处理某个站点的 pdf,那么在 data 标签里增加 android:host=”yoursite.com” 则只会匹配 http://yoursite.com/xxx/xxx.pdf,但这不会匹配 www.yoursite.com,如果你也想匹配这个站点的话,你就需要再添加一个 data 标签,除了 android:host 改为 “www.yoursite.com” 其他都一样。
(2)如果我们做的是一个即时通信应用,或是其他类似于微博之类的应用,如何让别人通过 Intent 进行调用出现在选择框里呢?我们只用注册 android.intent.action.SEND 与 mimeType 为 “text/plain” 或 “/”
就可以了,整个 intent-filter 设置为:
<intent-filter>
<action android:name="android.intent.action.SEND" />
<category android:name="android.intent.category.DEFAULT" />
<data mimeType="*/*" />
</intent-filter>
这里设置 category 的原因是,创建的 Intent 的实例默认 category 就包含了 Intent.CATEGORY_DEFAULT ,google 这样做的原因是为了让这个 Intent 始终有一个 category。
(3)如果我们做的是一个音乐播放软件,当文件浏览器打开某音乐文件的时候,使我们的应用能够出现在选择框里?这类似于文件关联了,其实做起来跟上面一样,也很简单,我们只用注册 android.intent.action.VIEW 与 mimeType 为 “audio/*”
就可以了,整个 intent-filter 设置为:
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<data android:mimeType="audio/*" />
</intent-filter>