Migration d'un service JMS

Vous pouvez migrer un service JMS dans une importation SCA avec liaison JMS.

Remarque : Si le message JMS est envoyé à un adaptateur WebSphere Business Integration, voir "Migration des interactions avec les adaptateurs WebSphere Business Integration".

Pour migrer un projet de service JMS sortant, procédez comme suit :

  1. Vous devrez d'abord importer le projet de service à l'aide de l'Assistant de migration. Cela va créer un module Business Integration contenant les messages WSDL, les types de port, les connexions et les services créés dans WebSphere Studio Application Developer Integration Edition.
  2. Dans Business Integration, développez le module pour voir son contenu. Pour ouvrir Assembly Editor, double-cliquez sur le premier élément sous le projet de module (même nom que le projet).
  3. Ensuite, ajoutez une importation qui permettra à l'application d'interagir avec une file d'attente JMS en fonction du modèle de programmation SCA.
  4. Dans Assembly Editor, développez le projet de module migré et développez la catégorie Interfaces puis recherchez le type de port WSDL qui décrit le service Web que l'application doit appeler. Faites-le glisser dans l'éditeur d'assemblage.
  5. Une boîte de dialogue Création de composant vous invite à sélectionner le type de composant à créer. Choisissez Importation sans liaison.
  6. Une nouvelle importation est créée dans Assembly Editor. Sélectionnez-la puis ouvrez la vue Propriétés. Dans l'onglet Description, vous pouvez remplacer le nom et le nom d'affichage de l'importation par un nom plus descriptif.
  7. Vous pouvez vous reporter aux fichiers de service et de liaison WSDL 5.1 pour plus de détails sur le service JMS en cours de migration. Ces fichiers peuvent être utilisés pour consigner des informations détaillées sur l'importation avec liaison JMS de la version 6.0. Recherchez-les dans le projet de service 5.1 (ils sont habituellement appelés *JMSBinding.wsdl et *JMSService.wsdl). Prenez connaissance des informations de liaison et de service qui s'y trouvent. Les informations sur la liaison permettent de déterminer si des messages de texte, des messages d'objet ou des liaisons de formats de données personnalisées ont été utilisées. Si tel est le cas, pensez également à créer une liaison de données personnalisée pour l'importation avec liaison JMS de la version 6.0. Les informations sur le service indiquent la fabrique de contextes initiale, le nom de la fabrique de connexions JNDI, le nom de destination JNDI et le style de destination (file d'attente).
  8. Avec le bouton droit, cliquez sur l'importation et sélectionnez Générer la connexion puis Connexion JMS. Vous serez invité à entrer les paramètres suivants :
    Sélectionnez le domaine de messagerie JMS :
    • Point à point
    • Publier/Abonner
    • Indépendant du domaine
    Sélectionnez la façon dont les données sont sérialisées entre l'objet métier et le message JMS :
    • Texte
    • Objet
    • Fourni par l'utilisateur
    Si vous sélectionnez Fourni par l'utilisateur :
    Indiquez le nom qualifié complet de la classe d'implémentation com.ibm.websphere.sca.jms.data.JMSDataBinding. Vous devez indiquer une liaison de données définie par l'utilisateur si l'application doit définir des propriétés d'en-tête JMS qui ne sont habituellement pas disponibles dans la liaison d'importation JMS. Dans ce cas, vous pouvez créer une classe de liaison de données personnalisée étendant la liaison de données JMS standard "com.ibm.websphere.sca.jms.data.JMSDataBinding", et ajouter un code personnalisé permettant d'accéder directement à JMSMessage. Pour consulter les exemples JMS se trouvant dans "Creating and modifying bindings for import and export components", cliquez sur le lien ci-dessous.
    La connectivité en entrée utilise la classe de sélecteur de fonction JMS par défaut :
    <selected> ou <deselected>
  9. Sélectionnez l'importation que vous venez de créer. Dans la vue Propriétés, sélectionnez l'onglet Connexion. Vous pouvez indiquer manuellement toutes les données de connexion en utilisant les valeurs que vous avez déjà indiquées dans WebSphere Studio Application Developer Integration Edition. Les données de connexion que vous pouvez indiquer sont les suivantes :
    • Connexion d'importation JMS (le plus important)
    • Connexion
    • Adaptateur de ressource
    • Destinations JMS
    • Connexion de méthode
Quand vous avez terminé, vous devez reconnecter le service :
  • Si ce service est appelé par un processus métier dans le même module, créez une connexion entre la référence de processus métier appropriée et cette importation.
  • Si ce service est appelé par un processus métier situé dans un autre module, créez une exportation avec liaison SCA et à partir de l'autre module, effectuez un glisser-déposer de cette exportation vers l'éditeur d'assemblage de ce module pour créer l'importation avec liaison SCA correspondante. Connectez la référence de processus métier appropriée à cette importation.
  • Enregistrez le diagramme de l'assemblage.
Tâches associées
Migration des interactions avec les adaptateurs WebSphere Business Integration
Creating and modifying bindings for import and export components

Commentaires
(C) Copyright IBM Corporation 2005. Tous droits réservés.