接收其他设备的文件

编写:jdneo - 原文:http://developer.android.com/training/beam-files/receive-files.html

Android Beam文件传输将文件拷贝至接收设备上的某个特殊目录。同时使用Android Media Scanner扫描拷贝的文件，并在MediaStore provider中为媒体文件添加对应的条目记录。本课将展示当文件拷贝完成时要如何响应，以及在接收设备上应该如何定位拷贝的文件。

响应请求并显示数据

当Android Beam文件传输将文件拷贝至接收设备后，它会发布一个包含Intent的通知，该Intent拥有：ACTION_VIEW，首个被传输文件的MIME类型，以及一个指向第一个文件的URI。用户点击该通知后，Intent会被发送至系统。为了使我们的应用程序能够响应该Intent，我们需要为响应的Activity所对应的<activity>标签添加一个<intent-filter>标签，在<intent-filter>标签中，添加以下子标签：

<action android:name="android.intent.action.VIEW" />

该标签用来匹配从通知发出的Intent，这些Intent具有ACTION_VIEW这一Action。

<category android:name="android.intent.category.CATEGORY_DEFAULT" />

该标签用来匹配不含有显式Category的Intent对象。

<data android:mimeType="mime-type" />

该标签用来匹配一个MIME类型。仅仅指定那些我们的应用能够处理的类型。

下例展示了如何添加一个intent filter来激活我们的activity：

  1.     <activity
  2.         android:name="com.example.android.nfctransfer.ViewActivity"
  3.         android:label="Android Beam Viewer" >
  4.         ...
  5.         <intent-filter>
  6.             <action android:name="android.intent.action.VIEW"/>
  7.             <category android:name="android.intent.category.DEFAULT"/>
  8.             ...
  9.         </intent-filter>
  10.     </activity>

Note：Android Beam文件传输不是含有ACTION_VIEW的Intent的唯一可能发送者。在接收设备上的其它应用也有可能会发送含有该Action的intent。我们马上会进一步讨论这一问题。

请求文件读权限

要读取Android Beam文件传输所拷贝到设备上的文件，需要请求READ_EXTERNAL_STORAGE权限。例如：

  1. <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

如果希望将文件拷贝至应用程序自己的存储区，那么需要的权限改为WRITE_EXTERNAL_STORAGE，另外，WRITE_EXTERNAL_STORAGE权限包含了READ_EXTERNAL_STORAGE权限。

Note：对于Android 4.2.2（API Level 17）及之前版本的系统，READ_EXTERNAL_STORAGE权限仅在用户选择要读文件时才是强制需要的。而在今后的版本中会在所有情况下都需要该权限。为保证应用程序在未来的稳定性，建议在Manifest清单文件中声明该权限。

由于我们的应用对于自身的内部存储区域具有控制权，因此当要将文件拷贝至应用程序自身的的内部存储区域时，不需要声明写权限。

获取拷贝文件的目录

Android Beam文件传输一次性将所有文件拷贝到目标设备的一个目录中，Android Beam文件传输通知所发出的Intent中含有指向了第一个被传输的文件的URI。然而，我们的应用程序也有可能接收到除了Android Beam文件传输之外的某个来源所发出的含有ACTION_VIEW这一Action的Intent。为了明确应该如何处理接收的Intent，我们要检查它的Scheme和Authority。

可以调用Uri.getScheme()获得URI的Scheme，下例展示了如何确定Scheme并对URI进行相应的处理：

  1. public class MainActivity extends Activity {
  2.     ...
  3.     // A File object containing the path to the transferred files
  4.     private File mParentPath;
  5.     // Incoming Intent
  6.     private Intent mIntent;
  7.     ...
  8.     /*
  9.      * Called from onNewIntent() for a SINGLE_TOP Activity
  10.      * or onCreate() for a new Activity. For onNewIntent(),
  11.      * remember to call setIntent() to store the most
  12.      * current Intent
  13.      *
  14.      */
  15.     private void handleViewIntent() {
  16.         ...
  17.         // Get the Intent action
  18.         mIntent = getIntent();
  19.         String action = mIntent.getAction();
  20.         /*
  21.          * For ACTION_VIEW, the Activity is being asked to display data.
  22.          * Get the URI.
  23.          */
  24.         if (TextUtils.equals(action, Intent.ACTION_VIEW)) {
  25.             // Get the URI from the Intent
  26.             Uri beamUri = mIntent.getData();
  27.             /*
  28.              * Test for the type of URI, by getting its scheme value
  29.              */
  30.             if (TextUtils.equals(beamUri.getScheme(), "file")) {
  31.                 mParentPath = handleFileUri(beamUri);
  32.             } else if (TextUtils.equals(
  33.                     beamUri.getScheme(), "content")) {
  34.                 mParentPath = handleContentUri(beamUri);
  35.             }
  36.         }
  37.         ...
  38.     }
  39.     ...
  40. }

从File URI中获取目录

如果接收的Intent包含一个File URI，则该URI包含了一个文件的绝对文件名，它包括了完整的路径和文件名。对Android Beam文件传输来说，目录路径指向了其它被传输文件的位置（如果有其它传输文件的话），要获得该目录路径，需要取得URI的路径部分（URI中除去“file:”前缀的部分），根据路径创建一个File对象，然后获取这个File的父目录：

  1.     ...
  2.     public String handleFileUri(Uri beamUri) {
  3.         // Get the path part of the URI
  4.         String fileName = beamUri.getPath();
  5.         // Create a File object for this filename
  6.         File copiedFile = new File(fileName);
  7.         // Get a string containing the file's parent directory
  8.         return copiedFile.getParent();
  9.     }
  10.     ...

从Content URI获取目录

如果接收的Intent包含一个Content URI，这个URI可能指向的是存储于MediaStore Content Provider的目录和文件名。我们可以通过检测URI的Authority值来判断它是否是来自于MediaStore的Content URI。一个MediaStore的Content URI可能来自Android Beam文件传输也可能来自其它应用程序，但不管怎么样，我们都能根据该Content URI获得一个目录路径和文件名。

我们也可以接收一个含有ACTION_VIEW这一Action的Intent，它包含的Content URI针对于Content Provider，而不是MediaStore，这种情况下，该Content URI不包含MediaStore的Authority，且这个URI一般不指向一个目录。

Note：对于Android Beam文件传输，接收在含有ACTION_VIEW的Intent中的Content URI时，若第一个接收的文件MIME类型为“audio/”，“image/”或者“video/*”，Android Beam文件传输会在它存储传输文件的目录内运行Media Scanner，以此为媒体文件添加索引。同时Media Scanner将结果写入MediaStore的Content Provider，之后它将第一个文件的Content URI回递给Android Beam文件传输。这个Content URI就是我们在通知Intent中所接收到的。要获得第一个文件的目录，需要使用该Content URI从MediaStore中获取它。

确定Content Provider

为了确定是否能从Content URI中获取文件目录，可以通过调用Uri.getAuthority()获取URI的Authority，以此确定与该URI相关联的Content Provider。其结果有两个可能的值：

MediaStore.AUTHORITY

表明该URI关联了被MediaStore记录的一个文件或者多个文件。可以从MediaStore中获取文件的全名，目录名就自然可以从文件全名中获取。

其他值

来自其他Content Provider的Content URI。可以显示与该Content URI相关联的数据，但是不要尝试去获取文件目录。

要从MediaStore的Content URI中获取目录，我们需要执行一个查询操作，它将Uri参数指定为收到的ContentURI，将MediaColumns.DATA列作为投影（Projection）。返回的Cursor对象包含了URI所代表的文件的完整路径和文件名。该目录路径下还包含了由Android Beam文件传输传送到该设备上的其它文件。

下面的代码展示了如何测试Content URI的Authority，并获取传输文件的路径和文件名：

  1.     ...
  2.     public String handleContentUri(Uri beamUri) {
  3.         // Position of the filename in the query Cursor
  4.         int filenameIndex;
  5.         // File object for the filename
  6.         File copiedFile;
  7.         // The filename stored in MediaStore
  8.         String fileName;
  9.         // Test the authority of the URI
  10.         if (!TextUtils.equals(beamUri.getAuthority(), MediaStore.AUTHORITY)) {
  11.             /*
  12.              * Handle content URIs for other content providers
  13.              */
  14.         // For a MediaStore content URI
  15.         } else {
  16.             // Get the column that contains the file name
  17.             String[] projection = { MediaStore.MediaColumns.DATA };
  18.             Cursor pathCursor =
  19.                     getContentResolver().query(beamUri, projection,
  20.                     null, null, null);
  21.             // Check for a valid cursor
  22.             if (pathCursor != null &&
  23.                     pathCursor.moveToFirst()) {
  24.                 // Get the column index in the Cursor
  25.                 filenameIndex = pathCursor.getColumnIndex(
  26.                         MediaStore.MediaColumns.DATA);
  27.                 // Get the full file name including path
  28.                 fileName = pathCursor.getString(filenameIndex);
  29.                 // Create a File object for the filename
  30.                 copiedFile = new File(fileName);
  31.                 // Return the parent directory of the file
  32.                 return new File(copiedFile.getParent());
  33.              } else {
  34.                 // The query didn't work; return null
  35.                 return null;
  36.              }
  37.         }
  38.     }
  39.     ...

更多关于从Content Provider获取数据的知识，请参考：Retrieving Data from the Provider。