Ce tutoriel vous permet de vous familiariser avec l'environnement de développement intégré (EDI) de JBuilder. Le tutoriel montre comment :
JPanel
, JLabel
et JButton
.Fonctionnalité de JBuilder Professionnel et Entreprise.
Pour plus d'informations sur les conventions de la documentation, voir "Conventions utilisées par la documentation".
Le code source complet se trouve dans "Code source de HelloWorld" à la fin de ce tutoriel.
Remarque : Pour imprimer ce tutoriel, voir "Impression des tutoriels et autre documentation".
Si vous avez des suggestions à faire pour améliorer ce tutoriel, envoyez un e-mail à jpgpubs@borland.com.
Avant de créer une application dans JBuilder, vous devez créer un projet dans lequel travailler. JBuilder utilise un fichier projet (.jpx
ou .jpr
) pour organiser les fichiers de l'application et maintenir les paramètres de fonctionnement et les propriétés du projet. L'expert projet peut créer le projet à votre place.
Remarque : Au fur et à mesure que vous tapez dans le champ Nom du projet, le même nom est entré par défaut dans le champ Nom du répertoire du projet. Le projet est enregistré dans ce répertoire du projet, HelloWorld
.
Remarque : JBuilder utilise une extension .jpr
ou .jpx
pour les fichiers projet. Le type de fichier .jpr
sert de manière générale. Le type de fichier .jpx
, un fichier projet XML, est utilisé dans un environnement de développement en équipe et pour le contrôle de versions. Les deux types de fichiers fonctionnent pour ce tutoriel. Le tutoriel utilise l'extension .jpr
.
L'étape 1 de l'expert projet doit ressembler à ceci :
Remarque :Par défaut, JBuilder enregistre les projets dans le répertoire /<home>/jbproject/
. Le répertoire de base dépend de la plate-forme. Voir "Conventions de la documentation."
L'étape 3 de l'expert projet doit ressembler à ceci :
HelloWorld.jpr
et HelloWorld.html
, sont générés par l'expert et apparaissent dans le volet projet de l'AppBrowser.
Voir aussi : "Construction des chemins d'accès par JBuilder" et "Où sont mes fichiers ?" de "Création et gestion des projets" dans Construction d'applications avec JBuilder.
HelloWorld.html
, le fichier de notes du projet, pour le voir dans le volet contenu. Remarquez qu'il contient les informations du projet sur le nom, l'auteur, la société et la description saisies à l'étape 3 de l'expert projet.
L'expert application crée les fichiers source .java
qui seront ajoutés au projet que vous venez de créer.
Pour générer les fichiers source de votre application en utilisant l'expert application, procédez comme suit :
helloworld
, dans l'étape 1 de l'expert application. Par défaut, l'expert utilise le nom du fichier projet, HelloWorld.jpr
.
L'étape 1 de l'expert application doit ressembler à ceci :
L'étape 2 de l'expert application doit ressembler à ceci :
Les nouveaux fichiers source .java
et les images de la barre d'outils sont ajoutés à votre projet et affichés en tant que noeuds dans le volet projet. Le code source de HelloWorldCadre.java
est ouvert dans le volet contenu comme le montre l'image suivante.
Remarque : Dans les éditions JBuilder Professionnel et JBuilder Entreprise, un noeud de paquet source automatique, appelé helloworld
, apparaît également dans le volet projet lorsque l'option Activer automatiquement les paquets source est sélectionnée dans la page Général de la boîte de dialogue Propriétés du projet (Projet|Propriétés du projet).
Eléments de l'AppBrowser
Remarque : Les fichiers source sont enregistrés dans : /<home>/jbproject/HelloWorld/src/helloworld
Les fichiers classe sont enregistrés dans : /<home>/jbproject/HelloWorld/classes/helloworld
Maintenant, compilez et exécutez votre application.
Astuce : Vous pouvez aussi sélectionner HelloWorldClasse.java
dans le volet projet, cliquer avec le bouton droit et sélectionner Exécuter.
D'abord, le volet message s'ouvre en montrant le processus d'exécution. Ensuite, votre application s'affiche ; elle doit ressembler à ceci :
Remarque : L'application qui s'exécute dans ce tutoriel reflète l'apparence Windows.
Suivez les étapes ci-dessous pour personnaliser l'interface utilisateur de votre application.
HelloWorldCadre.java
dans le volet projet s'il n'est pas déjà ouvert.
Interface utilisateur
, Menu
et Autre
.
Eléments du concepteur d'interface utilisateur
JPanel
pour ajouter un panneau à votre conception.
Astuce : Placez le curseur sur un composant de la palette pour voir son nom s'afficher dans une bulle d'aide.
Remarque : La propriété constraints
, dans l'inspecteur, doit avoir la valeur Center. Sinon, cliquez sur la colonne de droite de la propriété constraints
et choisissez Center dans la liste déroulante.
jPanel1
est désormais sélectionné dans la conception de votre application, ainsi que dans l'arborescence des composants.
Remarque : Le composant sélectionné dans l'arborescence des composants ou dans le concepteur d'interface utilisateur s'affiche dans la barre d'état, en bas du volet structure.
jPanel1
.
background
.jPanel1
et changez sa couleur en Gray.
border
.jPanel1
en null
.
layout
.null
dans la liste déroulante.
null
, c'est à dire aucune disposition, est un bon choix lorsque vous prototypez votre conception. Comme null
n'utilise aucun gestionnaire de disposition, vous pouvez placer les composants exactement ou vous voulez qu'ils soient. Mais, null
utilisant le positionnement absolu des composants, et non le positionnement relatif, l'interface utilisateur ne se redimensionne pas correctement lorsque l'utilisateur change la taille de la fenêtre de l'application. De ce fait, il est conseillé de ne jamais laisser un conteneur en null
pour le déploiement. Plus tard dans ce tutoriel, vous pourrez choisir une disposition portable appropriée à votre conception et son déploiement.
Vous allez maintenant utiliser la palette des composants pour ajouter un composant JLabel
au composant JPanel
.
JLabel
.
JPanel
de votre conception en utilisant une des deux méthodes suivantes :
jPanel1
dans l'arborescence des composants. Cela place le composant dans le coin supérieur gauche du panneau.jPanel1
dans le concepteur. Le coin supérieur gauche du composant se place là où vous avez cliqué.jLabel1
est ajouté sous jPanel1
dans l'arborescence des composants. Si vous avez lâché le composant à un mauvais emplacement, vous pouvez le sélectionner, dans l'arborescence des composants ou dans le concepteur, et appuyer sur la touche Suppr. Ensuite, ajoutez-le à nouveau.
jLabel1
dans l'arborescence des composants et suivez les étapes ci-dessous :
text
. Tapez Hello World! Appuyez sur Entrée. "Hello World!" apparaît alors dans le libellé. Ne vous inquiétez pas s'il n'apparaît pas complètement dans le libellé. Vous corrigerez ce problème en changeant de fonte.font
pour définir la fonte. Cliquez sur le bouton Points de suspension pour ouvrir la boîte de dialogue.jLabel1
en faisant glisser les poignées noires jusqu'à ce que "Hello World!" soit complètement visible.foreground
pour définir la couleur du texte "Hello World!". Cliquez sur la flèche vers le bas et sélectionnez Blue dans la liste déroulante des couleurs.Votre conception doit ressembler à ceci :
Vous pouvez changer les informations de la boîte de dialogue A propos, en modifiant directement le code. Par défaut, la version créée par l'expert application est la version 1.0.
HelloWorldCadre_AboutBox.java
dans le volet projet pour ouvrir le fichier. Le volet contenu se transforme en une vue source où vous pouvez modifier le code dans l'éditeur.
String version = "1.0";
L'éditeur trouve le texte sélectionné.
1.0
et saisissez 2.0 entre les guillemets.
Vous pouvez maintenant compiler et exécuter l'application.
L'application "HelloWorld" s'affiche :
Vous pouvez aussi exécuter l'application hors de l'environnement de JBuilder, depuis la ligne de commande.
Remarque : Le répertoire jdk/bin/
qui contient la commande java doit se trouver dans votre chemin d'accès. Si java est dans votre chemin d'accès, lorsque vous saisissez java sur la ligne de commande, des informations expliquant la commande doivent s'afficher. Si ce n'est pas le cas, vous devez exécuter l'application depuis le répertoire jdk/bin/
.
Pour exécuter l'application,
java -classpath /<home>/jbproject/HelloWorld/classes helloworld.HelloWorldClasse
Remarque : Pour Windows, utilisez une barre oblique inversée (\).
Cette commande est de la forme :
java -classpath nom-paquet.nom-classe-principale
Dans cet exemple,
/<home>/jbproject/HelloWorld/classes
classes
a été défini comme chemin de destination des classes compilées à l'étape 1 de l'expert projet.c:\winnt\profiles\<nomutilisateur>
helloworld
HelloWorldClasse
Voir aussi : "Setting the classpath" et "Basic tools" à l'adresse http://java.sun.com/j2se/1.3/docs/tooldocs/tools.html
Nous allons maintenant ajouter un composant Swing à votre application.
HelloWorldCadre.java
, puis cliquez sur l'onglet Conception pour passer dans le concepteur d'interface utilisateur.
JButton
jPanel1
dans l'arborescence des composants, soit sur le panneau lui-même dans votre conception. jButton4
est ajouté sous jPanel1
dans l'arborescence des composants.
jButton4
dans le concepteur et faites-le glisser au centre de la partie supérieure de votre conception, comme le montre l'image ci-après.
Text
de jButton4
en Appuyer
. Appuyez sur Entrée. Agrandissez le bouton en faisant glisser les poignées noires jusqu'à ce que "Appuyer" soit complètement visible.
L'inspecteur doit ressembler à ceci :
jButton4
est enfoncé.
ActionPerformed
.
JBuilder va dans l'éditeur là où a été ajouté le squelette de code pour l'événement ActionPerformed
.
void jButton4_actionPerformed(ActionEvent e) { }Vous pouvez alors entrer votre code et définir l'événement.
void jButton4_actionPerformed(ActionEvent e) { jLabel1.setForeground(new Color(255,0,0)); }Astuce : Utilisez l'audit de code pour écrire le code. Tapez jLabel1. et attendez la fenêtre surgissante ou appuyez sur Ctrl+barre d'espace pour l'appeler. Tapez setfor pour mettre en évidence
setForeground(Color)
dans la fenêtre surgissante ou utilisez les flèches de direction. Appuyez sur Entrée. Vous pouvez configurer l'audit de code dans la boîte de dialogue Options de l'éditeur (Outils|Options de l'éditeur|Audit de code).
Maintenant, lorsque vous exécutez l'application et appuyez sur le bouton "Appuyer", "Hello World!" doit apparaître en rouge.
La dernière étape de la construction de votre application consiste à changer sa disposition en une disposition portable. N'oubliez pas que, si vous laissez jPanel1
en null, c'est-à-dire sans disposition, les composants de votre interface utilisateur ne se repositionnent pas lorsque l'utilisateur change la taille de la fenêtre de l'application pendant l'exécution. null
utilisant le positionnement absolu des composants, ceux-ci conservent la même place quelle que soit la taille de la fenêtre. De ce fait, null
n'est pas un gestionnaire de disposition approprié au déploiement final de votre application.
null
, exécutez l'application comme ci-dessous :
HelloWorldClasse.java
, qui contient la méthode main()
, et choisissez Exécuter.null
, utilisent le positionnement relatif, qui est dynamique. Dans les dispositions portables, les composants se repositionnent correctement lorsque l'utilisateur retaille la fenêtre de l'application. Dans cet exemple, vous changerez la disposition en GridBagLayout
. Pour plus d'informations sur les dispositions, voir "Utilisation des gestionnaires de dispositions" dans Construction d'applications avec JBuilder.
HelloWorldCadre.java
dans le volet contenu, puis cliquez sur l'onglet Conception pour passer dans le concepteur.jPanel1
dans l'arborescence des composants. jPanel1
en GridBagLayout
dans l'inspecteur. Sélectionnez chaque composant dans le concepteur et notez la zone de la grille qu'il occupe.
GridBagLayout
est un choix approprié à la disposition sur une grille de composants de tailles variées. Voir "GridBagLayout" dans Construction d'applications avec JBuilder.
Les étapes 11 et 12 utilisent des fonctionnalités offertes par JBuilder Professionnel et JBuilder Entreprise. Si vous utilisez JBuilder Personnel, ce tutoriel est terminé.
Poursuivez les exercices de ce tutoriel si vous êtes en possession d'une version Professionnel ou Entreprise de JBuilder.
Le Constructeur d'archives de JBuilder rassemble tous les fichiers requis pour distribuer votre programme et peut les archiver dans un fichier JAR (Java archive).
Pour déployer votre application :
HelloWorld.jar
sera enregistré dans le répertoire HelloWorld
.
Application
apparaît dans le volet projet. Vous pouvez modifier ce fichier en cliquant dessus avec le bouton droit et en sélectionnant Propriétés.Application
pour développer le noeud et voir le fichier archive HelloWorld.jar
. Double-cliquez sur le fichier JAR dans le volet projet. Le fichier manifest apparaît dans le volet contenu et le contenu du fichier JAR apparaît dans le volet structure.
Pour plus d'informations sur le déploiement, voir "Déploiement des programmes Java" dans Construction d'applications avec JBuilder.
Poursuivez les exercices de ce tutoriel si vous êtes en possession d'une version Professionnel ou Entreprise de JBuilder.
Pour tester l'application déployée, vous pouvez exécuter le fichier JAR depuis la ligne de commande.
Remarque : Le répertoire jdk/bin/
qui contient la commande java doit se trouver dans votre chemin d'accès. Si java est dans votre chemin d'accès, lorsque vous saisissez java sur la ligne de commande, des informations expliquant la commande doivent s'afficher. Si ce n'est pas le cas, vous devez exécuter l'application depuis le répertoire jdk/bin/
.
java -classpath /<home>/jbproject/HelloWorld/HelloWorld.jar helloworld.HelloWorldClasse
Remarque : Pour Windows, utilisez une barre oblique inversée (\).
La commande doit respecter la syntaxe :
java -classpath nom-paquet.nom-classe-principale
Dans cet exemple,
java
= le lanceur de l'application Java/<home>/jbproject/HelloWorld/HelloWorld.jar
HelloWorld
. Le Constructeur d'archives l'enregistre par défaut à cet emplacement.c:\winnt\profiles\<nomutilisateur>
helloworld
HelloWorldClasse
Pour plus d'informations sur les fichiers JAR, voir le tutoriel JAR à l'adresse http://java.sun.com/docs/books/tutorial/jar/index.html.
Bravo. Vous venez de créer votre première application avec JBuilder. Maintenant que vous êtes familier de l'environnement de développement de JBuilder, vous allez constater que ses nombreuses fonctionnalités facilitent la programmation et vous font gagner du temps.
Pour trouver d'autres tutoriels sur la conception d'interfaces utilisateur dans JBuilder, voir "Editeur de texte", "GridBagLayout" et "Dispositions imbriquées".