Introduction à JBuilder

Transcription

1 Introduction à JBuilder VERSION 8 Borland JBuilder

2 Consultez le fichier deploy.html situé dans le répertoire redist de JBuilder pour avoir la liste complète des fichiers que vous pouvez distribuer en accord avec votre contrat de licence JBuilder. Les applications mentionnées dans ce manuel sont brevetées par Borland Software Corporation ou en attente de brevet. Reportez-vous au CD ou à la boîte de dialogue A propos. Ce document ne donne aucun droit sur ces brevets. COPYRIGHT 1997, 2002 Borland Software Corporation. Tous droits réservés. Tous les produits Borland sont des marques commerciales ou des marques déposées de Borland Software Corporation aux Etats-Unis et dans les autres pays. Toutes les autres marques sont la propriété de leurs fabricants respectifs. Pour connaître les conditions et limites des fournisseurs tiers, lisez les Remarques version sur votre CD JBuilder. JBE0080WW21000introjb 3E2R PDF

3 Table des matières Chapitre 1 Introduction 1-1 Chapitre 2 Pour mieux connaître JBuilder 2-1 La documentation de JBuilder Conventions de la documentation Utilisation de l aide en ligne de JBuilder Comment obtenir de l aide Les parties principales du visualiseur d aide Utilisation du visualiseur d aide Utilisation du sommaire Utilisation de l index Utilisation de la recherche de texte globale (y compris les recherches booléennes). 2-8 Recherche de texte dans la rubrique en cours Copie de texte depuis le visualiseur d aide Zoom dans le visualiseur d aide Utilisation des signets Définition des configurations proxy Démarrage du visualiseur d aide sur une autre VM Navigation dans le visualiseur d aide Défilement à l aide du clavier Affichage de la documentation de référence sur les classes Disposition des pages de la documentation de référence Impression des tutoriels et du reste de la documentation Autres sources d informations sur JBuilder Support et ressources destinés aux développeurs Comment contacter le support technique de Borland Ressources en ligne World Wide Web Groupes de discussion Borland Groupes de discussion Usenet Rapports de bogues Chapitre 3 Tutoriel : Construction d une application 3-1 Etape 1 : Création du projet Etape 2 : Génération de vos fichiers source Etape 3 : Compilation et exécution de votre application Etape 4 : Personnalisation de l interface utilisateur de votre application Etape 5 : Ajout d un composant à votre application Etape 6 : Modification de votre code source Etape 7 : Compilation et exécution de votre application Etape 8 : Exécution de votre application depuis la ligne de commande Etape 9 : Ajout d un événement à un bouton Etape 10 : Fin de la conception de votre interface utilisateur Etape 11 : Préparation de l application pour son déploiement Etape 12 : Exécution de l application déployée depuis la ligne de commande Code source de HelloWorld Code source de HelloWorldCadre.java Code source de HelloWorldClasse.java Code source de HelloWorldCadre_AboutBox.java Chapitre 4 Utilisation de l AppBrowser 4-1 Menu principal Barre d outils Volet projet Création d un nouveau projet Ajout de fichiers ou de classes à un projet Utilisation du volet projet Volet structure Tri dans le volet structure Visualisation des informations Javadoc Navigation dans le code source Affichage des messages d erreur Volet contenu Onglets des fichiers Onglets de vue des fichiers Redimensionnement du volet contenu Volet message i

4 Copie de texte depuis le volet message Masquage et affichage du volet message Désancrage du volet message Débogueur Barres d état Navigation et recherche dans l AppBrowser Recherches dans une arborescence Recherche de classes Utilisation des Favoris Personnalisation de l EDI Chapitre 5 Utilisation de l éditeur 5-1 Affectation des touches de l éditeur Personnalisation de l affectation des touches Division de la vue source Numéros de ligne Affichage de numéros de ligne Déplacement vers une ligne particulière Sélection de texte Sélection d une ligne entière Sélection de plusieurs numéros de ligne consécutifs Sélection de tous les numéros de ligne Glissement/déplacement de texte Redimensionnement de la fonte de l éditeur Recherche de texte dans l éditeur Recherche de la définition d un symbole Recherche des références à un symbole Formatage du code Application d un formatage au code Accolades autour d un bloc de code Raccourcis Javadoc dans l éditeur Utilisation de dans l éditeur Gestion de l impression dans l éditeur Glissement/déplacement d un fichier vers l éditeur Codage rapide Audit de code Audit de membre Audit de classe Audit de paramètre Trouver la définition (Examen/forage) Evaluation des expressions dans des conseils Audit d expression Configuration de l audit de code Modèles de code Edition des modèles de code Personnalisation de l éditeur Chapitre 6 Développement automatique du code 6-1 Utilisation des outils de conception visuelle Utilisation de la galerie d objets Utilisation des experts pour un démarrage rapide Chapitre 7 Projets JBuilder 7-1 Création d un nouveau projet Ajout de fichiers à un projet Visualisation d un fichier Ajout d un nouveau fichier source Java Retrait et suppression Attribution d un autre nom à des projets et fichiers Ouverture d un projet existant Pour mieux connaître les projets JBuilder Chapitre 8 Comparaison des fichiers et versions 8-1 Glossaire relatif à la gestion des versions Comparaison de deux fichiers Utilisation de la vue historique Page Sommaire Page Diff Page Info Page Conflits de fusion Chapitre 9 Tutoriel : Construction d une applet 9-1 Présentation Applet Good Evening Etape 1 : Création du projet Etape 2 : Génération de vos fichiers source Etape 3 : Compilation et exécution de votre applet Etape 4 : Personnalisation de l interface utilisateur de votre applet Etape 5 : Ajout de composants AWT à votre applet Etape 6 : Modification de votre code source Etape 7 : Déploiement de votre applet Déploiement de votre applet à l aide de l outil jar ii

5 Déploiement de votre applet à l aide du Constructeur d archives Etape 8 : Modification du fichier HTML Etape 9 : Exécution depuis la ligne de commande de l applet déployée Test sur le Web de votre applet déployée Code source de l applet Code source de l applet HTML pour GoodEveningApplet.html Code source de la classe de l applet pour GoodEveningApplet.java Chapitre 10 Tutoriel : Utilisation de la vue historique 10-1 Etape 1 : Génération de plusieurs versions d un fichier Etape 2 : Utilisation de la page Sommaire Etape 3 : Utilisation de la page Diff Tri des révisions Annulation de modifications Utilisation de Diff. intelligente Etape 4 : Utilisation de la page Info Index I-1 iii

6 iv

7 Chapitre 1 Chapitre1Introduction Introduction à JBuilder est le premier document à consulter si vous ne connaissez pas encore JBuilder. Après une description sommaire des nouveautés apportées à cette version de JBuilder, il présente les ressources dont vous disposez pour en savoir plus sur JBuilder et vous permet de démarrer rapidement à l aide d un tutoriel qui indique comment construire votre première application JBuilder. Après avoir découvert l environnement de développement de JBuilder, vous pourrez vous familiariser avec l AppBrowser, l éditeur et les nombreux raccourcis dont vous disposez pour écrire votre code. Vous apprendrez à connaître les divers volets de l AppBrowser et à les utiliser pour effectuer des tâches courantes. Vous y verrez comment utiliser l éditeur de JBuilder et en particulier les nombreux raccourcis qu il propose pour l écriture du code. Vous apprendrez à créer et gérer des projets JBuilder. Vous saurez comment comparer des fichiers et des versions avec la vue historique de JBuilder. Enfin, vous pourrez approfondir vos connaissances avec deux autres tutoriels fondamentaux ; le premier utilise la vue historique et le second crée une applet. Introduction à JBuilder contient les chapitres suivants : Chapitre 2, Pour mieux connaître JBuilder Décrit les ressources mises à votre disposition par Borland pour apprendre à utiliser JBuilder. Chapitre 3, Tutoriel : Construction d une application Explique comment créer une application simple, Hello World, en utilisant JBuilder. Chapitre 4, Utilisation de l AppBrowser Décrit l AppBrowser et la façon de l utiliser. Introduction 1-1

8 Introduction Chapitre 5, Utilisation de l éditeur Explique comment utiliser les nombreuses fonctions de l éditeur de code de JBuilder, dont l audit de code et les modèles de code. Chapitre 6, Développement automatique du code Décrit comment générer du code automatiquement en utilisant les outils de conception visuelle et les nombreux experts de JBuilder. Chapitre 7, Projets JBuilder Explique comment créer un projet JBuilder, décrit ce qu est un projet JBuilder et explique comment assurer les principales tâches de gestion de projet. Chapitre 8, Comparaison des fichiers et versions Décrit les pages et les fonctionnalités disponibles sur l onglet Historique du volet contenu. Décrit les fonctionnalités disponibles dans les différentes éditions de JBuilder et leur fonctionnement en présence et en l absence d un système de contrôle de versions. Chapitre 9, Tutoriel : Construction d une applet Explique comment créer une applet AWT. Chapitre 10, Tutoriel : Utilisation de la vue historique Explique l utilisation de la vue historique. 1-2 Introduction à JBuilder

9 Chapitre 2 Chapitre2Pour mieux connaître JBuilder Ce chapitre décrit les ressources dont vous disposez pour faire connaissance de JBuilder. Il décrit les documents JBuilder et explique les conventions utilisées dans la documentation. Il explique comment utiliser le système d aide en ligne de JBuilder ; la lecture de cette section vous permettra de tirer le meilleur parti de ces informations. Il indique également les autres emplacements auxquels vous trouverez des informations utiles sur JBuilder. Enfin, il indique comment prendre contact auprès de Borland pour obtenir un support développeur. La documentation de JBuilder La documentation JBuilder est accessible par plusieurs moyens. Pour afficher la documentation dans le visualiseur d aide de JBuilder, choisissez Aide Rubriques d aide. Voir Utilisation de l aide en ligne de JBuilder, page 2-6, pour tout savoir sur l affichage de l aide dans ce visualiseur. La documentation est également disponible sur votre CD JBuilder au format HTML et vous pouvez la consulter à l aide d un navigateur Web quelconque. Si vous préférez la consulter sous forme imprimée, vous pouvez acquérir le manuel JBuilder Développement d applications d entreprise en retournant le coupon se trouvant à cet effet dans la boite ou les télécharger tous au format PDF puis les imprimer. Que vous optiez pour l une ou Pour mieux connaî tre JBuilder 2-1

10 La documentation de JBuilder l autre solution, consultez le site Web de Borland sur la documentation JBuilder 8, à l adresse Document Toutes les éditions de JBuilder Introduction à JBuilder Introduction à Java Construction d applications avec JBuilder Conception d applications avec JBuilder Développement Opentools OpenTools API Reference (en anglais) Description Présente les nouveautés de cette version de JBuilder et indique où trouver une information particulière dans les documents JBuilder. Le tutoriel de programmation mis à votre disposition vous aide à devenir très vite opérationnel. Vous y apprendrez à créer une application Java simple avec JBuilder. Présente l AppBrowser de JBuilder, l éditeur de code et quelques-uns des nombreux experts et outils de production qui réduiront et faciliteront votre tâche. Les tâches décrites sont celles que vous rencontrerez le plus souvent dans le cadre de vos projets de programmation. La gestion des versions fait l objet d informations et d un tutoriel spécial. Vous y trouverez également un tutoriel sur la création d une applet. Présente le langage de programmation, les bibliothèques de classes et les différentes éditions de Java. Explique comment gérer des projets dans JBuilder et comment ce dernier utilise les chemins d accès. Explique comment compiler, déboguer, déployer et internationaliser des programmes dans JBuilder. Explique les fonctionnalités de JBuilder concernant Javadoc, la visualisation et le refactoring du code et le test des unités. Inclut également des informations sur les outils en ligne de commande, les messages d erreur, et comment faire migrer les applications créés avec d autres outils de développement en Java. Explique comment concevoir des interfaces utilisateur et utiliser les gestionnaires de disposition. Inclut des tutoriels pas-à-pas permettant de créer des interfaces utilisateur avec les outils de conception de offerts par JBuilder. Offre des informations conceptuelles sur l architecture de certains sous-systèmes de JBuilder et son API d outils ouverts pour que vous construisiez vos propres extensions. Fournit la documentation de référence de l API OpenTools de JBuilder. 2-2 Introduction à JBuilder

11 La documentation de JBuilder Document Documentation JDK (en anglais) Java Language Specification (en anglais) Aide en ligne contextuelle Editions SE et Entreprise Développement en équipe en utilisant JBuilder Edition Entreprise Guide du développeur d applications web Guide du développeur de services Web Guide du développeur XML Guide du développeur JDataStore Guide du développeur d applications bases de données Référence de la bibliothèque de composants DataExpress Guide du développeur Enterprise JavaBeans Description Documentation de référence de l API du JDK (Java Development Kit) de Sun Vous pouvez accéder à cette documentation par l un des moyens suivants : Choisissez Aide Référence Java. Choisissez l onglet Doc dans le volet Contenu lorsque vous visualisez un fichier du JDK. Contient la version 2.0 de la spécification du langage Java. Affiche des informations concernant l élément de l interface utilisateur de JBuilder en cours. Traite du contrôle de version et explique comment utiliser les interfaces de JBuilder avec les trois principaux systèmes de contrôle de version ainsi que les propres outils de gestion de version de JBuilder. Traite des technologies utilisées par JBuilder pour le développement Web. Explique comment utiliser les fonctions relatives aux services Web de JBuilder pour créer, utiliser, consulter et publier de tels services. Traite des technologies utilisées par JBuilder pour le développement XML. Explique comment utiliser efficacement les fonctionnalités JDataStore. JDataStore est une base de données entièrement Java, ultra-performante et de faible encombrement. Traite de l utilisation des fonctionnalités de base de données de DataExpress (JBuilder) pour développer des applications de bases de données. Présente des informations détaillées sur tous les composants, classes, propriétés, méthodes et événements orientés données à forte valeur ajoutée de JBuilder (documentation en ligne seulement). Décrit comment créer des Enterprise JavaBeans (EJB) avec les outils et les concepteurs EJB de JBuilder. Pour mieux connaî tre JBuilder 2-3

12 Conventions de la documentation Conventions de la documentation La documentation Borland sur JBuilder utilise les polices et les symboles décrits dans le tableau suivant pour signaler du texte particulier. Tableau 2.1 Police Police à espacement fixe Gras Italiques Polices et symboles Signification La police à espacement fixe représente : du texte tel qu il apparaît à l écran du texte que vous devez taper, comme dans Tapez Hello World dans le champ Titre de l expert Application. des noms de fichiers des noms de chemins des noms de répertoires ou de dossiers des commandes, comme SET PATH du code Java des types de données Java, comme boolean, int et long. des identificateurs Java, comme des noms de variables, classes, noms de paquets, interfaces, composants, propriétés, méthodes et événements des noms d argument des noms de champs des mots clés Java, comme void et static Le gras est utilisé pour désigner les outils java, bmj (Borland Make for Java), bcj (Borland Compiler for Java) et les options du compilateur. Par exemple : javac, bmj, -classpath. L italique est utilisé pour les termes nouveaux, les titres des manuels et, parfois, pour la mise en valeur. Touches Cette police indique les touches du clavier, comme dans Appuyez sur Echap pour quitter le menu. [ ] Les crochets droits dans le texte ou dans la syntaxe entourent les éléments facultatifs. Ne tapez pas ces crochets. 2-4 Introduction à JBuilder

13 Tableau 2.1 Conventions de la documentation Police Signification < > Les crochets angulaires indiquent des variables dans les chemins de répertoire, les options de commande et les exemples de code. Par exemple, <filename> peut être utilisé pour indiquer l emplacement où vous devez fournir un nom de fichier (y compris l extension du fichier) et <username> indique généralement que vous devez fournir votre nom d utilisateur. Lorsque vous remplacez des variables dans les chemins de répertoire, les options de commande et les exemples de code, remplacez toute la variable, y compris les crochets angulaires (< >). Par exemple, vous pouvez remplacer <filename> par le nom d un fichier, comme employee.jds, et omettre les crochets. Remarque : Les crochets angulaires sont utilisés dans les fichiers HTML, XML, JSP et d autres fichiers basés sur des balises pour démarquer les éléments des documents, comme <font color=red> et <ejb-jar>. La convention suivante décrit comment les chaînes variables sont spécifiées dans les exemples de code qui utilisent déjà des crochets angulaires comme délimiteurs. Italiques, serif Ce formatage permet d indiquer les chaînes variables des exemples de code qui utilisent déjà des crochets angulaires comme délimiteurs. Par exemple, <url="jdbc:borland:jbuilder\\ samples\\guestbook.jds">... Dans les exemples de code, les points de suspension (...) indiquent le code qui a été omis dans l exemple pour gagner de la place et améliorer la compréhension. Sur un bouton, les points de suspension indiquent que ce bouton ouvre une boîte de dialogue de sélection. JBuilder est disponible sur plusieurs plates-formes. Reportez-vous au tableau suivant pour une description des conventions associées aux diverses plates-formes. Tableau 2.2 Elément Chemins Répertoire de base Captures d écran Polices et symboles (suite) Conventions des plates-formes Signification Les chemins d accès mentionnés dans la documentation sont indiqués par une barre oblique (/). Pour Windows, utilisez une barre oblique inversée (\). L emplacement du répertoire de base standard dépend de la plate-forme et sera indiqué par la variable <home>. Pour UNIX et Linux, le répertoire de base peut varier. Par exemple, ce peut être /user/<nomutilisateur> ou /home/ <username> Pour Windows NT, le répertoire de base est C:\Winnt\ Profiles\<nomutilisateur> Pour Windows 2000, le répertoire de base est C:\Document and Settings\<nomutilisateur> Les captures d écran reflètent l apparence Metal sur diverses plates-formes. Pour mieux connaî tre JBuilder 2-5

14 Utilisation de l aide en ligne de JBuilder Utilisation de l aide en ligne de JBuilder JBuilder affiche les rubriques d aide en ligne dans le visualiseur d aide. Les rubriques peuvent aussi être affichées dans l AppBrowser ou dans un navigateur Web. Comment obtenir de l aide Remarque Il existe plusieurs moyens d obtenir de l aide sur toutes les rubriques : Pour obtenir de l aide à partir de l EDI, Choisissez Aide Rubriques d aide, dans le menu principal de JBuilder, pour ouvrir le visualiseur d aide. Cliquez sur le bouton Aide dans une boîte de dialogue ou appuyez sur F1. Choisissez Chercher Chercher des classes et choisissez une classe. Le fichier classe s affiche dans le volet contenu. Cliquez sur l onglet Doc pour voir s il existe une documentation pour cette classe. Pour obtenir de l aide à partir de l AppBrowser, Double-cliquez sur le nom d une classe dans le volet structure ou projet, puis sélectionnez l onglet Doc. La documentation de la classe sera affichée. Cliquez sur un nom de classe dans le volet structure ou projet, puis appuyez sur Entrée ; puis sélectionnez l onglet Doc. Cela équivaut à un double-clic. Placez le curseur sur un mot clé Java dans l éditeur et appuyez sur F1 pour obtenir de l aide sur ce mot clé. Pour obtenir de l aide à partir de l inspecteur, choisissez une propriété ou un événement et appuyez sur F1. Pour obtenir de l aide à partir de votre navigateur web, suivez les étapes ci-dessous : a Désarchivez tous les fichiers.jar du répertoire doc de JBuilder. Pour cela, utilisez votre outil favori, comme WinZip, ou, depuis la ligne de commande, allez dans le répertoire doc et entrez ce qui suit pour chaque fichier JAR :../<jdk>/bin/jar xf <docjarfile.jar>. b Une fois que tous les fichiers JAR ont été désarchivés, ouvrez index.html avec votre navigateur et suivez les instructions. Il n y a plus la fonctionnalité de recherche globale dans toute la documentation en ligne quand vous y accédez depuis votre navigateur web. 2-6 Introduction à JBuilder

15 Utilisation de l aide en ligne de JBuilder Les parties principales du visualiseur d aide Le visualiseur d aide de JBuilder comprend les éléments suivants : Le menu principal. La page Sommaire, qui montre la table des matières de tous les manuels. La page Index, qui montre l index de tous les manuels. La page Chercher, qui permet la saisie des mots à rechercher dans tous les manuels. Le volet Contenu, qui affiche le texte de la rubrique sélectionnée. Les boutons suivants : Bouton Nom Description Début Va à la première rubrique de l historique. En arrière Va à la rubrique précédente de l historique. En avant Va à la rubrique suivante de l historique. Imprimer Imprime la rubrique en cours. Chercher Cherche du texte dans la rubrique en cours. Utilisation du visualiseur d aide Utilisation du sommaire Pour choisir une rubrique dans le sommaire, 1 Cliquez sur l onglet Sommaire, en haut et à gauche du visualiseur d aide. 2 Double-cliquez sur l icône d un livre pour développer les rubriques qu il contient. 3 Cliquez sur une rubrique du sommaire pour voir cette rubrique dans le volet Contenu. Utilisation de l index Pour trouver une rubrique dans l index, 1 Cliquez sur l onglet Index, en haut et à gauche du visualiseur d aide. Pour mieux connaî tre JBuilder 2-7

16 Utilisation de l aide en ligne de JBuilder 2 Tapez la rubrique dans le champ texte. Au fur et à mesure que vous tapez, l index défile en faisant une recherche incrémentale dans les entrées de l index pour trouver la correspondance la plus proche. 3 Double-cliquez sur la rubrique en surbrillance dans l index, ou appuyez sur Entrée, pour faire apparaître son contenu. S il y a plusieurs rubriques pour l entrée d index sélectionnée, le volet d index se divise et affiche la liste des rubriques dans sa partie inférieure. Cliquez sur la rubrique que vous voulez afficher. Astuce Utilisation de la recherche de texte globale (y compris les recherches booléennes) Pour rechercher du texte dans tous les manuels et utiliser la recherche booléenne, 1 Cliquez sur l onglet Chercher, en haut et à gauche du visualiseur d aide. 2 Saisissez les mots recherchés dans le champ texte. Au fur et à mesure que vous tapez, la liste des mots défile et montre les termes les plus proches. Le visualiseur d aide prend en charge les recherches booléennes suivantes (n utilisez pas de guillemets dans le champ texte) : Intersection de rubriques (ET): Tapez un signe plus (+) entre les mots pour chercher toutes les rubriques qui contiennent tous les mots. Union de rubriques (OU) : Insérez une virgule (,) entre les mots pour chercher toutes les rubriques qui contiennent au moins un des mots. 3 Double-cliquez sur la rubrique en surbrillance, ou appuyez sur Entrée pour faire apparaître son contenu. S il y a plusieurs rubriques pour l entrée sélectionnée, le volet Chercher se divise et affiche la liste des rubriques dans sa partie inférieure. Cliquez sur la rubrique que vous voulez afficher. La recherche globale renvoie des résultats issus de tout le texte dans toutes les rubriques disponibles dans la documentation en ligne. Si vous considérez qu elle renvoie un trop grand nombre de résultats, essayez d utiliser l onglet Index à la place. 2-8 Introduction à JBuilder

17 Utilisation de l aide en ligne de JBuilder Recherche de texte dans la rubrique en cours Pour chercher du texte dans la rubrique en cours dans le visualiseur d aide, 1 Cliquez sur le bouton Chercher dans le visualiseur d aide ou appuyez sur Ctrl + f. 2 Tapez les mots recherchés dans le dialogue Chercher le texte dans la rubrique en cours. 3 Cliquez sur Chercher le suivant ou appuyez sur Entrée si vous voulez poursuivre la recherche. 4 Cliquez sur Annuler pour fermer la boîte de dialogue. 5 Appuyez sur F3 pour reprendre la recherche sans ouvrir la boîte de dialogue. Copie de texte depuis le visualiseur d aide Pour copier du texte sélectionné depuis le visualiseur d aide, 1 Sélectionnez le texte dans le volet Contenu. 2 Sélectionnez Edition Copier dans le menu principal du visualiseur d aide, ou appuyez sur Ctrl + c. Zoom dans le visualiseur d aide Vous pouvez changer la taille apparente de la police et des images dans le visualiseur d aide en faisant des zooms avant et arrière. Vous pouvez ainsi examiner de plus près les images, mettre davantage de texte à la fois dans la fenêtre ou ajuster la vue pour votre confort. Les incréments du zoom sont petits, ce qui vous permet de contrôler avec précision la taille apparente de la vue. Il y a deux façons d effectuer chaque type de zoom : Pour un zoom avant (agrandissement), Appuyez sur Ctrl + u ; maintenez la touche Ctrl enfoncée et appuyez sur u à nouveau jusqu à ce que la vue ait la taille souhaitée. Sélectionnez Options Zoom In. Pour un zoom arrière (réduction) : Appuyez sur Ctrl + d ; maintenez la touche Ctrl enfoncée et appuyez sur d à nouveau jusqu à ce que la vue ait la taille souhaitée. Sélectionnez Options Zoom Out. Pour revenir à la vue normale, sélectionnez Options Affichage normal. Pour mieux connaî tre JBuilder 2-9

18 Utilisation de l aide en ligne de JBuilder Utilisation des signets Pour ajouter un signet sur la page en cours dans le visualiseur d aide, sélectionnez Signets Ajouter un signet dans le menu principal. Pour modifier des signets dans le visualiseur d aide, 1 Sélectionnez Signets Modifier les signets dans le menu principal. La boîte de dialogue Editeur de signets s ouvre. 2 Sélectionnez le signet et cliquez sur l option permettant de retirer un signet, de réorganiser un signet ou d aller à un signet. 3 Cliquez sur Fermer. Pour aller sur un signet, sélectionnez Signets et choisissez un signet dans la liste. Les dix premiers signets sont associés à des mnémoniques dans le menu Signets. Il vous faut donc placer les signets les plus souvent utilisés début de liste. Le nombre de signets figurant dans le menu est limité à 25 mais vous pouvez modifier le fichier help.properties afin d augmenter cette valeur. Le fichier <help.properties> est créé la première fois que vous quittez le visualiseur d aide ; il est enregistré dans le répertoire.jbuilder dépendant de votre répertoire home. Définition des configurations proxy Pour accéder aux sites Internet depuis le visualiseur d aide par l intermédiaire d un serveur proxy, vous devez spécifier l ID et le numéro de port de l hôte du serveur proxy. Ces valeurs sont définies dans le visualiseur d aide. Pour permettre au visualiseur d aide d utiliser un serveur proxy pour la connexion à Internet, 1 Ouvrez le visualiseur d aide (Aide Rubriques). 2 Choisissez Options Suite pour ouvrir la boîte de dialogue Options du système d aide 3 Cochez l option Se connecter sur Internet via un serveur proxy. 4 Dans le champ Hôte, entrez le nom ou l adresse IP numérique du serveur proxy. 5 Dans le champ Port, entrez le numéro de port du serveur proxy. 6 Cliquez sur OK. 7 Redémarrez JBuilder pour que la modification prenne effet. Démarrage du visualiseur d aide sur une autre VM Vous pouvez exécuter le visualiseur d aide sur un ordinateur virtuel distinct pour accéder aux tutoriels et à d autres rubriques d aide alors qu une boîte de dialogue modale est affichée. Cette option est définie dans le visualiseur d aide Introduction à JBuilder

19 Utilisation de l aide en ligne de JBuilder Pour configurer le visualiseur d aide de sorte qu il démarre sur une autre VM, 1 Ouvrez le visualiseur d aide (Aide Rubriques). 2 Choisissez Options Suite pour ouvrir la boîte de dialogue Options du système d aide 3 Cochez l option Démarrer le système sur une autre machine virtuelle. 4 Cliquez sur OK. 5 Redémarrez JBuilder pour que la modification prenne effet. Navigation dans le visualiseur d aide Le tableau suivant décrit comment vous déplacer dans le visualiseur d aide : Pour Faites ceci... Raccourcis clavier Changer de manuel ou aller à une rubrique Développer ou réduire une section du sommaire Revenir à la rubrique précédente de l historique Aller à la rubrique suivante de l historique Aller à la première rubrique de l historique Chercher du texte dans la rubrique en cours Rechercher une nouvelle occurrence Chercher du texte dans tous les manuels Suivre un lien hypertexte souligné dans le texte Cliquez sur le titre de la rubrique. Cliquez sur l icône située à côté de la rubrique, dans la page Sommaire ou double-cliquez sur la rubrique. Cliquez sur le bouton Précédent. Cliquez sur le bouton Suivant. Cliquez sur le bouton Début. Cliquez sur le bouton Chercher. Cliquez sur l onglet Chercher. Cliquez sur le lien dans le texte. Utilisez les touches fléchées. Sélectionnez le manuel et appuyez sur Entrée pour l ouvrir. Vous pouvez aussi sélectionner le manuel et utiliser les flèches Droite et Gauche pour ouvrir et fermer le manuel. Ctrl+Gauche Ctrl+Droite Ctrl+Origine Ctrl+F F3 Défilement à l aide du clavier Quand vous sélectionnez une entrée dans les pages Sommaire, Index ou Chercher du visualiseur d aide, la focalisation du clavier suit. Les touches Pour mieux connaî tre JBuilder 2-11

20 Utilisation de l aide en ligne de JBuilder de navigation (comme la touche Pg. Suiv.) permettent le défilement dans le côté gauche du visualiseur d aide et non dans le volet Contenu. Pour placer la focalisation dans le volet Contenu, à droite, appuyez sur la touche Tab. La touche Tab fait tourner la focalisation du volet sélectionné à gauche du visualiseur d aide (Sommaire, Index ou Chercher) au volet Contenu et ensuite aux boutons de navigation. Appuyez sur Maj+Tab pour changer de sens. Affichage de la documentation de référence sur les classes Vous pouvez voir la documentation de la référence pour une classe dans la fenêtre de l AppBrowser, dans le visualiseur d aide ou dans un navigateur web. Pour afficher la documentation de référence dans l AppBrowser, effectuez une des opérations suivantes : Double-cliquez sur le nom d une classe dans le volet Structure ou Projet pour afficher le code source de cette classe dans le volet Source. Sélectionnez l onglet Doc pour voir la documentation de la classe. Choisissez Chercher Chercher des classes et choisissez une classe. Sélectionnez l onglet Doc pour voir la documentation de la classe. Pour que vous puissiez trouver de la documentation sur une classe, les instructions import du début du code source doivent mentionner la classe ou le paquet concerné. Si le message Symbole Java introuvable s affiche, naviguez jusqu à un fichier source qui importe la classe voulue. Pour afficher les guides de référence dans le visualiseur d aide, effectuez une des opérations suivantes : Dans la page Raccourcis du visualiseur d aide, cliquez sur un manuel de référence. Dans la fenêtre principale de JBuilder, choisissez Aide et le guide de référence voulu. Dans la page Sommaire du visualiseur d aide, choisissez un manuel de référence Disposition des pages de la documentation de référence La documentation de l ouvrage Référence de la bibliothèque de composants DataExpress est au format Javadoc standard. Pour plus d informations sur l utilisation du format Javadoc, voir Comment est organisé ce document dans la Référence de la bibliothèque de composants DataExpress Introduction à JBuilder

21 Autres sources d informations sur JBuilder Impression des tutoriels et du reste de la documentation Pour imprimer les tutoriels et le reste de la documentation de JBuilder, ouvrez la documentation dans le visualiseur d aide et sélectionnez Fichier Imprimer. La documentation est également fournie au format PDF sur le site web de JBuilder à l adresse jbuilder/. Pour voir une liste des tutoriels et leurs noms de fichiers PDF, choisissez Aide Tutoriels JBuilder. Autres sources d informations sur JBuilder Pour plus d informations sur JBuilder, vous disposez de plusieurs options : Visitez le site web de JBuilder à l adresse jbuilder/ et le site Web Borland Community à l adresse Pour faire une visite d introduction à JBuilder, ouvrez le projet Welcome. Choisissez Aide Welcome dans le menu principal de JBuilder. Dans les notes de livraison (Aide Remarques version), vous trouverez les informations sur les dernières mises à jour de JBuilder, ainsi que des suggestions de résolution pour les problèmes les plus connus. Support et ressources destinés aux développeurs Borland fournit de nombreuses options de support et ressources d information pour aider les développeurs à tirer le meilleur parti de leurs produits Borland. Ces options comprennent des programmes de support technique Borland, ainsi que des services gratuits sur Internet, où vous pouvez consulter notre importante base d informations et entrer en contact avec d autres utilisateurs de produits Borland. Comment contacter le support technique de Borland Borland propose divers programmes de support destinés aux clients et aux futurs clients. Vous pouvez choisir parmi plusieurs catégories de support, allant de l installation des produits Borland au support tarifé de niveau consultant, en passant par une assistance complète. Pour mieux connaî tre JBuilder 2-13

22 Support et ressources destiné s aux dé veloppeurs Pour obtenir des informations sur les services Borland de support aux développeurs, veuillez consulter notre site Web, à l adresse Quand vous contacterez le support, préparez des informations complètes sur votre environnement, la version du produit que vous utilisez et une description détaillée du problème. Pour avoir de l aide sur les outils tiers, ou leur documentation, contactez votre fournisseur. Ressources en ligne Vous pouvez obtenir des informations depuis les sources ci-après : World Wide Web FTP Listserv ftp://ftp.borland.com/ Documents techniques accessibles par anonymous ftp. Pour vous abonner aux bulletins électroniques, utilisez le formulaire en ligne : ou, pour l international, World Wide Web Consultez régulièrement L équipe produit de JBuilder y place notes techniques, analyses des produits concurrents, réponses aux questions fréquemment posées, exemples d applications, mises à jour du logiciel et informations sur les produits existants ou nouveaux. Vous pouvez vous connecter en particulier aux URL suivantes : (mises à jour du logiciel et autres fichiers) (mises à jour de la documentation et autres fichiers) (contient notre magazine d informations web pour les développeurs) Groupes de discussion Borland Vous pouvez vous inscrire à JBuilder et participer à de nombreux groupes de discussion dédiés à JBuilder. Les groupes de discussion Borland 2-14 Introduction à JBuilder

23 Support et ressources destiné s aux dé veloppeurs permettent à la communauté mondiale d utilisateurs d échanger des astuces et des techniques concernant les produits Borland, ainsi que les outils et technologies associés. Vous trouverez des groupes de discussion, animés par les utilisateurs, pour JBuilder et d autres produits Borland, à l adresse Groupes de discussion Usenet Remarque Les groupes Usenet suivants sont dédiées à Java et concernent la programmation : news:comp.lang.java.advocacy news:comp.lang.java.announce news:comp.lang.java.beans news:comp.lang.java.databases news:comp.lang.java.gui news:comp.lang.java.help news:comp.lang.java.machine news:comp.lang.java.programmer news:comp.lang.java.security news:comp.lang.java.softwaretools Ces groupes de discussion sont maintenus par les utilisateurs et ne sont pas des sites Borland officiels. Rapports de bogues Si vous pensez avoir trouvé un bogue dans le logiciel, merci de le signaler dans la page du support développeur de JBuilder, à l adresse Cliquez sur this form dans Reporting Borland Product Defects pour afficher le formulaire de saisie. Quand vous signalez un bogue, indiquez toutes les étapes nécessaires à la reproduction de ce bogue, ainsi que tout paramètre spécial de votre environnement et les autres programmes utilisés avec JBuilder. Précisez bien le comportement attendu et ce qui s est réellement passé. Si vous avez des commentaires (compliments, suggestions ou questions) destinés aux rédacteurs de la documentation de JBuilder, vous pouvez envoyer un à jpgpubs@borland.com. Uniquement pour la documentation. Les questions de support doivent être adressées au support développeur. JBuilder est fait par des développeurs pour des développeurs. Nous apprécions vraiment vos remarques. Pour mieux connaî tre JBuilder 2-15

24 2-16 Introduction à JBuilder

25 Chapitre 3 Chapitre3Tutoriel : Construction d une application Ce sont des fonctionnalités de JBuilder SE et Entreprise. Beaucoup de développeurs préfèrent apprendre par la pratique. Si c est votre cas, suivez les étapes décrites dans ce tutoriel pour apprendre à créer des applications avec l EDI de JBuilder, environnement de développement intégré. Le tutoriel montre comment Créer un projet pour l application. Créer une application simple, Hello World. Compiler et exécuter l application. Modifier l interface utilisateur d une application. Ajouter des composants Swing, comme JPanel, JLabel et JButton. Modifier le code source. Exécuter l application depuis la ligne de commande. Ajouter à un bouton une méthode d événement. Compléter l interface utilisateur. Regrouper les fichiers en vue du déploiement. Exécuter l application déployée depuis la ligne de commande. Tutoriel : Construction d une application 3-1

26 Etape 1 : Cré ation du projet Lorsque vous aurez fini le tutoriel, votre application Java ressemblera à ce qui suit : Etape 1 : Création du projet Pour obtenir des informations plus spécifiques de l EDI ou de l éditeur pendant l utilisation du tutoriel, voir Chapitre 4, Utilisation de l AppBrowser, et Chapitre 5, Utilisation de l éditeur. Pour obtenir des informations utiles sur la visualisation et l impression des tutoriels, voir la section Tutoriels du fichier Astuces JBuilder. La section Options d accessibilité des Astuces JBuilder contient des conseils permettant de simplifier l accès aux fonctionnalités de JBuilder, destinés en particulier aux personnes ayant des difficultés. Pour plus d informations sur les conventions utilisées dans ce tutoriel et la documentation JBuilder en général, voir Conventions de la documentation, page 2-4. Remarque Avant de créer une application dans JBuilder, vous devez créer un projet dans lequel travailler. JBuilder utilise un fichier projet, dont l extension est.jpx, 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. 1 Choisissez Fichier Nouveau projet pour ouvrir l expert projet. 2 Apportez les modifications suivantes aux champs appropriés au cours de l étape 1 de l expert projet. a Tapez HelloWorld dans le champ Nom. Au fur et à mesure que vous tapez le nom du projet dans le champ Nom, ce nom s affiche automatiquement dans le champ Répertoire. Par défaut, JBuilder utilise ce nom de projet pour composer les noms du répertoire et du paquet des classes du projet. Le nom de paquet est passé en minuscules pour respecter les conventions d appellation des paquets Java. Par défaut, JBuilder enregistre les projets dans le répertoire /<home>/jbproject/. Le répertoire home dépend de la 3-2 Introduction à JBuilder

27 Etape 1 : Cré ation du projet plate-forme. Voir Conventions de la documentation, page 2-4, et pour plus d informations sur les projets, voir Chapitre 7, Projets JBuilder. b Acceptez jpx comme type de fichier projet. c Cochez l option Créer le fichier de remarques du projet. Lorsque vous sélectionnez cette option, l expert projet crée un fichier HTML pour les annotations du projet et l ajoute à celui-ci. L étape 1 de l expert projet doit ressembler à ceci : 3 Acceptez toutes les autres valeurs par défaut de l étape 1. 4 Cliquez sur Suivant pour passer à l étape 2 de l expert projet. 5 Acceptez les chemins par défaut proposés à l étape 2. Notez où sont enregistrés les fichiers classes compilées, projet et sources. Pour plus d informations sur les chemins d accès et sur la façon dont JBuilder enregistre les fichiers, voir Gestion des chemins d accès dans Construction d applications avec JBuilder. Tutoriel : Construction d une application 3-3

28 Etape 1 : Cré ation du projet L étape 2 de l expert projet doit ressembler à ceci : Remarque 6 Cliquez sur Suivant pour passer à l étape 3 de l expert. 7 Apportez les modifications suivantes dans les champs appropriés de l étape 3 : a Acceptez les valeurs proposées par défaut pour Encodage et Paquets source automatiques. L option Paquets source automatiques est une fonctionnalité de JBuilder SE et de JBuilder Entreprise. b Entrez Hello World dans le champ Titre des champs Javadoc classe. c Entrez votre nom et celui de votre société, ainsi que la description de votre application, dans les champs facultatifs appropriés. L information contenue dans les champs Javadoc classe apparaît dans le fichier HTML du projet et comme commentaires d en-tête facultatifs dans le code source. 3-4 Introduction à JBuilder

29 Etape 1 : Cré ation du projet L étape 3 de l expert projet doit ressembler à ceci : 8 Cliquez sur le bouton Terminer. Deux fichiers, HelloWorld.jpx et HelloWorld.html, sont générés par l expert et apparaissent dans le volet projet situé dans la partie supérieure gauche de l AppBrowser. 9 Double-cliquez sur HelloWorld.html, le fichier de notes du projet, pour le voir dans le volet contenu situé au centre de l AppBrowser. 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. Tutoriel : Construction d une application 3-5

30 Etape 2 : Gé n é ration de vos fichiers source Etape 2 : Génération de vos fichiers source 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 : 1 Choisissez Fichier Nouveau ou cliquez sur le bouton Nouveau dans la barre d outils principale pour ouvrir la galerie d objets. 2 Sélectionnez l onglet Général et double-cliquez sur l icône Application pour ouvrir l expert application. 3 Acceptez le nom de paquet par défaut, helloworld, dans l étape 1 de l expert application. Par défaut, l expert dérive le nom du paquet du nom du fichier projet, HelloWorld.jpx. 4 Entrez HelloWorldClasse dans le champ Nom de classe. C est un nom de classe Java qui distingue les majuscules des minuscules. 5 Cochez Créer les commentaires d en-tête. Quand vous sélectionnez cette option, les informations des notes du projet qui ont été entrées à l étape 3 de l expert projet apparaissent au début de tous les fichiers source générés par l expert application. 3-6 Introduction à JBuilder

31 Etape 2 : Gé n é ration de vos fichiers source L étape 1 de l expert application doit ressembler à ceci : 6 Cliquez sur le bouton Suivant pour atteindre l étape 2 de l expert application. 7 Entrez HelloWorldCadre dans le champ Classe pour nommer la classe Cadre. 8 Entrez Hello World dans le champ Titre. Ce texte apparaît dans la barre de titre du cadre de votre application. 9 Cochez toutes les options correspondant aux fonctionnalités que vous voulez ajouter à votre application : Créer la barre de menus, Créer la barre d outils, Créer la barre d état, Créer la boîte de dialogue A propos et Centrer le cadre à l écran. L expert génère le code de base gérant ces fonctionnalités. L étape 2 de l expert application doit ressembler à ceci : Tutoriel : Construction d une application 3-7

32 Etape 2 : Gé n é ration de vos fichiers source Remarque Remarque 10 Cliquez sur le bouton Terminer. Les nouveaux fichiers source.java et les images de la barre d outils sont ajoutés à votre projet et affichés en tant que nœuds dans le volet projet. Le code source de HelloWorldCadre.java est ouvert dans le volet contenu comme le montre l image suivante. Le volet message n apparaît que si un message est affiché. Par conséquent, vous ne le voyez pas encore si vous suivez ces étapes. Dans les éditions JBuilder SE et JBuilder Entreprise, un nœud 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). Figure 3.1 Eléments de l AppBrowser Remarque 11 Choisissez Fichier Tout enregistrer pour enregistrer les fichiers source et le fichier projet. Les fichiers source sont enregistrés dans : /<home>/jbproject/helloworld/ src/helloworld. 3-8 Introduction à JBuilder

33 Etape 3 : Compilation et exé cution de votre application Les fichiers classe générés par le compilateur Java à partir des fichiers source sont enregistrés dans : /<home>/jbproject/helloworld/classes/ helloworld. Etape 3 : Compilation et exécution de votre application Astuce Maintenant, compilez et exécutez votre application. La compilation consiste à exécuter le compilateur Java. Le compilateur, qui traduit le code source en bytecode Java, génère des fichiers.class. 1 Choisissez Exécuter Exécuter le projet ou cliquez sur le bouton Exécuter le projet sur la barre d outils de JBuilder pour compiler et exécuter votre application. Vous pouvez aussi sélectionner HelloWorldClasse.java dans le volet projet, cliquer avec le bouton droit et choisir Exécuter en utilisant HelloWorldClasse. 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. 2 Choisissez Fichier Quitter dans l application Hello World pour fermer celle-ci. 3 Pour fermer les messages, cliquez sur le bouton Fermer de l onglet HelloWorldClasse. Tutoriel : Construction d une application 3-9

34 Etape 4 : Personnalisation de l interface utilisateur de votre application Etape 4 : Personnalisation de l interface utilisateur de votre application Suivez les étapes ci-dessous pour personnaliser l interface utilisateur de votre application : 1 Double-cliquez sur HelloWorldCadre.java dans le volet projet s il n est pas déjà ouvert. 2 Cliquez sur l onglet Conception en bas du volet contenu pour passer dans la vue conception. Le concepteur d interface utilisateur apparaît dans le volet contenu, la palette de composants au-dessus de lui et l inspecteur à sa droite. Utilisez la palette de composants pour ajouter des composants à votre interface utilisateur et l inspecteur pour modifier les propriétés et ajouter des événements à votre code. Le volet structure, situé à gauche du volet contenu, affiche désormais une arborescence de composants et de dossiers, tels que Interface utilisateur, Menu et Autre. Figure 3.2 Eléments du concepteur d interface utilisateur 3-10 Introduction à JBuilder