Exercice 02 - Le contrôleur
Pour ajoutez de l'interactivité à votre application, il faut lier du code java à la vue FXML. Suivez les prochaines étapes de cet exercice et créez le contrôleur Java de votre vue pour comprendre comment associer du code Java à un fichier FXML.
Création du contrôleur
Créez le contrôleur de hello.fxml dans le package be.esi.prj.
package be.esi.prj;
public class HelloController {
public HelloController() {
System.out.println("\tFXCONTROLLER | CONSTRUCTEUR");
}
}
Associez ensuite le contrôleur au fichier FXML en modifiant le nœud racine :
<VBox alignment="CENTER" spacing="20.0"
xmlns:fx="http://javafx.com/fxml"
fx:controller="be.esi.prj.HelloController">
Puis associez le libellé de l'interface au contrôleur en ajoutant
l'attribut welcomeText à HelloController.
package be.esi.prj;
import javafx.fxml.FXML;
import javafx.scene.control.Label;
public class HelloController {
@FXML private Label welcomeText;
public HelloController() {
System.out.println("\tFXCONTROLLER | CONSTRUCTEUR");
}
}
N'oubliez pas d'ajouter un identifiant portant le même nom que l'attribut au libellé dans le fichier FXML.
<VBox alignment="CENTER" spacing="20.0"
xmlns:fx="http://javafx.com/fxml"
fx:controller="be.esi.prj.HelloController">
<padding>
<Insets bottom="20.0" left="20.0" right="20.0" top="20.0"/>
</padding>
<Label fx:id="welcomeText"/>
<Button text="Hello!"/>
</VBox>
Écrivez sur une feuille l'ordre dans lequel sont exécutées les méthodes :
Parent root = fxmlLoader.load();Scene scene = new Scene(root, 640, 800);launch(args);HelloController()
Utilisez le debugger ou ajoutez des messages dans le terminal
via System.out.println() en cas de doute.
Quelle est la valeur de welcomeText lorsque le constructeur
de HelloController est terminé ?
Initialisation des attributs du contrôleur
La méthode initialize() d'un contrôleur FXML est une méthode appelée automatiquement
après le chargement du fichier FXML et l'injection des composants définis dans celui-ci.
Elle est utilisée pour initialiser les composants et définir les comportements avant
l'affichage de l'interface graphique. Elle ne prend aucun paramètre et ne retourne aucune valeur.
Ajoutez la méthode initialize() au contrôleur pour en comprendre l'utilité :
public void initialize() {
System.out.println("\tFXCONTROLLER | INITIALIZE");
welcomeText.setText("Hello World!");
}
Écrivez sur une feuille l'ordre dans lequel sont exécutées les méthodes :
Parent root = fxmlLoader.load();Scene scene = new Scene(root, 640, 800);launch(args);HelloController()initialize()
Quelle est la valeur de welcomeText lorsque la méthode
initialize() est terminée ?
Appeler une méthode du contrôleur
Si vous souhaitez appeler une méthode du contrôleur à partir du main,
il faut récupérer la référence du contrôleur à partir du FxmlLoader.
Pour découvrir comment procéder, ajoutez la méthode suivante au contrôleur :
public void setMessage(String message) {
welcomeText.setText(message);
}
Modifiez la méthode start() de l'application pour
appeler cette nouvelle méthode du contrôleur :
@Override
public void start(Stage stage) throws IOException {
URL resource = Main.class.getResource("/hello.fxml");
FXMLLoader fxmlLoader = new FXMLLoader(resource);
Parent root = fxmlLoader.load();
HelloController helloController = fxmlLoader.getController();
helloController.setMessage("Main send a message");
Scene scene = new Scene(root, 640, 800);
stage.setTitle("Hello!");
stage.setScene(scene);
stage.show();
}
Supprimer fx:controller
L'association du contrôleur avec un fichier FXML peut être effectué dynamiquement, autrement dit via une instruction java.
Testez cette mécanique en enlevant fx:controller="be.esi.prj.HelloController"
du fichier FXML.
Ensuite modifiez la méthode start() de l'application pour
créer le lien via la méthode setController :
@Override
public void start(Stage stage) throws IOException {
URL resource = Main.class.getResource("/hello.fxml");
FXMLLoader fxmlLoader = new FXMLLoader(resource);
HelloController helloController = new HelloController();
fxmlLoader.setController(helloController);
Parent root = fxmlLoader.load();
Scene scene = new Scene(root, 640, 800);
stage.setTitle("Hello!");
stage.setScene(scene);
stage.show();
}
Gestion des événements
Pour terminer la revue des possibilités d'interactions entre le contrôleur et le fichier FXML, ajoutez un identifiant au bouton dans le fichier FXML.
<Button fx:id="helloButton" text="Hello!"/>
Modifiez ensuite le contrôleur pour :
- Ajouter l'attribut représentant le bouton.
- Mettre à jour la
méthode initialize()pour initialiser la gestion des événements associée au bouton. - Ajouter la méthode
onHelloButtonClick()effectuant l'action.
package be.esi.prj;
import javafx.fxml.FXML;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
public class HelloController {
@FXML private Label welcomeText;
@FXML private Button helloButton;
public HelloController() {
System.out.println("\tFXCONTROLLER | CONSTRUCTEUR");
}
public void initialize() {
System.out.println("\tFXCONTROLLER | INITIALIZE");
welcomeText.setText("Hello World!");
helloButton.setOnAction(event -> {onHelloButtonClick();});
}
public void setMessage(String message) {
welcomeText.setText(message);
}
public void onHelloButtonClick() {
welcomeText.setText("Welcome to JavaFX Application!");
}
}
Vous pouvez associer une action avec le bouton d'une autre manière.
- Ouvrez le fichier hello.fxml via SceneBuilder.
- Sélectionnez le bouton helloButton.
- Ouvrez via le volet de droite de SceneBuilder le menu Code.
- Ajoutez le nom de la méthode onHelloButtonClick dans le champs On Action.
- Ouvrez le contrôleur HelloController.java via IntelliJ.
- Ajoutez @FXML devant la méthode protected void onHelloButtonClick()
- Supprimez la déclaration du bouton @FXML private Button helloButton;.
- Supprimez l'instruction helloButton.setOnAction();.