Générateur d'extensions
Le générateur d'extensions de JMap est un outil qui permet de générer rapidement le code source pour des extensions client et serveur de JMap. Le code source généré est de base, et vous devez le compléter afin d'implémenter les fonctions de votre extension. Cet outil aide à économiser du temps en permettant aux développeurs de se concentrer sur l'objectif réel de leur développement plutôt que sur les détails techniques de programmation et de déploiement des extensions JMap.
L'outil possède une interface graphique mais il peut aussi être utilisé à la ligne de commandes, sans interface graphique. Les paramètres acceptés par le générateur d'extensions sont les suivants. Notez qu'ils sont tous optionnels et que des valeurs par défaut sont proposées pour les paramètres manquants.
Paramètre |
Description |
-name extensionname |
Le nom de l'extension tel qu'il apparaîtra dans JMap Admin. Peut contenir des espaces. Ex.: Suivi de marchandises, Analyse de réseaux, etc. |
-class classname |
Le nom complet (avec paquetage) de la classe principale de l'extension. Les noms des autres classes nécessaires à l'extension seront dérivées à partir de ce nom. Ex.: jmap.extensions.Tracking |
-dest destfolder |
Le répertoire de destination pour les fichiers générés. Si le répertoire existe déjà, il sera effacé et recréé. La valeur par défaut est output. |
-target target |
Le type d'extension à générer. Les valeurs acceptées sont client, server ou both. La valeur par défaut est both. Des classes et paquetages différents sont créés selon l'option sélectionnée. |
-gui true\false |
Détermine si l'interface graphique doit s'afficher ou non. Les valeurs possibles sont true et false. La valeur par défaut est true. Si l'interface graphique est utilisée, ses champs seront initialisés avec les valeurs fournies en paramètre. |
La méthode la plus simple pour exécuter le générateur d'extensions est d'utiliser le script Ant fourni avec l'outil. Les paramètres passés à l'outil peuvent être modifiés à l'intérieur du script Ant.
ant -f extensionbuilder.xml
Le générateur d'extensions peut aussi être exécuté à la ligne de commandes. (Sur Mac ou Linux, remplacer les " ; " par des " : " dans le classpath.)
java -classpath extensionbuilder.jar;../../lib/kheops_util.jar jmap.sdk.tools.extensionbuilder.ExtensionBuilder -name extensionname -class classname -dest destfolder -target target -gui true\false
Après l'exécution de l'outil, le répertoire de destination contient les sources de l'extension générée ainsi que quelques autres fichiers. Si une extension client a été demandée (options client ou both), il y a un fichier JNLP, un fichier keystore.jks (pour la signature de votre extension client) et un fichier featureslist.properties. Si une extension serveur a été demandée (options server ou both), il y a un fichier JSP (interface de configuration de l'extension serveur). Un script Ant (build.xml) est aussi créé dans le répertoire. Ce script peut être utilisé pour compiler l'extension et générer les archives JAR pour le client et le serveur.
L'image suivante montre la structure des fichiers générés.
La structure des fichiers générés par le générateur d'extensions
Pour exécuter le script Ant, il suffit de lancer la commande ant à partir du répertoire de destination. Après l'exécution, le répertoire dist contient tous les fichiers à déployer sur JMap Server. L'image suivante montre la structure des fichiers générés.
La structures des fichiers générés par l'exécution du script Ant de l'extension