Exemples d'adaptateurs personnalisés pour référentiels fédérés

Les adaptateurs prêts à l'emploi pour référentiels fédérés vous permettent de disposer d'adaptateurs de fichier, de LDAP et de base de données. Ces adaptateurs implémentent l'interface SPI (software programming interface) com.ibm.wsspi.wim.Repository. Un adaptateur personnalisé de gestionnaire de membres virtuel doit implémenter la même interface SPI quel que soit les types de référentiels avec lesquels l'adaptateur interagit. Il n'existe aucune restriction quant au type de référentiels avec lesquels l'adaptateur personnalisé peut interagir.

Développement d'adaptateurs personnalisés pour référentiels fédérés

Les adaptateurs prêts à l'emploi pour référentiels fédérés vous permettent de disposer d'adaptateurs de fichier, de LDAP et de base de données. Tous ces adaptateurs implémentent l'interface SPI (software programming interface) com.ibm.wsspi.wim.Repository. Reportez-vous à l'interface SPI com.ibm.wsspi.wim.Repository pour plus d'informations. Lorsque vous développez un adaptateur personnalisé de gestionnaire de membres virtuel, vous devez implémenter la même interface SPI.

Les adaptateurs personnalisés pour référentiels fédérés ne doivent dépendre d'aucun composant WebSphere Application Server tel que source de données ou bean enterprise. Ces composants WebSphere Application Server exigent que la sécurité soit initialisée et activée avant leur démarrage. Si votre implémentation d'adaptateurs personnalisés pour référentiels fédérés doit recourir à des sources de données pour se connecter à une base de données, utilisez la connectivité JDBC (Java™ database connectivity) pour établir la connexion lors du démarrage du serveur. Vous vous redirigerez ensuite sur les sources de données une fois celles-ci disponibles.

Voici quelques suggestions de comportements et exigences propres aux adaptateurs personnalisés pour référentiels fédérés que vous pouvez trouver dans le code exemple.

Exemple d'adaptateur personnalisé pour référentiels fédérés

Un exemple d'implémentation d'adaptateur personnalisé a été mis à disposition à titre de démonstration. Cet adaptateur est basé sur un référentiel de fichiers. Les exemples de code source et de fichiers classe sont regroupés dans le fichier vmmsampleadapter.jar.

Contenu du fichier vmmsampleadapter.jar :
  • Fichiers classe pour l'exemple d'adaptateur :
    • com/ibm/ws/wim/adapter/sample/AbstractAdapterImpl.class
    • com/ibm/ws/wim/adapter/sample/SampleFileAdapter.class
    • com/ibm/ws/wim/adapter/sample/XPathHelper.class
  • Code source pour l'exemple d'adaptateur :
    • src/com/ibm/ws/wim/adapter/sample/AbstractAdapterImpl.java
    • src/com/ibm/ws/wim/adapter/sample/SampleFileAdapter.java
    • src/com/ibm/ws/wim/adapter/sample/XPathHelper.java
Remarque : Les exemples de fichiers ne doivent pas être utilisés dans un environnement de production. Il conviendra de faire une copie de ces fichiers, de les renommer et de les mettre à jour sur la base de votre implémentation d'adaptateur spécifique. Pour plus d'informations, reportez-vous à la documentation Java dans le code source.
com/ibm/ws/wim/sample/adapter/AbstractAdapterImpl.java
Met à disposition une classe d'implémentation abstraite qui gère la plupart des opérations internes indépendantes du référentiel pour l'adaptateur et qui définit quelques méthodes abstraites simples devant être implémentées par l'adaptateur personnalisé. Dans la majorité des cas, il pourra vous être nécessaire de modifier ce fichier.
com/ibm/ws/wim/sample/adapter/SampleFileAdapter.java
Etend la classe AbstractAdapterImpl et implémente les méthodes abstraites. Cette classe met en oeuvre les méthodes abstraites en utilisant le fichier en tant que référentiel. Les fournisseurs d'adaptateurs peuvent utiliser cette classe comme référence pour implémenter les méthodes spécifiques à leurs adaptateurs.
com/ibm/ws/wim/sample/adapter/XPathHelper.java
Définit une classe auxiliaire pour analyser l'expression de recherche XPath et générer l'arbre de recherche. Cette classe comporte également la méthode d'évaluation de l'expression de recherche. Si votre référentiel peut traiter une expression de recherche, vous devez convertir l'expression XPath en une expression prise en charge par votre référentiel puis laisser celui-ci évaluer l'expression. Cette classe auxiliaire évalue l'expression de recherche en fonction de l'utilisation des objets données (dataobjects). Vous pouvez remplacer la méthode evaluate() par écrasement de façon à effectuer l'évaluation avec d'autres objets tels que java.util.Map.

Un certain nombre de classes utilitaires ont été jointes pour venir en aide aux fournisseurs d'adaptateurs. La plupart de ces méthodes utilitaires sont utilisées dans l'exemple d'adaptateur. Consultez la documentation Javadoc pour plus de détails.


Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwim_dev_vmmca
Nom du fichier : rwim_dev_vmmca.html