Passer au contenu principal

Events

Ouvrir dans ChatGPT
Java API

Les composants, qu'ils soient personnalisés ou faisant partie du framework, prennent en charge la gestion des événements. Vous pouvez ajouter des écouteurs d'événements pour capturer divers types d'événements, tels que les interactions utilisateur, les changements d'état ou d'autres événements personnalisés. Ces écouteurs d'événements peuvent être utilisés pour déclencher des actions ou des comportements spécifiques en réponse aux événements.

Dans l'exemple ci-dessous, un événement est ajouté en utilisant chacune des trois méthodes prises en charge : expressions lambda, classes anonymes et références de méthode.

Ajouter des événements​

Ajouter un écouteur d'événement est possible en utilisant l'un des motifs suivants où :

  • myComponent est le composant auquel vous souhaitez attacher l'écouteur d'événement.

  • addEventListener est remplacé par la méthode spécifique à l'événement.

  • EventListener est remplacé par le type d'événement écouté.

myComponent.addEventListener(e -> {
  //Exécuté lorsque l'événement se déclenche
});

//OU

myComponent.addEventListener(new ComponentEventListener<EventListener>() {
  @Override
  public void onComponentEvent(ComponentEvent e){
    //Exécuté lorsque l'événement se déclenche
  }
});

//OU

myComponent.addEventListener(this::eventMethod);

Des méthodes, ou alias, supplémentaires ont été ajoutées pour permettre une addition alternative d'événements en utilisant le préfixe on suivi de l'événement, tel que :

myComponent.onEvent(e -> {
  //Exécuté lorsque l'événement se déclenche
});

Suppression d'un événement​

Lors de l'ajout d'un écouteur d'événement, un objet ListenerRegistration sera retourné. Cela peut être utilisé, entre autres choses, pour supprimer l'événement plus tard.

//Ajout de l'événement
ListenerRegistration listenerRegistration = myComponent.addEventListener(e -> {
    //Exécuté lorsque l'événement se déclenche
  });

//Suppression de l'événement
listenerRegistration.remove();

Utilisation de la charge utile d'événement​

Il est important de noter que les événements sont souvent accompagnés d'une charge utile, qui contient des informations supplémentaires liées à l'événement. Vous pouvez utiliser efficacement cette charge utile dans le gestionnaire d'événements pour accéder aux données pertinentes sans effectuer des allers-retours inutiles entre le client et le serveur. En procédant ainsi, vous pouvez améliorer les performances de votre application.

Le code ci-dessous interroge le composant pour obtenir des informations qui, pour les besoins de notre démonstration, sont déjà incluses dans la charge utile de l'événement, représentant un code inefficace :

myComponent.addEventListener(e -> {
  // Accéder aux données du composant
  String componentText = e.getComponent().getText();

  //OU si le composant est accessible dans la portée de la fonction
  String componentText = myComponent.getText();

  // Utilisez le componentText pour effectuer d'autres actions.
});

Au lieu de cela, en utilisant la charge utile de la méthode, qui pour l'exemple comprend le texte du composant, un aller-retour est évité :

myComponent.addEventListener(e -> {
  // Accéder aux données de la charge utile de l'événement
  String componentText = e.getText();

  // Utilisez le componentText pour effectuer d'autres actions.
});

Cette approche minimise la nécessité d'interroger le composant pour obtenir des informations, car les données sont déjà disponibles dans la charge utile de l'événement. En suivant cette pratique efficace de gestion des événements, vous pouvez améliorer les performances et la réactivité de vos composants. Pour plus d'informations, vous pouvez consulter Interaction Client/Serveur.

Exemple​

Voici une démonstration montrant l'ajout d'un ButtonClickEvent à un Button. Ce Button utilise également les informations provenant de la charge utile de l'événement pour afficher des informations à l'écran.

Afficher le code