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 :
- 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.
- 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).
- Ensuite, ajoutez une importation qui permettra à l'application
d'interagir
avec une file d'attente JMS en fonction du modèle de programmation
SCA.
- 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.
- Une boîte de dialogue Création de composant
vous invite à sélectionner le type de composant à créer. Choisissez
Importation sans liaison.
- 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.
- 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).
- 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>
- 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.