Déploiement des extensions de JMap Pro
Pour être déployée à l'intérieur des applications JMap Pro, les extensions client doivent respecter certaines règles. Si ces règles sont bien respectées, l'extension apparaît dans la section de déploiement de JMap Admin.
1 - Regrouper les classes de l'extension dans une archive (JAR)
Toutes les classes et ressources (images, etc.) de l'extension doivent être contenues dans un fichier d'archive unique de type JAR. Utiliser un nom de fichier significatif et unique car ce même nom devra être utilisé aux étapes suivantes.
2 - Inclure un fichier manifest
L'archive de l'extension doit inclure un fichier manifest.mf avec les entrées suivantes:
Variable |
Description |
extension_class |
Identifie la classe principale de l'extension. Il s'agit de la classe dérivée de la classe abstraite JMapClientExtension. |
extension_name |
Spécifie le nom de l'extension. Ce nom apparaît entre autres dans JMap Admin lors du déploiement des applications. |
extension_version |
Spécifie le numéro de version de l'extension. Cette information apparaît dans JMap Admin lors du déploiement des applications. Le numéro de version est utilisé seulement pour faciliter la gestion des extensions. |
Voici un exemple de de contenu d'un fichier manifest:
extension_class: jmap.extensions.edition.EditionExtension extension_name: Edition extension_version: 1.0.0049 |
3 - Fournir un fichier JNLP
Le fichier JNLP est obligatoire. Il décrit la librairie déployée. Le fichier doit porter le même nom que le fichier JAR de l'extension (sauf pour l'extension .jnlp). L'exemple qui suit montre en caractères gras les parties qui doivent être modifiées.
<?xml version="1.0" encoding="utf-8"?> <!-- JNLP File for Extension libraries --> <jnlp spec="1.0+" codebase="http://$JMAPSERVER_HOST$:$JMAPSERVER_WEBPORT$$PATH$/edition_client" href="edition_client.jnlp"> <information> <title>Edition Extension</title> <vendor>K2 Geospatial</vendor> <description>Edition Extension</description> <description kind="short">Edition Extension</description> </information> <security> <all-permissions/> </security> <resources> <jar href="edition_client.jar"/> </resources> <component-desc/> </jnlp>
|
4 - Placer les fichiers dans le bon répertoire
Tous les fichiers qui composent l'extension (fichier JAR, fichier JNLP, autres fichiers) doivent être placés dans un répertoire spécialement créé pour l'extension, à l'intérieur du répertoire destiné aux extensions client (JMAP_HOME/extensions/client). Le nom du répertoire de l'extension doit obligatoirement être identique au nom du JAR de l'extension. L'image suivante montre l'organisation des fichiers et répertoires sur Windows pour l'extension Edition de K2 Geospatial.
