启动另外一个Activity并不都是单向的,你也可以启动另外一个Activity,并接受被启动的Activity所返回的结果,这需要调用startActivityForResult()方法,而不是startActivity()方法。
例如,你的应用程序可以启动一个Camera应用程序,并把该应用程序拍摄的照片作为结果来接收。或者为了让用户选择联系人,你可以启动People应用程序,并且把联系人细节作为结果来接收。
当然,响应请求的Activity必须要比设计成能够返回一个结果。在返回结果时,它会把结果作为一个Intent对象来发送。你的Activity在onActivityResult()回调方法中接收这个对象。
注意:在调用startActivityForResult()方法时,你可以使用明确的或隐含的Intent对象。当你要启动的Activity是你自己的定义Activity时,你应该使用明确的Intent对象,以便确保你能够接收到期望的结果。
启动Activity
有关用于能够启动返回结果的Activity的Intent对象,没有特殊的要求,但是你需要把一个附加的整数参数传递给startActivityForResult()方法。
这个整数参数是一个标识你的请求的请求代码。当你接收到Intent对象时,回调方易做图提供相同的请求代码,以便你的应用程序能够正确识别结果,并判定如何处理它。
例如,以下代码启动了一个允许用户选择联系人的Activity:
staticfinalint PICK_CONTACT_REQUEST =1; // The request code
...
private void pickContact() {
Intent pickContactIntent = new Intent(Intent.ACTION_PICK, new Uri("content://contacts"));
pickContactIntent.setType(Phone.CONTENT_TYPE); // Show user only contacts w/ phone numbers
startActivityForResult(pickContactIntent, PICK_CONTACT_REQUEST);
}
接收结果
当用户使用完被启动的Activity并返回时,系统会调用你的Activity的onActivityResult()方法,这个方法包括三个参数:
1. 你传递给startActivityForResult()方法的请求代码;
2. 由第二个Activity指定的结果代码。如果操作成功,它是RESULT_OK,如果用户退出或因为某些原因让操作失败,则是RESULT_CANCELED.
3. 一个携带结果数据的Intent对象。
例如,以下代码处理选取联系人Intent对象的结果:
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
// Check which request we're responding to
if (requestCode == PICK_CONTACT_REQUEST) {
// Make sure the request was successful
if (resultCode == RESULT_OK) {
// The user picked a contact.
// The Intent's data Uri identifies which contact was selected.
// Do something with the contact here (bigger example below)
}
}
}
在这个例子中,从Android的Contacts或People应用程序中返回的Intent对象提供了一个标识用户选择的联系人的内容Uri。
为了能够成功的处理返回结果,你必须了解被返回的Intent对象的格式。当返回的结果是有你自己的Activity提供的时候,做这件事就很容易。Android平台的应用程序都提供了它们自己的API来从返回的Intent对象中获取具体的结果数据。例如,People应用程序(某些较旧版本上的Contacts应用程序)总是返回标识用户选择的联系人的内容URI,并且Camera应用会在“data”附加字段中返回一个Bitmap对象。
读取联系人数据
以上代码介绍了如何获取来自People应用程序的返回结果,但没有详细的介绍如何从返回结果中读取数据,因为它需要讨论一些更高级的有关content Providers的话题。以下代码会告诉你如何查询结果数据,从而获取用户选择的联系人的电话号码:
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
// Check which request it is that we're responding to
if (requestCode == PICK_CONTACT_REQUEST) {
// Make sure the request was successful
if (resultCode == RESULT_OK) {
// Get the URI that points to the selected contact
Uri contactUri = data.getData();
// We only need the NUMBER column, because there will be only one row in the result
String[] projection = {Phone.NUMBER};
// Perform the query on the contact to get the NUMBER column
// We don't need a selection or sort order (there's only one result for the given URI)
// CAUTION: The query() method should be called from a separate thread to avoid blocking
// your app's UI thread. (For simplicity of the sample, this code doesn't do that.)
// Consider using CursorLoader to perform the query.
Cursor cursor = getContentResolver()
.query(contactUri, projection, null, null, null);
cursor.moveToFirst();
// Retrieve the phone number from the NUMBER column
int column = cursor.getColumnIndex(Phone.NUMBER);
String number = cursor.getString(column);
// Do something with the phone number...
}
}
}
注意:在Android2.3(API Level 9)之前,执行基于Contacts提供器的查询,会要求你的应用程序声明READ_CONTACTS权限。但是,从Android2.3开始,Contacts/People应用程序会给你的应用程序授予一个临时权限,以便能够从Contacts提供器中获取被返回的数据。这个临时权限仅适用于具体的请求的联系人,因此你不能使用这个返回结果来查询由Intent的Uri指定的联系人以外的数据,除非你声明了READ_CONTACTS权限