转自http://flysnow.javaeye.com/blog/961576 飞雪无情原创
在正式介绍Intent之前,我们先看下上面说的Activity、Service和Broadcast Receiver是怎样传递Intent。对于这三个组件而言,他们都有自己独立的传递Intent的机制:
消息之间的传递是没有重叠的,比如调用startActivity()传播一个Intent,只会传播给Activity,而不会传播给Service和Broadcast Receiver,反过来也是这样的。
一个Intent对象包含了很多数据的信息,比如要执行的动作,类别,数据,附加信息等等,下面就一一列列出一个Intent中包含的信息。
这个组件名称字段其实就是一个ComponentName类,它包含了一个目标组件的全限定名,比如com.flysnow.intent.Activity1,这就是一个全限定名的Activity。组件名字可以通过setComponent()、setClass()或者setClassName()设置,如果设置了Intent目标组件的名字,那么这个Intent就会被传递给特定的组件,也就是我们说的显式Intent.如果不设置,则是隐式的Intent,Android系统将根据Intent Filter中的信息进行匹配.
一个Intent的Action在很大程度上说明这个Intent要做什么,是查看(View)、删除(Delete)、编辑(Edit)等等。Action一个字符串命名的动作,Android中预定义了很多Action,可以参考Intent类查看,下面是文档中的几个动作
当然,我们也可以自定义Action,比如com.flysnow.intent.ACTION_ADD,定义Action的时候最好能表明意思,要做什么,这样我们的Intent中的数据才好填充。Intent对象的getAction()可以获取动作,使用setAction()可以设置动作。
Data,其实就是一个URI,用于执行一个Action时所用到的数据的URI和MIME。不同的Action有不同的数据规格,比如ACTION_EDIT动作,数据就可以能包含一个用于编辑文档的URI,如果是一个ACTION_CALL动作,那么数据就是一个包含了tel:6546541的数据字段,所以上面提到的自定义Action时要规范命名。数据的URI和类型对于Intent的匹配是很重要的,Android往往根据数据的URI和MIME找到能处理该Intent的最佳目标组件。
Category指定了用于处理Intent的组件的类型信息,一个Intent可以添加多个Category,使用addCategory()方法即可,使用removeCategory()删除一个已经添加的类别。Android的Intent类里定义了很多常用的类别,可以参考使用。
有些用于处理Intent的目标组件需要一些额外的信息,那么就可以通过Intent的put..()方法把额外的信息塞入到Intent对象中,用于目标组件的使用,一个附件信息就是一个key-value的键值对..Intent有一系列的put和get方法用于处理附加信息的塞入和取出。
Android有很多标识,用于标记如何启动一个活动,是NEW_TASK还是其他等等,以及启动后怎么对待这个活动。。可以参考Intent类中的FLAG常量字段。
介绍完了Intent对象的构成,就要介绍Android系统是怎样解析Intent的,Android是怎么传递Intent到目标组件的呢?
Intent可以分为两类,一类是显式的Intent,一类是隐式的Intent,上面有过提及。显示的Intent就是指定了组件名字的,隐式的就是没有指定Intent的组件名字,需要Android根据Intent中的Action、data、Category等来解析匹配。而目标组件(Activity、Service、Broadcast Receiver)怎通过设置他们的Intent Filter来界定其处理的Intent。如果一个组件没有定义Intent Filter,那么它只能接受处理显示的Intent,只有定义了Intent Filter的组件才能同时处理隐式和显示的Intent。
为了对Action的作用进行检测,我们使用一个例子来演示Action的作用。项目名为Intents,应用名为Intents and Filters,运行在Android2.2版本上.主启动Activity为IntentsTestList
1.IntentsTestList代码如下:
/** * Intents测试列表类 * @author 飞雪无情 * @since 2011-3-14 */ public class IntentsTestList extends ListActivity { private String ACTION_VIEW="com.flysnow.intent.ACTION_VIEW"; /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); //定义ListAdapter setListAdapter(new SimpleAdapter(this, getData(), android.R.layout.simple_list_item_1, new String[] { "title" },new int[] {android.R.id.text1})); getListView().setTextFilterEnabled(true); //注册一个广播 super.registerReceiver(new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { Toast.makeText(context, "该Broadcast的Intent Filter值只设置了Action", Toast.LENGTH_SHORT).show(); } },new IntentFilter(ACTION_VIEW)); } @Override protected void onListItemClick(ListView l, View v, int position, long id) { Intent intent=(Intent)getData().get(position).get("intent"); Boolean isActivity=(Boolean)getData().get(position).get("isActivity"); if(isActivity){ startActivity(intent); }else{ sendBroadcast(intent); } } /** * 返回ListView需要的数据 * @return ListView需要的数据 */ private List<Map<String,Object>> getData() { List<Map<String,Object>> data=new ArrayList<Map<String,Object>>(); addItem(data, "空Action的Activity", new Intent(),true); addItem(data, "Action检测-Activity", new Intent(ACTION_VIEW),true); addItem(data, "Action检测-Broadcast", new Intent(ACTION_VIEW),false); return data; } /** * 给ListView添加数据 * @param data 存储数据的List * @param name 要显示的Title * @param intent 单击某一项时要启动的Activity * @param isActivity 启动的是否是Activity,true是,false为广播 */ private void addItem(List<Map<String,Object>> data, String name, Intent intent,boolean isActivity) { Map<String, Object> temp = new HashMap<String, Object>(); temp.put("title", name); temp.put("intent", intent); temp.put("isActivity", isActivity); data.add(temp); } }
这里主要是使用ListActivity列出3个测试,一个测试空的Intent,一个测试只有Action的Intent--Activity版,一个测试只有Action的Intent--Broadcast版。。。
1.为了测试startActivity(),我们新建一个Activity名字为ActionActivity代码如下:
/** * @author 飞雪无情 * @since 2011-3-14 */ public class ActionActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); TextView text=new TextView(this); text.setText("该Activity的Intent Filter值只设置了Action"); setContentView(text); } }
很简单,只有一段文本的展示。
3.AndroidManifest.xml修改如下:
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.flysnow.intent" android:versionCode="1" android:versionName="1.0"> <uses-sdk android:minSdkVersion="8" /> <application android:icon="@drawable/icon" android:label="@string/app_name"> <activity android:name=".IntentsTestList" android:label="@string/app_name"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <activity android:name=".ActionActivity" android:label="Action检测"> <intent-filter> <action android:name="com.flysnow.intent.ACTION_VIEW"></action> <action android:name="android.intent.action.VIEW"></action> <category android:name="android.intent.category.DEFAULT"></category> </intent-filter> </activity> </application> </manifest>
很简单,为我们的ActionContext加上了两个action标签和一个category标签,加category标签设置成android.intent.category.DEFAULT是为了让这个Activity可以接收隐式的Intent请求,这是Android规定的,对于Activity,使用Context.startActivity()传递隐式Intent,默认是包含了android.intent.category.DEFAULT的,所以定义的Activity要想接收,必须在Intent Filter里添加android.intent.category.DEFAULT这个Category。
4.运行入下图:
当点击“空Action的Activity”的时候,会报异常,因为Intent什么都没有设置,没有任何的Activity能处理它 。当点击“Action检测-Activity”的时候会打开我们的ActionActivity这个Activity,点击“Action检测-Broadcast”会弹出Toast提示,说明已经被接收到。。从上面我们可以看出,当Intent设置了Action时,只要对应的组件的Intent Filter中包含该Action的定义,那么这个组件就会接收该Intent。。。
类别在<intent-filter>中是通过<category>标记定义的,Category和Action一样,他们的名字都是一个字符串定义,但是我们在代码中可以使用对应的类别常量,在xml文件定义中只能使用定义好的字符串。Android的Intent类中提供了很多内置的类别定义,一中类别代表一个意思,可以参考说明使用。。比如android.intent.category.LAUNCHER标表示你的应用会展示在启动列表页面,经常和android.intent.action.MAIN搭配使用
下面通过一个例子来说明Category的检测,项目名为Intents,应用名为Intents and Filters,运行在Android2.2版本上.主启动Activity为IntentsTestList。
IntentsTestList代码如下:
/** * Intents测试列表类 * @author 飞雪无情 * @since 2011-3-14 */ public class IntentsTestList extends ListActivity { private String ACTION_VIEW="com.flysnow.intent.ACTION_VIEW"; private String CATEGORY_MAN="com.flysnow.intent.CATEGORY_MAN"; private String CATEGORY_SHOP="com.flysnow.intent.CATEGORY_SHOP"; /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); //定义ListAdapter setListAdapter(new SimpleAdapter(this, getData(), android.R.layout.simple_list_item_1, new String[] { "title" },new int[] {android.R.id.text1})); getListView().setTextFilterEnabled(true); filter.addCategory(CATEGORY_MAN); //注册一个广播 super.registerReceiver(new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { Toast.makeText(context, "该Broadcast的Intent Filter设置了Category和Action", Toast.LENGTH_SHORT).show(); } },filter); } @Override protected void onListItemClick(ListView l, View v, int position, long id) { Intent intent=(Intent)getData().get(position).get("intent"); Boolean isActivity=(Boolean)getData().get(position).get("isActivity"); if(isActivity){ startActivity(intent); }else{ sendBroadcast(intent); } } /** * 返回ListView需要的数据 * @return ListView需要的数据 */ private List<Map<String,Object>> getData() { List<Map<String,Object>> data=new ArrayList<Map<String,Object>>(); addItem(data, "1个Category检测-Activity", new Intent(ACTION_VIEW).addCategory(CATEGORY_MAN),true); addItem(data, "1个Category检测-Broadcast", new Intent(ACTION_VIEW).addCategory(CATEGORY_MAN),false); addItem(data, "2个Category检测-Activity", new Intent(ACTION_VIEW).addCategory(CATEGORY_MAN).addCategory(CATEGORY_SHOP),true); return data; } /** * 给ListView添加数据 * @param data 存储数据的List * @param name 要显示的Title * @param intent 单击某一项时要启动的Activity * @param isActivity 启动的是否是Activity,true是,false为广播 */ private void addItem(List<Map<String,Object>> data, String name, Intent intent,boolean isActivity) { Map<String, Object> temp = new HashMap<String, Object>(); temp.put("title", name); temp.put("intent", intent); temp.put("isActivity", isActivity); data.add(temp); } private IntentFilter filter=new IntentFilter(ACTION_VIEW); }
以上代码主要是一个ListView,列出了三个测试项,1个Category的测试和2个Category的测试,注册了一个广播.
为了测试新建了2个Activity,分别是CategoryActivity和Category2Activity,代码如下:
/** * @author 飞雪无情 * @since 2011-3-14 */ public class CategoryActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); TextView text=new TextView(this); text.setText("该Activity的Intent Filter值设置了Action和1个Category,不包含android.intent.category.DEFAULT"); setContentView(text); } }
/** * @author 飞雪无情 * @since 2011-3-14 */ public class Category2Activity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); TextView text=new TextView(this); text.setText("该Activity的Intent Filter值设置了Action和2个Category,不包含android.intent.category.DEFAULT"); setContentView(text); } }
很简单只是一段文字的说明
AndroidManiftest.xml修改如下:
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.flysnow.intent" android:versionCode="1" android:versionName="1.0"> <uses-sdk android:minSdkVersion="8" /> <application android:icon="@drawable/icon" android:label="@string/app_name"> <activity android:name=".IntentsTestList" android:label="@string/app_name"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <activity android:name=".CategoryActivity" android:label="1个Category检测"> <intent-filter> <action android:name="com.flysnow.intent.ACTION_VIEW"></action> <category android:name="android.intent.category.DEFAULT"></category> <category android:name="com.flysnow.intent.CATEGORY_MAN"></category> </intent-filter> </activity> <activity android:name=".Category2Activity" android:label="2个Category检测"> <intent-filter> <action android:name="com.flysnow.intent.ACTION_VIEW"></action> <category android:name="android.intent.category.DEFAULT"></category> <category android:name="com.flysnow.intent.CATEGORY_MAN"></category> <category android:name="com.flysnow.intent.CATEGORY_SHOP"></category> </intent-filter> </activity> </application> </manifest>
为CategoryActivity添加了2个Category,一个是默认的(隐式Intent必须),一个是自定义的。而相应的Category2Activity则有三个Category。
我们运行测试,效果图如下:
当点击“1个Category检测-Activity”的时候,会弹出
这是,因为我们的Intent定义了一个Category,这个Category在CategoryActivity和Category2Activity里都有,都能匹配上,所以就会弹出这两个Activity供我们选择,而当我们单击《2个Category检测-Activity》的时候就会直接打开Category2Activity,这是因为这个选项里的Intent有2个Category,只有Category2Activity才能匹配上。。。通过例子我们可以总结到:Intent中所包含的所有Category必须在一个组件的intent-filter中有定义,一个都不能少,否则不能通过检测。。但是intent-filter的可以有额外的Category .再次提醒: Android对所有传递给 Context.startActivity()的隐式intent至少包含"android.intent.category.DEFAULT"
data标记也是在intent-filter中定义的,大致格式如下:
<intent-filter> <action android:name="android.intent.action.VIEW"></action> <category android:name="android.intent.category.DEFAULT"></category> <data android:mimeType="text/plain"></data> </intent-filter>
每个data定义一个URI和数据类型(MIME),URI由4个属性来定义,分别是android:scheme,android:host,android:port,android:path..这个四个属性构成如下格式的URI: scheme://host:port/path 如:content://com.flysnow.intent:8080/show/view。其中content就是scheme,com.flysnow.intent就是host,8080就是port,show/view就是path...如果有经常使用ContentProvider的应该熟悉。。我们经常定义的authority不就是host+port吗?还有这几个元素都是可选的,但是不是随便用就可以的,port要依赖于host,没有host,port就会被忽略,不起作用,同样,如果要使用host+port(authority)就必须指定scheme。而path则依赖于scheme和authority。。
还有一个很重要的类型就是mimeType,这个属性用于指定内容的类型,也就是这个组件可以处理哪些类型的内容。。如text/plain表示无格式文本类型,mimeType也支持通配符,使用text/*则表示所有文本类型。通过使用它,你可以很方便的开发出关联打开诸如txt文件,pdf文件的应用。后面的两个自理将会演示txt文件查看器,图片查看器的例子。。MIME可以参考http://www.w3school.com.cn/media/media_mimeref.asp。这里有所有的内容类型的定义。。
下面通过一个例子来演示data的检测,项目名为Intents,应用名为Intents and Filters,运行在Android2.2版本上.主启动Activity为IntentsTestList。例子包括以下演示:
- 通过发送intent的方式“打开拨号界面并输入电话123456”。
- 创建一个Text文件阅读器
- 创建一个图片查看器
/** * Intents测试列表类 * @author 飞雪无情 * @since 2011-3-14 */ public class IntentsTestList extends ListActivity { /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); //定义ListAdapter setListAdapter(new SimpleAdapter(this, getData(), android.R.layout.simple_list_item_1, new String[] { "title" },new int[] {android.R.id.text1})); getListView().setTextFilterEnabled(true); } @Override protected void onListItemClick(ListView l, View v, int position, long id) { Intent intent=(Intent)getData().get(position).get("intent"); Boolean isActivity=(Boolean)getData().get(position).get("isActivity"); if(isActivity){ startActivity(intent); }else{ sendBroadcast(intent); } } /** * 返回ListView需要的数据 * @return ListView需要的数据 */ private List<Map<String,Object>> getData() { List<Map<String,Object>> data=new ArrayList<Map<String,Object>>(); addItem(data, "打开拨号界面并输入电话123456", new Intent(Intent.ACTION_DIAL, Uri.parse("tel://123456")), true); return data; } /** * 给ListView添加数据 * @param data 存储数据的List * @param name 要显示的Title * @param intent 单击某一项时要启动的Activity * @param isActivity 启动的是否是Activity,true是,false为广播 */ private void addItem(List<Map<String,Object>> data, String name, Intent intent,boolean isActivity) { Map<String, Object> temp = new HashMap<String, Object>(); temp.put("title", name); temp.put("intent", intent); temp.put("isActivity", isActivity); data.add(temp); } }
新建TextWatcherActivity代码如下:
/** * 显示文本的Activity * @author 飞雪无情 * @since 2011-3-24 */ public class TextWatcherActivity extends Activity { private TextView mTextView; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); mTextView=new TextView(this); setContentView(mTextView); } @Override protected void onStart() { super.onStart(); Intent txtIntent=getIntent(); Uri data=txtIntent.getData(); String txt; try { txt = readTxt(data); } catch (IOException e) { txt="打开txt文件异常"; } mTextView.setText(txt); } /** * 读取txt文本 * @param txtUri * @return * @throws IOException */ private String readTxt(Uri txtUri) throws IOException{ BufferedReader bufferedReader=new BufferedReader(new InputStreamReader(getContentResolver().openInputStream(txtUri),Charset.forName("GBK"))); StringBuilder txt=new StringBuilder(); String buf=""; while((buf=bufferedReader.readLine())!=null){ txt.append(buf).append("/n"); } return txt.toString(); } }
然后在AndroidManifest.xml中加入如下定义:
<activity android:name=".TextWatcherActivity" android:label="查看TXT文件"> <intent-filter> <action android:name="android.intent.action.VIEW"></action> <category android:name="android.intent.category.DEFAULT"></category> <data android:mimeType="text/plain"></data> </intent-filter> </activity>
这样在单击txt文件的时候就可以选择我们的这个Activity对txt文件处理,显示其内容.我们新建一个1.txt文件,写上一些内容,放在我们的sd卡中,使用文件管理工具查看这个txt文件,会弹出如下图的提示,看到我们刚刚做的《TXT阅读器》了吧。
选择“查看TXT文件”,就可以看到我们的txt内容:
新建ImageWatcherActivity,代码如下:
/** * 显示文本的Activity * @author 飞雪无情 * @since 2011-3-24 */ public class ImageWatcherActivity extends Activity { private final String IMAGE_URI_KEY="imageUriKey"; private Uri image; private ImageView mImageView; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); mImageView=new ImageView(this); setContentView(mImageView); } @Override protected void onStart() { super.onStart(); Intent txtIntent=getIntent(); image=txtIntent.getData(); //对于大图片未做优化处理 mImageView.setImageURI(image); } @Override protected void onRestoreInstanceState(Bundle savedInstanceState) { super.onRestoreInstanceState(savedInstanceState); image=savedInstanceState.getParcelable(IMAGE_URI_KEY); mImageView.setImageURI(image); } @Override protected void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); outState.putParcelable(IMAGE_URI_KEY,image); } }
然后在AndroidManifest.xml中加入如下定义:
<activity android:name=".ImageWatcherActivity" android:label="查看图片文件"> <intent-filter> <action android:name="android.intent.action.VIEW"></action> <category android:name="android.intent.category.DEFAULT"></category> <data android:mimeType="image/*"></data> </intent-filter> </activity>
这样在单击图片文件的时候就可以选择我们的这个Activity对txt文件处理并且显示。
对于data的匹配,如果说怎么怎么匹配,在什么情况下通过可能会比较难以理解,这里以一种简单的方式来解说。
假定我们定义的Intent Filter 的data标签为集合A,传递的Intent中包含的data为集合B,当B是A的子集时就通过了(Action和Category也得检测通过)。如果B为空(不配置data),那么A也得为空(不配置data)才能通过 。更详细(繁琐)的介绍请参考doc
Android提供了以Intent的方式调用Android设备的内置Google应用,比如打电话,调用Google浏览器打开网页,搜索等。关于这方便的介绍可以参考Android开发文档《Intents List: Invoking Google Applications on Android Devices》这一节的介绍,很详细。docs/guide/appendix/g-app-intents.html。
Intent是一个很好的设计,它提供了一种在各个组建之间通信的方式,也为我们使用其他的应用的功能提供了可能,这样如果我们想在自己的应用打开一个网页,我们就不用特意迁入一个webview,我们直接调用Android内的浏览器打开即可。。
最后值得一提的是PackageManager这个类中为我们提供了一系列的query...()方法,可以让我们根据我们定义的Intent查询特定的匹配Intent Filter标记的所有组件。。有兴趣的可以研究一下。。