Table des aéronefs

3.1.1. Graphe de scène

1. Colonnes textuelles
   

   Les colonnes textuelles sont simples à créer car, en dehors de leur titre et de leur largeur préférée, le seul paramètre à configurer est leur « fabrique de valeur de cellule » (cell value factory) qui sert à obtenir, pour une ligne donnée, la valeur à afficher dans la cellule.

   Cette configuration se fait en appelant la méthode setCellValueFactory, à laquelle on passe généralement une lambda. Cette lambda est appelée chaque fois qu'une nouvelle ligne est ajoutée à la table, afin de savoir ce que la colonne à laquelle cette lambda est associée doit afficher.

   La lambda prend un seul argument, qui est du type CellDataFeatures. Il n'est pas nécessaire de comprendre ce type en détail, il faut juste savoir que sa méthode getValue permet d'obtenir la valeur correspondant à la ligne de la table en cours d'ajout, ici une valeur de type ObservableAircraftState.

   Étant donné cet argument, qui correspond donc à une ligne entière, la lambda doit retourner une valeur observable de type ObservableValue<String>, qui est la chaîne de caractères à afficher dans la table.

   Par exemple, pour la colonne affichant l'indicatif, la fabrique de valeur de cellule peut s'écrire ainsi :

   TableColumn<ObservableAircraftState, String> c = …;
   c.setCellValueFactory(f ->
     f.getValue().callSignProperty().map(CallSign::string));
   

   La méthode getValue de f retourne l'état observable de l'aéronef dont la ligne est en cours d'ajout — une valeur de type ObservableAircraftState — et on en extrait la propriété contenant l'indicatif au moyen de callSignProperty. Cela fait, il ne reste plus qu'à transformer le contenu de cette propriété — de type CallSign — en la chaîne à afficher dans la table, ce qui se fait au moyen de sa méthode string.

   Pour comprendre pourquoi ce code fonctionne, il faut savoir que, comme expliqué dans sa documentation, la méthode map n'appelle la lambda qu'on lui a passée que lorsque la valeur de la propriété à laquelle l'a appliquée n'est pas nulle. Sinon, la valeur observable qu'elle retourne produit simplement null. De plus, TableColumn n'affiche rien dans la cellule lorsque la valeur observable qui donne son contenu produit null.

   Dès lors, tant que le contenu de callSignProperty est null — généralement car aucun message d'identification n'a été reçu de l'aéronef correspondant — la cellule de la table est vide. Mais lorsque le contenu de callSignProperty est différent de null, et est donc une instance de CallSign, la méthode string est appelée sur elle, et la chaîne retournée est affichée dans la cellule de la table.

2. Colonnes numériques
   

   Les colonnes numériques sont plus difficiles à définir que les textuelles pour différentes raisons, détaillées ci-dessous.

   Une première (petite) difficulté est que la classe de style numeric doit être attachée aux colonnes numériques, afin que leur contenu soit bien aligné à droite.

   Une seconde difficulté est liée au fait que l'on désire contrôler le nombre de décimales affichées pour les différentes colonnes numériques, qui doit être 4 pour la longitude et la latitude, et 0 pour les autres valeurs. JavaFX n'offre aucun moyen de faire cela, et il nous faut donc trouver comment contourner cette limitation.

   La solution que nous vous proposons d'utiliser consiste à représenter le contenu de ces cellules au moyen de chaînes de caractères, exactement comme les cellules textuelles. Cela nous permet de contrôler la manière dont les valeurs numériques sont transformées en chaînes, en particulier le nombre de décimales à utiliser.

   Afin de transformer les valeurs numériques en chaînes, et inversement, nous utiliserons la classe NumberFormat. Une nouvelle instance de cette classe peut être obtenue au moyen de la méthode getInstance, et le nombre de décimales à utiliser configuré au moyen des méthodes setMinimumFractionDigits et setMaximumFractionDigits. Une fois configurée, l'instance de NumberFormat peut être utilisée pour convertir des valeurs numériques en chaînes au moyen de format, et pour convertir des chaînes en valeur numérique au moyen de parse — ce qui est utile pour le comparateur décrit ci-après.

   Le fait de convertir les valeurs numériques en chaînes nous permet de contrôler leur format mais pose un problème pour le tri des colonnes, puisque trier les représentations textuelles d'une séquence de nombres n'est pas équivalent à trier les nombres eux-mêmes. Il faut donc modifier le comparateur associé aux colonnes numériques, au moyen de la méthode setComparator. On lui passe un comparateur qui compare les chaînes qu'il reçoit comme des chaînes si au moins l'une d'entre elles est vide, et comme des nombres sinon.

3.1.2. Liens et auditeurs

3.1.3. Gestion des événements

3.1.4. Conseils de programmation

ObservableValue<String> constantObservable =
  new ReadOnlyObjectWrapper<>("Javions");