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 requête démarre un Activity dans l'application serveur qui affiche les fichiers qu'elle peut partager.
L'utilisateur sélectionne un fichier, après quoi l'application serveur renvoie l'URI de contenu du fichier à l'application cliente.
Cette leçon explique comment une application cliente demande un fichier à une application de serveur, reçoit l'URI de contenu du fichier à partir de l'application de serveur et ouvre le fichier à l'aide de l'URI de contenu.
Envoyer une requête pour le fichier
Pour demander un fichier à l'application de serveur, l'application cliente appelle startActivityForResult avec un Intent contenant l'action telle que ACTION_PICK et un type MIME que l'application cliente peut gérer.
Par exemple, l'extrait de code suivant montre comment envoyer un Intent à une application serveur pour 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 serveur renvoie l'URI du contenu du fichier à l'application cliente dans un Intent. Cet Intent est transmis à l'application cliente dans son forçage de onActivityResult(). Une fois que l'application cliente dispose de l'URI de contenu du fichier, elle peut y accéder 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 que l'application cliente reçoit. Lors de l'analyse du contenu, vous devez vous assurer que cet URI ne pointe vers aucun élément en dehors du répertoire prévu, garantissant ainsi qu'aucune tentative de balayage de chemin n'est effectuée. Seule l'application cliente doit avoir accès au fichier, et uniquement pour les autorisations accordées par l'application serveur. Les autorisations étant temporaires, une fois la pile de tâches de l'application cliente terminée, le fichier n'est plus accessible en dehors de l'application serveur.
L'extrait de code suivant montre comment l'application cliente gère l'Intent envoyé à partir de l'application de serveur et comment l'application cliente obtient l'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 un ParcelFileDescriptor pour le fichier. À partir de cet objet, l'application cliente obtient un objet FileDescriptor, qu'elle peut ensuite utiliser pour lire le fichier.
Pour en savoir plus, consultez les ressources suivantes: