注：本文翻译自Google官方的Android Developers Training文档，译者技术一般，由于喜爱安卓而产生了翻译的念头，纯属个人兴趣爱好。
原文链接： http://developer.android.com/training/beam-files/receive-files.html
Android Beam文件传输将文件拷贝至接收设备上的一个特殊目录。同时使用Android媒体扫描器 （ Android Media Scanner ）扫描拷贝的文件，并为媒体文件添加对应的字段至媒体库（ MediaStore provide）中。这节课将向你展示当文件拷贝完成时要如何响应，并且在接收设备上应该如何放置拷贝的文件。
一）. 响应需求以显示数据
当Android Beam文件传输将文件拷贝至接收设备后，它会发布一个通知，包含了一个
Intent
，它有有一个
ACTION_VIEW
的行为，第一个传输文件的
MIME
类型，和一个指向第一个文件的
URI。当用户点击了这个通知后，intent会被发送至系统。为了让你的应用能够响应这个intent，为要响应的
Activity
所对应的
<activity>
标签添加
<intent-filter>
标签，在
<intent-filter>
标签中，添加下面的子标签：
<action android:name="android.intent.action.VIEW" />
用来匹配从通知发送的intent。
<category android:name="android.intent.category.CATEGORY_DEFAULT" />
匹配隐式的 Intent 。
<data android:mimeType=" mime-type " />
匹配一个MIME类型。要指定那些你的应用能够处理的类型。
例如，下面的例子展示了如何添加一个intent过滤器来激活你的activity：
com.example.android.nfctransfer.ViewActivity
<
activity
android:name
="com.example.android.nfctransfer.ViewActivity"
android:label
="Android Beam Viewer"
>
...
<
intent-filter
>
<
action
android:name
="android.intent.action.VIEW"
/>
<
category
android:name
="android.intent.category.DEFAULT"
/>
...
</
intent-filter
>
</
activity
>
Note：
不仅仅只有Android Beam文件传输会发送含有 ACTION_VIEW 的intent。在接收设备上的其它应用也有可能会发送含有该行为的intent。我们马上会进一步讨论这一问题。
二）. 需求文件权限
如果要读取Android Beam文件传输所拷贝到设备上的文件，需要 READ_EXTERNAL_STORAGE 权限。例如：
<
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 权限仅在用户选择要读文件时才是强制需要的。而在今后的版本中会在所有情况下都需要该权限。为了保证应用在未来的兼容性，建议在清单文件中申明该权限。
由于你的应用对于其 内部 存储区域具有控制权，所以若要将文件拷贝至你应用的 内部 存储区域，写权限式不需要申明的。
三）. 获取拷贝文件的目录
Android Beam文件传输一次性将所有文件拷贝到目标设备的一个目录内， Android Beam文件传输通知所发出的 Intent 中包含有URI，他指向了第一个传输的文件。然而，你的应用也有可能接收到除了 Android Beam文件传输之外的某个来源所发出的含有 ACTION_VIEW 行为的Intent。为了明确你应该如何处理接收的Intent，你需要检查它的架构（ scheme ）和权威（ authority ）。
为了获得URI的架构，调用 Uri.getScheme() ，下面的代码展示了如何明确架构并处理URI：
public
class
MainActivity
extends
Activity {
...
//
A File object containing the path to the transferred files
private
File mParentPath;
//
Incoming Intent
private
Intent mIntent;
...
/*
* Called from onNewIntent() for a SINGLE_TOP Activity
* or onCreate() for a new Activity. For onNewIntent(),
* remember to call setIntent() to store the most
* current Intent
*
*/
private
void
handleViewIntent() {
...
//
Get the Intent action
mIntent =
getIntent();
String action
=
mIntent.getAction();
/*
* For ACTION_VIEW, the Activity is being asked to display data.
* Get the URI.
*/
if
(TextUtils.equals(action, Intent.ACTION_VIEW)) {
//
Get the URI from the Intent
Uri beamUri =
mIntent.getData();
/*
* Test for the type of URI, by getting its scheme value
*/
if
(TextUtils.equals(beamUri.getScheme(), "file"
)) {
mParentPath
=
handleFileUri(beamUri);
}
else
if
(TextUtils.equals(
beamUri.getScheme(),
"content"
)) {
mParentPath
=
handleContentUri(beamUri);
}
}
...
}
...
}
从文件URI中获取目录
如果接收的 Intent 包含一个内容URI，则该URI包含了一个文件的绝对文件名，包括了完整的路径和文件名。对于 Android Beam文件传输来说，目录路径指向了其它传输文件的位置（如果有其它传输文件的话），要获得这个目录路径，取得URI的路径部分（URI中除去“ file: ”前缀的部分），根据路径创建一个 File 对象，然后获取这个 File 的父目录：
...
public
String handleFileUri(Uri beamUri) {
//
Get the path part of the URI
String fileName =
beamUri.getPath();
//
Create a File object for this filename
File copiedFile =
new
File(fileName);
//
Get a string containing the file's parent directory
return
copiedFile.getParent();
}
...
从内容URI获取目录
如果接收的 Intent 包含一个内容URI，这个URI可能指向的是一个存储于 MediaStore 内容提供程序的目录和文件名。你可以通过检测URI的权威值来判断是否是 MediaStore 的内容URI。一个 MediaStore 的内容URI可能来自 Android Beam文件传输也可能来自其它应用，但不管怎么样，你都能根据该内容URI获得一个目录和文件名。
你也能接收一个 ACTION_VIEW 的Intent，它包含有一个内容提供程序的URI而不是 MediaStore ，在这个例子中，这个内容URI不包含 MediaStore 的权威值，且这个URI一般不指向一个目录
Note：
对于 Android Beam文件传输，如果第一个接收的文件，其MIME类型为“ audio/* ”，“ image/* ”或者“ video/* ”，那么你接收这个处于 ACTION_VIEW 的Intent的内容URI。 Android Beam文件传输会通过在它存储传输文件的目录内运行媒体扫描器，以此为媒体文件添加索引。同时媒体扫描器将结果写入 MediaStore 内容提供程序，之后它将第一个文件的内容URI回递给 Android Beam文件传输。这个内容URI就是你在通知 Intent 中所接收到的。要获得第一个文件的目录，你需要使用该内容URI从 MediaStore 中获取它。
确定内容提供程序
为了明确你能从内容URI中获取文件目录，你可以通过调用 Uri.getAuthority() 获取URI的权威，以此确定与该URI相关联的内容提供程序。其结果有两个可能的值：
表明这个URI关联了被 MediaStore 追踪的 一个文件或者 多个文件。可以从 MediaStore 中获取文件的全名，目录名就自然可以从文件全名中获取。
其他任何权威值
来自其他内容提供程序的内容URI。可以显示与该内容URI相关联的数据，但是不要尝试去获取文件目录。
为了从
MediaStore
的内容URI中获取目录，执行一个查询操作，它将
Uri
参数指定为收到的内容URI，列名为
MediaColumns.DATA
。返回的
Cursor
包含了完整路径和URI所代表的文件名。该目录路径下还包含了由
Android Beam文件传输传送到该设备上的其它文件。
下面的代码展示了你要如何测试内容URI的权威值，并获取传输文件的路径和文件名：
...
public
String handleContentUri(Uri beamUri) {
//
Position of the filename in the query Cursor
int
filenameIndex;
//
File object for the filename
File copiedFile;
//
The filename stored in MediaStore
String fileName;
//
Test the authority of the URI
if
(!
TextUtils.equals(beamUri.getAuthority(), MediaStore.AUTHORITY)) {
/*
* Handle content URIs for other content providers
*/
//
For a MediaStore content URI
}
else
{
//
Get the column that contains the file name
String[] projection =
{ MediaStore.MediaColumns.DATA };
Cursor pathCursor
=
getContentResolver().query(beamUri, projection,
null
,
null
,
null
);
//
Check for a valid cursor
if
(pathCursor !=
null
&&
pathCursor.moveToFirst()) {
//
Get the column index in the Cursor
filenameIndex =
pathCursor.getColumnIndex(
MediaStore.MediaColumns.DATA);
//
Get the full file name including path
fileName =
pathCursor.getString(filenameIndex);
//
Create a File object for the filename
copiedFile =
new
File(fileName);
//
Return the parent directory of the file
return
new
File(copiedFile.getParent());
}
else
{
//
The query didn't work; return null
return
null
;
}
}
}
...
要学习更多关于从内容提供程序获取数据的知识，可以阅读： Retrieving Data from the Provider 。
