Tutoriel : Construction d'une 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 :
GoodEveningApplet.class
doit se trouver dans un répertoire firstapplet
pour suivre la structure du paquet : firstapplet/GoodEveningApplet.class
. Si vous effectuez le déploiement dans un fichier JAR, vérifiez que la structure des répertoires dans ce fichier est conforme.codebase
.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 :
code
de GoodEveningApplet.html
contienne le nom de classe complet, avec le nom de paquet : firstapplet.GoodEveningApplet
.codebase
de GoodEveningApplet.html
spécifie le bon emplacement du fichier classe par rapport à celui du fichier HTML. Dans cet exemple, le codebase
est ".", car le fichier JAR contenant le fichier classe sera dans le même répertoire que le fichier HTML. 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 :
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.
/<home>/jbproject/FirstApplet/
jar cvf GoodEvening.jar -C classes firstappletoù :
jar
- la commande qui génère le fichier JAR c
- crée une nouvelle archivev
- génère une sortie spécifiant ce qui a été ajouté au fichier JARf
- 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éefirstapplet
- le paquet des classes à ajouter au fichier JARRemarque : 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 firstappletOù
<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 (\).
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.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 :
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 :
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.
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.
JAR de l'applet
, dans le champ Nom./<home>/jbproject/applets/
. GoodEvening.jar
et choisissez OK.
firstapplet
. Le paquet s'affiche dans la liste Classes, paquets et ressources nécessaires.
Remarque : Pour plus d'informations sur les fichiers manifest, voir "A propos du fichier manifest" dans "Déploiement des programmes Java".
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.firstapplet
que vous avez ajouté dans le fichier JAR à l'étape 3 de l'expert. 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 :
Tutoriel : Construction d'une applet
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,
GoodEveningApplet.html
dans JBuilder et ajoutez l'attribut archive
comme ci-après :
<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.
<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.
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.
Tutoriel : Construction d'une applet
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,
GoodEveningApplet.html
et de GoodEvening.jar
se trouvent bien dans le répertoire applets
.set CLASSPATH=
unsetenv CLASSPATH
unset CLASSPATH
applets
.<jbuilder>/jdk1.3/bin/appletviewer GoodEveningApplet.htmlOù
<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 (\).
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 :
Tutoriel : Construction d'une applet
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.
codebase
du fichier HTML et que l'attribut code
contient le nom de classe complet (y compris le nom du paquet).Pour ouvrir la console Java :
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 :