Création d'un système de plugins en javaDate de publication : 15/02/2006 , Date de mise à jour : 15/02/2006
Par
Lainé Vincent (autres articles) Dans cet article nous arborderons la mise en oeuvre d'un système de plugins en java. I. Introduction II. Conception du système II-A. Problématique II-B. Les différentes classes et interface(s) III. Programmation du système III-A. Le code fonctionnel III-B. Le(s) interface(s) III-C. Création d'une archive java pour les interfaces de définition de plugins IV. Programmation d'un plugins V. Remerciements VI. Bibliographie et téléchargement I. Introduction
Dans les applications d'aujourd'hui nous voyons souvent la possibilité d'ajouter des fonctionnalités par l'intermédiaire de plugins. Ces fameux plugins sont en effet une façon très simple, tant au niveau de la programmation que du déploiement, d'ajouter des fonctionnalités à une application tournant déja et cela sans recompilation et/ou redéploiement de l'application cible Nous verrons dans cet article comment ajouter à vos applications cette possibilité à la fois au niveau de la conception de l'application que au niveau de la programmation. Enfin nous verrons rapidement les aspects "sécurité" de la gestion des plugins.
II. Conception du systèmeII-A. Problématique
Avant de se lancer dans la programmation proprement dite, arrêtons-nous un moment et réfléchissons un peu à comment notre système de plugins va fonctionner. En effet, il faut commencer par déterminer quels sont les services que nous allons offrir aux plugins, quels seront les droits sur les données que les plugins auront, comment les plugins seront intégrés à notre application, etc ... Une fois ces questions résolues, il faut se poser la question de la sécurité. Pourquoi ? Tout simplement par ce que vous ne contrôlerez pas le code des plugins et que par conséquent, ils sont un danger potentiel pour votre application et ses données. C'est pourquoi il faut définir une politique stricte d'accès aux données et s'y tenir. Par exemple vous pouvez choisir de passer les données par copie plutôt que par référence afin de garantir que tout changement effectué par le plugins n'ai pas de répercursion sur le reste de l'application. Mais dès lors si la modification des données par le plugins est systématiquement annulé à quoi sert-il ? C'est le genre de questions types auxquelles il vous faudra répondre avant de commencer à penser à coder. II-B. Les différentes classes et interface(s)
Afin de mettre en oeuvre notre système de plugins nous allons devoir coder un certain nombre de classe et d'interface(s). Dans cet exemple nous allons donc créer : - Une classe qui va s'occuper de charger les .jar en mémoire, de déterminer quelle(s) interface(s) de notre système sont implémentées et de créer les objets correspondants. - Au moins une interface qui va permettre de définir les actions que les plugins devront implémenter. Et c'est tout au niveau même du système de plugins. III. Programmation du système
Dans cette partie nous allons voir le code qui permet de charger les plugins en mémoire et d'en obtenir des objets. Nous verrons ensuite une interface de base pour plugins, mais gardez à l'esprit que ce n'est qu'un exemple qui est loin d'être complet. III-A. Le code fonctionnel
Attaquons-nous maintenant au code proprement dit de notre système de plugins.
Voyons d'abord le code puis les explications liées à ce code.
Voyons les lignes intéressantes ensemble :
- La création de l'URLClassLoader :
Pourquoi créer un URLClassLoader ? Tout simplement pour que le loader de java puisse localiser les classes contenues dans le jar.
En effet le jar ne figurant (normalement) pas dans le CLASSPATH, il faut créer un nouveau ClassLoader qui possède le chemin du jar dans son CLASSPATH.
La méthode la plus simple consiste donc à créer un nouveau loader par le biais de URLClassLoader.
- Le chargement de la classe dans le système :
Vous remarquerez ici que nous déterminons le nom de la classe grâce au convention de nommage java.
En effet nous partons du chemin au niveau du jar et nous remplaçons les '/' par des '.' ce qui est réellement la définition des paquetages en java.
De plus le nom du fichier est celui utilisé pour le nom de la classe, ce qui est là aussi un impératif de java (pour les public au moins). - La création d'un objet à partir d'une instance de la classes Class :
Ce code permet de créer une instance d'un objet à partir d'un objet de type Class qui contient la définition de la classe que l'on veux instancier. En effet la méthode newInstance() de Class appelle un contructeur sans argument afin de créer une instance de la classe. Cela nous donne donc une contrainte en plus : avoir un constructeur sans argument. Cette restriction est contournable en récupérant la collection de constructeur de la classe grâce à la méthode public Constructor[] getDeclaredConstructors(). Une fois cette collection de contructeurs récupérée vous pouvez appeller la méthode newInstance(Object[] params) de la classe Contructor afin de créer une instance de cette classe. Voila nous en avons fini avec le code fonctionnel du système de plugins. Comme vous avez l'avez vu, la gestion basique des plugins n'est pas très compliquée. III-B. Le(s) interface(s)
Dans cette partie nous allons rapidement voir les interfaces utilisées dans le projet exemple.
Cette interface est l'interface de base pour tous les plugins de l'application.
Elle fournit les services d'enregistrement du plugins auprès du menu principal de l'application grâce à la récupération du libellé et de la catégorie.
Cette interface comme IntPlugins permet seulement de faire des tests. Il n'y a rien de particulier à remarquer si ce n'est l'extends PluginsBase Pour conclure sur les interfaces, je rappellerais seulement que ce ne sont là que des exemples simplistes qui n'ont rien à voir avec de vraies interfaces de vrais plugins. III-C. Création d'une archive java pour les interfaces de définition de plugins
Pourquoi créer une archive java contenant les interfaces des plugins ? Tout simplement pour la pratique.
En effet, lors du développement d'un plugins, il est plus pratique de travailler avec une archive réduite qu'avec toute l'application. Dès lors la question de "Que dois-je mettre dans le jar ? " peut devenir un vrai casse-tête à cause des dépendances. Une chose quand même qui est valable tout le temps : il faut séparer l'interface du corps du programme. Voyons rapidement comment créer un jar avec nos interfaces du programme d'exemple :
Cette ligne de commande vous donne un jar contenant la totalité du dossier plugins, c'est à dire les interfaces et la classe de chargement IV. Programmation d'un plugins
Dans cette partie nous verrons rapidement un exemple de programmation de plugins à partir des interfaces définies plus haut.
Comme vous le voyez, il n'y a rien de plus simple que la création d'un plugins grâce à nos interfaces.
V. RemerciementsVI. Bibliographie et téléchargement
L'article au format pdf ( mirroir http ) Les sources du projet eclipse Les sources du plugins exemple |
Copyright © 15/02/2006 Lainé Vincent. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.