《Android 应用案例开发大全（第二版）》——6.2节Intent对象

本节书摘来自异步社区《Android 应用案例开发大全（第二版）》一书中的第6章，第6.2节Intent对象，作者李宁，更多章节内容可以访问云栖社区“异步社区”公众号查看

6.2 Intent对象
Android开发权威指南(第二版)
上一节介绍了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应用的唯一索引PackageName1定位某个具体的程序，这也是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，那就是“与窗口2绑定的一个或多个字符串”，也就是说Activity Action是一个字符串，而且一个窗口可以拥有多个这样的字符串。其实Activity Action在前面的章节虽然未专门讲解，但已经多次涉及了。每次建立Android工程时都会自动创建一个主窗口，该窗口通常会在AndroidManifest.xml文件中有如下的声明代码。其中标签的android:name属性值android.intent.action.MAIN就是一个系统提供的Activity Action。一旦应用程序启动，Android系统就会寻找要运行的Android应用中定义了该Activity Action的窗口3，一旦找到，就会显示该窗口。

<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.2.4　种类（Category）
在这里先给大家提个问题，如果系统中有多个窗口（不同应用程序中的窗口）定义了同一个Action，而且自己编写的程序中也定义了这个Activity Action。这样如果通过Intent.setAction方法设置这个Action后显示窗口，就会首先显示一个选择列表，列出了所有定义该Activity Action的窗口。那么在调用自己编写的程序中定义了该Activity Action的窗口时不想显示这个选择列表，而只显示自己应用中的窗口又该如何做呢？

其实解决上述问题也很简单，就像文件和文件夹的关系一样，如果想在磁盘上存储多个同名的文件，又不发生冲突的方法就是将这些文件放到不同的文件夹下。那么Action也是一样。如果单凭Action无法定位唯一的窗口，那就要再加一个可以定位的标志，这就是种类（Category）。

Category实际上与Action一样，也是与窗口绑定的字符串。在声明主窗口时标签的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);

通过指定系统的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.2.7　标志（Flags）
Flags和前几种Intent对象封装的信息都不同。Flags既不会定位窗口，也不会向窗口传递数据，Flags只用来控制窗口显示行为。这里涉及任务（Task）和回退栈（Back Stack）的概念。这一部分内容会在7.2节详细讨论。在本章读者只要知道通过Intent对象可以完成如下3项工作即可。

定位窗口：通过Component name、Action、Category和Data可以定位一个或多个窗口。
传递数据：通过Data和Extra。
控制访问组件的行为（窗口、服务和广播）：通过Flags。
1就是AndroidManifest.xml文件中标签的package属性值。
2不仅窗口、服务和广播接收器也可以与多个字符串进行绑定，由于本章主要介绍窗口的基础知识，所以本章的大多数地方只提到了窗口，但读者要清楚一点，除非特别提到，否则后面章节介绍的服务和广播接收器也拥有同样的特性。关于如何将字符串与窗口绑定，会在本章后面的部分详细介绍。
3当然，除了要有android.intent.action.MAIN外，还需要定义一个叫android.intent.category.LAUNCHER的category。这部分内容会在本章后面的部分介绍。`