组件 -- Activity -- IntentFilter的匹配规则

一、概述

启动Activity分为两种,显示调用和隐式调用。
显示调用,需要明确指定被启动对象的组件信息,包括包名和类名。
隐式调用,不需要明确指定组件信息,隐式调用需要Intent能够匹配目标组件的IntentFilter中所设置的过滤信息,如果不匹配将无法启动目标Activity。
原则上一个Intent不应该既是显示调用又是隐式调用,如果二者共存的话以显示调用为主。

IntentFilter中的过滤信息有action、category、data三项,每一项可以有多个,所有的action、category、data分别构成不同类别,同一类别的信息共同约束当前类别的匹配过程。一个Intent只有同时匹配action类别、category类别、data类别才算完全匹配,只有完全匹配才能成功启动目标Activity。
另外,一个Activity中可以有多个intent-filter,一个Intent只要能匹配任何一组intent-filter即可成功启动对应的Activity。

二、action的匹配规则

action是一个字符串,系统预定义了一些action,同时我们也可以在应用中定义自己的action。
action的匹配规则是,Intent中的action存在且必须和过滤规则中的其中一个action相同。action区分大小写。

三、category的匹配规则

category是一个字符串,系统预定义了一些category,同时我们也可以在应用中定义自己的category。
category的匹配规则是,Intent中如果含有category,那么所有的category都必须和过滤规则中的其中一个category相同。分两个情况:
情况1. Intent中有category,
每个category必须是过滤规则中已经定义了的category。
情况2. Intent中没有category,
系统会默认为Intent加上"android.intent.category.DEFAULT"这个category。
因此,为了activity能够接收隐式调用,就必须在intent-filter中指定"android.intent.category.DEFAULT"这个category。

action和category匹配规则的不同:
action,要求Intent中必须有一个action且必须能够和过滤规则中的某个action相同;
category,Intent中可以没有category,但是如果一旦有category,不管有几个,每个都要能够和过滤规则中的任何一个category相同。

四、data的匹配规则

1. data的组成

data由两部分组成,mimeType和URI。
mimeType:
媒体类型,比如image/jpeg、audio/mpeg4-generic、video/* 、text/plain等,可以表示图片、音频、视频、文本等不同的媒体格式。
URI:
在Android平台,URI主要分为三个部分:scheme、authority和path,其中authority又分为host和port,格式如下:
scheme://host:port/path
例子:
http://www.baidu.com:80/search/info
content://com.example.project:200/folder/subfolder/etc

2. data的匹配规则

data的匹配规则和action类似,如果过滤规则中定义了data,那么Intent中也必须含有data数据,并且data数据能够完全匹配过滤规则中的某一个data。
Intent设置data的方法有三个,
Intent#setDataAndType(URI, mimeType):
如果要为Intent指定完整的data,必须要调用setDataAndType方法,不能先调用setData方法再调用setType方法,因为这两个方法彼此会清除对方的值。
Intent#setData(URI):
设置URI,把mimeType设置为null。
Intent#setType(mimeType):
设置mimeType,把URI设置为null。

3. data匹配具体情况

data匹配分以下三个情况:
情况1. intent-filter指定了mimeType,无指定URI:

//AndroidManifest.xml
<activity android:name=".ActivityA"
    android:launchMode="standard">
    <intent-filter>
        <action android:name="com.tomorrow.androidtest7.action.a"/>
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="image/*"/>
    </intent-filter>
</activity>

//代码,MainActivity
private void initView() {
    mMain_btn = (Button)findViewById(R.id.main_btn);
    mMain_btn.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            Intent intent = new Intent();
            intent.setAction("com.tomorrow.androidtest7.action.a");
            intent.setType("image/png");
            startActivity(intent);
        }
    });
}

情况2. intent-filter指定了URI,无指定mimeType:

//AndroidManifest.xml
<activity android:name=".ActivityA"
    android:launchMode="standard">
    <intent-filter>
        <action android:name="com.tomorrow.androidtest7.action.a"/>
        <category android:name="android.intent.category.DEFAULT" />
        <data android:scheme="tomorrow"/>
    </intent-filter>
</activity>

//代码,MainActivity
private void initView() {
    mMain_btn = (Button)findViewById(R.id.main_btn);
    mMain_btn.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            Intent intent = new Intent();
            intent.setAction("com.tomorrow.androidtest7.action.a");
            intent.setData(Uri.parse("tomorrow://test"));
            startActivity(intent);
        }
    });
}

情况3. intent-filter指定了两组data规则:

//AndroidManifest.xml
<activity android:name=".ActivityA"
    android:launchMode="standard">
    <intent-filter>
        <action android:name="com.tomorrow.androidtest7.action.a"/>
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="text/plain" android:scheme="file" />
        <data android:mimeType="audio/*" android:scheme="tomorrow" />
    </intent-filter>
</activity>

//代码,MainActivity
private void initView() {
    mMain_btn = (Button)findViewById(R.id.main_btn);
    mMain_btn.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            //Intent intent = new Intent(MainActivity.this, ActivityA.class);

            //方式1
            //Intent intent = new Intent();
            //intent.setAction("com.tomorrow.androidtest7.action.a");
            //intent.setDataAndType(Uri.parse("file://test"), "text/plain");
            //startActivity(intent);

            //方式2
            Intent intent = new Intent();
            intent.setAction("com.tomorrow.androidtest7.action.a");
            intent.setDataAndType(Uri.parse("tomorrow://test"), "audio/*");
            startActivity(intent);
        }
    });
}

五、通过Intent查询Activity

通过隐式方式启动一个Activity的时候,可以先做一个判断,看是否有Activity能够匹配我们的隐式Intent。
判断方法有三种:
方法1:PackageManager#resolveActivity
public abstract ResolveInfo resolveActivity(Intent intent, int flags)
功能:返回给定条件的ResolveInfo对象(本质上是Activity)。
第一个参数intent:查询条件。
第二个参数flags:我们要使用MATCH_DEFAULT_ONLY这个标记位,这个标记位的含义是仅仅匹配那些在intent-filter中声明了"android.intent.category.DEFAULT"这个category的Activity。如果不使用这个标记位,那么intent-filter中那些不含"android.intent.category.DEFAULT"这个category的Activity也能匹配,从而导致startActivity可能失败。因为不含"android.intent.category.DEFAULT"这个category的Activity是无法接收隐式Intent的。

//代码,MainActivity
private void initView() {
    mMain_btn = (Button)findViewById(R.id.main_btn);
    mMain_btn.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            Intent intent = new Intent();
            intent.setAction("com.tomorrow.androidtest7.action.a");
            intent.setDataAndType(Uri.parse("tomorrow://test"), "audio/*");

            ResolveInfo resolveInfo = getPackageManager().resolveActivity(intent, PackageManager.MATCH_DEFAULT_ONLY);
            if(resolveInfo != null) {
                Log.d("MainActivity", "zwm, packageName: " + resolveInfo.activityInfo.packageName);
                Log.d("MainActivity", "zwm, className: " + resolveInfo.activityInfo.name);
                startActivity(intent);
            }
        }
    });
}

方法2:PackageManager#queryIntentActivities
public abstract List<ResolveInfo> queryIntentActivities(Intent intent, int flags)
功能 :返回给定条件的所有ResolveInfo对象(本质上是Activity),集合对象。
参数同上。

//代码,MainActivity
private void initView() {
    mMain_btn = (Button)findViewById(R.id.main_btn);
    mMain_btn.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            Intent intent = new Intent();
            intent.setAction("com.tomorrow.androidtest7.action.a");
            intent.setDataAndType(Uri.parse("tomorrow://test"), "audio/*");

            List<ResolveInfo> resolveInfoList = getPackageManager().queryIntentActivities(intent, PackageManager.MATCH_DEFAULT_ONLY);
            if(resolveInfoList != null) {
                for(ResolveInfo resolveInfo : resolveInfoList) {
                    Log.d("MainActivity", "zwm, packageName: " + resolveInfo.activityInfo.packageName);
                    Log.d("MainActivity", "zwm, className: " + resolveInfo.activityInfo.name);
                }
                startActivity(intent);
            }
        }
    });
}

方法3:Intent#resolveActivity
public ComponentName resolveActivity(PackageManager pm)
功能:返回给定条件的ComponentName对象。

//Intent#resolveActivity:
public ComponentName resolveActivity(PackageManager pm) {
    if (mComponent != null) {
        return mComponent;
    }

    ResolveInfo info = pm.resolveActivity(
        this, PackageManager.MATCH_DEFAULT_ONLY);
    if (info != null) {
        return new ComponentName(
                info.activityInfo.applicationInfo.packageName,
                info.activityInfo.name);
    }

    return null;
}
//代码,MainActivity
private void initView() {
    mMain_btn = (Button)findViewById(R.id.main_btn);
    mMain_btn.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            Intent intent = new Intent();
            intent.setAction("com.tomorrow.androidtest7.action.a");
            intent.setDataAndType(Uri.parse("tomorrow://test"), "audio/*");

            ComponentName componentName = intent.resolveActivity(getPackageManager());
            if(componentName != null) {
                Log.d("MainActivity", "zwm, packageName: " + componentName.getPackageName());
                Log.d("MainActivity", "zwm, className: " + componentName.getClassName());
                startActivity(intent);
            }
        }
    });
}

六、特殊action和category

在action和category中,有一类action和category比较特殊,

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

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

七、Service和BroadcastReceiver的IntentFilter匹配规则

Activity的IntentFilter匹配规则对于Service和BroadcastReceiver是同样的道理,不过系统对于Service的建议是尽量使用显示调用方式来启动服务。
另外,针对Service和BroadcastReceiver,PackageManager同样提供了类似的方法来获取成功匹配的组件信息。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,189评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,577评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,857评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,703评论 1 276
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,705评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,620评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,995评论 3 396
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,656评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,898评论 1 298
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,639评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,720评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,395评论 4 319
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,982评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,953评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,195评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,907评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,472评论 2 342