IntentFilter的匹配规则

IntentFilter的匹配规则

       启动Activity分为两种，显式调用和隐式调用，原则上一个Intent不应该既是显式调用又是隐式调用，如果二者共存的话以显示调用为主，这里介绍隐式调用。隐式调用需要Intent能够匹配目标组件的IntentFilter中所设置的过滤信息，如果不匹配将无法启动目标Activity。IntentFilter中的过滤信息有action、category、data,下面是一个过滤规则的示例：

<activity
         android:name="com.ryg.chapter_1.ThirdActivity"
         android:configChanges="screenLayout"
         android:label="@string/app_name"
         android:launchMode="singleTask"
         android:taskAffinity="com.rgy.task1">
         <intent-filter>
                 <action android:name="com.ryg.charpter_1.c" />
                 <action android:name="com.ryg.charpter_1.d" />
                 <category android:name="com.rgy.category.c" />
                 <category android:name="com.rgy.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中可以有多个intent-filter,一个Intent只要能匹配任何一组intent-filter即可成功启动对应的Activity。

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

                   <action android:name="android.intent.action.SEND" />

                   <action android:name="android.intent.action.SEND_MULTIPLE" />
                   <category android:name="android.intent.category.DEFAULT" />

                   <data android:mimeType="APPLICATION/VND.GOOGLE.PANNORAMA360+JPG" />
                   <data android:mimeType="image/*" />
                   <data android:mimeType="video/*" /> 
           <intent-filter/>
 </activity>

下面详细分析各种属性的匹配规则。
1、action的匹配规则
     action式一个字符串，系统预定义了一些action，同时我们也可以在应用中定义自己的action，action的匹配规则是Intent中的action必须能够和过滤规则中的action匹配，这里说的匹配是指action的字符串完全一样，一个过滤规则可以有多个action，那么只要Intent中的action能够和过滤规则中的任何一个action相同即可匹配成功，针对上面的过滤规则，只要我们的Intent中的action值为“com.rgy.charpter_1.c”或“com.rgy.charpter_1.d”都能成功匹配，需要注意的是，Intent中如果没有指定action，那么匹配失败，总结一下，action的匹配要求Intent中的action存在且必须和过滤规则中的其中一个action相同，需要注意的是它和category匹配规则的不同，另外，action区分大小写，大小写不同字符串相同的action会匹配失败。
     
2、category的匹配规则
    category是一个字符串，系统预定义了一些category，同时我们也可以在应用中定义自己的category，category的匹配规则和action不同，它要求Intent中如果含有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.ryg.category.c”)或者intent.addcategory(“com.rgy.category.d”)亦或者不设置category,为什么不设置category也可以匹配成功呢，原因是系统在调用startActivity或者startActivityForResult的时候会默认为Intent加上“android.intent.category.DEFAULT”这个category，所以这个category就可以匹配前面的过滤规则中的第三个category。

3、data的匹配规则
data的匹配规则和action类似，如果过滤规则中定义了data，那么Intent中必须也要定义可匹配的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。
      mimeType指媒体类型。比如image/jpeg、audio/mpeg4-generic和video/*等。可以表示图片、文本、视频等不同的媒体格式，而URI中包含的数据就比较多了

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表示路径的前缀信息。

data的匹配规则：
data的匹配规则和action类似，它也要求Intent中必须含有data数据，并且data数据能够完全匹配过滤规则中的某一个data这里的完全匹配是指过滤规则中出现的data部分也出现在了Intent中data中。

如下过滤规则：

<intent-filter>
<data android:mimeType="image/*"
</intent-filter>

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

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) 如下过滤规则：

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

这种规则指定了两组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：

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);

当我们通过隐藏方式启动一个Activity的时候，可以做一个判断，看是否有Activity能够匹配我们的隐式iIntent，如果不做判断就有可能出现上述的错误了。判断方法有两种：采用PackageManager的resolveActivity方法或者Intent的resolveActivity方法，如果它们找不到匹配的Activity就会返回null，我们通过判断返回值就可以规避上述错误了。另外，PackageManager还提供了queryIntentActivities方法，这个方法和resolveActivity方法不同的是：它不是返回最佳匹配的Activity信息而是返回成功匹配的Activity信息。

public abstract List<ResolveInfo> queryIntentActivities(Intent intent,int flags);
public abstract ResolveInfo 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比较重要，它们是：

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

这二者共同作用是用来标明这是一个入口，Activity并且会出现在系统的应用列表中，少了任何一个都没有实际意义，也无法出现在系统的应用列表中，也就是二者缺一不可。另外，针对Service和BroadcastReceiver,PackageManager同样提供了类似的方法去获取成功匹配的组件信息。