IntentFilter的匹配规则

最新推荐文章于 2022-04-04 16:38:03 发布

任笑天

最新推荐文章于 2022-04-04 16:38:03 发布

阅读量332

点赞数

分类专栏： Android开发文章标签： filter 过滤器

本文链接：https://blog.csdn.net/u013627830/article/details/51097814

版权

Android开发专栏收录该内容

8 篇文章 0 订阅

订阅专栏

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

   <activity android:name=".ThirdActivity"
            android:configChanges="orientation"
            android:taskAffinity="com.rxt.task1"
            android:launchMode="singleTask"
            >
            <intent-filter>
                <action android:name="com.rxt.action1"></action>
                <action android:name="com.rxt.action2"></action>
                <category android:name="com.rxt.category1"></category>
                <category android:name="com.rxt.category2"></category>
                  <category android:name="android.intent.category.DEFAULT"></category>
                <data android:mimeType="text/plain"></data>
            </intent-filter>
     </activity>

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


        <activity android:name=".SecondActivity">
            <intent-filter>
                <action android:name="android.rxt.action1"></action>
                <category android:name="android.intent.category.DEFAULT"></category>
            </intent-filter>
            <intent-filter>
                <action android:name="android.rxt.action2"></action>
                <category android:name="android.intent.category.DEFAULT"></category>
                <data android:mimeType="video/*"></data>
            </intent-filter>
        </activity>

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

1.action的匹配规则

action是一个字符串，系统预定义了一些action，同时我们也可以在应用中定义自己的action。action的匹配规则是Intent中的action必须能够和过滤规则中的action匹配，这里说的匹配是指action的字符串值完全一样。一个过滤规则中可以有多个action,那么只要Intent中的action能够和过滤规则中的任何一个action相同即可匹配成功。针对上面的过滤规则，只要我们的Intent中action值为”android.rxt.action1”或者”android.rxt.action2”都能成功匹配。需要注意的是，Intent中如果没有指定action，那么匹配失败。总结一下，action的匹配要求Intent中的action存在且必须和过滤规则中的其中一个相同，这里需要注意它和category匹配规则的不同。另外，action区分大小写，大小写不同字符串字符串相同的action也会匹配失败。

2.category的匹配规则

category是一个字符串，系统预定义了一些category，同时我们也可以在应用中定义自己的category。category的匹配规则和action不同，它要求Intent中如果含有category那么所有的category都必须和过滤规则中的其中一个category相同。换句话说，Intent中如果出现了category，不管有几个category，对于每个category来说，它必须是过滤规则中已经定义了的category。当然，Intent中可以没有category，如果没有category的话，按照上面的描述，这个Intent仍然可以匹配成功。这里要注意下它的action匹配过程的不同，action是要求Intent中必须有一个action且必须能够和过滤规则中的某个action相同，而category要求Intent可以没有category，但是如果你一旦有category，不管有几个，每个都要能够和过滤规则中的任何一个category相同。为了匹配前面的过滤规则中的category，我们可以写出下面的Intent，intent.addcategory(“com.rxt.category1”);或者intent.addcategory(“com.rxt.category2”)亦或者不设置。为什么不设置category也可以匹配呢？原因是系统用startActivity或者startActivityForResult的时候会默认为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的结构，因为data稍微有些复杂。

data的语法如下所示。

 <activity android:name=".SecondActivity">
            <intent-filter>
                <data
                    android:scheme="string"
                    android:host="string"
                    android:port="string"
                    android:path="string"
                    android:pathPattern="string"
                    android:pathPrefix="string"
                    android:mimeType="string"
                    ></data>
            </intent-filter>
 </activity>

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

<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:UR中的端口号，比如80，仅当URI中指定了scheme和host参数的时候port参数才是有意义的。

Path、pathPattern、和pathPrefix:这三个参数表述路径信息，其中path表示完整的路径信息；pathPattern也表示完整的路径信息，但是它里面可以包含通配符”*”表示0个或多个任意字符，需要注意的是，由于正则表达式的规范，如果想表示真正的字符串，那么要加入转译字符。

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

 <activity android:name=".ThirdActivity">
            <intent-filter>
                <data
                    android:mimeType="image/*"></data>
            </intent-filter>
</activity>

这种规则指定了媒体类型为所有类型的图片，那么Intent中的mimeType属性必须为”image/*”才能匹配，这种情况下虽然过滤规则没有指定URI，但是却有默认值，URI的默认值为content和file。也就是说，intent-filter虽然没有指定URI，但是intent中的URI部分的scheme必须为content或者file才能匹配，这点是需要尤其注意的。为了匹配(1)中的规则，我们可以写出如下示例：

 intent.setDataAndType(Uri.parse("file://abc"),"image/png");

另外，如果要为intent指定完整的data，必须要调用setDataAndType方法，不能先调用setData再调用setType，因为这两个方法彼此会清除对方的值，这个看源码就很容易理解，比如setData:

 public Intent setData(Uri data) {
        mData = data;
        mType = null;
        return this;
    }

可以发现，setData会把mimeType置为null，同理setType也会把URI置为null。

(2)如下过滤规则:

    <activity android:name=".ThirdActivity">
       <intent-filter>
                <data android:mimeType="video/mpeg" android:scheme="http"></data>
                <data android:mimeType="audio/mpeg"  android:scheme="http"></data>
            </intent-filter>
    </activity>

这种规则指定了两组data规则，且每个data都指定了完整的属性值，既有URI又有mimeType。为了匹配(2)中规则，我们可以写出如下示例:

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

或者

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

通过上面两个示例，读者应该已经明白了data的匹配规则，关于data还有一个特殊情况需要说明下，这也是它和action不同的地方，如下两种特殊的写法，它们的作用是一样的。

   <activity android:name=".ThirdActivity">
           <intent-filter>
               <data android:scheme="file"
                   android:host="www.baidu.com"
                   ></data>
           </intent-filter>
            <intent-filter>
                <data android:scheme="file"></data>
                <data android:host="www.baidu.com"></data>
            </intent-filter>
        </activity>

到这里我们已经把IntentFilter的过滤规则都讲了一遍，还记得本节前面给出的一个intent-filter的示例吗？现在我们给出完全匹配它的intent。

    Intent intent=new Intent();
    intent.setAction("com.rxt.action1");
    intent.addCategory("com.rxt.category1");
    intent.setDataAndType(Uri.parse("file://abc"),"text/plain");
    startActivity(intent);

还记得URI的scheme是有默认值的吗？如果把上面的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，我们通过判断返回值就可以规避上述错误（找不到Activity），另外，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中声明<categoryandroid:name="android.intent.category.LAUNCHER" />这个category的Activity。使用这个标记位的意义在于，只要上述两个方法不返回null，那么startActivity一定可以成功。如果不用这个标记位，就可以吧intent-filter中category不含DEFAULT的那些Activity给匹配出来，从而导致 startActivity可能失败。在action和category中，有一类action和category比较重要。

  <intent-filter>
             <action android:name="android.intent.action.MAIN"></action>
             <category android:name="android.intent.category.LAUNCHER"></category>
  </intent-filter>