本课程教你:
- 请求一个共享文件
- 获取请求的文件
当一个应用想要访问被其他应用分享的文件时,这个请求的应用(客户端应用)通常会给分享文件的应用(服务端应用)发送一个请求。在大多数情况下,这个请求会在服务端应用中打开一个 Activity 并显示它能分享的文件。当用户选择这个文件后,服务端应用返回这个文件的content URI 给客户端应用。
本课程教你如何使用一个客户端应用向服务端应用请求一个文件,从服务端应用中接收这个文件的content URI,使用这个content URI打开这个文件。
请求分享一个文件
从服务器端请求一个文件,客户端应用调用 [startActivityForResult](https://developer.android.com/reference/android/app/Activity.html#startActivityForResult(android.content.Intent, int)),并传入包含诸如 ACTION_PICK 的动作和客户端能处理的MIME类型的 Intent。
例如,下面的这段代码展示了如何給服务端应用发送一个 Intent来开启一个在 Sharing a File 中描述的 Activity画面。
public class MainActivity extends Activity {
private Intent mRequestFileIntent;
private ParcelFileDescriptor mInputPFD;
...
@Override
protected 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);
...
}
...
}
访问请求的文件
服务端应用通过 Intent 发送一个文件的content URI返回给客户端应用。这个 Intent 在客户端应用的 [onActivityResult()](https://developer.android.com/reference/android/app/Activity.html#onActivityResult(int, int, android.content.Intent)) 中返回。一旦客户端应用获得了文件的content URI,它能通过文件的 FileDescriptor 访问这个文件。
文件在这个过程中是安全的,因为客户端应用收到的content URI只是一部分的数据。因为这个URI不包含文件路径,客户端的应用无法发现和获取任何服务端应用的其他文件。客户端只能访问获取的文件,而这个访问只能由服务端应用授权。由于这个权限是是临时的,因此一旦客户端的任务栈结束后,这个文件不能再被服务端应用之外的应用访问。
下面这段代码展示了客户端应用是如何处理从服务端应用返回 Intent,客户端应用如何使用content 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.
*/
@Override
public void onActivityResult(int requestCode, int resultCode,
Intent returnIntent) {
// If the selection didn't work
if (resultCode != RESULT_OK) {
// Exit without doing anything else
return;
} else {
// Get the file's content URI from the incoming Intent
Uri 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 file
FileDescriptor fd = mInputPFD.getFileDescriptor();
...
}
}
[openFileDescriptor()](https://developer.android.com/reference/android/content/ContentResolver.html#openFileDescriptor(android.net.Uri, java.lang.String)) 方法返回该文件的 ParcelFileDescriptor 对象。从这个对象中,客户端获取到 FileDescriptor,然后使用它来读取文件。