Zane'Blog

IntentFilter的匹配规则

“当下”稍纵即逝,刚刚说出的话立刻就成了过去,很多要说的话却还在未来;活在当下是一个悖论,对时间掐头去尾后,你会发现几乎什么都不会剩下.

启动Activity分为两种,显示调用和隐式调用。二者的区别简单来说就是:显示调用需要明确地指定被启动对象的组价信息,包括包名和类名;而隐式调用则不需要明确指定组件信息。原则上来说,一个Intent不应该既是显示调用又是隐式调用,如果二者共存的话以显示调用为主。显示调用很简单,这里主要介绍隐式调用。隐式调用需要Intent能够匹配目标组件的IntentFilter中所设置的过滤信息,如果不匹配将无法启动目标Activity。IntentFilter中的过滤信息有action、category、data。

示例如下:

示例答案会在下面给大家展示出来!

为了匹配过滤列表,需要同时匹配过滤列表中的action、category、data的信息,否则匹配失败。一个过滤列表中的action、category和data可以有多个,所有的action、category、data分别构成不同类别,同一类别的信息共同约束当前类别的匹配过程。只有当一个Intent同时匹配action类别、category类别和data类别才算完全匹配,只有完全匹配才能成功启动目标Activity。一个Activity中可以有多个intent-filter,一个Intent只要能匹配任何一组intent-filter即可成功启动对应的Activity

下面详细分析各种属性的匹配规则。

  1. action的匹配规则

    action是一个字符串,系统预定义了一些action,同时我们也可以在应用中自定义action。action的匹配规则是Intent中的action能够和过滤规则中的任何一个action相同(完全一样)即可匹配成功,一个过滤规则中可以有多个action。如针对上面示例中的过滤规则,只要我们的Intent中action值为“com.zanelove.intentfilter.c”或者“com.zanelove.intentfilter.d”都能匹配成功。注意,Intent中如果没有指定action,那么匹配失败。

    总结一下:action的匹配要求Intent中的action存在且必须和过滤规则中的其中一个action相同,另外,action区分大小写,大小写不同字符串相同的action会匹配失败

  2. category的匹配规则

    category是一个字符串,系统预定义了一些category,同时我们也可以在应用中自定义category。它要求Intent中如果含有category,那么所有的category都必须和过滤规则中的其中一个category相同。当然,Intent中可以没有category,如果没有category的话,Intent仍然可以匹配成功,这里要注意下它和action匹配过程的不同,action要求Intent中必须有一个action且必须能够和过滤规则中的某个action相同,而category要求Intent可以没有category,但是如果你一旦有category,不管有几个,每个都要能够和过滤列表中的其中一个category相同。如针对上面示例中的过滤规则,我们可以这样写Intent:intent.addcategory(“com.zanelove.category.c”)或者intent.addcategory(“com.zanelove.category.d”)亦或者不设置category。why?原因是系统在调用startActivity或者startActivityResult方法的时候默认为Intent加上“android.intent.category.DEFAULT”这个category,所以这个category就可以匹配前面的过滤规则中的第三个category。同时,为了我们的Activity能够接收隐式调用,就必须在intent-filter中指定“android.intent.category.DEFAULT”这个category。

  3. data的匹配规则

    data的匹配规则和action类似,如果过滤规则中定义了data,那么Intent中必须也要定义可匹配的data。

    data的语法如图所示:

    data由两部分组成,mimeType和URI。mimeType指媒体类型,比如image/jpeg、audio/mpeg4-generic和video/*等,可以表示图片、文本、视频等不同的媒体格式,而URI中包含的数据就比较多了,下面是URI的结构:

    举例说明:

    content://com.zanelove.demo:200/folder/subfolder/etc

    http://www.baidu.com:80/search/info

    下面分析一下每个数据的含义:

    (1)Scheme:URI的模式,比如http、file、content等,如果URI中没有指定scheme,那么整个URI的其他参数无效,这也意味着URI是无效的。

    (2)Host:URI的主机名,比如www.baidu.com,如果host未指定,那么整个URI中的其他参数无效,这也意味着URI是无效的。

    (3)Port:URI中的端口号,比如80,仅当URI中指定了scheme和host参数的时候port参数才有意义。

    (4)Path、pathPattern和pathPrefix:这三个参数表述路径信息,其中path表述完整的路径信息;pathPattern也表示完整的路径信息,但是它里面可以包含通配符“”,“”表示0个或者多个任意字符,需要注意的是,由于正则表达式的规范,如果想要表示真实的字符串,那么 “” 要写成 “\”,”\” 要写成 “\\”;pathPrefix表示路径的前缀信息。

    介绍完data的数据格式后,我们要说一下data的匹配规则了。前面说到,data的匹配规则和action类似,它也要求Intent中必须含有data数据,并且data数据能够完全匹配过滤规则中的某个data。这里的完全匹配是指过滤规则中出现的data部分也出现在了Intent中的data中。

    (1)如下过滤规则:

    这种规则指定了媒体类型为所有类型的图片,那么Intent中的mimeType属性值必须为“image/*”才能匹配,这种情况下虽然过滤规则没有指定URI,但是却有默认值,URI的默认值为content和file。也就是说,虽然没有指定URI,但是Intent中的URI部分的scheme必须为content或者file才能匹配。

    为了匹配(1)中规范,Intent可以这样写:

    1
    intent.setDataAndType(Uri.parse(“file://abc”,”image/png”));

    注意,如果要为Intent指定完整的data,必须要调用setDataAndType方法,不能先调用setData方法再调用setType方法,因为这两个方法彼此会清除对方的值,这个看源码就很好理解,比如setData方法:

    1
    2
    3
    4
    5
    public Intent setData(Uri data) {
    mData = data;
    mType = null;
    return this;
    }

    可以发现,setData会把mimeType设置成null,同理setType会把URI设置成null。

    (2)如下过滤规则:

    这种规则指定了两组data规则,且每个data指定了完整的属性值,既有URI又有mimeType。

    为了匹配(2)中规则,Intent可以这样写:

    1
    intent.setDataAndType(Uri.parse("http://abc"),"video/mpeg");

    or

    1
    intent.setDataAndType(Uri.parse("http://abc"),"audio/mpeg");

    关于data还有一个特殊情况需要说明一下,这也是它和action不同的地方,如下两种特殊的写法,它们的作用是一样的:

    至此IntentFilter的过滤规则都讲解了一遍!

    到这,我要把本节前面给出的第一个intent-filter示例讲解一下,给它一个完整匹配它的Intent:

    1
    2
    3
    4
    Intent intent = new Intent("com.zanelove.intentfilter.c");
    intent.addCategory("com.zanelove.category.c");
    intent.setDataAndType(Uri.parse("file://abc"),"text/plain");
    startActivity(intent);

    还记得URI的scheme是有默认值(content,file)的吗?如果把上面的intent.setDataAndType(Uri.parse(“file://abc”),”text/plain”)改成intent.setDataAndType(Uri.parse(“http://abc"),"text/plain"),打开Activity的时候就会报错,提示无法找到Activity。另外一点,intent-filter的匹配规则对于Service和BroadcastReceiver也是同样的道理,不过系统对于Service的建议是尽量使用显示调用方式来启动服务。

    最后,当我们通过隐式方法启动一个Activity的时候,可以做一些判断,看是否有Activity能够匹配我们的隐式Intent,防止报错。判断方法两种:采用PackageManager的resolveActivity方法或者Intent的resolveActivity方法,如果它们找不到匹配的Activity就会返回null,这样通过判断返回值就可以避免报错。另外,PackageManager还提供了queryIntentActivities方法,这个方法和resolveActivity方法不同的是:它不是返回最佳匹配的Activity信息而是返回所有成功匹配的Activity信息。我们可以看下queryIntentActivities和resolveActivity方法的原型:

    1
    2
    3
    public abstract List<ResolveInfo> queryIntentActivities(Intent intent, int flags);
    public abstract ResuloveInfo resolveActivity(Intent intent, int flags);

    上述两个方法的第一个参数比较好理解,第二个参数需要注意,我们要使用MATCH_DEFAULT_ONLY这个标记位,这个标记位的含义是仅仅匹配那些intent-filter中声明了这个category的Activity。使用这个标记位的意义在于,只要上述两个方法不返回null,那么startActivity一定可以成功。如果不用这个标记位,就可以把intent-filter中category不含DEFAULT的那些Activity给匹配出来,从而导致startActivity可能失败。因为不含DEFAULT这个category的Activity是无法接收隐式Intent的

    在action和category中,有一类action和category比较重要,它们是:

    1
    2
    3
    <action andorid:name="android.intent.action.MAIN"/>
    <category android:name="android.intent.category.LAUNCHER"/>

    这二者共同作用是用来标明这个一个入口Activity并且会出现在系统的应用列表中,少了任何一个都没有实际意义。

    针对Service和BroadcastReceiver,PackageManager同样提供了类似的方法去获取成功匹配的组件信息。

坚持原创技术分享,您的支持将鼓励我继续创作!