mardi 21 février 2012

Sauvegarder l'état des variables d'une activité Android lors de la rotation

Si vous développez des appli Android, il vous est sûrement déjà arrivé de devoir remplir passer des données d'une activité à une autre, et de vous apercevoir que lorsque vous tourniez votre téléphone les données du bundle étaient perdues.

Cela est une problématique classique du cycle de vie d'une activité sur Android. En effet, lors d'une rotation, votre activité est détruite, et elle se rappelle elle-même en quelque sorte. De ce faite, toutes les données qui avaient été stockées dans les variables automatiques sont initialisées à nouveau. Une façon de conserver ces données serait de passer les variables en statiques, et c'est une erreur que je considérerais de débutant, que j'ai faite à mes débuts. Sur le principe cela fonctionne, mais le code n'est pas propre.

Le meilleure pratique est, je pense, de considérer la surcharge de la méthode onSaveInstanceState(Bundle icicle) de la classe Activity. Prenons une activité classique:

import android.app.Activity;
import android.os.Bundle;
import android.util.Log;


public class testActivity extends Activity
{
 
 String test;
 
 @Override
 protected void onCreate(Bundle savedInstanceState)
 {
  super.onCreate(savedInstanceState);
  test = getIntent().getExtras().getString("test", "test perdu");
  Log.d("test bundle", test);
 }

}

Si vous avez lancé l'activité depuis une autre activité de cette façon:

Intent i = new Intent(this, testActivity.class);
i.putExtra("test", "test ok");
startActivity(i);

Votre logcat va afficher test ok.
Si vous faites une rotation de l'écran, votre logcat affiche test perdu. C'est là qu'intervient onSaveInstanceState(Bundle icicle). Celui-ci va être appelé avant la destruction de l'activité. Nous allons donc l'implémenter ainsi:

import android.app.Activity;
import android.os.Bundle;
import android.util.Log;

public class testActivity extends Activity
{
 String test;

 @Override
 protected void onCreate(Bundle savedInstanceState)
 {
  super.onCreate(savedInstanceState);

  test = getIntent().getExtras().getString("test");
  if (test == null) savedInstanceState.getString("test", "test non défini");

  Log.d("test bundle", test);
 }

 @Override
 protected void onSaveInstanceState(Bundle outState)
 {
  outState.putString("test", test);
  super.onSaveInstanceState(outState);
 }

}

Comme on peut le voir ici, on place dans le bundle outState toutes les données que l'on veut sauvegarder. Nous avons légèrement modifier le traitement de la méthode onCreate(Bundle savedInstanceState) pour récupérer ces données que nous avons stockée dans outState. Donc on récupère, par exemple, les extras qui auraient du être passés par l'activité précédente. Si ces extras ont disparu à la rotation, on regarde si l'on ne peut pas les récupérer dans le savedInstanceState, qui est une copie du bundle outState précédent.

Bien sûr, cela ne fonctionne pas qu'avec les String, toutes les données stockables dans un bundle peuvent être sauvegardées dans outState de onSaveInstance et récupérée dans le savedInstance de onCreate après la rotation.

Vous pouvez désormais vous passer de ces vilaines variables statiques que l'on ne saurait voir et faire des rotations d'activité en conservant vos données :)

vendredi 10 février 2012

Liste d'arguments variable en objective-C et Java


Pour changer aujourd'hui un post non pas axé sur un language mais sur une façon de coder. Je vais vous expliquer comment créer une fonction varargs ou en français variadique, c'est à dire une fonction qui prend un nombre arbitraire d'opérandes.

Il vous est sûrement déjà arrivé de créer des fonctions que prennent des tableaux d'objets en paramètre. C'est très bien quand on ne sait pas quels éléments vont constituer le tableau, mais lorsque savez que vous coderez toujours en dur les paramètres de la fonction, je ne pense pas qu'il soit judicieux de créer et allouer un tableau. Voici comment je procède en Objective-C sur iPhone en Java sur Android.

Sur iPhone, tout d'abord, dans le .h, je déclare par exemple ceci:

- (void) maFonctionAvecUnParametre:(id)param1
        etUneListeVariable:(id)param2,...
        NS_REQUIRES_NIL_TERMINATION;

Vous remarquerez que le paramètre "etUneListeVariable" et constitué d'un paramètre, ici de type id car je n'ai pas voulu me limiter à un seul type, trois points et une macro système. Voici comment les interpréter:

  • le paramètre va définir tout simplement le type des arguments qui vont suivre
  • les trois petits points suivant une virgule annoncent que le nombre de paramètres est variable
  • le NS_REQUIRES_NIL_TERMINATION n'est pas indispensable, c'est une macro qui déclare au compilateur que la liste des paramètres doit se terminer par un "objet nul", soit nil en objective-C.
l'utilisation dans le .m se fait de cette façon:

-(void) maFonctionAvecUnParametre:(id)param1 etUneListeVariable:(id)param2,...
{
    va_list args;
    va_start(args, param2);

    id valeur = param2;

    //si le premier argument des varargs n'est pas nul
    if(valeur)
    {
        //on boucle sur les éléments la liste des paramètres variable en commençant par le premier, ici param2 
        do {
         //ici mes traitement sur l'objet valeur
        } while ((valeur = va_arg( args, id )));
    }
}
Exemple d'utilisation:

[monObjet maFonctionAvecUnParametre:toto etUneListeVariable:titi, tata, tutu, nil];

[monObjet2 maFonctionAvecUnParametre:toto etUneListeVariable:titi, tata, tutu, tyty, nil];


Voilà pour l'objective-C.
En ce qui concerne le Java et entre autres Android, rien de plus simple, trois petits points suffisent, le langage assimile la liste lui-même à un tableau:


private static void traiterMaListe(Object... params)
{
     for (Object param : params)
     {
          //traitement sur mon param
     }
}

Exemple:

monObjet.traiterMaListe(toto, tata, titi);
monObjet2.traiterMaListe(toto, tata, titi, tutu, tyty);

Pratique n'est-ce pas :)

Voilà pour mon domaine de compétence. Il faut savoir que la syntaxe d'objective-C est directement issue du C, et que d'autres langages comme le PHP par exemple implémentent les fonctions variadiques. Si vous voulez les implémenter dans un de ces langages, cherchez tout simplement varargs + votre langage sur Google, ou regardez sur Wikipedia :)

Twitter