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 lance une Activity dans l'application du 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 de l'application serveur et ouvre le fichier à l'aide de l'URI de contenu.
Envoyer une requête pour le fichier
Pour demander un fichier à partir de l'application 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 de serveur afin de lancer l'Activity décrite dans 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 de contenu du fichier à l'application cliente dans un Intent. Ce 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 est préservée dans ce processus, car l'URI de contenu est la seule donnée que l'application cliente reçoit. Comme cet URI ne contient pas de chemin de répertoire, l'application cliente ne peut pas découvrir ni ouvrir d'autres fichiers dans l'application serveur. Seule l'application cliente a 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 le 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 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: