Déploiement des extensions serveur

 

Pour être déployée dans JMap Server, les extensions serveur doivent respecter certaines règles. Si ces règles sont bien respectées, l'extension apparaît dans la section Extensions de JMap Admin.

1 - Regrouper les classes de l'extension dans une archive (JAR)

Toutes les classes de l'extension doivent être contenues dans un fichier d'archive unique de type JAR. Utiliser un nom de fichier significatif et unique.

 

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 qui implémente l'interface JMapServerExtension.

extension_request

Identifie la classe utilisée comme requête pour cette extension. C'est cette entrée qui permettra d'acheminer les requêtes jusqu'à votre extension. Si votre extension supporte plusieurs classes de requêtes, elles doivent toutes dériver de cette classe.

extension_response

Identifie la classe utilisée comme réponse pour cette extension. Si votre extension supporte plusieurs classes de réponses, elles doivent toutes dériver de cette classe.

extension_name

Spécifie le nom de l'extension. Ce nom apparaît dans JMap Admin dans la section Extensions.

extension_version

Spécifie le numéro de version de l'extension. Cette information apparaît dans JMap Admin dans la section Extensions. 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.tracking.server.TrackingExtension

extension_name: Tracking

extension_request: jmap.extensions.tracking.common.TrackingRequest

extension_response: jmap.extensions.tracking.common.TrackingResponse

extension_version: 5.0.0010

 

 

3 - Placer le fichier dans le bon répertoire

Le fichier JAR de l'extension doit être placé dans le répertoire des extensions serveur (JMAP_HOME/extensions).

 

4 - (Facultatif) Placer les fichiers de l'interface de configuration de l'extension dans le bon répertoire

Les fichiers qui composent l'interface de configuration (pages JSP) doivent être copiés dans le répertoire réservé à cette fin (JMAP_HOME/jmapadmin/extensions).