Android官方开发文档Training系列课程中文版：分享文件之请求一个共享文件

原文地址：http://android.xsoftlab.net/training/secure-file-sharing/request-file.html

当APP需要访问一个被其它APP所共享的文件时，这个APP通常需要发送一个请求给共享文件的那个APP(服务端)，在大多数的情况下，这个请求会启动一个服务端的Activity，这个Activity会展示可以共享的文件。用户可以选择一个文件，稍后服务端APP会将这个文件以URI的形式返回给客户端APP。

这节课展示了客户端APP如何向服务端APP请求一个共享文件，以及从服务端APP接收这个URI，和通过这个URI打开被选中的文件。

发送文件请求

如果要请求服务端的文件，客户端APP需要调用startActivityForResult方法并传入一个Intent对象，这个Intent对象包含了一个行为比如ACTION_PICK以及一个MIME类型，这个类型是指客户端APP可以处理的类型。

举个例子，下面这段代码演示了如何发送一个Intent给服务端APP并启动展示共享文件的那个Activity：

public class MainActivity extends Activity {private Intent mRequestFileIntent;private ParcelFileDescriptor mInputPFD;...@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);mRequestFileIntent = new Intent(Intent.ACTION_PICK);mRequestFileIntent.setType("image/jpg");...}...protected void requestFile() {/*** When the user requests a file, send an Intent to the* server app.* files.*/startActivityForResult(mRequestFileIntent, 0);...}...
}

访问请求到的文件

服务端给客户端返回了一个带有文件URI的Intent。这个Intent会从客户端中的onActivityResult()方法返回。一旦客户端有了这个文件的URI，那么它就可以通过FileDescriptor来访问这个文件。

在这个过程中，文件的安全性一直被保留，因为客户端接收到的URI只是数据的一部分。既然这个URI没有包含目录路径，那么客户端APP不可能发现并打开任何服务端上的任何其它文件。只有客户端APP可以访问文件,且仅仅是由服务器APP授予的权限。这个权限是个临时的权限，所以一旦客户端APP的任务终止，那么这个文件就不可被服务端APP之外的地方所访问。

下面这段代码演示了客户端APP如何处理从服务端返回的Intent，以及如何使用URI来获得FileDescriptor对象：

/** When the Activity of the app that hosts files sets a result and calls* finish(), this method is invoked. The returned Intent contains the* content URI of a selected file. The result code indicates if the* selection worked or not.*/@Overridepublic void onActivityResult(int requestCode, int resultCode,Intent returnIntent) {// If the selection didn't workif (resultCode != RESULT_OK) {// Exit without doing anything elsereturn;} else {// Get the file's content URI from the incoming IntentUri returnUri = returnIntent.getData();/** Try to open the file for "read" access using the* returned URI. If the file isn't found, write to the* error log and return.*/try {/** Get the content resolver instance for this context, and use it* to get a ParcelFileDescriptor for the file.*/mInputPFD = getContentResolver().openFileDescriptor(returnUri, "r");} catch (FileNotFoundException e) {e.printStackTrace();Log.e("MainActivity", "File not found.");return;}// Get a regular file descriptor for the fileFileDescriptor fd = mInputPFD.getFileDescriptor();...}}

方法openFileDescriptor()返回了一个文件的ParcelFileDescriptor对象。客户端APP可以根据这个对象得到FileDescriptor对象，这个对象便可以用来读取文件了。