Introduction Etape 6 Etape 8Code source

Tutoriel : Construction d'une applet

Etape 7 : Déploiement de votre applet

Déployer une applet Java consiste à rassembler les fichiers classe Java, les fichiers image et les autres fichiers nécessaires à l'applet, et à les copier, ainsi que le fichier HTML de l'applet, sur une machine serveur ou client où ils peuvent être exécutés. Vous pouvez livrer les fichiers séparément ou dans des fichiers d'archive compressés ou non. Les fichiers JAR, fichiers archive Java, sont le plus couramment utilisés. L'avantage des fichiers JAR est qu'ils sont plus petits et que leur téléchargement est plus rapide.

Lorsque vous déployez votre applet, n'oubliez pas ceci :

Attention : Si vous créez vos applets pour d'anciens navigateurs basés sur le JDK 1.02, n'oubliez pas qu'ils ne supportent pas les fichiers JAR. Créez à la place un fichier archive ZIP.

Voir aussi :

Selon l'édition de JBuilder que vous possédez, il existe différents outils pour déployer votre applet :

Important : Avant de créer le fichier JAR, relisez cette liste :

Déploiement de votre applet à l'aide de l'outil jar

JBuilder Personnel

Le JDK contient un outil jar, dans le répertoire bin, pour créer les fichiers JAR du déploiement. L'outil jar, utilitaire d'archivage et de compression, regroupe plusieurs fichiers dans une seule archive JAR.

La commande jar de base est de la forme suivante :

jar {ctxu}[vfm0M] [fichier-jar] [fichier-manifest] [-C répertoire] fichiers ...

Remarque : Pour obtenir de l'aide sur les autres options JAR, entrez jar -help sur la ligne de commande ou reportez-vous à la documentation jar, à l'adresse http://java.sun.com/j2se/1.3/docs/tooldocs/tools.html#basic.

Créez le fichier JAR en suivant ces étapes :

  1. Enregistrez et compilez votre projet.
  2. Créez pour votre applet un répertoire applets dans votre répertoire /<home>/jbproject/. Ce sera le répertoire de test dans lequel vous mettrez le fichier HTML de votre applet et le fichier JAR.
  3. Ouvrez la fenêtre de commandes ou une fenêtre DOS.
  4. Passez dans le répertoire du projet : /<home>/jbproject/FirstApplet/
  5. Entrez la commande JAR suivante :
    jar cvf GoodEvening.jar -C classes firstapplet
    
    où :
    jar - la commande qui génère le fichier JAR
    c - crée une nouvelle archive
    v - génère une sortie spécifiant ce qui a été ajouté au fichier JAR
    f - spécifie le nom du fichier JAR pour créer
    -C - change temporairement pour le répertoire spécifié pendant l'exécution de la commande jar (dans ce cas, le répertoire classes)
    classes - le répertoire où la commande jar est exécutée
    firstapplet - le paquet des classes à ajouter au fichier JAR

    Remarque : Le JDK doit se trouver dans votre chemin d'accès. Sinon, utilisez la commande suivante :

    <jbuilder>/jdk1.3/bin/jar cvf GoodEvening.jar -C classes firstapplet
    
    <jbuilder> représente la version de JBuilder que vous exécutez, par exemple, jbuilder5/. Si JBuilder se trouve sur un autre lecteur, incluez le nom de ce lecteur.

    Remarque : Pour Windows, utilisez des barres obliques inverses (\).

  6. Le fichier JAR est créé dans le répertoire FirstApplet du projet. Ouvrez le fichier JAR avec un utilitaire JAR comme WinZip, et vérifiez que la structure des répertoires des classes est correcte : par exemple, firstapplet/GoodEveningApplet.class. De même, remarquez que l'outil jar a créé un fichier manifest. C'est dans le fichier manifest que sont stockées toutes les méta-informations sur l'archive.
  7. Copiez GoodEvening.jar dans le répertoire applets pour le tester.

Une fois le fichier JAR créé, passez à l'Etape 8 : Modification du fichier HTML.

Voir aussi :

Déploiement de votre applet à l'aide du Constructeur d'archives

C'est une fonctionnalité de JBuilder Professionnel et de JBuilder Entreprise.

Le Constructeur d'archives de JBuilder rassemble tous les fichiers requis pour distribuer votre applet et peut les archiver dans un fichier JAR.

Pour déployer votre applet avec JBuilder Professionnel et JBuilder Entreprise :

  1. Enregistrez et compilez votre projet.
  2. Créez pour votre applet un répertoire applets dans votre répertoire /<home>/jbproject/. Ce sera le répertoire de test dans lequel vous mettrez le fichier HTML de votre applet et le fichier JAR.
  3. Choisissez Experts|Constructeur d'archives pour ouvrir le Constructeur d'archives.

    Etape 1 du Constructeur d'archives

  4. Sélectionnez JAR de l'applet dans la liste déroulante Type d'archive, à l'étape 1. Cliquez sur Suivant pour passer à l'étape 2.

    Remarque : Sélectionnez le type d'archive ZIP de l'applet si vous développez des applets pour des navigateurs anciens ne supportant pas les fichiers JAR.

  5. Acceptez le nom par défaut, JAR de l'applet, dans le champ Nom.
  6. Cliquez sur le bouton Points de suspension, à côté du champ Fichier, et naviguez jusqu'au répertoire /<home>/jbproject/applets/.
  7. Changez le nom du fichier JAR en GoodEvening.jar et choisissez OK.

    Etape 2 du Constructeur d'archives

  8. Cliquez sur Suivant pour aller à l'étape 3.
  9. Choisissez Inclure les classes requises et ressources connues. Ensuite, vous choisirez manuellement les classes que vous voulez ajouter. Choisir cette option vous permet d'exclure le fichier HTML, qui n'a pas besoin d'être déployé avec les classes.
  10. Cliquez sur le bouton Ajouter une classe et sélectionnez le paquet firstapplet. Le paquet s'affiche dans la liste Classes, paquets et ressources nécessaires.

  11. Cliquez sur Suivant pour aller à l'étape 4.
  12. Acceptez les valeurs par défaut aux étapes 4 et 5. Notez que dans l'étape 5, la création d'un fichier manifest pour l'archive est définie par défaut.

    Remarque : Pour plus d'informations sur les fichiers manifest, voir "A propos du fichier manifest" dans "Déploiement des programmes Java".

  13. Cliquez sur Terminer pour quitter le Constructeur d'archives. Un noeud d'archive, appelé JAR de l'applet, 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.
  14. Compilez votre projet en sélectionnant Projet|Construire le projet. Le Constructeur d'archives joint le paquet firstapplet que vous avez ajouté dans le fichier JAR à l'étape 3 de l'expert.
  15. Cliquez sur l'icône de développement, à côté du noeud d'archive JAR de l'applet pour voir le fichier d'archive GoodEvening.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. Sélectionnez un fichier dans le volet structure pour le voir dans le volet contenu.

Remarque :Si vous livrez plusieurs programmes au même endroit, vous pouvez livrer séparément les fichiers redistribuables, au lieu de les inclure dans chacun de vos fichiers JAR.

Voir aussi :

Introduction Etape 7 Etape 9

Tutoriel : Construction d'une applet

Etape 8 : Modification du fichier HTML

Maintenant que votre applet est déployée dans un fichier JAR, vous avez besoin de modifier dans le fichier HTML l'attribut archive pour y inclure le nom du fichier JAR. Vous allez aussi insérer un message entres les balises <applet> indiquant aux utilisateurs qui ne disposent pas d'un navigateur supportant Java qu'ils ne pourront pas voir l'applet, sauf s'ils activent Java dans leur navigateur ou s'ils mettent ce dernier à jour.

Pour modifier le fichier HTML,

  1. Ouvrez GoodEveningApplet.html dans JBuilder et ajoutez l'attribut archive comme ci-après :
    1. Sélectionnez l'onglet Source pour voir le code source du HTML.
    2. Ajoutez le code HTML suivant dans la balise <applet> :
      archive  = "GoodEvening.jar"
      
      La balise <applet> doit ressembler à ceci :
      <applet
        codebase = "."
        code     = "firstapplet.GoodEveningApplet.class"
        archive  = "GoodEvening.jar"
        name     = "TestApplet"
        width = 400
        height = 300
        hspace = 0
        vspace = 0
        align = top
      >
      </applet>
      

    Astuce : Si vous avez plusieurs fichiers JAR pour votre applet, séparez-les par une virgule, comme ceci :

    archive="fichier1.jar, fichier2.jar"
    

    Important : Certains anciens navigateurs ne supportent ni les fichiers JAR ni les listes multiples de fichiers archive, mais supportent un seul fichier ZIP dans l'attribut archive.

    Ensuite, ajoutez un message pour signaler aux utilisateurs n'ayant pas de navigateur supportant Java que leur navigateur ne supportera pas Java et qu'ils ne pourront donc pas voir l'applet.

  2. Entrez le message suivant entre les balises <applet> d'ouverture et de fermeture :
    Vous devez avoir un navigateur supportant Java et exécutant JDK 1.1.x ou une version supérieure pour voir cette applet.
    

    La balise <applet> doit ressembler à ceci :

    <applet
      codebase = "."
      code     = "firstapplet.GoodEveningApplet.class"
      archive  = "GoodEvening.jar"
      name     = "TestApplet"
      width = 400
      height = 300
      hspace = 0
      vspace = 0
      align = top
    >
    Vous devez avoir un navigateur supportant Java et exécutant JDK 1.1.x ou une version supérieure pour voir cette applet.
    </applet>
    

    Les navigateurs ne supportant pas Java ignorent les balises <applet> et affichent tout ce qui se trouve entre ces balises. Comme un navigateur supportant Java reconnaît les balises <applet>, tout utilisateur disposant d'un tel navigateur verra l'applet et non le message.

    Important : Avant d'enregistrer le fichier HTML, vérifiez encore les valeurs de codebase et de code. Si ces valeurs sont incorrectes, l'applet ne s'exécutera pas. N'oubliez pas que la valeur de codebase est l'emplacement du code de l'applet (fichier classe ou fichier JAR) par rapport au fichier HTML. La valeur "." signifie que le fichier classe se trouve dans le même répertoire que le fichier HTML. La valeur de code doit être le nom de classe complet de l'applet, y compris le nom du paquet.

  3. Enregistrez et fermez le fichier.
  4. Copiez le fichier GoodEveningApplet.html modifié, du répertoire classes du projet vers le répertoire applets. Le répertoire applets doit contenir deux fichiers, GoodEveningApplet.html et GoodEvening.jar.

    Attention : Souvenez-vous que JBuilder crée deux fichiers HTML : le fichier HTML des notes du projet, FirstApplet.html, se trouvant dans la racine du répertoire du projet et le fichier HTML de l'applet contenant la balise <applet>, GoodEveningApplet.html, se trouvant dans le répertoire src du projet. Ne copiez pas FirstApplet.html au lieu de GoodEveningApplet.html dans le répertoire applets car l'applet ne s'exécuterait pas.

Introduction Etape 8 Etape 10Code source

Tutoriel : Construction d'une applet

Etape 9 : Exécution depuis la ligne de commande de l'applet déployée

C'est une bonne idée de tester l'applet déployée en local avant de la tester sur le web. Vous pouvez faire cela à partir de la ligne de commande, en utilisant l'appletviewer de Sun. Cela vous indiquera si le navigateur possède tout ce qui est nécessaire pour exécuter l'applet. Si des fichiers sont manquants ou s'il y a des erreurs dans le fichier HTML, l'applet ne s'exécutera pas. Vous pourrez alors corriger les erreurs avant de l'envoyer sur le web.

Pour exécuter l'applet depuis la ligne de commande,

  1. Assurez-vous que les copies de GoodEveningApplet.html et de GoodEvening.jar se trouvent bien dans le répertoire applets.
  2. Ouvrez la fenêtre de la ligne des commandes.
  3. Effacez toute variable CLASSPATH afin de supprimer d'éventuels chemins de classe pour cette session, comme ceci :
  4. Passez dans le répertoire applets.
  5. Exécutez l'appletviewer en entrant la commande suivante :
    <jbuilder>/jdk1.3/bin/appletviewer GoodEveningApplet.html
    
    <jbuilder> représente la version de JBuilder que vous exécutez, par exemple, jbuilder5/.

    Important : Si JBuilder se trouve sur un autre lecteur, incluez le nom de ce lecteur.

    Remarque : Pour Windows, utilisez des barres obliques inverses (\).

  6. Si l'applet "Good Evening" se charge et s'exécute dans l'appletviewer, c'est que le déploiement a réussi et que les classes ont toutes été trouvées et incluses. Si l'applet ne s'exécute pas, lisez les messages d'erreur, corrigez les erreurs, recompilez, déployez et essayez à nouveau.

L'applet "Good Evening" est fournie en exemple dans le répertoire samples/Tutorials/FirstApplet/ de JBuilder.

Si vous avez des problèmes pour exécuter votre applet, reportez-vous au code source de l'applet, à la fin de ce tutoriel, et lisez les rubriques suivantes pour les erreurs les plus courantes :

Introduction Etape 9Code source

Tutoriel : Construction d'une applet

Etape 10 : Test sur le web de votre applet déployée

Cette étape est une présentation générale du test de votre applet déployée sur le web et n'aborde pas les aspects spécifiques. Il est important de tester votre applet sur une grande variété de navigateurs pour être certain que tous les fichiers nécessaires sont inclus dans l'archive.

La dernière étape pour tester votre applet consiste à l'exécuter sur le web. Cela vous indiquera si elle a bien tous les fichiers nécessaires.

Effectuez les étapes suivantes, puis testez votre applet sur le web.

  1. Transférez les fichiers HTML et les fichiers JAR de l'applet sur un serveur Internet ou copiez-les sur un serveur Windows NT.
    1. Servez-vous d'un utilitaire de transfert FTP pour transférer les fichiers sur le serveur. Vérifiez que vous transférez les fichiers en tant que fichiers binaires.
    2. Assurez-vous que les emplacements sur le serveur des fichiers HTML et JAR correspondent bien à l'attribut codebase du fichier HTML et que l'attribut code contient le nom de classe complet (y compris le nom du paquet).
  2. Testez l'applet dans divers navigateurs. Si l'applet ne peut se charger, vérifiez que le navigateur supporte Java. Consultez aussi les messages d'erreur dans la console Java du navigateur.

    Pour ouvrir la console Java :

  3. Corrigez ces erreurs, redéployez votre applet et testez-la à nouveau dans divers navigateurs.

Félicitations ! Vous venez de créer votre première applet 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.

Si vous avez des suggestions à faire pour améliorer ce tutoriel, envoyez un e-mail à jpgpubs@borland.com.

Pour d'autres tutoriels sur les applets, voir :

Présentation Etape 9 Code source