Demander un fichier partagé

Lorsqu'une application souhaite accéder à un fichier partagé par une autre application, l'application à l'origine de la demande (le client) envoie généralement une requête à l'application qui partage les fichiers (le serveur). Dans la plupart des cas, la demande démarre une Activity dans l'application de serveur qui affiche les fichiers qu'elle peut partager. L'utilisateur sélectionne un fichier, puis l'application de serveur renvoie l'URI de contenu du fichier à la l'application cliente.

Cette leçon explique comment une application cliente demande un fichier à une application de serveur, reçoit l'adresse IP du fichier l'URI du contenu de l'application de serveur, puis ouvre le fichier à l'aide de l'URI de contenu.

Envoyer une requête pour le fichier

Pour demander un fichier à l'application serveur, l'application cliente appelle startActivityForResult avec un Intent contenant l'action, par exemple ACTION_PICK et un type MIME que l'application cliente peut gérer.

Par exemple, l'extrait de code suivant montre comment envoyer une Intent à une application de serveur afin de démarrer le Activity décrit dans la section Partager un fichier:

Kotlin

class MainActivity : Activity() {
    private lateinit var requestFileIntent: Intent
    private lateinit var inputPFD: ParcelFileDescriptor
    ...
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        requestFileIntent = Intent(Intent.ACTION_PICK).apply {
            type = "image/jpg"
        }
        ...
    }
    ...
    private fun requestFile() {
        /**
         * When the user requests a file, send an Intent to the
         * server app.
         * files.
         */
        startActivityForResult(requestFileIntent, 0)
        ...
    }
    ...
}

Java

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

Accéder au fichier demandé

L'application de serveur renvoie l'URI de contenu du fichier à l'application cliente dans une Intent Cet Intent est transmis au client l'application dans sa version de remplacement de onActivityResult(). Une fois l'application cliente dispose de l'URI de contenu du fichier, elle peut accéder au fichier en obtenant son FileDescriptor

La sécurité des fichiers n'est préservée dans ce processus que si vous analysez correctement l'URI de contenu reçues par l'application cliente. Lors de l'analyse du contenu, vous devez vous assurer que cet URI ne pointe pas à tout élément extérieur au répertoire prévu, en veillant à ce qu'aucun une tentative de balayage de répertoire est en cours ; Seule l'application cliente doit pouvoir accéder au fichier, et uniquement pour les autorisations accordées par le l'application de serveur. Les autorisations sont temporaires. Par conséquent, une fois la pile de tâches de l'application cliente terminée, fichier n'est plus accessible en dehors de l'application de serveur.

L'extrait de code suivant montre comment l'application cliente gère Intent envoyé à partir de l'application serveur et comment l'application cliente obtient le FileDescriptor à l'aide de l'URI de contenu:

Kotlin

/*
 * 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.
 */
public override fun onActivityResult(requestCode: Int, resultCode: Int, returnIntent: Intent) {
    // If the selection didn't work
    if (resultCode != Activity.RESULT_OK) {
        // Exit without doing anything else
        return
    }
    // Get the file's content URI from the incoming Intent
    returnIntent.data?.also { returnUri ->
        /*
         * 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.
         */
        inputPFD = try {
            /*
             * Get the content resolver instance for this context, and use it
             * to get a ParcelFileDescriptor for the file.
             */
            contentResolver.openFileDescriptor(returnUri, "r")
        } catch (e: FileNotFoundException) {
            e.printStackTrace()
            Log.e("MainActivity", "File not found.")
            return
        }

        // Get a regular file descriptor for the file
        val fd = inputPFD.fileDescriptor
        ...
    }
}

Java

    /*
     * 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.
                 */
                inputPFD = 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 = inputPFD.getFileDescriptor();
            ...
        }
    }

La méthode openFileDescriptor() renvoie ParcelFileDescriptor pour le fichier. À partir de cet objet, le client L'application obtient un objet FileDescriptor, qu'elle peut ensuite utiliser pour lire le fichier.

Pour en savoir plus, consultez les ressources suivantes:

• Intents et filtres d'intents
• Récupérer des données auprès du fournisseur