Talend 6.4.0 Milestone 2

 

Talend nous fait la belle surprise dans la deuxième pre-release 6.4.0 de son Talend Open Studio d’introduire Swagger.
Swagger est l’outil de référence pour documenter les services Rest.
Swagger est avant tout orienté Design-First, à savoir que le design de l’application précède son développement. Le développeur décrit ses Web Services Rest dans l’interface Web de Swagger. Ensuite il lui est possible de générer des squelettes de code (dans différents languages) et de commencer le développement.
Dernièrement Swagger a introduit la possibilité de générer la documentation depuis le code source. On parle alors d’approche Code-First.
CXF est le framework utilisé par Talend pour sa couche Web Service.
Et CXF permet l’intégration de Swagger dans cette approche. Voir http://cxf.apache.org/docs/swagger2feature.html

 

Exemple

 

Voici un exemple qui montre cette fonctionnalité
Il vous faudra télécharger Talend Open Studio for ESB pour le mettre en pratique

 

Job Talend

Voici un nouveau Job de type Web Service REST qui répond en GET à une URL et qui renvoie une réponse en format JSON

 

Talend et Swagger
Le composant tRESTRequest est défini comme ceci :

 

Talend et Swagger
Le schéma de la sortie nommée ping contient un champ id de type String.

Dans l’Advanced Settings on retrouve cette possibilité d’exposer Swagger :

 

 

 

Le tXMLMap construit une sortie de type Document

 

Talend et swagger - 3

 

Le tRESTResponse est classique hormis le paramètre nécessaire Drop JSON

 

talend et swagger - 4

 

Démarrer le Job et vous obtiendrez l’URL de connexion

 

talend et swagger - 5

 

http://127.0.0.1:8090/test

 

Pour tester le service ouvrez l’url suivante

 

http://127.0.0.1:8090/test/ping/abc

 

Cela vous donnera

 

 

code-1

Swagger UI

 

Pour l’accès à l’interface Swagger il suffit de complèter l’URL de base par /swagger.json :

 

http://127.0.0.1:8090/test/swagger.json

 

pasted-1

 


Ou également en format YAML :

 

http://127.0.0.1:8090/test/swagger.yaml

 

 

pasted-2

 

Pour visualiser ceci dans Swagger UI sur une station de développement, un moyen simple est via l’extension Chrome “Swagger UI Console” :

https://chrome.google.com/webstore/detail/swagger-ui-console/ljlmonadebogfjabhkppkoohjkjclfai
Vous devrez entrer la référence au swagger.json que Talend construit :

 

image05

image06

 

Conclusion

 

C’est un module en cours de développement. Talend devra, par exemple, donner à l’utilisateur la possibilité de modifier ce qui est ici codé en dur comme la description, l’utilisateur, la licence etc…

En Talend 6.2.0 (version sous souscription) il est possible de construire non plus des archives Karaf mais des microservices Spring Boot

Il est à espérer que Talend continue à investir dans l’optique de fournir une plateforme orientée Microservices solide.

Article créé par:

30_meditation_practice_512

Vincent

Team Manager Data Intelligence

Parlez-nous de vos défis et de vos ambitions.

Et voyons ensemble comment nous pouvons vous aider à les concrétiser.

Contactez un de nos ingénieurs