Théorie: session #

Informations spécifiques au Frontal #

1. La session mémorise des informations spécifiques au Frontal, pex.

   • la vue courante / page courante
   • le dernier modèle affichée (p.ex. la dernière partie affichée).

2. En quittant l’application, Ntro va sauvegarder la session

3. La session permet donc de reprendre l’affichage «là où on était rendu»

Pour déclarer la session #

1. Il faut créer une classe qui hérite de Session

   public class SessionPong extends Session<SessionPong> {
   
           // ajouter des attributs, p.ex. la vue courante ou la partie courante
   
       }
   

2. Ensuite, il faut déclarer la classe session dans le Frontal

   public class FrontalPong implements FrontendFx {
   
           // ...
   
           @Override
           public void registerSessionClass(SessionRegistrar registrar) {
               registrar.registerSessionClass(SessionPong.class);
           }
   

Pour utiliser la session dans le code #

1. On peut récupérer la session partout dans le Frontal:

   SessionPong session = Ntro.session(SessionPong.class);
   

2. Dans PremierAffichage, on peut s’en servir pour décider quelle page afficher en premier, p.ex.

   tasks.task("choisirPremiereVue")
   
        .waitsFor(created(VueA.class))
   
        .executes(inputs -> {
   
           SessionPong session = Ntro.session(SessionPong.class);
   
           if(session.siVueCouranteEst(VueFileAttente.class)){
   
               // afficher la file d'attente comme première vue
   
           } else if(session.siVueCouranteEst(VuePartie.class)){
   
               // afficher la partie comme première vue
   
   
           } // ...
   
        });
   

Pour démarrer l’application avec une session #

1. Modifier le fichier build.gradle du projet. Ajouter:

   ntroProject.users = ["alice","bob"]
   

2. Démarrer en ajoutant le nom de l’usager au nom du le tâche Gradle

   $ sh gradlew pongAlice
   $ sh gradlew pongBob
   

Où sont sauvegarder les sessions? #

1. Fichiers lus par Ntro: mon_projet/_storage/sessions

2. Pour les sauvegarder dans Git, les copier dans p.ex. mon_projet/json/sessions