组件 -- 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

    
        
        
        
    


//代码,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

    
        
        
        
    


//代码,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

    
        
        
        
        
    


//代码,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 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 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比较特殊,



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

七、Service和BroadcastReceiver的IntentFilter匹配规则

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

你可能感兴趣的:(组件 -- Activity -- IntentFilter的匹配规则)