Création d'un gestionnaire de médiations

Vous pouvez créer un gestionnaire de médiations, lui ajouter une fonction et le préparer en vue de son installation sur un serveur d'applications.

Avant de commencer

Vous devez avoir accès à un environnement de programmation Java™ et à un outil d'assemblage (par exemple, IBM® Rational Application Developer).

Pourquoi et quand exécuter cette tâche

Un gestionnaire de médiations peut être déployé. Chaque gestionnaire de médiations exécute un traitement spécifique des messages lors de l'exécution (par exemple, la conversion d'un format de message ou l'acheminement d'un message à une destination particulière). Un gestionnaire de médiations est une structure de programme Java, à laquelle vous ajoutez le code qui effectue la fonction de médiation.

Vous pouvez définir une classe de gestionnaire de médiations dans un projet Java ou un projet EJB (requis pour l'artefact de déploiement). Vos artefacts de programmation et de déploiement peuvent se trouver dans des projets différents. Les étapes ci-après concernent un projet EJB, mais la procédure de création d'un projet Java est très similaire, car vous définissez simplement un serveur cible pour un projet Java ou un projet EJB et le plug-in d'exécution du serveur définit correctement le chemin d'accès aux classes.

Procédure

  1. Créez un projet EJB :
    1. Passez à la perspective Java EE pour utiliser les projets Java EE. Cliquez sur Fenêtre > Ouvrir la perspective > Autre >Java EE.
    2. Dans le menu Fichier, sélectionnez Nouveau > Projet.
    3. Développez le dossier Java EE, puis sélectionnez Projet d'application d'entreprise. Cliquez sur Suivant.
    4. Facultatif : Si vous avez créé un projet Java au lieu d'un projet EJB, cliquez sur l'icône du dossier du projet Java à l'aide du bouton droit de la souris pour afficher le menu contextuel et sélectionnez Propriétés. Lorsque le panneau Propriétés apparaît, sélectionnez Propriétés du serveur et choisissez un serveur approprié pour votre système, comme à l'étape ci-après.
    5. Entrez un nom pour le projet et choisissez un serveur approprié pour votre système. (Si c'est la première fois que vous sélectionnez ce serveur, vous devez cliquer sur le bouton Nouveau.) Cliquez sur Suivant pour accéder à la fenêtre Projets de module EAR.
    6. Cliquez sur Nouveau module....
    7. Créez un projet de module en cochant la case en regard du projet EJB et en entrant le nom de votre gestionnaire de médiations.
    8. Cliquez sur Terminer. La fenêtre Projets de module EAR s'affiche.
    9. Cliquez sur Terminer pour créer le projet.
  2. Créez une classe de gestionnaire de médiations en implémentant l'interface com.ibm.websphere.sib.mediation.handler.MediationHandler.
    1. Dans le menu Fichier, sélectionnez Nouveau > Classe Java.
    2. Spécifiez le dossier source du projet EAR de votre médiation.
    3. Spécifiez un nom pour votre gestionnaire de médiations.
    4. Sélectionnez la superclasse java.lang.Object.
    5. Sélectionnez l'interface com.ibm.websphere.sib.mediation.handler.MediationHandler.
    6. Cochez la case Hériter des valeurs par défaut.
    7. Cliquez sur Terminer pour créer la classe de gestionnaire de médiations.
  3. Ajoutez du code fonctionnel transformant ou routant des messages vers le gestionnaire de médiation avec IBM Rational Application Developer. Pour plus d'informations, voir Ajout d'une fonction de médiation au code du gestionnaire. La valeur renvoyée par défaut pour la méthode handle créée par les outils de développement est false ; par conséquent, le message est ignoré. Pour conserver le message, vous devez redéfinir la valeur renvoyée sur true.
  4. Générez un fichier EAR à partir de votre classe de gestionnaire de médiations. Suivez les instructions fournies dans la documentation IBM Rational Application Developer.

Que faire ensuite

Vous êtes maintenant prêt à installer le fichier EAR contenant votre gestionnaire de médiations sur le serveur d'applications.

Icône indiquant le type de rubrique Rubrique de tâche



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=tjy1700
Nom du fichier : tjy1700.html