IntroductionEtape 1Etape 3

Tutoriel : Construction d'une applet

Etape 2 : Génération de vos fichiers source

L'expert applet crée un fichier .java et le fichier HTML de l'applet, et les place dans le projet que vous venez de créer à l'aide de l'expert projet.

Pour générer les fichiers source de votre applet, suivez ces étapes :

  1. Choisissez Fichier|Nouveau et choisissez l'onglet Web de la galerie d'objets. (Dans JBuilder Personnel, l'icône Applet se trouve sur la page Nouveau.)
  2. Double-cliquez sur l'icône Applet pour afficher l'expert applet.
  3. Acceptez le nom de paquet par défaut, firstapplet, à l'étape 1. Par défaut, l'expert tire le nom du paquet du nom du fichier projet, FirstApplet.jpr.
  4. Entrez GoodEveningApplet dans le champ Classe. C'est un nom de classe Java qui distingue les majuscules des minuscules.

    Remarque : Le nom de classe complet (nom du paquet + nom de la classe) est firstapplet.GoodEveningApplet.class. Le fichier classe est enregistré dans la structure de paquet Java suivante : firstapplet/GoodEveningApplet.class.

  5. Acceptez la Classe de base par défaut, java.applet.Applet.

    Attention : Si vous créez l'applet en utilisant javax.swing.JApplet, elle ne s'exécutera pas dans les navigateurs. A l'heure où nous écrivons, Swing n'est pas encore supporté par les navigateurs. Voir "Présentation" pour plus d'informations.

  6. Cochez Créer les méthodes standard.

    L'étape 1 de l'expert applet doit ressembler à ceci :

    Expert applet - Etape 1

  7. Cliquez sur Suivant pour passer à l'étape 2. Au cours de cette étape, vous allez ajouter des paramètres à votre applet. L'expert ajoute les balises <param> à l'intérieur des balises <applet> dans le fichier HTML de l'applet et insère dans le code source le code de gestion des paramètres. Les paramètres de l'applet, équivalents des arguments de la ligne de commande pour les applications, vous permettent de personnaliser l'applet. N'ajoutez aucun paramètre.

    Voir aussi : "Defining and using parameters" à l'adresse http://www.java.sun.com/docs/books/tutorial/applet/appletsonly/param.html.

  8. Cliquez sur Suivant pour passer à l'étape 3 de l'expert applet.
  9. Apportez les modifications suivantes à l'étape 3 :
    1. Acceptez l'option par défaut Créer une page HTML. Quand vous sélectionnez cette option, le fichier HTML qui appelle l'applet est créé. Ce fichier HTML contient la balise <applet> et divers attributs.
    2. Titre : Page HTML de l'applet Good Evening
      Le titre s'affiche dans la fenêtre du navigateur web quand l'applet s'exécute.
    3. Acceptez les valeurs par défaut de tous les autres attributs.

    L'étape 3 de l'expert applet doit ressembler à ceci :

    Expert applet - Etape 3

    Certains des attributs suivants se trouvent dans la balise <applet> du fichier HTML :

    codebase
    Cet attribut facultatif spécifie le chemin relatif au fichier HTML de l'applet dans lequel le navigateur recherche les fichiers classe nécessaires. La valeur "." spécifie le même répertoire que le fichier HTML exécutant l'applet. L'attribut codebase est obligatoire quand les fichiers classes se trouvent dans un répertoire différent de celui du fichier HTML.
    code
    Cet attribut obligatoire, qui est automatiquement inséré par l'expert applet de JBuilder, est le nom complet (nom du paquet + nom de la classe) de la classe applet contenant la méthode init(). Vous le verrez dans le fichier HTML lorsqu'il sera généré. Dans cet exemple, le nom complet de la classe est firstapplet.GoodEveningApplet.class.
    archive
    Cet attribut facultatif, qui ne figure pas dans le code généré par l'expert applet, est obligatoire lorsque l'applet est déployée dans un fichier JAR, ZIP ou CAB. Les fichiers d'archive doivent se trouver dans le répertoire spécifié par codebase.
    name
    Cet attribut facultatif est le nom de l'applet.
    width/height
    Ces attributs obligatoires déterminent la largeur et la hauteur en pixels de la zone d'affichage de l'applet.
    hspace/vspace
    Ces attributs facultatifs déterminent l'ajout d'espace horizontal (marges de gauche et de droite) et l'ajout d'espace vertical (marges en haut et en bas) autour de l'applet, en pixels.
    align
    Cet attribut facultatif détermine l'alignement de l'applet sur la page HTML.

    Important : Les valeurs de codebase, code, archive et name doivent être entre guillemets et distinguent les majuscules des minuscules.

    Voir aussi : "Attributs de la balise <applet>" dans "Utilisation des applets", dans le Guide du développeur d'applications web.

  10. Sélectionnez Terminer pour clore l'expert applet. Remarquez que deux fichiers sont créés et ajoutés au projet, GoodEveningApplet.java et GoodEveningApplet.html.

    Remarque : Dans les éditions JBuilder Professionnel et JBuilder Entreprise, un noeud de paquet source automatique, appelé firstapplet, 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).

  11. Double-cliquez sur chaque fichier et sélectionnez l'onglet Source dans le volet contenu pour voir le code généré.

    Examinez GoodEveningApplet.java et remarquez ce qui suit :

    Observez GoodEveningApplet.html et remarquez que l'expert a inséré la valeur de code, firstapplet.GoodEveningApplet.class.

  12. Choisissez Fichier|Tout enregistrer pour enregistrer les fichiers source et le fichier projet.

    Remarque : Par défaut, JBuilder enregistre les fichiers source dans :
    /<home>/jbproject/FirstApplet/src/firstapplet/

    Le fichier HTML de l'applet est enregistré dans le répertoire classes :
    /<home>/jbproject/FirstApplet/classes/

    Les fichiers classe, après la compilation, sont enregistrés dans le chemin de sortie : /<home>/jbproject/FirstApplet/classes/firstapplet/

    JBuilder suit toujours la hiérarchie des paquets lors de l'enregistrement des fichiers. Dans cet exemple, les fichiers source et classe sont enregistrés à l'intérieur d'un répertoire firstapplet dans les chemins du source et de sortie pour suivre la structure du paquet firstapplet. Ces chemins sont définis pour chaque projet dans la boîte de dialogue Propriétés du projet (Projet|Propriétés du projet). Dans ce tutoriel, vous avez accepté les chemins proposés par défaut à l'étape 2 de l'expert projet.

Introduction Etape 2Etape 4

Tutoriel : Construction d'une applet

Etape 3 : Compilation et exécution de votre applet

Maintenant, compilez et exécutez l'applet.

Important : Pour plus d'informations sur l'exécution des applets JDK 1.1.x et 1.2 dans JBuilder, voir "Exécution des applets" dans le chapitre "Utilisation des applets" du Guide du développeur d'applications web.

  1. Choisissez Exécuter|Exécuter le projet ou cliquez sur le bouton Exécuter Icône Exécuter pour compiler et exécuter votre applet. Le menu et l'icône Exécuter exécutent l'applet dans le visualiseur d'applet de JBuilder, AppletTestbed.

    Astuce :Vous pouvez aussi cliquer avec le bouton droit sur GoodEveningApplet.html dans le volet projet et sélectionner Exécuter. Cela exécute votre applet dans l'appletviewer de Sun.

    S'il y a une erreur de compilation lorsque vous exécutez votre applet, le volet message apparaît en bas de l'AppBrowser. Corrigez ces erreurs et exécutez à nouveau l'applet.

    Votre applet s'affiche et doit ressembler à ceci :

  2. Vous pouvez changer les paramètres d'exécution de l'applet dans la page Exécution de la boîte de dialogue Propriétés du projet. Pour accéder à cette boîte de dialogue, sélectionnez Projet|Propriétés du projet, ou bien cliquez avec le bouton droit sur FirstApplet.jpr et sélectionnez Propriétés. Les paramètres de la page Exécution contrôlent le comportement du menu Exécuter et de l'icône Exécuter figurant dans la barre d'outils. Choisissez l'option Classe principale pour exécuter votre applet dans l'AppletTestbed de JBuilder. Choisissez l'option HTML pour exécuter votre applet dans l'appletviewer de Sun. Lorsque vous utilisez l'expert applet pour créer votre applet, l'option Classe principale est sélectionnée par défaut.

    Important : Les applets s'exécutent depuis le fichier HTML qui appelle la classe contenant la méthode init(), et non depuis le fichier .java. Toute tentative d'exécuter le fichier .java entraînera un message d'erreur (sauf si l'option Peut s'exécuter indépendamment a été sélectionnée à l'étape 1 de l'expert applet) :

    java.lang.NoSuchMethodError: main
    Exception dans thread "main"
    
  3. Choisissez Exit dans l'applet "Good Evening" pour la fermer.
  4. Cliquez avec le bouton droit sur l'onglet GoodEveningApplet du volet message et sélectionnez Retirer l'onglet "GoodEveningApplet" pour fermer tout message d'exécution.

Introduction Etape 2 Etape 4