<!-- If the browser does not support frames put the first topic content here --> <div class="WordSection1"> <p class="MsoBodyTextIndent2" align="center" style= 'text-align:center;text-indent: 0cm'>Les paquetages, la compression de paquetages et la génération d'aide</p> <p class="MsoNormal" style='text-align:justify'><span style= 'font-size:14.0pt'> </span></p> <p class="MsoNormal"><b><i><span style= 'font-size:12.0pt;font-family:"Arial",sans-serif'> </span></i></b></p> <p class="T" style= 'margin-top:0cm;margin-right:0cm;margin-bottom:12.0pt; margin-left:17.85pt;text-indent:-17.85pt'> <span style='font-size:14.0pt'>1. LES PAQUETAGES (Packages)</span></p> <p class="MsoNormal"> </p> <p class="St"><span style= 'font-size:12.0pt;text-decoration:none'>1.1 Définition</span></p> <p class="MsoNormal"><span style='font-size:12.0pt'>Un paquetage est un ensemble de classes regroupées par domaine d'utilisation.</span></p> <p class="MsoNormal"><span style='font-size:12.0pt'>Exemple : les paquetages java.io, java.awt, etc.</span></p> <p class="MsoNormal"><span style= 'font-size:12.0pt'> </span></p> <p class="MsoNormal"><i><span style= 'font-size:12.0pt'> </span></i></p> <p class="St" style='margin-left:18.0pt;text-indent:-18.0pt'> <span style='font-size:12.0pt;text-decoration:none'>1.2<span style= 'font:7.0pt "Times New Roman"'> </span></span> <span style= 'font-size:12.0pt;text-decoration:none'> Création d'un paquetage</span></p> <p class="St"><i><span style='font-size:12.0pt'>Deux solutions :</span></i></p> <p class="St"><span style= 'font-size:12.0pt;font-weight:normal'>1<sup>ère</sup> solution :</span></p> <p class="MsoNormal" style= 'margin-left:54.0pt;text-indent:-17.0pt'><span style= 'font-size:12.0pt;font-family:Wingdings'>@</span><span style= 'font-size:12.0pt'>Créer un sous-répertoire dans un des répertoires définis dans CLASSPATH (par exemple, on pourra créer le sous-répertoire <i>monpack</i> dans E:\ClassesJava si E:\ClassesJava appartient au classpath).</span></p> <p class="MsoNormal" style= 'margin-left:54.0pt;text-indent:-17.0pt'><span style= 'font-size:12.0pt;font-family:Wingdings'>@</span><span style= 'font-size:12.0pt'>Créer les sources des classes en écrivant en tout début de programme la ligne <b>package <i>nomPackage</i>;</b> (exemple : <i>package monpack;</i>) et les placer dans le sous-répertoire créé (donc ici dans E:\ClassesJava\<i>monpack</i>).</span></p> <p class="MsoNormal" style= 'margin-left:54.0pt;text-indent:-17.0pt'><span style= 'font-size:12.0pt;font-family:Wingdings'>@</span><span style= 'font-size:12.0pt'>Compiler les sources, cela produit les .class du package dans le répertoire E:\ClassesJava\<i>monpack</i> .</span></p> <p class="MsoNormal"><span style= 'font-size:12.0pt;display:none'> </span></p> <p class="MsoBodyText">Remarque : après la création du .class, les sources peuvent être placées ailleurs que dans le package.</p> <p class="MsoBodyText"> </p> <p class="St"><span style= 'font-size:12.0pt;font-weight:normal'>2<sup>ème</sup> solution :</span></p> <p class="MsoNormal" style= 'margin-left:54.0pt;text-indent:-17.0pt'><span style= 'font-size:12.0pt;font-family:Wingdings'>@</span><span style= 'font-size:12.0pt'>Créer les sources des classes en écrivant en tout début de programme la ligne <b>package <i>nomPackage</i>;</b> (exemple : package <i>monpack;</i>) et les placer dans un répertoire à part (exemple :</span> <span class= "listing">C:\SourcesJava).</span></p> <p class="MsoNormal" style= 'margin-left:54.0pt;text-indent:-17.0pt'><span style= 'font-size:12.0pt;font-family:Wingdings'>@</span><span style= 'font-size:12.0pt'>Compiler directement les sources sans créer préalablement le sous-répertoire associé au package par exemple, on lancera la commande :</span></p> <p style= 'margin-top:0cm;margin-right:0cm;margin-bottom:0cm;margin-left:45.0pt; text-indent:9.0pt'> <span class="listing"><span style= 'font-size:10.0pt; font-family:"Courier New"'>javac -d </span></span> <span style= 'font-size:10.0pt;font-family:"Courier New"'>E:\ClassesJava<span class="listing"> C:\SourcesJava\nom_du_programme.java</span></span></p> <p class="St" style= 'margin-top:0cm;margin-right:0cm;margin-bottom:0cm; margin-left:54.0pt'> <span style= 'font-size:12.0pt;font-weight:normal; text-decoration:none'>pour créer le sous-répertoire <i>monpack</i> dans E:\ClassesJava (E:\ClassesJava doit figurer dans le CLASSPATH) et y créer le .class.</span></p> <p class="St" style= 'margin-top:0cm;margin-right:0cm;margin-bottom:0cm; margin-left:54.0pt'> <span style= 'font-size:12.0pt;font-weight:normal; text-decoration:none'>Remarque : si le répertoire <i>monpack</i> existe déjà, il y a uniquement création du .class.</span></p> <p class="MsoNormal"> </p> <p class="MsoBodyText">Remarques :</p> <p class="MsoBodyText">Généralement un package contient plusieurs classes et est organisé de façon hiérarchique sur plusieurs sous-répertoires (voir TP).</p> <p class="MsoBodyText">Si le paquetage n'est pas spécifié, il y a un paquetage par défaut : c'est le répertoire courant et il est constitué de tous les .class y figurant.</p> <p class="MsoBodyText">Les classes des paquetages doivent être publiques.</p> <p class="MsoBodyText"> </p> <p class="MsoNormal"><span style= 'font-size:12.0pt'> </span></p> <p class="St"><span style= 'font-size:12.0pt;text-decoration:none'>1.3 Utilisation d'un paquetage</span></p> <p class="MsoNormal"><span style='font-size:12.0pt'>On peut utiliser les classes d'un paquetage en préfixant la classe du nom du paquetage ce qui n'est pas très pratique. Le mieux est d'importer le paquetage : pour cela, il faut placer la ligne <b>import <i>nomdupaquetage</i>.*;</b> en début de programme si on souhaite importer toutes les classes du paquetage ou bien <b>import<i>nomdupaquetage.NomClasse;</i></b> si on souhaite importer une seule classe du paquetage.</span></p> <p>Attention, si on a un paquetage sous_pack inclus dans pack, le fait d'inclure pack.* permettra uniquement l'accès aux classes figurant directement dans pack, il faudra importer pack.sous_pack.* pour avoir accès aux classes de sous_pack.</p> <p style='margin:0cm'>Les paquetages sont utilisés :</p> <p style='margin:0cm'>. lors de la pré-compilation des programmes les important,</p> <p style='margin:0cm'>. lors de l'exécution des programmes les important.</p> <p>Attention : lors de la pré-compilation d'un programme important des paquetages, il faut être vigilant sur l'organisation des fichiers car Java sait compiler des fichiers sources "à la volée". Donc s'il trouve en utilisant la variable <tt><span style= 'font-size:10.0pt'>CLASSPATH</span></tt> ou l'option <tt><span style='font-size:10.0pt'>-classpath</span></tt> de <tt><span style='font-size:10.0pt'>javac</span></tt> un fichier <tt><span style='font-size:10.0pt'>.java</span></tt> avant le fichier correspondant <tt><span style= 'font-size:10.0pt'>.class</span></tt> <tt><span style= 'font-family:"Times New Roman",serif'>(le pré-compilateur peut très bien trouver un fichier .java dans le 2<sup>ème</sup> répertoire du CLASSPATH alors que le .class figure dans le 1<sup>er</sup> répertoire du CLASSPATH)</span></tt>, il le recompilera, ce qui non seulement ralentira l'exécution, mais pourra même la faire échouer.<br /> </p> <p class="T" style= 'margin-top:0cm;margin-right:0cm;margin-bottom:12.0pt; margin-left:36.0pt;text-indent:-36.0pt'> <span style='font-size:14.0pt; text-decoration:none'>2.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <span style='font-size:14.0pt'>LA COMPRESSION DES PAQUETAGES</span></p> <p class="St"><span style= 'font-size:12.0pt;text-decoration:none'>2.1 Introduction</span></p> <p>Les paquetages vont être compressés dans des fichiers d'extension jar.</p> <p>Un "jar" peut contenir d'autres fichiers en plus des .class, on peut y inclure aussi notamment les manuels utilisateurs, la documentation technique des programmes et de l'application,</p> <p><span style='color:black'>L'utilisation des jar est particulièrement pertinente avec les beans et même les applications. En fait, le format jar est le format de diffusion de composants java.</span></p> <p><span style='color:black'>Un jar peut être signé ce qui permet d'assouplir et d'élargir le modèle de sécurité, notamment des applets qui ont des droits restreints par défaut.</span></p> <p style='margin:0cm'><span style='color:black'>Une archive jar contient un fichier manifest qui permet de préciser le contenu du jar et de fournir des informations sur celui-ci (classe principale, type de composants, signature...).</span></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif;color:black'><br clear="all" style='page-break-before:always' /></span> <p style='margin:0cm'><span style='color:black'> </span></p> <p class="St" style='margin-bottom:0cm'><span style= 'font-size:12.0pt;text-decoration: none'>2.2 Création d'un jar</span></p> <p class="MsoNormal"><span style= 'font-size:12.0pt;color:black'>Création d'un jar contenant tous les fichiers du répertoire courant et des sous-répertoires</span></p> <p class="MsoNormal"><span style= 'font-size:12.0pt;color:black'>avec un fichier manifest créé automatiquement :</span></p> <p style='margin-left:36.0pt'><span lang="NL" style= 'font-size:10.0pt;font-family: "Courier New";color:black' xml:lang= "NL">jar cf test.jar <i>monpack</i></span></p> <p><span style='color:black'>Si on reprend l'exemple précédent, on devra se placer dans le répertoire support de <i>monpack</i> donc ici dans</span> E:\ClassesJava <span style='color:black'>pour la création du jar et ensuite on supprimera le répertoire monpack.</span></p> <p><span style='color:black'>Le nom du jar (précédé de son emplacement) doit être indiqué</span></p> <p><span style='color:black'>Remarque : si on a un jar contenant toutes les classes au même niveau, il n'est pas nécessaire de placer les classes dans un paquetage. Il suffira de mettre le nom du jar dans le CLASSPATH.</span></p> <p><span style='color:black'>Mais généralement, on organise les classes en paquetages et ensuite on compresse l'ensemble dans un jar.</span></p> <p><span style='color:black'>On emploiera généralement la commande jar avec les options suivantes :</span></p> <div align="center"> <table class="MsoNormalTable" border="1" cellspacing="0" cellpadding="0" width="80%" style='width:80.0%'> <tr> <td style='padding:4.5pt 4.5pt 4.5pt 4.5pt'> <p class="MsoNormal"><span style= 'font-size:10.5pt;font-family:"Comic Sans MS"; color:black'>cf</span></p> </td> <td style='padding:4.5pt 4.5pt 4.5pt 4.5pt'> <p class="MsoNormal"><span style= 'font-size:10.5pt;font-family:"Comic Sans MS"; color:black'>Création d'un nouvelle archive</span></p> </td> </tr> <tr> <td style='padding:4.5pt 4.5pt 4.5pt 4.5pt'> <p class="MsoNormal"><span style= 'font-size:10.5pt;font-family:"Comic Sans MS"; color:black'>tf</span></p> </td> <td style='padding:4.5pt 4.5pt 4.5pt 4.5pt'> <p class="MsoNormal"><span style= 'font-size:10.5pt;font-family:"Comic Sans MS"; color:black'>Affiche le contenu de l'archive</span></p> </td> </tr> <tr> <td style='padding:4.5pt 4.5pt 4.5pt 4.5pt'> <p class="MsoNormal"><span style= 'font-size:10.5pt;font-family:"Comic Sans MS"; color:black'>xf</span></p> </td> <td style='padding:4.5pt 4.5pt 4.5pt 4.5pt'> <p class="MsoNormal"><span style= 'font-size:10.5pt;font-family:"Comic Sans MS"; color:black'>Extraction du contenu de l'archive</span></p> </td> </tr> <tr> <td style='padding:4.5pt 4.5pt 4.5pt 4.5pt'> <p class="MsoNormal"><span style= 'font-size:10.5pt;font-family:"Comic Sans MS"; color:black'>uf</span></p> </td> <td style='padding:4.5pt 4.5pt 4.5pt 4.5pt'> <p class="MsoNormal"><span style= 'font-size:10.5pt;font-family:"Comic Sans MS"; color:black'>Mise à jour ou ajout de fichiers à l'archive </span></p> </td> </tr> </table> </div> <p class="St" style='margin-bottom:0cm'><span style= 'font-size:12.0pt;text-decoration: none'> </span></p> <p class="MsoNormal"><span style= 'font-size:12.0pt;color:black'>Autre exemple : lister le contenu d'un jar</span></p> <p style='margin-left:36.0pt'><span lang="NL" style= 'font-size:10.0pt;font-family: "Courier New";color:black' xml:lang= "NL">jar tf test.jar</span></p> <p class="St" style='margin-bottom:0cm'><span lang="NL" style= 'font-size:12.0pt; text-decoration:none' xml:lang= "NL"> </span></p> <p class="St" style='margin-bottom:0cm'><span style= 'font-size:12.0pt;text-decoration: none'>2.3 Utilisation d'un jar</span></p> <p><span style='color:black'>Le jar est uniquement à préciser dans le CLASSPATH.</span></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p> </p> <p class="T" style= 'margin-top:0cm;margin-right:-14.4pt;margin-bottom:12.0pt; margin-left:17.85pt;text-indent:-17.85pt'> <span style='font-size:14.0pt'>3. GENERATION D'AIDE HTML A PARTIR D'UN PROGRAMME JAVA</span></p> <p class="MsoHeader"><span style='font-size:12.0pt'>Pour générer un document "d'aide Html" du style de l'API d'aide fournie par Sun, il faut insérer dans son programme java des commentaires interprétables par celui-ci, c'est à dire au format <b>/** … **/</b> et utiliser l'utilitaire <b>javadoc</b>.</span></p> <p class="MsoHeader"><span style= 'font-size:12.0pt'> </span></p> <p class="MsoHeader" style='margin-bottom:3.0pt'><b><span style= 'font-size:12.0pt'>L'utilitaire javadoc peut s'utiliser :</span></b></p> <p class="MsoHeader" style='margin-bottom:3.0pt'><b><span style= 'font-size:12.0pt'>. à partir d'une fenêtre de commandes :</span></b></p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:117.0pt;margin-right:120.6pt'> <p class="MsoHeader" align="center" style= 'text-align:center;border:none; padding:0cm'><i><span style= 'font-size:12.0pt'>javadoc nomduprogramme.java</span></i></p> </div> <p class="MsoHeader" style='margin-top:3.0pt'><span style= 'font-size:12.0pt'>OU</span></p> <p class="MsoHeader" style='margin-top:3.0pt'><b><span style= 'font-size:12.0pt'>. à partir d'un éditeur (exemple avec UltraEdit) :</span></b></p> <p class="MsoHeader" style='margin-top:3.0pt;text-indent:35.4pt'> <span style='font-size:12.0pt'>il faut créer un outil personnalisé :</span></p> <p class="MsoNormal"><img width="428" height="384" src= "S36_Cours_Atelier5_fichiers/image001.jpg" alt="image" /></p> <p class="MsoNormal"><span style='font-size:12.0pt'>Après l'utilisation de cette commande, un fichier html : <i>nomduprog.html</i> sera créé dans le répertoire courant.</span></p> <p class="MsoNormal"> </p> <p class="MsoBodyText">L'utilisation de javadoc nécessite que les classes soient publiques.</p> <p class="MsoNormal"> </p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoBodyText">Extrait de Factorielle2.java :</p> <p class="MsoNormal"> </p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt'> <p class="MsoNormal" style='border:none;padding:0cm'> </p> <p class="MsoNormal" style='border:none;padding:0cm'>import java.io.*;</p> <p class="MsoNormal" style='border:none;padding:0cm'><b>/** Ma classe Factorielle2 **/</b></p> <p class="MsoNormal" style='border:none;padding:0cm'><span lang= "EN-GB" xml:lang="EN-GB">public class Factorielle2</span></p> <p class="MsoNormal" style='border:none;padding:0cm'><span lang= "EN-GB" xml:lang="EN-GB">{</span></p> <p class="MsoNormal" style='border:none;padding:0cm'><span lang= "EN-GB" xml:lang= "EN-GB"> <b>/** Méthode main **/</b></span></p> <p class="MsoNormal" style='border:none;padding:0cm'><span lang= "EN-GB" xml:lang= "EN-GB"> public static void main(String args[]) throws IOException</span></p> <p class="MsoNormal" style='border:none;padding:0cm'><span lang= "EN-GB" xml:lang= "EN-GB"> </span> {</p> <p class="MsoNormal" style='border:none;padding:0cm'> </p> </div> <p class="MsoNormal"> </p> <p class="MsoBodyText">La commande javadoc Factorielle2.java produit le fichier Factorielle2.html suivant :</p> <p class="MsoNormal"> </p> <p class="MsoNormal"><img width="604" height="457" src= "S36_Cours_Atelier5_fichiers/image002.jpg" alt="image" /></p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> </div>
Table des matières
Sujets
Recherche
Help content
Help content
Générée avec
chmProcessor
Générée avec
chmProcessor