Configuration d'un ESB avec TalendESB

1. TP 3: Mise en Place d’un ESB
avec Talend ESB
Cours eServices - GL5
GL5 - 2015-2016
TP 3 ESERVICES MME. LILIA SFAXI 1
Objectifs du TP
Création de services web avec l’outil Talend Open Studio for ESB, et configuration des
routes dans Talend ESB

2. I. Les outils Talend pour ESB
1. Talend ESB
Talend ESB est une solution légère, robuste et modulaire pour la création de services
web sécurisés ainsi que pour l’intégration d’applications nouvelles ou existantes.
Talend participe au développement des composants ESB à travers la communauté
Apache. Il collabore avec un grand nombre de développeurs de la communauté Apache
et a fait plusieurs contributions aux projets Apache.
Talend fournit:
• Un courtier de messages à haute performance.
• Des options de déploiement flexibles
• Des outils de développement pour Eclipse
• Une interface utilisateur pour l’intégration et la médiation d’applications
• Support pour les services web SOAP et REST
• La médiation et le routage
• Support pour le failover, le monitoring et la sécurité
L’environnement d’exécution standard de Talend ESB est un conteneur OSGi.
L’implémentation OSGi fournie avec Talend ESB est Apache Karaf, avec Eclipse Equinox
comme environnement d’exécution OSGi. Elle fournit un conteneur léger dans lequel les
différents composants et applications peuvent être déployées.
2. Talend Open Studio for ESB
Talend Open Studio for ESB (TOS-ESB) fournit une interface graphique de
développement pour implémenter, compiler, tester et publier des services Web Java, des
applications REST, des services de données et des routes de messages.
Le déploiement d’applications avec TOS-ESB utilise principalement les trois blocs
représentés dans cette figure:
TP 3 ESERVICES MME. LILIA SFAXI 2

3. • Le bloc bleu représente l’API Talend Studio, où il est possible d’intégrer des
données, des services ou des applications
• Les blocs rouges représentent un ou plusieurs environnements d’exécution Talend
déployés dans votre système d’information. Il vous permet de déployer et
d’exécuter les Jobs, les routes et les services créés dans Talend Studio. Il est
possible d’avoir plusieurs environnements d’exécution, entre lesquels vous pouvez
basculer grâce à Talend Service Locator.
• Le bloc orange est une base de données de monitoring, permettant de stocker les
informations d’exécution des processus et de l’activité des services.
L’interface utilisateur de TOS-ESB se présente comme suit:
Le traditionnel Reposoitory contenant vos Jobs, services,
fichiers, routes…
La fenêtre principale, représentant graphiquement la
composition de vos jobs et routes
Fenêtre contenant les propriétés, la console d’exécution…
La palette des composants à utiliser
Onglets pour le choix de la perspective à utiliser
!
1
!
4
!
2
!
5
!
3
TP 3 ESERVICES MME. LILIA SFAXI 3
1
2
4
3
5

4. Dans TOS-ESB, nous avons principalement deux perspectives:
• Intégration: pour la création de Jobs, services…
• Médiation: pour la définition des routes.
3. Documents fournis
Pour les besoins de notre TP, nous vous fournissons :
• le bundle TOS_ESB-V6.0.1.zip : une archive complète contenant à la fois
l’environnement d’exécution Talend ESB (dans le sous-répertoire Runtime ESBSE)
ainsi que les outils Talend Open Studio for ESB (dans le sous-répertoire Studio)
fourni pour plusieurs systèmes d’exploitation et distributions.
• TalendOpenStudio_ESB_GettingStarted_6.0.1_EN.pdf : Une documentation détaillée
pour utiliser les outils Talend ESB (à partir de laquelle nous nous sommes inspirés
pour réaliser ce TP).
II. Création de services web SOAP
Nous ne pouvons pas configurer un ESB avant de savoir créer, déployer et exécuter des
services web avec les outils Talend ESB. Nous allons donc commencer avec le
traditionnel Hello World. Pour cela, il faut commencer par créer un projet de votre choix.
Dans toute cette partie, nous nous trouverons dans la perspective Integration.
1. Création et exécution du service SOAP HelloWorld
Pour créer un nouveau service de type SOAP:
• Clic-droit sur Services de votre Repository, et choisir Create Service. Appeler le
service HelloWorldService. Cliquer sur Suivant.
• On vous propose soit de créer un nouveau WSDL, soit de choisir un WSDL existant.
Dans notre cas, nous créons un nouveau WSDL. Cliquer sur Terminer.
• Un service simple qui reçoit une chaîne de caractères et en produit une autre est
créé. Une vue graphique de son WSDL s’affiche.
TP 3 ESERVICES MME. LILIA SFAXI 4
Cette vue est
obtenue en passant
la souris sur cette
flèche
Vous trouverez ici
l’adresse du
service créé

5. Pour pouvoir tester votre service, il faut créer un Job. Mais d’abord:
• Importer le WSDL de votre service dans votre repository. Pour cela, clic droit sur
HelloWorldService, et choisir Importer les schémas WSDL. Vous retrouverez votre
WSDL dans la partie Metadonnées -> Fichier XML.
• Créer un nouveau Job pour votre service. Pour cela, clic-droit sur l’opération
HelloWorldServiceOperation et choisir Assign Job.
• Modifier votre Job pour qu’il ait l’allure suivante (Le tLogRow nous permettra
d’afficher le résultat du service exécuté sur la console avant de l’envoyer au
consommateur):
• Configurer votre tXMLMap pour que le in de la requête soit transmise au out de la
réponse, en lui concaténant le célèbre “Hello”. Pour cela:
• Double clic sur votre XML Map.
• Clic-droit sur payload de l’entrée, et cliquer sur Import from Repository
• Choisir HelloWorldServiceOperationRequest correspondant au fichier WSDL que
vous avez généré.
• Refaire les mêmes étapes pour le payload de la sortie, en choisissant
HelloWorldServiceOperationResponse.
• Relier le in de la requête avec le out de la réponse
• Modifier l’expression du out en ajoutant la chaîne “Hello “ avant la valeur in de
l’entrée. (créer l’entrée comme sous-élément de la réponse)
• Sauvegarder et quitter.
• Lancer votre Job (cela permettra de publier votre service web sur le port 8090).
Vérifier que votre fichier WSDL existe bien.
2. Création du consommateur du service
Nous allons maintenant créer un consommateur pour notre service. Pour cela:
• Créer un nouveau Job, que vous appellerez HelloWorldServiceConsumer.
• Concevez votre job de manière à ce qu’il ait l’allure suivante:
TP 3 ESERVICES MME. LILIA SFAXI 5

6. Voici le rôle des éléments que vous avez ajouté:
• tFixedFlowInput : définir les entrées à envoyer à votre service
• tXMLMap : associer les entrées définies aux entrées du service
• tESBConsumer : consommateur du service
• tLogRow: afficher les réponses et/ou les fautes (s’il y’en a)
• Configurer votre composant tFixedFlowInput de manière à ce que son schéma
contienne une seule colonne de type chaîne de caractères appelée Nom, et ajouter
comme noms à entrer: “Alice”, “Bob” et “Chuck”.
• Configurer votre tESBConsumer en lui donnant comme WSDL celui du service que
vous avez créé. Vérifiez bien que le Endpoint soit sur le port 8090.
• Configurer votre tXMLMap pour que la variable Nom soit associée au in de votre
service.
• Exécuter le Job, et observez le résultat.
III. Configuration et utilisation de l’ESB Talend
1. Lancement de deux instances de l’ESB Talend
Pour les besoins de notre TP, nous allons lancer deux instances de l’ESB Talend. Pour
cela, l’environnement nous fournit une manière très simple de le faire:
• Aller dans le répertoire <rep_install_talend>/Runtime_ESBSE
• Copier le répertoire container et le renommer en alternate-container.
• Nous allons maintenant configurer la deuxième instance de l’ESB (dans alternate-
container) pour qu’elle se lance sur un port différent de la première. Pour cela:
• Lancer l’ESB : dans le répertoire alternate-container que vous venez de créer, aller
vers bin et exécuter trun.bash (sur windows). Si vous êtes sur Linux ou mac,
TP 3 ESERVICES MME. LILIA SFAXI 6

7. placez-vous sous le répertoire alternate-container/bin et lancer dans un terminer
la commande ./trun. La fenêtre suivante devrait s’afficher:
• Configurer l’ESB: dans l’invite de commande affichée, taper:
source scripts/configureC1.sh
• Un affichage semblable au suivant va s’afficher :
TP 3 ESERVICES MME. LILIA SFAXI 7

8. Vous avez ainsi créé un ESB, que vous avez configuré pour se lancer sur le port
8041, alors que, par défaut, il devrait se lancer sur le port 8040. Si vous voulez
créer une troisième instance, vous pouvez la configurer en utilisant le fichier
configureC2.sh, de même pour une quatrième instance… Pour revenir à la
configuration par défaut, utiliser configureC0.sh.
• Arrêtez votre ESB, en cliquant sur ctrl-d, et relancez-le de nouveau.
• Lancez dans un autre terminal l’instance de l’ESB se trouvant sous le répertoire
d’origine container. Il est inutile de la configurer, elle se lancera par défaut sur le port
8040.
2. Publier votre service dans l’ESB et le tester
Pour publier votre service web sur l’ESB, il faut:
• Faire un clic-droit sur le service HelloWorldService et choisir Exporter le service
• Choisir comme répertoire de destination le dossier deploy se trouvant dans le
conteneur où vous désirez déployer le service. Un fichier archive de type kar sera
alors créé sous ce répertoire, permettant ainsi son déploiement à chaud (pas besoin
de redémarrer l’ESB).
• Déployer votre service sur les deux instances d’ESB que vous avez démarré.
• Vérifier que vos services sont actifs:
• en tapant list dans vos deux instances d’ESB
• en affichant les fichiers WSDL du service sur les ports 8040 et 8041 au lieu de
8090.
Pour tester votre service web:
• Dans le job consommateur de service, dans les propriétés du composant
tESBConsumer, modifier le port du endpoint de 8090 à 8040
• Lancer votre job. Vérifier que l’affichage se fait correctement sur la console du TOS-
ESB.
Vérifier que votre service s’exécute bien sur l’ESB principal, en consultant le terminal où il
est démarré. Vous devriez trouver un affichage semblable à celui-ci:
TP 3 ESERVICES MME. LILIA SFAXI 8

9. IV. Création de Routes
Les routes permettent de définir le comportement que doit prendre le message selon son
contenu. Dans notre exemple, nous allons définir deux types de routes: une route
permettant de filtrer les messages par contenu, en envoyant les messages contenant le
nom “Alice” vers un ESB, et le reste vers l’autre ESB. Une deuxième route permettra de
modifier le contenu de certains messages avant de les faire parvenir à leurs
destinataires.
Dans cette partie, nous devons changer de perspective, pour utiliser la perspective
Mediation.
1. Première Route : Filtrage des Messages
• Créer une nouvelle route en cliquant-droit sur Routes -> Créer une Route. Nous
allons l’appeler FiltrageRoute.
• Définir votre route de manière à ce qu’elle ressemble à ce qui suit:
• Les composants utilisés sont:
• cCXF : fournit l'intégration avec Apache CXF pour la connexion aux services JAX-
WS.
• MessageRouter : route des messages dans différents canaux selon des conditions
spécifiées.
• Configurer la condition when, en précisant que c’est une condition de type simple,
dont le texte est :
"${bodyAs(String)} contains 'Alice'"
TP 3 ESERVICES MME. LILIA SFAXI 9

10. Cela veut dire que, si le corps du message contient Alice, la requête sera routée vers
le composant cCXF_2.
• Configurer le composant cCXF_1:
• Adresse: http://localhost:8042/services/HelloWorldService Remarquez que le port
ici est 8042, car le nouveau service sera diffusé sur ce port.
• WSDL: http://localhost:8040/services/HelloWorldService?WSDL. On utilise ici le
WSDL du service initial.
• Configurer l’adresse de cCXF_2 sur le port 8040, et celle de cCXF_3 sur le port
8041, tout en gardant le même WSDL pour les trois composants.
• Lancer la route pour la tester. La console devra afficher connected.
Pour utiliser cette route, vous devez reconfigurer votre consommateur pour qu’il lance sa
requête sur le port 8042. Exécutez-le et observez le résultat sur les terminaux des deux
instances d’ESB démarrées. Que constatez-vous?
2. Déploiement des Routes sur l’ESB
Dans leur état actuel, vos routes doivent être lancées manuellement pour être prises en
considération. Pour les déployer sur votre ESB et les garder ainsi toujours actives, suivre
les étapes suivantes:
• Faites un clic-droit sur votre route et sélectionner: Build Route
• Choisir le répertoire deploy du conteneur de votre choix.
• Tester votre route en exécutant à nouveau le consommateur (veillez à ce que le job
FiltrageRoute soit bien arrêté).
3. Deuxième Route : Filtrage et Modification de
Messages
Dans cette nouvelle partie, nous allons modifier le corps du message après l’avoir filtré.
Pour cela:
• Dupliquer votre route FiltrageRoute et la nommer ModificationRoute
• Insérer un composant cSetBody (permettant de modifier le corps du message reçu)
puis un composant cProcessor (permettant de remanier rapidement du code dans
la route) entre le cMessageRouter et le cCXF_3. Le but ici est de modifier le corps
des messages reçus, selon leur contenu.
• Insérer le code suivant (de type Xpath) dans le cSetBody:
"tns:HelloWorldServiceOperationRequest/in"
Ceci permet de saisir le contenu de la balise in de la requête SOAP envoyée par le
consommateur. Il ne faut pas oublier de définir le Namespace tns (http://www.talend.org/
service/)
TP 3 ESERVICES MME. LILIA SFAXI 10

11. • Insérer le code suivant dans le processeur:
String name = exchange.getIn().getBody(String.class);
String surname;
if (name.contains("Bob")){
surname = "Bobby";
}else{
surname = "Chucky";
}
exchange.getIn().setBody(
“<tns:HelloWorldServiceOperationRequest xmlns:tns=
"http://www.talend.org/service/"><in>"+surname+"</in>< /
tns:HelloWorldServiceOperationRequest>");
Ce code permet de modifier le corps du message entrant en remplaçant le nom par un
surnom.
• Sauvegarder et exporter votre route dans l’ESB. Lancer le consommateur de
nouveau et observez le résultat.
V. Homework
En utilisant Talend ESB, créer un service web de votre choix, en utilisant plusieurs routes
(modification du Header, du Body, gestion des versions, routage simple….)
TP 3 ESERVICES MME. LILIA SFAXI 11