Когда приложение хочет получить доступ к файлу, предоставляемому другим приложением, запрашивающее приложение (клиент), как правило, отправляет запрос в приложение, предоставляющее файл (сервер). В большинстве случаев, запрос запускает Activity в серверном приложении, которая отображает файлы, которыми оно может поделиться. Пользователь выбирает файл, после чего сервер приложений возвращает URI контента для файла клиентскому приложению.

Этот урок покажет вам, как клиентское приложение запрашивает файл у серверного приложения, получает URI контента файла от серверного приложения, и открывает файл, используя URI контента.

Отправить запрос на получение файла

Чтобы запросить файл у серверного приложений, клиентское приложение вызывает startActivityForResult с Intent , содержащим действие, такое как ACTION_PICK и MIME типом, которые клиентское приложение может обработать.

Например, следующий фрагмент кода показывает, как послать Intent в серверное приложение, чтобы запустить 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);
        ...
    }
    ...
}

Получить доступ к требуемому файлу

Серверное приложение посылает URI контента файла обратно в клиентское приложение в Intent. Это Intent передается клиентскому приложению в перегруженный метод onActivityResult(). Как только клиентское приложение имеет URI контента файла, оно может получить доступ к файлу, получив его FileDescriptor.

Безопасность файла сохраняется в этом процессе, так как URI контента является единственным фрагментом данных, который получает клиентское приложение. Так как этот URI не содержит путь к каталогу, клиентское приложение не может искать и открывать какие-либо другие файлы серверного приложения. Только клиентское приложение получает доступ к файлу, и только используя разрешений, предоставленное серверным приложением. Разрешения временные, поэтому, как только стек задачи клиентского приложения завершится, файл не будет больше доступен за пределами серверного приложения.

Следующий фрагмент демонстрирует, как клиентское приложение обрабатывает Intent отправленный с серверного приложения, и как клиентское приложение получает FileDescriptor используя URI контента:

    /*
     * 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() возвращает ParcelFileDescriptor для файла. Из этого объекта, клиентское приложение получает FileDescriptor объект, который она может использовать, чтобы прочитать файл.