Android---获取来自Activity的结果

本文译自：http://developer.android.com/training/basics/intents/result.html

启动另外一个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权限。