Android开发权威指南(第二版)
上QQ阅读APP看书,第一时间看更新

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就是AndroidManifest.xml文件中<manifest>标签的package属性值。定位某个具体的程序,这也是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的窗口当然,除了要有android.intent.action.MAIN外,还需要定义一个叫android.intent.category.LAUNCHER的category。这部分内容会在本章后面的部分介绍。,一旦找到,就会显示该窗口。

<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。