Tutoriel 4: gestion d’événements usager #

Créer les événements Ntro #

1. En VSCode, créer le paquet pong.frontal.evenements

2. Dans le paquet evenements, créer les classes

   • EvtAfficherFileAttente
   • EvtAfficherPartie

3. NOTE: la classe est nommée EvtNomEvenement par convention

4. Ajuster les signatures de ces classes, qui doivent hériter de ca.ntro.app.Event

   public class EvtAfficherFileAttente extends Event {
   
   }
   

   public class EvtAfficherPartie extends Event {
   
   }
   

5. Avec Ctrl+.Eclipse: Ctrl+1, ajouter les import

   • ATTENTION importer ca.ntro.app.Event

6. S’assurer d’avoir l’arborescence suivante

Déclarer les événements Ntro dans le Frontal #

1. Déclarer les événements Ntro dans le Frontal

   @Override
   public void registerEvents(EventRegistrar registrar) {
   
   	registrar.registerEvent(EvtAfficherFileAttente.class);
   
   	registrar.registerEvent(EvtAfficherPartie.class);
   
   }
   

Récupérer les contrôles des Vues JavaFx #

1. S’assurer d’avoir l’attribut fx:id sur chaque bouton:

   • dans file_attente.fxml

     <Button 
         fx:id="boutonDebuterPartie" 
         text="%debuterPartie"
         styleClass="gros-bouton"
         id="bouton-debuter-partie">
     </Button>
     

   • dans partie.fxml

     <Button 
         fx:id="boutonQuitterPartie" 
         text="%quitterPartie"
         styleClass="gros-bouton"
         id="bouton-quitter-partie">
     </Button>
     

2. NOTE: le fx:id et id ne jouent pas le même rôle

   • fx:id identifiant JavaFx
   • id identifiant CSS

3. Les classes VueFileAttente et VuePartie, ajouter un attribut pour le bouton

   ATTENTION ci-bas il faut importer javafx.scene.control.Button

   • dans VueFileAttente

     public class VueFileAttente extends ViewFx {
     
         @FXML
         private Button boutonDebuterPartie;
     
         @Override
         public void initialize() {
     
             Ntro.assertNotNull(boutonDebuterPartie);
     
         }
     }
     

   • dans VuePartie

     public class VuePartie extends ViewFx {
     
         @FXML
         private Button boutonQuitterPartie;
     
         @Override
         public void initialize() {
     
             Ntro.assertNotNull(boutonQuitterPartie);
     
         }
     }
     

4. S’assurer que:

   • le nom de l’attribut correspond exactement au fx:id du fichier .fxml
   • l’annotation @FXML est directement au dessus de l’attribut
   • utiliser une ligne Ntro.assertNotNull pour détecter rapidement une erreur

Créer les capteurs d’événements JavaFx #

1. Dans les classes VueFileAttente et VuePartie, capter les événements JavaFx

   • dans VueFileAttente

     public class VueFileAttente extends ViewFx {
     
         @Override
         public void initialize() {
     
             // ...
     
             installerEvtAfficherPartie();
         }
     
         private void installerEvtAfficherPartie() {
     
             boutonDebuterPartie.setOnAction(evtFx -> {
     
                 Ntro.logger().info("[VueFileAttente] clic:" + evtFx.getEventType());
     
             });
         }
     }
     

   • dans VuePartie

     public class VuePartie extends ViewFx {
     
         @Override
         public void initialize() {
     
             // ...
     
             installerEvtAfficherFileAttente();
         }
     
     
         private void installerEvtAfficherFileAttente() {
     
             boutonQuitterPartie.setOnAction(evtFx -> {
     
                 Ntro.logger().info("[VuePartie] clic: " + evtFx.getEventType());
     
             });
         }
     }
     

2. Exécuter pong et je s’assurer que le capteur fonctionne

    $ sh gradlew pong
   
        # Dois afficher quand je cliques sur le bouton
   
        [INFO] [VueFileAttente] clic: ACTION
        [INFO] [VueFileAttente] clic: ACTION
        [INFO] [VueFileAttente] clic: ACTION
   

Créer et déclencher les événements Ntro #

1. Dans les classes VueFileAttente et VuePartie, ajouter

   • dans VueFileAttente

     private void installerEvtAfficherPartie() {
     
         boutonDebuterPartie.setOnAction(evtFx -> {
     
             Ntro.newEvent(EvtAfficherPartie.class)
                 .trigger();
     
         });
     }
     

   • dans VuePartie

     private void installerEvtAfficherFileAttente() {
     
     
         boutonQuitterPartie.setOnAction(evtFx -> {
     
             Ntro.newEvent(EvtAfficherFileAttente.class)
                 .trigger();
     
         });
     }
     

2. Observer qu’on crée et déclenche l’événement Ntro en même temps