La documentation en PDF - Louis SWINNEN

Programmation en JavaIntroduction à la programmation visuelle etl’exploitation des donnéesSLPack 0.5.0par Louis SWINNENdernière révision : 08/04/13Ce document est disponible sous licence Creative Commons indiquant qu’il peut êtrereproduit, distribué et communiqué pour autant que le nom de l’auteur reste présent,qu’aucune utilisation commerciale ne soit faite à partir de celui-ci et que le document ne soitni modifié, ni transformé, ni adapté.http://creativecommons.org/licenses/by-nc-nd/2.0/be/La Haute Ecole Libre Mosane (HELMo) attache une grande importance au respect des droits d’auteur.C’est la raison pour laquelle nous invitons les auteurs dont une oeuvre aurait été, malgré tous nosefforts, reproduite sans autorisation suffisante, à contacter immédiatement le service juridique de laHaute Ecole afin de pouvoir régulariser la situation au mieux.Avril 2013

Programmation en JavaIntroduction à la programmation visuelle et l’exploitation desdonnéespar Louis SWINNEN1. IntroductionCe document a pour but d’introduire à la programmation d’interface visuelle simple aumoyen du langage Java. Pour ce faire, il est nécessaire de disposer du composant SLPack.Ce document décrit la version 0.5.0 de ce composant. La dernière version de ce composantet la documentation l’accompagnant sont disponibles sur le site internet :http://www.swila.be1.1 SLPack, de quoi s’agit-il ?SLPack est un composant développé pour simplifier la programmation d’interface visuelle. Cecomposant est développé dans un but pédagogique uniquement : rendre laprogrammation d’interface visuelle ainsi que l’exploitation des bases de donnéesen Java accessibles aux débutants.Lorsque l’étudiant étudiera, de manière approfondie, le langage Java, l’utilisation de cecomposant ne sera plus nécessaire.Si vous souhaitez partager votre expérience avec ce composant (signaler un problème,demander une modification quelconque), il suffit de vous rendre sur la page du projet, sur lesite internet suivant :http://www.swila.beSeule la version « compilée » est disponible sous forme de librairie indépendante (un fichierJar). Ce composant est compatible avec la version 5.0 ou supérieur de Java.1.2 Installation de SLPackLa procédure d’installation consiste à placer le composant SLPack dans un dossier de votrechoix et ensuite de référencer celui-ci. Le composant SLPack prend la forme de fichiers Jar(c’est-à-dire des classes compilées et directement utilisables).Dans votre environnement de développement (par exemple sous NetBeans, Eclipse ouIntelliJ), il faut indiquer, dans votre projet, le lien vers le composant SLPack à utiliser.• Par exemple dans NetBeans, il faut ajouter les fichiers JAR dans votre projet. Pource faire, dans la section Libraries (panneau de gauche), faire un clic-droit et choisirAdd Jar/Folders et sélectionner les fichiers JAR nécessaires à votre application.• Sous Eclipse, il est possible lors de la création du projet Java d’indiquer des librairesparticulières. Ainsi dans la fenêtre Java Settings, choisir l’onglet Libraries et ensuiteAdd External JARs et sélectionner les fichiers JAR. Si le projet est déjà créé, il estpossible d’ajouter les libraires en faisant un clic-droit sur le nom du projet et enchoisissant Properties. Ensuite, l’option Java Build Path fait apparaître une série© HELMo Informatique, 2013 2

d’onglets. Choisir dans l’onglet Librairies l’option Add External JARs et sélectionner lesfichiers JARs à intégrer.• Sous IntelliJ, il faut ajouter également le composant SLPack. Pour ce faire, dans leprojet (panneau de gauche), faire un clic-droit sur Libraries et choisir Jump ToSource. Les paramètres du projet sont alors affichés, choisir dans la section Librairies,l’icône + au sommet. Ensuite, il faut donner un nom à ces librairies, comme parexemple SLPack et enfin, dans le panneau de droite, choisir l’option Attach Classes etchoisir les librairies à ajouter.En dehors de l’environnement de développement, il faut modifier la variable d’environnementCLASSPATH afin que celle-ci pointe vers les fichiers JAR. Ainsi, sous Windows, il fauteffectuer les étapes suivantes (en administrateur) :• Sous Windows XP : Clic-droit sur le poste de travail, choisir Propriétés puis l’ongletAvancé et cliquer sur Variables d’environnement.Sous Windows Vista/7 : Clic-droit sur Ordinateur puis choisir Propriétés puis, dansles tâches qui apparaissent à gauche, choisir Paramètres système avancés et ensuitecliquer sur Variables d’environnement.• Dans la section Variables système, localiser la variable PATH (qui indique le cheminde recherche par défaut) et modifiez celle-ci pour ajouter le chemin vers les fichierssystèmes Java. Ainsi, si votre compilateur Java est installé dans C:\ProgramFiles\Java\jdk1.6.0_06, ajoutez ceci à la fin de la valeur existante :;C:\Program Files\Java\jdk1.6.0_06\bin• Egalement dans la section Variables système, vérifiez si la variable CLASSPATH estdéfinie. Si ce n’est pas le cas, il faut créer une nouvelle variable, sinon modifier lavariable existante. Il faut ici ajouter le chemin vers le composant SLPack installé survotre machine. Si, comme à l’école, le composant est installé dans un répertoireSLPack dans le dossier Program Files, la variable CLASSPATH doit contenirnotamment le chemin suivant :C:\Program Files\SLPack\slpack.jarSous les systèmes basés Unix, il faut réaliser les mêmes modifications. Par exemple, sousLinux, si vous avez installé le compilateur Java et le composant SLPack dans le répertoire/opt, vous devez adapter la variable PATH et CLASSPATH comme sous Windows.Le plus simple est d’ajouter le fichier suivant dans le répertoire /etc/profile.d :Fichier /etc/profile.d/java.sh#! /bin/bashJAVA_HOME=/opt/jdk1.6.0_06PATH=$PATH:$JAVA_HOME/binCLASSPATH=$CLASSPATH:/opt/SLPack/slpack.jarexport JAVA_HOME PATH CLASSPATHIl reste ensuite à rendre ce script exécutable soit en ajoutant la permission execute parl’interface graphique, ou en entrant dans un terminal la commande suivante :chmod +x /etc/profile.d/java.shUne fois cette modification effectuée, il suffit de redémarrer la machine et l’environnementJava est prêt à être utilisé.© HELMo Informatique, 2013 3

1.3 Installation des librairies externesDepuis la version 0.4 de SLPack, un nouveau composant simplifié d’accès aux bases dedonnées SQL Server et Oracle est proposé. Cependant, afin que celui-ci fonctionne, il estnécessaire de disposer des drivers JDBC adéquats fournis par Oracle et Microsoft.Pour des raisons de copyright, ces drivers JDBC ne peuvent être fournis directement avecSLPack mais doivent être téléchargé par l’utilisateur et intégré à l’environnement dedéveloppement. Voici les composants à télécharger :• Pilote JDBC 2.0 Microsoft SQL Server :http://www.microsoft.com/downloads/details.aspx?familyid=99B21B65-E98F-4A61-B811-19912601FDC9&displaylang=fr• Pilote JDBC Oracle Express Edition (XE) – 2 fichiers :http://download.oracle.com/otn/utilities_drivers/jdbc/10204/ojdbc14.jarhttp://download.oracle.com/otn/utilities_drivers/jdbc/10204/orai18n.jarUne fois ces drivers téléchargés, il faut les inclure dans l’environnement de développement.La procédure est identique à celle vue précédemment pour inclure la bibliothèque SLPack. Eneffet, tous ces drivers JDBC sont des librairies JAR.A titre d’information, tous les drivers JDBC sont installés sur les ordinateurs de l’école dans lerépertoire C:\Program Files\JDBC. Il suffit de localiser les fichiers JAR et les inclure dansle projet pour pourvoir établir une connexion vers la base de données.Si la librairie est mal installée, la connexion à la base de données échouera avec un messagedu type « Error while loading the JDBC Driver (driver not found, not in classpath, …) ». Ilconvient dans ce cas de vérifier à nouveau la configuration afin d’être sûr que les driverssont bien présents.Il n’y a aucune objection à installer l’ensemble des librairies dans le même répertoire. Ainsi,il est possible de rassembler les fichiers suivants :• SLPack.jar – librairie SLPack• ojdbc14.jar et orai18n.jar – Pilote JDBC de Oracle• sqljdbc4.jar – Pilote JDBC de Microsoft SQL Server© HELMo Informatique, 2013 4

2. Utilisation de SLPackNous allons maintenant détailler l’utilisation de SLPack. Nous verrons :• La structure de base d’un programme SLPack• Les différents composants graphiques disponibles• La gestion des évènements• Les différentes « fonctions » (on parle plutôt de méthodes dans les langagesorientés-objets) disponiblesCe document ne montrera pas comment SLPack a été créé, bien que cela ne soit pas biencompliqué. En guise d’application, les étudiants plus avancés en Java peuvent se risquer àcet exercice.2.1 Structure d’un programme SLPackComme il s’agit d’un programme Java, il faut respecter les règles inhérentes au langageJava. Celles-ci ne seront pas détaillées dans ce document. Reportez-vous à vos notesconcernant Java en cas de doute. Vous pouvez également trouver beaucoup d’éléments dansl’excellent livre Thinking in Java [1] 1 ou encore dans les livres de référence Core Java [2] [3].Le squelette du programme SLPack sera au moins le suivant :import SLPack.SLForm;public class MonProgramme extends SLForm {public static void main(String [] args) {MonProgramme p = new MonProgramme();}public MonProgramme() {// insérer le code source ici}}public void action(String id) {// insérer la gestion des événements ici}Code 1 : Squelette minimal d’un programme SLPackAttention ! Le langage Java impose que le nom de votre fichier Java soit identiqueau nom de la classe. Ainsi, pour le squelette proposé (voir code 1), le fichier doit porter lenom MonProgramme.java.Si vous souhaitez changer le nom de votre fichier, assurez vous de modifier votre codesource Java en conséquence. Ainsi, si je souhaite que mon fichier se nomme Exervice1.java,il convient de changer tous les noms MonProgramme (en rouge dans code 1) en Exercice1.Dans le squelette minimal, on trouve les éléments suivants :1. La clause import qui assure que le composant SLPack est inséré.2. La définition de la classe qui contiendra le programme principal. Comme indiqué cidessus,il faut que le nom de la classe et le nom du fichier source java1 Les éléments entre crochets sont des références à la bibliographie© HELMo Informatique, 2013 5

correspondent. La définition de la classe contient le mot clé extends indiquant qu’ellehérite du composant SLForm.Le composant SLForm représente une fenêtre graphique. Nous en reparlerons plustard.3. La méthode (ou fonction) main qui sera exécutée lorsque nous lancerons cetteapplication. Cette méthode main standard crée un objet. Aucune modification ne doitêtre faite ici.4. La méthode MonProgramme (le nom doit être celui du fichier Java et celui présentdans la méthode main) contiendra le code à exécuter, comme l’indique lecommentaire.5. La méthode (ou fonction) action est appelée automatiquement lorsque l’utilisateurclique sur un composant visuel bouton. Elle est obligatoire dans tous vos programmesSLPack.2.2 Premier programme SLPackDans notre premier programme, nous allons calculer l’aire et le périmètre d’un rectangle.Voici la fenêtre que nous souhaitons obtenir :Fenêtre 1 : Application PremierExempleCette fenêtre contient de 3 types de composants graphiques :• des labels : des zones textes non modifiables par l’utilisateur• des textfields : des champs de saisie• des buttons : des boutons permettant de déclencher des actions.Le bouton calculer doit permettre de calculer l’aire et le périmètre en fonction des longueurset largeurs introduites par l’utilisateur. L’utilisateur doit pouvoir effectuer autant d’essais qu’ille souhaite, simplement en modifiant les champs longueur et largeur et en cliquant ànouveau sur le bouton calculer.Le bouton quitter doit permettre de quitter l’application. Il faut également qu’un clic sur lacroix en haut à droite (sous Microsoft Windows) provoque la fin du programme.Nous allons maintenant détailler le code et ensuite, partant de celui-ci, expliquer les conceptset possibilités de SLPack.© HELMo Informatique, 2013 6

import SLPack.SLForm;public class PremierExemple extends SLForm {public static void main(String [] args) {PremierExemple pe = new PremierExemple();}public PremierExemple() {// insérer le code source icisetDimension(3,4,80);setTitle("Aire rectangle");addLabel("lbLongueur", "Longueur:", 0, 0);addTextField("tfLongueur", "", 0, 1);addLabel("lbLargeur", "Largeur:", 1, 0);addTextField("tfLargeur", "", 1, 1);addLabel("lbAire", "Aire:", 0, 2);addLabel("lbAireResultat", "", 0, 3);addLabel("lbPerimetre", "Périmètre:", 1, 2);addLabel("lbPerimetreResultat", "", 1, 3);addButton("btCalculer", "Calculer", 2, 2);addButton("btQuitter", "Quitter", 2, 3);setVisible(true);}}public void action(String id) {// insérer la gestion des événements iciif(id.equals("btQuitter")) { quit(); }else if(id.equals("btCalculer")) {float longueur = getFloat("tfLongueur");float largeur = getFloat("tfLargeur");if(Float.isNaN(longueur) || Float.isNaN(largeur)) {setText("lbAireResultat", "Erreur donnée");setText("lbPerimetreResultat", "Erreur donnée");} else {setFloat("lbAireResultat", longueur*largeur);setFloat("lbPerimetreResultat", 2*(longueur+largeur));}}}Code 2 : Premier programme (PremierExemple.java)Le code coloré en bleu représente les mots clés du langage Java. Le code coloré en vertreprésente les méthodes (ou fonctions) spécifiques du composant SLPack. Les élémentscolorés en gris sont des commentaires.Le placement des composants est réalisé dans la méthode PremierExemple. Onremarque que l’on commence par définir la taille de la fenêtre (on en parlera plus tard).Ensuite, on définit le titre de la fenêtre, on ajoute les différents composants :• Ajout de texte via les labels. On peut ajouter autant de texte que souhaité en utilisantla méthode / fonction addLabel.• Ajout de champs de saisie (ou TextField) afin de permettre à l’utilisateur d’encoderdes informations (comme la longueur et la largeur dans cet exemple). Les champs desaisie sont ajoutés avec la méthode / fonction addTextField.• Ajout de boutons pour déclencher des actions. Dans notre cas il s’agit des boutonsCalculer et Quitter. Les boutons sont ajoutés avec la méthode / fonction addButton.Lorsque l’utilisateur clique sur un bouton, il déclenche une action. L’action estprogrammée dans la méthode action.© HELMo Informatique, 2013 7

La méthode action décrit les actions à déclencher lorsqu’un utilisateur clique sur unbouton. Ainsi, lorsque l’utilisateur clique sur un bouton placé dans une fenêtre, il fautassocier un comportement (des instructions) particulier.Lorsque l’utilisateur clique sur le bouton Calculer, il faut afficher les résultats dans la fenêtre.Lorsque l’utilisateur clique sur le bouton Quitter, il faut sortir du programme. Il est possiblede distinguer le bouton sur lequel l’utilisateur a cliqué (Calculer ou Quitter) grâce auparamètre id présent dans la méthode / fonction action. Le paramètre id reprend l’identifiantdu bouton sur lequel l’utilisateur a cliqué.Attention ! Les champs de saisie ne permettent pas de faire des vérifications (comme scanf).Rien n’interdit à l’utilisateur d’entrer une donnée incorrecte par rapport à ce qui est attendu.S’il rentre un caractère à la place de la longueur, il y aura une erreur.La fenêtre 2 montre un tel exemple.Fenêtre 2 : erreur dans la saisie des donnéesOn voit que la barre d’information annonçant la version est passée en couleur rouge. Celaindique qu’une erreur s’est produite dans le composant SLPack. Il faut alors examiner laconsole pour identifier le problème (ici, erreur de conversion du champ longueur vers unfloat).2.3 La fenêtre, la taille et le placement des composantsDans SLPack, la fenêtre est divisée en ligne et colonne (comme on peut le voir sur la fenêtre3). Les objets sont alors placés dans une « case » particulière de la fenêtre. On peutégalement mentionner la hauteur et la largeur de chaque composant.Ainsi, dans l’exemple (fenêtre 3), nous avons une fenêtre de taille 3 lignes x 4 colonnes.Nous avons décidé de placer :• Des labels dans les cases suivantes : (0,0) ; (0,2) ; (0,3) ; (1,0) ; (1,2) ; (1,3)• Des textfields dans les cases suivantes : (0,1) ; (1,1)• Des buttons dans les cases suivantes : (2,2) ; (2,3)Il reste 2 cases vides aux positions (2,0) et (2,1).© HELMo Informatique, 2013 8

Fenêtre 3 : fenêtre et composantsPour déterminer la taille de la fenêtre, il faut utiliser la méthode setDimension. Cette fonction/ méthode permet d’indiquer le nombre de lignes et le nombre de colonnes souhaités. Ellepermet également de mentionner la taille minimale de chaque composant. Nous décrironsexactement cette fonction plus loin.En ce qui concerne le placement des composants, chaque méthode d’ajout de composantaddLabel, addButton et addTextField prend comme paramètre la position de ce composantet sa taille exprimée en nombre de cases. Si la taille n’est pas précisée, la taille par défautest 1 case en hauteur et 1 case en largeur.© HELMo Informatique, 2013 9

3. Les composantsLe package SLPack permet d’utiliser 5 types de composants graphiques. Il y a les boutons,les zones de texte, les champs de saisie, la liste déroulante et les tables.Chaque composant est identifié au moyen d’une chaîne de caractère. Il ne peut y avoir deuxcomposants ayant même valeur comme identifiant. Les identifiants servent à gérer lesactions sur ces composants.3.1 Le boutonLe bouton est un composant permettant à l’utilisateur de commander l’application. Lorsqu’unutilisateur clique sur un bouton, il déclenche une action programmée. Les boutons serontdonc utilisés pour commander l’application.L’aspect graphique d’un bouton est :Le bouton est ajouté dans la fenêtre par la méthode addButton. Il faut donner un identifiantau bouton. Par convention, on utilisera un identifiant commençant par les lettres bt.La gestion des événements est expliquée dans la section 4.3.2 La zone de texte (ou label)La zone de texte est une zone permettant d’afficher un texte donné. Le texte n’est paséditable. Il peut être fixé par le programmeur au moment de la création du composant ouêtre fixé par après.Dans le code 2, nous avons des textes dont la valeur est spécifiée à la création ducomposant (par exemple pour le label identifié par lbAire) ou lors de l’exécution duprogramme (par exemple pour le label identifié par lbAireResultat) et la fonction setFloat.L’aspect graphique d’une zone de texte est :La zone de texte est ajoutée dans la fenêtre par la méthode addLabel. Il faut donner unidentifiant au label. Par convention, on utilisera un identifiant commençant par les lettres lb.Les méthodes (comme setFloat) pour modifier le contenu d’un composant seront vues dansla section 5.3.3 Le champ de saisie (ou TextField)Le champ de saisie est un champ permettant à l’utilisateur d’encoder une donnée. Le champde saisie est éditable par l’utilisateur. Le programmeur peut fixer une valeur à l’intérieur(bien que la plupart du temps, le champ de saisie est vide) lors de la création du composantou par après.© HELMo Informatique, 2013 10

Dans le code 2, nous avons créé des champs de saisie vides pour permettre à l’utilisateurd’encoder le périmètre et l’aire. Ces champs étaient identifiés par tfLongueur et tfLargeur.Puisqu’il s’agit de données introduites par l’utilisateur, il faut pouvoir récupérer la valeur deces données. Cela se fait grâce aux méthodes getText, getFloat, getInteger ou getDouble.L’aspect graphique d’un champ de saisie est :Le champ de saisie est ajouté dans la fenêtre par la méthode addTextField. Il fautmentionner un identifiant au textfield. Par convention, on utilisera un identifiant commençantpar les lettres tf.Les méthodes (comme getFloat) pour lire le contenu d’un composant seront vues dans lasection 5.3.4 La liste déroulanteLa liste déroulante est un composant graphique permettant à l’utilisateur de choisir unevaleur parmi une liste de chaînes de caractères déjà établie. Le contenu initial est fixé par leprogrammeur lors de la création du composant.L’aspect graphique d’une liste déroulante est :La liste déroulante est ajoutée dans la fenêtre par la méthode addComboBox ouaddExtendedComboBox. Il faut mentionner un identifiant à la combobox. Par convention, onutilisera un identifiant commençant par les lettres cb (pour une ComboBox standard) ou ecb(pour une ExtendedComboBox).Les méthodes pour récupérer l’élément sélectionné (comme getSelectedIndex), poursélectionner un élément (comme setSelectedIndex), pour fixer la liste de valeur (commesetListComboBox ou setListComboBoxExtended) ou récupérer la liste de valeur (viagetListComboBox ou getListExtendedComboBox) sont décrites dans la section 6.3.5 La case à cocher (ou Checkbox)La case à cocher (ou checkbox) est un composant graphique permettant à l’utilisateurd’activer ou non une option particulière. Elle peut prendre deux valeurs : cochée ou noncochée.L’aspect graphique d’une case à cocher est :La case à cocher est ajoutée dans la fenêtre par la méthode addCheckBox. Il fautmentionner un identifiant à la checkbox. Par convention, on utilisera un identifiantcommença,t par les lettres cbx.Les méthodes pour connaître l’état coché ou non de la case (comme getSelectedIndex), oupour modifier l’état (comme setSelectedIndex) sont décrites dans la section 6.© HELMo Informatique, 2013 11

3.6 La tableLa table est un composant graphique permettant d’afficher un tableau à 2 dimensions.Toutes les cases sont éditables. Le contenu initial peut être fixé par le programmeur lors dela création du composant.Lorsque le programmeur a besoin de récupérer les données contenues dans la table, il peutfaire appel aux méthodes getIntegerTable, getFloatTable, getDoubleTable ougetStringTable .Le programmeur peut également connaître la ligne sélectionnée par l’utilisateur au moyen dela méthode getSelectedIndex qui retourne l’index dans la table de la ligne sélectionnée.Enfin, la ligne des titres peut également être fixée par le programmeur au moyen de laméthode setTitleTable ou lors de la création de la table.L’aspect graphique d’une table (d’entier) est :La table est ajoutée dans la fenêtre par la méthode addArray. Il faut donner un identifiant àla table. Par convention, on utilisera un identifiant commençant par les lettres tb.Les méthodes pour récupérer le contenu du composant (comme getIntegerTable), pourconnaître la ligne ou les lignes sélectionnées (comme getSelectedIndex ougetSelectedIndexes) ou celles pour modifier le contenu du composant (commesetIntegerTable) seront vues dans la section 6.La table peut avoir un aspect un peu différent. En effet, s’il s’agit d’une table de chaine decaractères, dans certains cas, il est possible de faire apparaître dans une colonne une case àcocher. Nous verrons cet aspect dans la section 6 également.3.7 Le panneau de texte (ou TextPane, HTMLPane)Le panneau de texte (ou textpane ou htmlpane) est un composant graphique permettantd’afficher un texte assez long (avec ascenseur si nécessaire), pouvant s’étendre sur plusieurslignes, dans une fenêtre.© HELMo Informatique, 2013 12

La taille du composant est fixe et si le texte est important, celui-ci sera arrangé pour tenirdans le panneau en faisant apparaitre des barres de défilement si cela s’avère nécessaire.L’aspect graphique d’un panneau de texte est :Le panneau de texte peut être ajouté à la fenêtre par la méthode addTextPane ouaddHTMLPane. La première version (i.e. TextPane) autorise du texte sans mise en formealors que la seconde (i.e. HTMLPane) permet une mise en forme HTML. Il faut mentionnerun identifiant au textpane ou htmlpane. Par convention, on utilisera un identifiantcommençant par les lettres tp ou hp.Lors de l’ajout du panneau, il est possible de mentionner si le texte est modifiable ou non.Les méthodes getText et setText peuvent être utilisées pour récupérer le texte en cours oupour changer ce texte.© HELMo Informatique, 2013 13

4. Les événementsLorsqu’un utilisateur clique sur un bouton dans la fenêtre, il faut déclencher une action. Enfait, lorsqu’un utilisateur déclenche une telle action, la méthode action est appelée.Le schéma 1 montre l’action déclenchée par l’utilisateur lorsque celui-ci clique sur le boutonidentifié par btQuitter.L’utilisateur cliquesur le boutonpublic void action(String id){btQuitterbtQuitter}Schéma 1 : déclenchement d’un événementComme précisé plus haut, lorsqu’un utilisateur clique sur le bouton, la méthode action estautomatiquement appelée. Afin d’identifier clairement le bouton sur lequel l’utilisateur acliqué, le paramètre id contient l’identifiant du bouton sur lequel l’utilisateur a cliqué.Dans notre schéma 1, id prend la valeur btQuitter qui est l’identifiant du bouton Quitter. Decette manière, si notre fenêtre propose plusieurs boutons, nous serons toujours capablesd’identifier clairement le choix de l’utilisateur. Il suffit, pour ce faire, de comparer la valeurde id avec les identifiants de chaque bouton.Le code 2 montre un exemple d’utilisation avec deux boutons, btQuitter et btCalculer :if(id.equals("btQuitter")) {action à programmer lors d’un clic sur le bouton quitter.} else if(id.equals("btCalculer")) {action à programmer lors d’un clic sur le bouton calculer.}Dans notre système simplifié, il n’est possible de capturer les événements que sur lesboutons. Il convient donc d’utiliser les boutons pour commander l’application.© HELMo Informatique, 2013 14

5. Construction de la fenêtreDans cette section, nous allons détailler les méthodes avec précision afin de permettrel’utilisation du composant SLPack. Les méthodes sont proposées dans l’ordre logique de leurutilisation.5.1 setDimensionvoid setDimension(int row, int col, int minimumSize)void setDimension(int row, int col, boolean sameSize)Comme montré ci-dessus, il existe 2 versions de la méthode setDimension. Dans les deuxcas, les 2 premiers paramètres sont communs et permettent de déterminer la taille de lafenêtre en nombre de cases. Il faut spécifier le nombre de lignes (dans le paramètre row) etle nombre de colonnes (dans le paramètre col).Dans la 1 ère version, le dernier paramètre est un entier minimumSize définissant la tailleminimale d’une case.Dans la 2 ème version, le dernier paramètre est un booléen déterminant si toutes les casesdoivent avoir la même largeur ou pas.Il faut définir la taille de la fenêtre avant de placer des composants à l’intérieur.Si vous oublier de mentionner une taille de fenêtre, le système crée une fenêtrede taille 3 lignes x 3 colonnes.Si vous tentez de définir la taille de la fenêtre après avoir placé un composant,vous recevrez un message d’erreur.Exemple :setDimension (3, 4, 80);Cet appel définit la taille de la fenêtre à 3 lignes et 4 colonnes (donc 12 cases) avec unetaille minimale pour les cases de 80 points (ou pixel).setDimension (3,3, true);Cet appel définit la taille de la fenêtre à 3 lignes et 3 colonnes (donc 9 cases). Chaque caseayant une taille identique (la taille de la plus grande case sera utilisée).setDimension(5,3, false);Cet appel définit la taille de la fenêtre à 5 lignes et 3 colonnes (donc 15 cases). Les casesayant des tailles proportionnelles à leur contenu.5.2 setTitlevoid setTitle(String title)Cette méthode permet de fixer le titre de la fenêtre à la chaîne title passée en paramètre.Exemple :setTitle ("Calcul rectangle");Place le titre « Calcul rectangle » à la fenêtre.© HELMo Informatique, 2013 15

5.3 addButtonboolean addButton(String id, String content, int row, int col)boolean addButton(String id, String content, int row, int col, int width,int height)La seconde version de la méthode est la version la plus complète. Ces méthodes permettentde placer un bouton dans la fenêtre. Lorsqu’on ajoute un bouton, il faut préciser les donnéessuivantes :• id – l’identifiant de ce composant sous la forme d’une chaîne de caractère. Cetidentifiant permet de déterminer si un utilisateur a cliqué sur ce bouton.• content – détermine le texte à placer dans le bouton• row – détermine la ligne dans laquelle le bouton doit être placé. La première ligneest la ligne 0.• col – détermine la colonne dans laquelle le bouton doit être placé. La premièrecolonne est la colonne 0. Associé à la valeur précédente, nous avons la case où lebouton sera placé• width – détermine la largeur en nombre de colonnes du composant. Si elle n’est pasmentionnée, la largeur par défaut est 1.• height – détermine la hauteur en nombre de lignes du composant. Si celle-ci n’estpas mentionnée, la hauteur par défaut est 1.La fonction retourne un booléen indiquant si le bouton a pu être placé dans la (ou les)case(s) mentionnée(s).Exemple :addButton ("btCalculer", "Calculer", 2,2);Cet appel ajoute un bouton identifié par btCalculer dont le texte visible est calculer dans lacase (2,2) - donc 3 ème ligne, 3 ème colonne. La hauteur et la largeur par défaut (1 case) estutilisée.5.4 addLabelboolean addLabel(String id, String content, int row, int col)boolean addLabel(String id, String content, int row, int col, int width,int height)La seconde version de la méthode est la plus complète. Ces méthodes permettent de placerun texte non modifiable (appelé label) dans la fenêtre. Lorsqu’on ajoute un label, il fautpréciser les données suivantes :• id – l’identifiant de ce composant sous la forme d’une chaîne de caractère. Cetidentifiant permet de modifier le texte ou d’en obtenir la valeur.• content – détermine le texte à placer dans la zone.• row – détermine la ligne dans laquelle le label doit être placé. La première ligne estla ligne 0.• col – détermine la colonne dans laquelle le label doit être placé. La premièrecolonne est la colonne 0. Associé à la valeur précédente, nous avons la case où lelabel sera placé• width – détermine la largeur en nombre de colonnes du composant. Si elle n’est pasmentionnée, la largeur par défaut est 1.• height – détermine la hauteur en nombre de lignes du composant. Si celle-ci n’estpas mentionnée, la hauteur par défaut est 1.© HELMo Informatique, 2013 16

La fonction retourne un booléen indiquant si le bouton a pu être placé dans la (ou les)case(s) mentionnée(s).Exemple :addLabel ("lbAire", "Aire", 0,2);Cet appel ajoute un label identifié par lbAire dont le texte affiché est Aire dans la case (0,2)- donc 1 ère ligne, 3 ème colonne. La hauteur et la largeur par défaut (1 case) est utilisée.5.5 addTextFieldboolean addTextField(String id, String content, int row, int col)boolean addTextField(String id, String content, int row, int col,int width, int height)La seconde version de la méthode est la plus complète. Ces méthodes permettent de placerun champ de saisie (appelé TextField) dans la fenêtre. Lorsqu’on ajoute un TextField, il fautpréciser les données suivantes :• id – l’identifiant de ce composant sous la forme d’une chaîne de caractère. Cetidentifiant permet d’obtenir le texte entré ou d’en fixer la valeur.• content – détermine le texte par défaut à placer dans la zone.• row – détermine la ligne dans laquelle le TextField doit être placé. La première ligneest la ligne 0.• col – détermine la colonne dans laquelle le TextField doit être placé. La premièrecolonne est la colonne 0. Associé à la valeur précédente, nous avons la case où lelabel sera placé• width – détermine la largeur en nombre de colonnes du composant. Si elle n’est pasmentionnée, la largeur par défaut est 1.• height – détermine la hauteur en nombre de lignes du composant. Si celle-ci n’estpas mentionnée, la hauteur par défaut est 1.La fonction retourne un booléen indiquant si le TextField a pu être placé dans la (ou les)case(s) mentionnée(s).Exemple :addTextField ("tfLargeur", "", 1,1);Cet appel ajoute un textfield identifié par tfLargeur sans texte par défaut (l’utilisateur devraremplir la zone) dans la case (1,1) - donc 2 ème ligne, 2 ème colonne. La hauteur et la largeurpar défaut (1 case) est utilisée.Affiche la fenêtre construite précédemment.5.6 addComboBoxboolean addComboBox(String id, String[] content, int row, int col)boolean addComboBox(String id, String[] content, int row, int col, intwidth, int height)Ces méthodes permettent d’ajouter une liste déroulante simple dans une fenêtre. Les valeursinitiales sont données en paramètre. Par défaut, la première valeur est sélectionnée et© HELMo Informatique, 2013 17

affichée. Lorsqu’on ajoute une liste déroulante dans une fenêtre, il faut préciser les donnéessuivantes :• id – l’identifiant de ce composant sous la forme d’une chaîne de caractère. Cetidentifiant permet d’obtenir les valeurs de la liste, par la suite.• content – détermine la source des données. Il doit s’agir d’un tableau contenantdes données de type String.• row – détermine la ligne à laquelle la liste doit être placée. La première ligne est laligne 0.• col – détermine la colonne à laquelle la liste doit être placée. La première colonneest la colonne 0. Associé à la valeur précédente, nous avons la case début contenantle composant• width – détermine la largeur en nombre de colonne du composant. Si elle n’est pasmentionnée, la largeur par défaut est 1.• height – détermine la hauteur en nombre de lignes du composant. Si celle-ci n’estpas mentionnée, la hauteur par défaut est 1.5.7 addExtendedComboBoxboolean addExtendedComboBox(String id, String[][] content,int row, int col)boolean addExtendedComboBox(String id, String[][] content, int row, intcol, int width, int height)Ces méthodes permettent d’ajouter une liste déroulante étendue dans une fenêtre. Lesvaleurs initiales sont données en paramètre. Par défaut, la première valeur est sélectionnéeet affichée. Lorsqu’on ajoute une liste déroulante dans une fenêtre, il faut préciser lesdonnées suivantes :• id – l’identifiant de ce composant sous la forme d’une chaîne de caractères. Cetidentifiant permet d’obtenir les valeurs de la liste, par la suite.• content – détermine la source des données. Il doit s’agir d’un tableau à 2dimensions contenant des données de type String. Seule la dernière colonne estaffichée dans la combobox, les autres colonnes ne sont pas affichée mais sontprésentes dans le composant. Par exemple, pour garder l’identifiant et les valeurs.• row – détermine la ligne à laquelle la liste doit être placée. La première ligne est laligne 0.• col – détermine la colonne à laquelle la liste doit être placée. La première colonneest la colonne 0. Associé à la valeur précédente, nous avons la case début contenantle composant• width – détermine la largeur en nombre de colonne du composant. Si elle n’est pasmentionnée, la largeur par défaut est 1.• height – détermine la hauteur en nombre de lignes du composant. Si celle-ci n’estpas mentionnée, la hauteur par défaut est 1.5.8 addCheckBoxboolean addCheckBox(String id, String content, int row, int col)boolean addCheckBox(String id, String content, int row, int col, int width,int height)Ces méthodes permettent d’ajouter une case à cocher dans une fenêtre. La case est, pardéfaut, non cochée (pour changer le statut, il est nécessaire d’appeler la méthodesetSelectedIndex sur ce composant). Lorsqu’on ajoute une case à cocher dans une fenêtre, ilfaut préciser les données suivantes :© HELMo Informatique, 2013 18

• id – l’identifiant de ce composant sous la forme d’une chaîne de caractères. Cetidentifiant permet d’obtenir l’état de la case, par la suite.• content – détermine le texte qui sera affiché à côté de la case.• row – détermine la ligne à laquelle la case doit être placée. La première ligne est laligne 0.• col – détermine la colonne à laquelle la case doit être placée. La première colonneest la colonne 0. Associé à la valeur précédente, nous avons la case début contenantle composant• width – détermine la largeur en nombre de colonne du composant. Si elle n’est pasmentionnée, la largeur par défaut est 1.• height – détermine la hauteur en nombre de lignes du composant. Si celle-ci n’estpas mentionnée, la hauteur par défaut est 1.5.9 addArrayboolean addArray(String id, int[][] content, int row, int col)boolean addArray(String id, int[][] content, int row, int col, int width,int height)boolean addArray(String id, int[][] content, String[] title, int row,int col, int width, int height)boolean addArray(String id, float[][] content, int row, int col)boolean addArray(String id, float[][] content, int row, int col,int width, int height)boolean addArray(String id, float[][] content, String[] title, int row,int col, int width, int height)boolean addArray(String id, double[][] content, int row, int col)boolean addArray(String id, double[][] content, int row, int col,int width, int height)boolean addArray(String id, double[][] content, String[] title, int row,int col, int width, int height)boolean addArray(String id, String[][] content, int row, int col)boolean addArray(String id, String[][] content, String[] title, int row,int col, int width, int height)Ces méthodes permettent d’afficher un tableau dans une fenêtre. Le tableau est affiché etentièrement modifiable. Lorsqu’on ajoute un tableau dans une fenêtre, il faut préciser lesdonnées suivantes :• id – l’identifiant de ce composant sous la forme d’une chaîne de caractère. Cetidentifiant permet d’obtenir les valeurs de la table, par la suite.• content – détermine la source des données. Il doit s’agir d’un tableau à 2dimensions contenant des données de type int, float, double ou String.• title – détermine la ligne de titre. Il doit s’agir d’un tableau de String dont lenombre de colonnes doit correspondre à celui des données. Cet élément n’est pasobligatoire.• row – détermine la ligne à laquelle la table doit être placée. La première ligne est laligne 0.• col – détermine la colonne à laquelle la table doit être placée. La première colonneest la colonne 0. Associé à la valeur précédente, nous avons la case début contenantle composant© HELMo Informatique, 2013 19

• width – détermine la largeur en nombre de colonne du composant. Si elle n’est pasmentionnée, la largeur par défaut est 1.• height – détermine la hauteur en nombre de lignes du composant. Si celle-ci n’estpas mentionnée, la hauteur par défaut est 1.5.10 addTextPane et addHTMLPaneboolean addTextPane(String id, String content, boolean isEditable, int row,int col)boolean addTextPane(String id, String content, boolean isEditable, int row,int col, int width, int height)boolean addHTMLPane(String id, String content, boolean isEditable, int row,int col)boolean addHTMLPane(String id, String content, boolean isEditable, int row,int col, int width, int height)Ces méthodes permettent d’ajouter un panneau de texte (sans mise en forme) ou HTML(avec mise en forme) dans une fenêtre. Le panneau contient le texte passé en paramètre etpeut être modifié si l’on mentionne cette option. Lorqu’on ajoute un panneau de texte ouHTML dans une fenêtre, il faut préciser les données suivantes :• id – l’identifiant de ce composant sous la forme d’une chaîne de caractères. Cetidentifiant permet d’obtenir le texte courant du panneau, par la suite.• content – détermine le texte qui sera affiché dans le panneau.• isEditable – détermine si le texte peut être modifié par l’utilisateur dans lafenêtre. La valeur false empêche toute édition alors que la valeur true permet àl’utilisateur de modifier le texte en question.• row – détermine la ligne à laquelle le panneau doit être placé. La première ligne estla ligne 0.• col – détermine la colonne à laquelle le panneau doit être placé. La premièrecolonne est la colonne 0. Associé à la valeur précédente, nous avons la case débutcontenant le composant• width – détermine la largeur en nombre de colonne du composant. Si elle n’est pasmentionnée, la largeur par défaut est 1.• height – détermine la hauteur en nombre de lignes du composant. Si celle-ci n’estpas mentionnée, la hauteur par défaut est 1.Exemple :String description = "Ce disque dur externe peut être utilisé sur tous lestype d’ordinateur, il a une capacité de 2 To et se connecte en USB 3" ;addTextPane ("tpDescription", description, true, 1,1, 3, 2);String HTMLDescription = " Cedisque dur externe peut être utilisé sur tous les type d’ordinateur, il aune capacité de 2 To et se connecte en USB 3";addHTMLPane ("thDescription", HTMLDescription, false, 2,1, 4, 3);Dans ce premier exemple, un panneau de texte est ajouté dans la fenêtre. Il contient letexte qui se trouve dans la donnée description. Il est éditable par l’utilisateur et estpositionné aux coordonnées 1, 1 et occupe 3 colonnes et 2 lignes. S’il faut récupérer lecontenu modifié par l’utilisateur, il faut utiliser la méthode getText décrite au point 6.2.Inversement, s’il faut placer un texte précis dans le panneau, il convient d’utiliser la méthodesetText décrite au point 6.3.© HELMo Informatique, 2013 20

Dans le second exemple, un panneau HTML est ajouté dans la fenêtre. Il contient le textemis en forme qui se trouve dans la donnée HTMLDescription. Il n’est pas modifiable et estpositionné aux coordonnées 2, 1 et occupe 4 colonnes et 3 lignes. Les méthodes getText etsetText peuvent être utilisées pour, respectivement, obtenir ou modifier le texte. Il faut noterla manière dont le format HTML est inséré : comme celui-ci doit contenir des guillemets, ilest nécessaire de placé le caractère backslah (\) devant afin que Java ne confonde pas cesguillemets avec la fin de la chaîne de caractères.5.11 setVisiblevoid setVisible(boolean value)Cette méthode permet d’afficher ou de cacher la fenêtre. Le paramètre de cette méthodeest :• value – qui est un booléen. Si la valeur est true, le système construit la fenêtre etplace les différents composants à l’intérieur et rend cette fenêtre visible. Si la valeurest false, le système cache la fenêtre.Cette méthode doit être appelée une seule fois lorsque tous les composants ont été placéssur la fenêtre.Exemple :setVisible(true);5.12 messageOKBoxint messageOKBox(String message)Cette méthode permet d’afficher une petite fenêtre d’information reprenant le messagepassé en paramètre. Utile pour informer l’utilisateur d’un événement.La valeur entière retournée est 0.Exemple :messageOKBox("La valeur entrée n’est pas valide");5.13 messageYESNOBoxint messageYESNOBox(String message)Cette méthode permet d’afficher une fenêtre de confirmation avec les boutons OUI, NON etANNULER. Le message affiché dans la fenêtre est celui passé en paramètre.La valeur entière retournée dépend du bouton sur lequel l’utilisateur a cliqué. S’il a cliquésur le bouton :© HELMo Informatique, 2013 21

• OUI, la valeur retournée est 0• NON, la valeur retournée est 1• ANNULER, la valeur retournée est 2• De fermeture de la fenêtre (la croix en haut à droite), la valeur retournée est -1Exemple :rep = messageYESNOBox("Voulez-vous quitter ? ");5.14 inputIntegerBoxint inputIntegerBox(String message)Cette méthode permet de demander à l’utilisateur une valeur entière. Une fenêtre spécifiqueapparaît avec le message passé en paramètre.La valeur entière retournée est celle saisie par l’utilisateur pour autant que le format estcorrect ou la valeur particulière Integer.MIN_VALUE (plus petite valeur représentable surun entier) en cas d’erreur ou d’abandon de la saisie (choix du bouton annuler oufermeture par la croix en haut à droite de la fenêtre).Exemple :age = inputIntegerBox("Entrez l’age :");if(age == Integer.MIN_VALUE) { // Erreur dans la saisie }5.15 inputFloatBoxfloat inputFloatBox(String message)Cette méthode permet de demander à l’utilisateur de saisir une valeur réelle. Une fenêtrespécifique apparaît avec le message passé en paramètre.La valeur réelle retournée est celle saisie par l’utilisateur pour autant que le format soitcorrect ou la valeur particulière Float.NaN (problème de conversion) en cas d’erreur oud’abandon de la saisie (choix du bouton annuler ou fermeture par la croix en haut à droitede la fenêtre).Exemple :longueur = inputFloatBox("Entrez la longueur :");© HELMo Informatique, 2013 22

if(Float.isNaN(longueur)) { // Erreur dans la saisie }5.16 inputDoubleBoxdouble inputDoubleBox(String message)Cette méthode permet de demander à l’utilisateur de saisir une valeur réelle précise. Unefenêtre spécifique apparaît avec le message passé en paramètre.La valeur double retournée est celle saisie par l’utilisateur pour autant que le format soitcorrect ou la valeur particulière Double.NaN (problème de conversion) en cas d’erreurou d’abandon de la saisie (choix du bouton annuler ou fermeture par la croix en haut àdroite de la fenêtre).Exemple :largeur = inputDoubleBox("Entrez la largeur :");if(Double.isNaN(largeur)) { // Erreur dans la saisie }5.17 inputStringBoxString inputStringBox(String message)Cette méthode permet de demander à l’utilisateur de saisir une chaîne de caractère. Unefenêtre spécifique apparaît avec le message passé en paramètre.La chaîne retournée est celle saisie par l’utilisateur ou la référence null si l’utilisateur choisitle bouton annuler ou clique sur la croix (en haut à droite).Exemple :nom = inputStringBox("Entrez votre nom :");if(nom == null) { // Abandon de la saisie }© HELMo Informatique, 2013 23

5.18 inputFileChooserBoxString inputFileChooserBox()Cette méthode permet à l’utlisateur d’aller sélectionner un fichier en parcourant les fichierset répertoire de son ordinateur. S’il choisit d’abandonner la sélection, la méthode retourne laréférence null sinon le chemin complet vers le fichier sélectionné est retourné.Exemple :nomFichier = inputFileChooserBox() ;L’exécution de cette méthode entraînera l’affichage d’une fenêtre standard de sélection dontnous pouvons voir un exemple ci-dessous.6. Méthodes usuelles6.1 Comment quitter ? les méthodes quit et canQuitvoid quit()boolean canQuit()© HELMo Informatique, 2013 24

La méthode quit() est la méthode qui doit être appelée pour quitter l’application. Cetteméthode appelle la méthode canQuit(). En fonction du résultat, l’application se termine ounon.La méthode quit() est également appelée automatiquement lorsque l’utilisateur cliquesur la croix de fermeture de la fenêtre (en haut à droite).La méthode canQuit() permet :• de demander à l’utilisateur une confirmation ;• de libérer toutes les ressources nécessaires (sauvegarde et fermeture de fichiers, …)• de clôturer les opérations avant de quitterSi la méthode canQuit() retourne true, l’application se ferme. Si la méthode canQuit()retourne false, l’application reste active.Une méthode canQuit() par défaut est déjà programmée et retourne la valeur true. Ilvous est possible de changer cette méthode pour l’adapter à vos besoins.Exemple :public boolean canQuit() {int rep ;rep = messageYESNOBox("Voulez-vous vraiment quitter ?");return(rep == 0); // Si l’utilisateur clique sur Oui -> true}public void action(String id) {if(id.equals("btCalculer")) {...} else if(id.equals("btQuitter")) {quit();}}Dans cet exemple, par la programmation de la méthode canQuit(), nous avons choisi deprogrammer une confirmation avant de quitter. Si l’utilisateur clique sur le bouton Quitter(identifié dans le code par btQuitter) ou si l’utilisateur clique sur la croix de fermeture de lafenêtre (en haut à droite), la méthode canQuit() est exécutée et une demande deconfirmation est affichée à l’écran. L’utilisateur peut choisir de confirmer ou d’annuler lafermeture de l’application.6.2 Extraire une valeur d’un composantString getText(String id)double getDouble(String id)float getFloat(String id)int getInteger(String id)Ces méthodes permettent d’extraire le contenu d’un composant sous la forme d’une chaînede caractères (pour getText()), d’un réel précis (pour getDouble()), d’un réel (pourgetFloat()) ou d’un entier (pour getInteger()).Le paramètre id doit désigner l’identifiant d’un composant existant dans la fenêtre. Sil’identifiant désigne un composant de type :© HELMo Informatique, 2013 25

• label – les méthodes retournent le texte affiché• textfield – les méthodes retournent le texte saisi par l’utilisateur• button – les méthodes retournent le texte du boutonPour les tables, des méthodes particulières sont utilisées. Elles sont détaillées ci-dessous.Si, lors de la conversion, une erreur survient, ces méthodes retournent des valeursparticulières :• getDouble() retourne la valeur Double.NaN en cas d’erreur de conversion• getFloat() retourne la valeur Float.NaN en cas d’erreur de conversion• getInteger() retourne la valeur Integer.MIN_VALUE en cas d’erreur deconversionExemples :age = getInteger("tfAge");longueur = getFloat("lbLongueur");double largeur = getDouble("tfLargeur");String texteBouton = getString("btQuitter");Dans cet exemple, l’age est extrait du composant tfAge. En cas d’erreur de conversion de lavaleur entière (si l’utilisateur n’entre pas une valeur valide), age prendra la valeurInteger.MIN_VALUE.La longueur est extraite du composant lbLongueur. En cas d’erreur de conversion de lavaleur réelle (si le format n’est pas correct), longueur prendra la valeur Float.NaN.La largeur est extraite du composant tfLargeur. En cas d’erreur de conversion de la valeurréelle précise (si le format n’est pas correct), largeur prendra la valeur Double.NaN.La donnée texteBouton est extraite du composant btQuitter (s’il s’agit d’un bouton, c’est letexte du bouton qui est retourné).6.3 Placer une valeur dans un composantboolean setText(String id, String val)boolean setFloat(String id, float val)boolean setDouble(String id, double val)boolean setInteger(String id, int val)Ces méthodes permettent de « placer » la valeur val dans le composant identifié par lachaîne id. Il faut que le composant id existe dans la fenêtre.Si l’identifiant désigne un composant de type :• label – les méthodes modifient le texte placé dans ce label• textfield – les méthodes modifient le champ de saisie pour y placer la valeur• button – les méthodes modifient le texte affiché sur le boutonCes méthodes retournent une valeur booléenne qui prend :• la valeur true si la modification a été effectuée• la valeur false si le composant identifié par id n’a pas pu être trouvé.Exemples :© HELMo Informatique, 2013 26

setFloat("lbAireResultat", longueur*largeur);setText("lbAireResultat", "Erreur de donnée");setDouble("tfLargeur", 3.5);setInteger("btNum", 1);Dans le 1 ier exemple, le résultat de l’expression longueur*largeur est placé dans lecomposant lbAireResultat (sous la forme d’un réel). Le contenu précédent est perdu.Dans le 2 ème exemple, le texte Erreur de donnée est placé dans le composant lbAireResultat.Le contenu précédent est perdu.Dans le 3 ème exemple, la valeur 3,5 est placé dans le composant tfLargeur (sous la formed’un réel précis). Le contenu précédent est perdu.Dans le 4 ème exemple, la valeur 1 est placée dans le composant btNum (sous la forme d’unentier). Le contenu précédent est perdu.6.4 Gérer les listes déroulantesUne liste déroulante est un composant reprenant une collection de valeur. Elle ne peut doncpas être gérer de la même façon que les composants précédents.Il existe deux versions pour la liste déroulante, la ComboBox et l’ExtendedComboBox. Ils’agit du même composant graphique. La seule différence est que la ComboBox gère etaffiche une seule liste d’élément. En revanche, l’ExtendedComboBox gère une table complèteet n’affiche qu’une seule colonne, la dernière. Son principal intérêt est de pouvoir afficherdes valeurs mais garder en mémoire des informations complémentaires comme desidentifiants par exemple. Ce composant est particulièrement utile pour les bases de données.Dans les 2 versions, il n’y a pas de méthode particulière pour modifier un élément déterminéde la liste, il est nécessaire d’agir sur l’ensemble. Ainsi, il est possible de récupérerl’ensemble des valeurs sous la forme d’un tableau de chaînes de caractères ou encore d’enspécifier un ensemble de nouvelles valeurs.Voici les méthodes intéressantes pour la gestion de ces listes déroulantes :a) cas d’une comboboxboolean setListComboBox(String id, String[] content)String[] getListComboBox(String id)int getSelectedIndex(String id)void setSelectedIndex(String id, int index)La méthode setListComboBox permet de fixer ou modifier le contenu de la liste déroulante.La liste est alors directement mise à jour en fonction du contenu du tableau de chaîne fournien paramètre.La méthode getListComboBox permet d’obtenir la liste des valeurs de la liste déroulante. Lesvaleurs sont retournées sous la forme d’un tableau de chaines de caractères.La méthode getSelectedIndex permet de connaître l’index dans la liste qui est actuellementsélectionné et choisi par l’utilisateur. Il s’agit de l’indice dans le tableau de valeur, la 1 èrevaleur se trouve à l’indice 0.© HELMo Informatique, 2013 27

La méthode setSelectedIndex permet de sélectionner un élément dans la liste. Cetteméthode est particulièrement intéressante avant l’affichage des valeurs pour que la valeuraffichée soit définie (par défaut, il s’agit du 1 ier élément de la liste). Cette méthode prend, enparamètre, l’identifiant de la combobox et l’indice dans le tableau, à sélectionner. Il fautnoter que la 1 ère valeur se trouve à l’indice 0.Exemple :String[] maListe = {"zero", "un", "deux", "trois" } ;...setListComboBox("cbListe", maListe);setSelectedIndex("cbListe", 2);System.out.println("La valeur selectionne est : " +maListe[getSelectedIndex("cbListe")]) ;b) cas d’une ExtendedComboBoxboolean setListExtendedComboBox(String id, String[][] content)String[][] getListExtendedComboBox(String id)int getSelectedIndex(String id)void setSelectedIndex(String id, int index)La méthode setListExtendedComboBox permet de fixer ou modifier le contenu de la listedéroulante. La liste est alors directement mise à jour en fonction du contenu du tableau dechaîne fourni en paramètre (seule la dernière colonne est affichée).La méthode getListExtendedComboBox permet d’obtenir la liste des valeurs complète (tout letableau) et non pas uniquement la liste affichée. Les valeurs sont retournées sous la formed’un tableau de chaines de caractères.La méthode getSelectedIndex permet de connaître l’index dans la liste qui est actuellementsélectionné et choisi par l’utilisateur. Il s’agit de l’indice dans le tableau de valeur, la 1 èrevaleur se trouve à l’indice 0.La méthode setSelectedIndex permet de sélectionner un élément dans la liste. Cetteméthode est particulièrement intéressante avant l’affichage des valeurs pour que la valeuraffichée soit définie (par défaut, il s’agit du 1 ier élément de la liste). Cette méthode prend, enparamètre, l’identifiant de la combobox et l’indice dans le tableau, à sélectionner. Il fautnoter que la 1 ère valeur se trouve à l’indice 0.Exemple :String[][] maListe = { {"1", "zero"}, {"2", "un"}, {"3", "deux"},{"4", "trois"} } ;...setListExtendedComboBox("ecbListe", maListe);setSelectedIndex("ecbListe", 2);...String[][] val = getListExtendedComboBox("ecbListe");System.out.println("La valeur selectionne est : " +val[getSelectedIndex("ecbListe")][1] + " et l’ID est " +val[getSelectedIndex("ecbListe")][0]) ;© HELMo Informatique, 2013 28

6.5 Gérer les tablesUne table est un composant un peu particulier car il s’agit d’une collection de valeur. Elle nepeut donc pas être gérée de la même façon que pour les composants simples.Il n’y a pas de méthode pour modifier l’élément spécifique d’une ligne ou d’une colonne de latable, on doit agir sur l’ensemble. Ainsi, il est possible de récupérer l’ensemble des valeurssous la forme d’un tableau ou encore d’en spécifier un ensemble de valeurs.Pour modifier les titres des colonnes, il faut utiliser la méthode suivante :boolean setTitleTable(String id, String [] titre)Cette méthode remplace les titres de la table identifiée par id par les éléments contenusdans le tableau titre fourni en paramètre. Il faut que le nombre de colonnes du tableau titresoit identique à celui des données.Les méthodes permettant de modifier le contenu des valeurs affichées sont les suivantes :boolean setIntegerTable(String id, int[][] content)boolean setFloatTable(String id, float[][] content)boolean setDoubleTable(String id, double[][] content)boolean setStringTable(String id, String [][] content)Suivant le type de données dans la table identifiée par Id, il faut choisir la méthode setadéquate. On peut de cette manière mettre à jour l’ensemble des données de la table. Laméthode retourne true si la mise à jour a pu être opérée, false sinon.Exemple :int[][] table = new Integer[4][4] ;...setIntegerTable("tbEntier1", table);Dans cet exemple, le composant tbEntier1 est mis à jour et les données dans la table sontreprises de la donnée table passée en paramètre.Pour obtenir le contenu de la table (qui peut avoir été modifié par un utilisateur), il faututiliser l’une des méthodes suivantes :int[][] getIntegerTable(String id)float[][] getFloatTable(String id)double[][] getDoubleTable(String id)String[][] getStringTable(String id)int getSelectedIndex(String id)int[] getSelectedIndexes(String id)Suivant le type de données présent dans la table identifiée par Id, il faut choisir la méthodeget adéquate. Ces méthodes permettent de récupérer l’ensemble des données contenuesdans la table sous la forme d’un tableau.© HELMo Informatique, 2013 29

La méthode getSelectedIndex permet de connaître l’index dans la liste qui est actuellementsélectionné et choisi par l’utilisateur. Il s’agit de l’indice dans le tableau de valeur, la 1 èrevaleur se trouve à l’indice 0. Si aucune ligne n’est sélectionnée, la valeur -1 est retournée.La méthode getSelectedIndexes permet de connaître les index dans la liste des élémentssélectionnés et choisis par l’utilisateur. La méthode retourne alors un tableau d’entier (et lepremier élément commence à l’indice 0). Si aucune ligne n’est sélectionnée, la valeur null estretournée.Exemple :int[][] matable = new Integer[4][4];int[] selectionEnCours;...matable = getIntegerTable("tbEntier1");selectionEnCours = getSelectedIndexes("tbEntier1");Dans cet exemple, le contenu de le table tbEntier1 est retourné et le résultat est placé dansla donnée matable qui est un tableau à 2 dimensions. Le programme peut alors traiter lesdonnées récupérées.a) Faire apparaître une case à cocher dans une tableDans certains cas, il est intéressant de faire apparaître une case à cocher dans la table afinde représenter une valeur de type booléenne. Pour que cela fonctionne, voici comment ilfaut procéder :• La table doit contenir des éléments de type chaine de caractères (String donc)• La colonne pour laquelle on souhaite faire apparaître une case à cocher doit contenirla chaine texte true ou false. Aucune autre valeur n’est autorisée sinon la donnéesera affichée sous la forme d’une chaine.© HELMo Informatique, 2013 30

7. Accès aux bases de donnéesSLPack permet l’accès aux bases de données de type SQL Server et Oracle. Ces deux SGBDR(systèmes de gestion de base de données relationnels) sont disponibles et utilisés dans lecadre des laboratoires.Pour que l’accès fonctionne, il est nécessaire de disposer des drivers JDBCcorrectement installés (voir section 1. 3).Afin de pouvoir accéder à une base de données, un composant particulier SLDB a étéconstruit. Ce composant permet d’établir la connexion avec un serveur de base de données,d’exécuter une requête de sélection, d’exécuter une requête de mise à jour, de débuter unetransaction, d’enregistrer les modifications suite à une transaction réussie (COMMIT) ouencore d’abandonner les modifications suite à une transaction annulée (ROLLBACK).7.1 L’objet SLDBToutes les méthodes que nous verrons dans cette section s’appliquent sur un objetparticulier, créé pour cet usage, l’objet SLDB.Avant de pouvoir établir une connexion, il est donc nécessaire de créer l’objet SLDB. Pour cefaire, rien de plus simple, il suffit de le créer comme suit :SLDB db = new SLDB() ;Cette instruction permet de créer un objet de type SLDB qui pourra être utilisé pour accéderà la base de données. Par facilité, il vaut mieux déclarer cet objet directement commedonnée privée de la classe. Ainsi, on trouvera très souvent la définition suivante :public class Programme extends SLForm {private SLDB db = new SLDB();...}public Programme() {...}public void action(String id) {...}public static void main (String[] args) {new Programme();}code 3 : Squelette minimal d’un programme avec base de données7.2 Interaction avec la base de donnéesAfin de permettre des interactions avec la base de données, les méthodes (ou fonctions)suivantes sont définies :7.2.1 Connexionpublic boolean connectToOracle(String host, String login, String pass,String dbName);© HELMo Informatique, 2013 31

public boolean connectToMSSQL(String host, String login, String pass,String dbName);Ces deux méthodes permettent la connexion au serveur de base de données. Suivant leserveur utilisé, on choisira la méthode connectToOracle ou connectToMSSQL. Ces deuxméthodes prennent les mêmes paramètres :• host : le nom ou l’adresse IP du serveur de base de données. À Saint-Laurent,Oracle est disponible sur Dartagnan (172.16.130.13) et SQL Server sur Pothos(172.16.130.14).• login : le nom d’utilisateur pour la connexion• pass : le mot de passe associé• dbName : le nom de la base de données. Sous Oracle, le nom de la base de donnéesest obligatoirement XE (pour eXpress Edition).Ces méthodes retournent un booléen qui vaut :• true si la connexion a pu être établie• false si une erreur est survenue (reportez-vous à la console pour plusd’explication).Remarque :Si l’erreur suivante apparaît : Error while loading the JDBC Driver (driver not found, not inclasspath, …), cela signifie que les pilotes JDBC n’ont pas pu être trouvés. Reportez-vous à lasection 1.3 pour corriger cette erreur.Exemple :if(db.connectToOracle("172.16.130.13", "i10299", "3012", "XE")) {System.out.println("Connexion réussie");} else {System.out.println("Connexion ratée");}7.2.2 Exécuter une requête de sélectionpublic String[][] executeQuery(String requete);Cette méthode permet de lancer l’exécution d’une requête de sélection (qui retourne unrésultat) sur la base de données. Il est nécessaire que la connexion à la base de données aitété établie au préalable.Cette méthode prend, en paramètre :• requete – La requête SQL de sélection (SELECT) qui doit être envoyée à la base dedonnéesCette méthode retourne le résultat de la requête sous la forme d’un tableau de String à deuxdimensions. Le nombre de lignes dépend du nombre de résultats retournés par la requêtetandis que le nombre de colonne dépend du nombre de champs sélectionnés.En cas d’erreur, la valeur null est retournée et un message est envoyé sur la console.Exemple :String[][] tblResultat;tblResultat = db.executeQuery("SELECT numLivre, titre, cote FROM livres");© HELMo Informatique, 2013 32

7.2.3 Exécuter une requête de mise à jourpublic int executeUpdate(String requete);Cette méthode permet d’exécuter une mise à jour sur la base de données. Cette mise à jourest indépendante. Si vous souhaitez lier plusieurs requêtes de mise à jour entre-elles, ilconvient d’utiliser une transaction.Avant de pouvoir procéder à l’exécution d’une mise à jour, il est nécessaire que la connexionvers la base de données ait été établie.Cette méthode prend, en paramètre :• requete – La requête SQL de mise à jour (UPDATE) qui doit être envoyée à la basede données.Cette méthode retourne un entier qui correspond aux nombres de lignes effectivement misesà jour après l’exécution de la requête ou -1 en cas d’erreur. Si une erreur survient, unmessage sur la console est également envoyé.Exemple :int resultat = db.executeUpdate("UPDATE livres SET cote=0");if(resultat < 0) {System.out.println("Une erreur est survenue !");}7.2.4 Les transactionspublic boolean openTransaction();public boolean commit();public boolean rollback();Les transactions permettent d’exécuter un ensemble de requêtes ensembles. Ainsi, en cas deproblème, toutes les modifications effectuées peuvent être abandonnées.Toutes ces méthodes ont une signature identique : elles ne prennent aucun paramètre etretourne un résultat de type booléen. Ainsi, chaque méthode retourne :• true – si aucune erreur n’a été rencontrée• false – si un problème est survenu. Dans ce cas, un message d’erreur est retournésur la console.Pour débuter la transaction, il faut invoquer la méthode openTransaction(). Cetteméthode reporte toutes les modifications qui vont être effectuées jusqu’à la clôture de latransaction. Avant de pouvoir débuter une transaction, il est nécessaire que la connexionvers la base de données ait été établie.Pour clôturer la transaction, il faut faire appel à l’une des deux méthodes suivantes :• commit() – qui va enregistrer les modifications de manière durable dans la base dedonnées• rollback() – qui retourne à l’état juste avant le début de la transaction et annuleainsi toutes les modifications.© HELMo Informatique, 2013 33

Exemple :if(db.openTransaction()) {if( (db.executeUpdate("...")>= 0) && (db.executeUpdate("...")>= 0) )db.commit() ;elsedb.rollback() ;}7.2.5 Déconnexion de la base de donnéespublic boolean disconnect();Afin de libérer les ressources, il est préférable de fermer la connexion à la base de donnéesde manière explicite. Pour ce faire, il suffit d’invoquer la méthode disconnect().Cette méthode retourne un booléen, qui vaut :• true – si la déconnexion a pu être réalisée sans erreur• false – si une erreur est survenue lors de la déconnexion. Dans ce cas, un messageest également retourné dans la console.Exemple :db.disconnect() ;© HELMo Informatique, 2013 34

RemerciementsJ’aimerais remercier toutes les personnes qui ont contribué au développement de cecomposant. En particulier, mon collègue Nicolas Hendrikx, avec qui j’ai imaginé les grandeslignes de cet outil, en espérant qu’il sera apprécié. J’aimerais également remercier mescollègues et les étudiants qui ont, par leurs intérêts, leurs remarques et leurs souhaits,permis de corriger et d’améliorer ce composant.Bibliographie et références[1] Bruce Eckel, Thinking in Java, Prentice-Hall, 3 rd edition, December 2002,http://mindview.net/Books/TIJVersion française disponible sur : http://penserenjava.free.fr[2] Cay S. Horstmann, Gary Cornell, Core Java 2 : Volume 1 Fundamentals, SunMicrosystems, 7 th edition, 2005[3] Cay S. Hortsmann, Gary Cornell, Core Java 2 : Volume 2 Advanced Features, SunMicrosystems, 7 th editon, 2005Information de CopyrightJava TM , Netbeans TM , Oracle ® , Oracle ® Database Express Edition are registered trademarks ofOracle and/or its affiliates. Other names may be trademarks of their respective owners.Eclipse © Copyright Eclipse contributors and others 2000, 2010. All rights reserved. Eclipseis a trademark of Eclipse Foundation Inc.IntelliJ IDEA © 2000-2010 JetBrains s.r.o. All rights reserved.Microsoft ® , Microsoft Windows ® , Microsoft SQL Server ®Corporation and/or its affiliates.are trademarks of MicrosoftTous les noms et marques des produits cités sont des marques déposées par leursproducteurs respectifs.© HELMo Informatique, 2013 35