Apprendre à passer des données entre deux activités via des extras en programmation Android

| Diane MOREAU | Sébastien DEPARDIEU |

Prérequis pour bien comprendre ce tutoriel :

- connaître les bases de la programmation Android (Java et XML) ;

- utiliser Android Studio (conseillé) ;

- savoir ouvrir une nouvelle activité en utilisant un Intent.

Pour réagir à ce tutoriel, un espace de dialogue vous est proposé sur le forum. Commentez

- Titre : Apprendre à passer des données entre deux activités via des extras en programmation Android

- Auteurs : Diane MOREAU, Sébastien DEPARDIEU

- Parution : 17 octobre 2017

- Licence : Copyright ® 2017 BeeApps - Sébastien DEPARDI. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Voir également :

- Apprendre à passer des objets complexes entre deux activités via des extras en programmation Android

Sommaire

- I. Introduction

- II. Création des layouts

- III. Passer des extras (c'est-à-dire des données) à la seconde activité

- IV. Récupérer les extras dans la seconde activité

- V. Afficher les données que nous avons récupérées

- VI. Testons notre code

- VII. Note de la rédaction de developpez.com

I - Introduction

Aujourd'hui nous allons voir comment passer des données entre deux activités.

Animation en format "youtube" non supportée.
Contenu uniquement consultable en ligne à cette adresse :
https://www.youtube.com/watch?v=_5osl5e_hE8

II - Création des layouts

Nous allons avoir besoin de données à passer entre nos deux activités ! Notre activité principale se nomme “MainActivity” et notre seconde activité « MaDeuxiemeActivity ». Nous ne ferons donc pas dans l'originalité, mais les noms sont explicites !

Nous allons, dans notre  activité principale, créer un petit formulaire dans le layout, et envoyer les données, qui auront été entrées dans le formulaire, à la seconde activité.

Pour faire simple, notre formulaire sera uniquement composé :

- d'un EditText dans lequel on pourra entrer le texte que l'on souhaite ;

- d'un bouton pour valider et passer le texte à la seconde activité. Pour lancer la seconde activité, nous utiliserons l'attribut onClick qui appellera la méthode « ChangeActivity » que l'on implémentera côté Java. Cependant, libre à toi d'utiliser un listener sur ton bouton si tu as plutôt l'habitude d'utiliser cette méthode.

Je te laisse le faire, et tu devrais obtenir un fichier XML de ce style :

1. <?xml version="1.0" encoding="utf-8"?>

2. <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"

3. xmlns:app="http://schemas.android.com/apk/res-auto"

4. xmlns:tools="http://schemas.android.com/tools"

5. android:layout_width="match_parent"

6. android:layout_height="match_parent"

7. tools:context="com.example.formation.changementactivity.MainActivity">

9. <EditText

10. android:id="@+id/et1"

11. android:layout_width="match_parent"

12. android:layout_height="wrap_content"

13. android:layout_above="@+id/bt"

14. />

16. <Button

17. android:id="@+id/bt"

18. android:layout_width="wrap_content"

19. android:layout_height="wrap_content"

20. android:text="Changer d'activity"

21. android:onClick="ChangeActivity"

22. android:layout_centerInParent="true"

23. />

25. </RelativeLayout>

La seconde activité comporte uniquement un TextView qui permettra d'afficher ce qui lui aura été passé par la première activité :

1. <?xml version="1.0" encoding="utf-8"?>

2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

3. xmlns:app="http://schemas.android.com/apk/res-auto"

4. xmlns:tools="http://schemas.android.com/tools"

5. android:layout_width="match_parent"

6. android:layout_height="match_parent"

7. tools:context="com.example.formation.changementactivity.MaDeuxiemeActivity"

8. android:gravity="center"

9. android:orientation="vertical"

10. >

12. <TextView

13. android:id="@+id/tv1"

14. android:layout_width="wrap_content"

15. android:layout_height="wrap_content"

16. android:text="Tu es sur la deuxieme activity"

17. />

18. </LinearLayout>

III - Passer des extras (c'est-à-dire des données) à la seconde activité

Maintenant que tu as ton layout de prêt, nous pouvons passer à la partie intéressante qui va se produire du côté du Java !

Nous allons implémenter notre méthode ChangeActivity, dont voici le prototype :

public void ChangeActivity(View view)

Dans un premier temps, nous allons récupérer notre EditText avec la méthode findViewById, que tu dois avoir l'habitude d'utiliser :

EditText = (EditText) findViewById(R.id.et1);

Il va ensuite falloir récupérer la String qui a été rentrée dans l'EditText. Attention, l'EditText n'est pas capable de nous retourner directement la String qui a été saisie. Il faut d'abord récupérer le Text puis le convertir en String :

String str = editText.getText().toString();

Très bien ! Nous allons pouvoir passer cette chaîne de caractères à notre seconde activité. Mais pour l'exemple d'aujourd'hui, nous allons aussi passer un entier. Il représente simplement le nombre de caractères qui se trouve dans la String. Tu dois te dire que ça ne sert à rien de passer cette donnée à notre seconde activité et tu as tout à fait raison, mais comme ça nous allons pouvoir passer deux types de données différents : une String et un entier. Pour récupérer cet entier, il suffit d'appeler la méthode length sur notre String :

int nbLettre = str.length();

Là nous avons toutes les données que nous allons passer à notre seconde activité, à savoir la String et l'entier.

Comment allons-nous faire ça ?

Tu dois savoir que pour passer d'une activité à une autre, nous utilisons un Intent. Dans notre cas, pour passer de notre « MainActivity » à « MaDeuxiemeActivity », nous utilisons le code suivant (toujours dans la méthode ChangeActivity) :

1. Intent intent = new Intent(this, MaDeuxiemeActivity.class);

2. startActivity(intent);

Nous allons ajouter des extras à cet Intent (ce seront les données), à savoir la String et l'entier.

Comment fonctionne un Extra ? Un extra est un couple clé/valeur, basé sur le système Bundle :

- la clé est l'identifiant, tu peux mettre ce que tu veux, c'est simplement une chaîne de caractères ;

- la valeur est la valeur de ta donnée. Elle sera associée à la clé.

Ainsi, quand tu vas créer un extra, tu vas lui donner une clé et une valeur. En revanche, quand tu voudras récupérer ton extra, tu lui donneras la clé et il te renverra la valeur associée. Nous allons à présent voir ensemble comment faire ça concrètement.

Tu vas pouvoir ajouter des extras à ton Intent entre le moment où tu as créé ton Intent et le moment où tu appelles startActivity. Pour cela, tu vas appeler la méthode putExtra sur ton Intent qui prend deux arguments :

- le premier argument : la clé ;

- le second : la valeur.

Tu ajoutes la String et l'entier comme extra, ce qui doit te donner :

1. Intent intent = new Intent(this, MaDeuxiemeActivity.class);

2. intent.putExtra("edittext", str);

3. intent.putExtra("nbLettre", nbLettre);

4. startActivity(intent);

Si tu avais voulu utiliser directement le système bundle, le code aurait plutôt ressemblé à ça :

1. Intent intent = new Intent(this, MaDeuxiemeActivity.class);

2. Bundle bundle = new Bundle();

3. bundle.putString("edittext ", str);

4. bundle.putString("nbLettre", nbLettre);

5. intent.putExtras(bundle);

6. startActivity(intent);

L'intérêt du bundle, c'est qu'il peut être retourné par une classe indépendante de l'Activity sur laquelle tu travailles.

IV - Récupérer les extras dans la seconde activité

Dans ta seconde activité, dans la méthode onCreate et juste après l'appel de la méthode setContentView, nous allons pouvoir récupérer nos extras.

Pour cela, tu dois d'abord récupérer l'Intent de la manière suivante :

Intent intent = getIntent();

Si l'Intent récupéré n'est pas null, tu vas pouvoir effectuer les actions nécessaires pour récupérer les extras. A priori, Intent n'est pas null, mais c'est une bonne pratique de vérifier, quand tu utilises un objet, qu'il n'est pas null. Ça t'évitera des crashs si jamais il est null pour une raison x ou y. On le fait pour éviter les soucis plus tard.

1. if (intent != null){

2. // Le code pour récupérer les extras ira ici

3. }

On va vouloir, dans un premier temps, récupérer notre String. Tu vas donc créer la variable à laquelle sera assignée la valeur que l'on va récupérer :

String str = "";

On va d'abord vérifier que notre Intent a bien une valeur associée à la clé « edittext ». Pour cela, nous allons simplement ajouter une condition et si la clé existe bien, on récupérera la valeur qui lui est associée :

1. String str = "";

2. if (intent.hasExtra("edittext")){ // vérifie qu'une valeur est associée à la clé “edittext”

3. str = intent.getStringExtra("edittext"); // on récupère la valeur associée à la clé

4. }

Tu remarqueras que nous avons appelé la méthode « getStringExtra », car la valeur que l'on souhaite récupérer est de type String.

Si tu avais utilisé un bundle pour passer tes données à la seconde activité, tu aurais dû récupérer ta String de cette façon :

1. Bundle bundle = getIntent().getExtras();

2. str = bundle.getString("edittext");

Nous allons maintenant récupérer notre extra de type « int », qui représente le nombre de lettres contenues dans la String. Étant donné que cette fois tu souhaites récupérer un « int », tu vas appeler la méthode « getIntExtra » sur ton Intent. Si tu avais voulu récupérer un double, tu aurais appelé getDoubleExtra, etc. Il existe une méthode pour chaque type natif de Java.

Tu remarqueras que l'on n'a pas vérifié si la clé existe en appelant la méthode « hasExtra » comme nous l'avons fait tout à l'heure. Pourquoi ? Parce que pour les entiers, si la clé n'existe pas, on peut renvoyer une valeur par défaut. Ce n'est pas possible avec les Strings, si la clé n'existe pas, la méthode « getStringExtra » nous renvoie null.

Dans notre cas, on va renvoyer 0 si la clé « nbLettre » n'existe pas. Il n'est pas nécessaire de faire un traitement plus poussé si la clé n'existe pas, car ce n'est pas critique dans notre application.

int nbLettre = intent.getIntExtra("nbLettre", 0);

V - Afficher les données que nous avons récupérées

Nous allons récupérer le TextView dans notre seconde activité :

TextView textView = (TextView) findViewById(R.id.tv1);

Maintenant il ne reste plus qu'à afficher nos données en utilisant le TextView ! Nous allons afficher la String récupérée, suivie d'un point-virgule et du nombre de lettres contenues dans la String :

textView.setText(str + "; " + nbLettre);

Le code complet de ta seconde activité devrait ressembler à ça :

1. @Override

2. protected void onCreate(Bundle savedInstanceState) {

3. super.onCreate(savedInstanceState);

4. setContentView(R.layout.activity_ma_deuxieme);

6. Intent intent = getIntent();

7. if (intent != null){

8. String str = "";

9. if (intent.hasExtra("edittext")){

10. str = intent.getStringExtra("edittext");

11. }

12. int nbLettre = intent.getIntExtra("nbLettre", 0);

13. TextView textView = (TextView) findViewById(R.id.tv1);

14. textView.setText(str + "; " + nbLettre);

15. }

16. }

VI - Testons notre code

Dans notre première activity, j'écris « coucou » et je clique sur le bouton « Changer d'activity » :

La seconde activité affiche bien « coucou » suivi du nombre de lettres, à savoir six, ce qui signifie que nous avons bien réussi à envoyer et récupérer les données voulues entre deux activités. Attention, si le nombre de lettres affiché pour toi est sept, c'est probablement que ton appareil Android t'a ajouté une espace après que tu as écrit « coucou », ce qui te donne  »coucou  ».

Le tutoriel d'aujourd'hui touche à sa fin, j'espère qu'il t'a plu. Je te souhaite une bonne journée et je te dis à la prochaine !

VII - Note de la rédaction de developpez.com

Nous tenons à remercier Jacques_jean pour la relecture orthographique.