6.2 Intent对象
上一节介绍了Intent的主要作用就是封装和传递各种信息。那么Intent对象到底可以封装和传递哪些信息呢?本节将会揭开这些秘密。
6.2.1 Intent对象可以封装和传递哪些信息
Intent对象可以封装和传递如下6种信息。
组件名(Component name)。
动作(Action)。
种类(Category)。
数据(Data)。
附加信息(Extra)。
标志(Flags)。
在6.2.1至6.2.7小节会分别介绍这6种信息,并从6.4节开始提供大量的案例演示在Android应用中如何使用这些信息。
6.2.2 组件名(Component name)
Intent对象可以直接指定要访问的组件,例如,有一个名为MyActivity的窗口类,可以使用下面的代码指定该窗口类。
// 下面的代码在窗口类中调用,this就是Context对象
Intent intent = new Intent(this, MyActivity.class);
直接指定窗口类的class只是其中最常用的引用方式,除此之外,还有如下3个方法可以指定具体的窗口。
setClass:指定Context对象和窗口类的class。与通过Intent类的构造方法传递信息的作用是一样的。
setClassName:指定Context对象、字符串形式的包名和窗口类名。
setComponent:与setClassName方法类似,只是要传递的数据都封装在了ComponentName对象中。
1.setClass方法
setClass方法的原型如下:
public Intent setClass(Context packageContext, Class<?> cls)
该原型与下面的Intent类构造方法的一个重载形式是完全一样的。
public Intent(Context packageContext, Class<?> cls)
从setClass方法及Intent类的构造方法原型可以看出,这两个方法是完全等效的,也就是不想在Intent类的构造方法传递信息,也可以使用Intent.setClass方法完成同样的工作。
Intent intent1 = new Intent(this, MyActivity.class);
//下面两行代码等价与上面的一行代码(intent1和intent2封装的信息是相同的)
Intent intent2 = new Intent();
intent2.setClass(this, MyActivity.class);
2.setClassName方法
setClassName方法允许直接指定具体的应用程序和组件类(窗口类、服务类等)的全名。该方法有如下两个重载形式。
public Intent setClassName(Context packageContext, String className)
public Intent setClassName(String packageName, String className)
由于Android应用不能像Windows程序一样直接执行可执行文件,所以需要使用Android应用的唯一索引PackageName定位某个具体的程序,这也是packageName参数的值。而packageContext允许以另外一种形式定位应用程序,这就是应用程序的Context对象(上下文对象),在6.4节中会学习如何来获得当前和其他应用程序的Context对象。className参数表示类的全名(记住,是PackageName+ClassName,不能只指定类名)。
3.setComponent方法
setComponent方法通过ComponentName对象指定PackageName、ClassName等信息,该方法的原型如下:
public Intent setComponent(ComponentName component)
使用setComponent方法之前先要创建ComponentName对象,在6.4节中会详细介绍setComponent方法及ComponentName对象的使用方法。
6.2.3 动作(Action)
一般会通过窗口类的class或窗口类的全名确定某个具体的窗口,不过这些信息都是窗口的固有属性。然而还有第3种确定窗口的方法,这就是窗口动作(Activity Action)。如果用一句话解释什么是Activity Action,那就是“与窗口绑定的一个或多个字符串”,也就是说Activity Action是一个字符串,而且一个窗口可以拥有多个这样的字符串。其实Activity Action在前面的章节虽然未专门讲解,但已经多次涉及了。每次建立Android工程时都会自动创建一个主窗口,该窗口通常会在AndroidManifest.xml文件中有如下的声明代码。其中<action>标签的android:name属性值android.intent.action.MAIN就是一个系统提供的Activity Action。一旦应用程序启动,Android系统就会寻找要运行的Android应用中定义了该Activity Action的窗口,一旦找到,就会显示该窗口。
<activityandroid:name=".MyActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
尽管一个窗口可以有多个Activity Action,但只能通过Intent.setAction方法设置一个Activity Action。如果指定的Activity Action并不存在,当显示窗口时(调用startActivity方法)就会抛出异常。例如,我们可以通过如下的代码指定一个Activity Action,并显示定义该Activity Action的窗口,如果系统中有多个窗口定义了该Activity Action,会显示一个选择列表,列表中显示了所有定义该Activity Action窗口,用户可以选择显示哪个窗口。
// 通过Intent对象指定了一个Activity Action
Intent intent = new Intent(“mobile.android.android.MYACTION”);
// 如果系统中没有定义mobile.android.android.MYACTION的窗口,执行下面的代码会抛出异常
startActivity(intent);
如果用户不想通过Intent类的构造方法指定Activity Action,也可以通过Intent.setAction方法指定Action,代码如下:
Intent intent = new Intent();
intent.setAction(“mobile.android.android.MYACTION”);
startActivity(intent);
系统应用也有很多窗口定义了Activity Action,这些Activity Action可以调用Android系统内置应用中的窗口。例如,照相机拍照界面、拨号界面等。虽然可以直接用字符串指定这些系统的Activity Action,但为了兼容(Android的后续版本又可以修改系统窗口的Activity Action),应尽量使用在Intent类中定义的Action常量(以ACTION_开头的都是Action常量)。这些常量包括Activity Action和Broadcast Action,系统未定义Service Action。直接在代码编辑器中输入“Intent.”就会看到所有的Action常量,如图6-1所示。
▲图6-1 Action常量
6.2.4 种类(Category)
在这里先给大家提个问题,如果系统中有多个窗口(不同应用程序中的窗口)定义了同一个Action,而且自己编写的程序中也定义了这个Activity Action。这样如果通过Intent.setAction方法设置这个Action后显示窗口,就会首先显示一个选择列表,列出了所有定义该Activity Action的窗口。那么在调用自己编写的程序中定义了该Activity Action的窗口时不想显示这个选择列表,而只显示自己应用中的窗口又该如何做呢?
其实解决上述问题也很简单,就像文件和文件夹的关系一样,如果想在磁盘上存储多个同名的文件,又不发生冲突的方法就是将这些文件放到不同的文件夹下。那么Action也是一样。如果单凭Action无法定位唯一的窗口,那就要再加一个可以定位的标志,这就是种类(Category)。
Category实际上与Action一样,也是与窗口绑定的字符串。在声明主窗口时<category>标签的android:name属性值指定的就是Category。如果声明窗口时同时指定了Action和Category,那么在显示窗口之前不仅要使用Intent.setAction方法设置Action,还要使用Intent.addCategory方法添加Category。对于Intent对象来说,Action与Category的不同之处在于只能为Intent对象指定一个Action,而Category可以指定多个(从方法名setAction和addCategory就可以很容易猜到)。
Category也可以和Action一样任意指定字符串。在Intent类中同样定义了一些系统的Category常量,如图6-2所示。
同时设置Action和Category的Java代码如下:
Intent intent = new Intent();
// 设置Action
intent.setAction("mobile.android.action.MYACTION");
// 设置Category
intent.addCategory(“mobile.android.category.MYCATEGORY);
▲图6-2 Category 常量
通过指定系统的Action和Category可以实现很多有趣的东西,例如,在上一章介绍的调用系统窗口就是其中之一。读者可以在学习完这一章的内容后再回过头来复习上一章的内容,会有更深的体会。
6.2.5 数据(Data)
Data与Action、Category并称为Android组件的3大过滤机制(将在6.6节详细介绍)。但Data与后两者不同的是并不是简单地通过字符串对比的方式进行匹配,而是按着一定规则进行匹配。实际上,Data本身又分为两种方式进行匹配:MIME Type和URI。
MIME Type就是指要访问的组件处理的数据类型,例如video/mpeg4、video/mp4、video/avi等。MIME Type也可以用通配符(*)匹配某一类型的数据,例如“audio/ *”表示所有的音频数据格式。
URI有些类似我们经常使用的Web地址,但要比Web地址范围更广,例如,下面的3行字符串都属于URI。
http://www.google.com
content://mobile.android.data/cities
ftp://192.168.17.168
设置MIME Type和URI可以由下面几个方法完成,通过这些方法可以单独设置这两个值,也可以同时设置这两个值。
1.setType方法
该方法的原型如下:
public Intent setType(String type)
setType方法用于设置MIME Type,并且在设置后会将Uri清除,这一点从setType方法的源代码很容易看出。
public Intent setType(String type)
{
// mData字段用于保存Uri,直接将该字段设为null了,也就是说前面设置的Uri将被清空
mData = null;
mType = type;
return this;
}
下面的代码使用setType方法设置了MIME Type。
Intent intent = new Intent();
intent.setType("audio/ *");
2.setTypeAndNormalize(String type)方法
该方法的原型如下:
public Intent setTypeAndNormalize(String type)
setTypeAndNormalize与setType的功能类似,也用于设置MIME Type,并且将Uri清空。但setTypeAndNormalize方法还可以规范MIME Type。例如,如果MIMI Type设为“text/plain; charset=utf-8”,就会将后面的非MIMI Type部分去掉,变成“text/plain”。该方法还可以使MIMI Type的写法看起来更标志,例如会将“text/x-vCard”变成“text/x-vcard”。
其实setTypeAndNormalize只是调用了Intent.normalizeMimeType方法对MIMI Type进行规范处理。setTypeAndNormalize方法的代码如下:
public Intent setTypeAndNormalize(String type)
{
// normalizeMimeType方法用于规范Mime Type
return setType(normalizeMimeType(type));
}
3.setData方法
该方法的原型如下:
public Intent setData(Uri data)
setData方法用于设置Uri,并且会清空MIMI Type。setData方法的代码如下:
public Intent setData(Uri data)
{
mData = data;
// mType保存MIME Type
mType = null;
return this;
}
下面的代码设置了一个Uri。
Intent intent = new Intent();
intent.setData(Uri.parse("http://192.168.17.168/process"));
4.setDataAndNormalize方法
该方法的原型如下:
public Intent setDataAndNormalize(Uri data)
setDataAndNormalize与setData的功能类似,只是会将scheme变成小写形式。scheme就是指Uri开始的部分(冒号以前的部分),例如,http://www.google.com中的http就是scheme。假设有一个Uri:HTTP://www.google.com,setDataAndNormalize方法会将该Uri变成http://www.google.com。
5.setDataAndType方法
该方法用于同时设置Uri和MIME Type,原型如下:
public Intent setDataAndType(Uri data, String type)
下面的代码同时设置了Uri和MIME Type。
Intent intent = new Intent();
intent.setDataAndType(Uri.parse("http://192.168.17.168/process"),"audio/ *");
6.setDataAndTypeAndNormalize方法
该方法用于同时设置Uri和MIME Type,并且将Uri和MIME Type标准化,该方法的原型如下:
public Intent setDataAndTypeAndNormalize(Uri data, String type)
6.2.6 附加数据(Extra)
Extra就是一些Key-Value数据对。这些数据通过Intent类提供的具有多个重载形式的putExtra方法设置。例如,下面是putExtra方法的一些常用的重载形式。
// 设置字符串
public Intent putExtra(String name, String value)
// 设置整数
public Intent putExtra(String name, int value)
// 设置浮点数
public Intent putExtra(String name, float value)
// 设置实现Parcelable接口的对象
public Intent putExtra(String name, Parcelable value)
尽管通过Data可以向要访问的组件传递一些数据,但对于数据量较大或需要将数据进行划分时应使用Extra。有很多系统的Action需要提供附加信息,例如ACTION_TIMEZONE_CHANGED就需要一个名为time-zone的附加信息,所以在使用该ACTION时需要使用下面的代码设置附加信息。
intent.putExtra("time-zone",java.util.TimeZone.getDefault());
如果想知道哪一个系统Action需要传递附加信息,可以通过Content Assist(内容助手)来查询。例如,要查询ACTION_TIMEZONE_CHANGED需要哪些附加信息,首先要找到该Action,然后选中该Action,就会在下方显示该Action的详细信息,如图6-3所示的黑框中就是该Action需要的附加信息。
▲图6-3 显示Action 需要哪些附加信息
6.2.7 标志(Flags)
Flags和前几种Intent对象封装的信息都不同。Flags既不会定位窗口,也不会向窗口传递数据,Flags只用来控制窗口显示行为。这里涉及任务(Task)和回退栈(Back Stack)的概念。这一部分内容会在7.2节详细讨论。在本章读者只要知道通过Intent对象可以完成如下3项工作即可。
定位窗口:通过Component name、Action、Category和Data可以定位一个或多个窗口。
传递数据:通过Data和Extra。
控制访问组件的行为(窗口、服务和广播):通过Flags。