L'actualité

Personnalisez et enrichissez les fonctionnalités d’Anypoint Studio avec les plugins Eclipse

MuleSoft Anypoint Platform est une plate-forme d’intégration de classe mondiale qui facilite l’intégration de diverses technologies sans avoir à écrire beaucoup de code. Cependant, les développeurs Java ont parfois leurs propres outils et plugins préférés, il convient donc de noter que vous pouvez personnaliser votre environnement de développement Anypoint Mule à l’aide de l’écosystème Eclipse IDE pour combiner harmonieusement chacun des deux mondes dans votre projet d’intégration.

Présentation

Dans cet article, je décrirai les étapes nécessaires pour créer votre propre environnement IDE Eclipse personnalisable avec le plugin Mule. Cela permettra plus de flexibilité et d’options avec vos plugins Eclipse préférés, en particulier si vous souhaitez utiliser vos archétypes Maven préférés dans vos projets quotidiens.

Qu’est-ce qu’Anypoint Studio ?

Les fonctionnalités d’Anypoint Studio améliorent votre productivité lors de la création d’applications Mule :

o Exécution instantanée de votre application Mule dans un environnement d’exécution local

o Éditeurs visuels pour configurer les fichiers de spécifications API et les domaines Mule

o Transférer les modifications vers une application locale en cours d’exécution pour tester les modifications

o Intégration avec Exchange pour créer des projets à partir de modèles et d’exemples, et importer des définitions et d’autres ressources depuis votre organisation Anypoint Platform

o Cadre de tests unitaires intégré

o Prise en charge intégrée pour le déploiement sur CloudHub

Anypoint Studio 7.x ne prend en charge que les projets Mule 4.x car la structure du projet, le format d’exportation, le XML et le langage de script sont différents. Il n’est pas possible d’intégrer les environnements d’exécution Mule 3.x ou des versions antérieures dans Anypoint Studio 7.x.

La plateforme Anypoint inclut une prise en charge prête à l’emploi des connecteurs cloud qui permettent aux flux d’interagir avec de nombreuses technologies cloud puissantes telles que Salesforce.com, Amazon S3, Dropbox, Twitter, Google Calendars et GitHub.

REMARQUE : Pour une liste complète des connecteurs, consultez la référence des connecteurs .

Configuration de votre ensemble d’outils Eclipse

Dans cette première section, nous allons personnaliser notre Eclipse avec les outils Eclipse détaillés suivants mais vérifions d’abord les prérequis…

Étape 1 : Vérification de vos prérequis

Pour installer Anypoint Studio, vous avez besoin d’au moins 8 Go de mémoire. Par expérience nous recommandons 16 Go de mémoire et 100 Go d’espace pour commencer, surtout lorsque vous aurez de nombreux organigrammes et projets au moment de votre quotidien de développeur MuleSoft.

Prévoyez une configuration machine matérielle musclée avec un processeur de type iCore i7 et 8 coeurs. Si vous utilisez des machines basées sur des processeurs Intel ou si vous êtes fan d’Apple, une machine de type MacBook Pro sera idéale si vous êtes également un développeur nomade.

Anypoint Studio est une interface utilisateur basée sur Eclipse qui vous permet de créer graphiquement des flux Mule et de les exécuter localement.

Pour rappel, si besoin, la plateforme Eclipse et l’IDE Eclipse sont un framework extensible qui permet d’ajouter des fonctionnalités supplémentaires, de supprimer ou de personnaliser des fonctionnalités existantes.

Il existe deux manières d’installer Anypoint Studio :

– Sous forme de bundle disponible sur le site officiel de MuleSoft : https://www.mulesoft.com/platform/studio . Ici, il vous suffit de décompresser et de suivre les étapes d’installation.

– En tant que plug-in Eclipse

Dans ce didacticiel, je me concentrerai sur l’installation en tant que plugin Eclipse, car il est plus personnalisable dans Eclipse et n’interrompt pas l’installation d’Anypoint Studio.

Étape 2 — Installation d’Anypoint Studio en tant que plug-in Eclipse

Dans notre présentation, nous utiliserons Eclipse IDE 2023-06 disponible sur le site Web officiel d’Eclipse https://www.eclipse.org/downloads/ .

Le package de bureau est disponible pour x86_64 (windows) et AArch64 (Mac). Dans mon cas, je choisirai le package Mac.

Après avoir lancé le programme d’installation d’Eclipse, choisissez l’installation Eclipse IDE for Java Developer qui est suffisante dans notre cas en tant que développeur MuleSoft :

Fig 1 — Option du programme d’installation d’Eclipse JEE

Sélectionnez la version Java (17 dans mon cas) et le dossier d’installation et cliquez sur installer.

Le processus d’installation commence et installe Eclipse sur votre poste de travail en créant un raccourci Eclipse dans votre dossier personnel personnel.

Lancez Eclipse et sélectionnez votre espace de travail :

Fig 2 — Spécification d’un espace de travail Eclipse

Cliquez sur Lancer , vous obtiendrez après avoir indiqué cette page de bienvenue :

Fig 3 — Page de bienvenue d’Eclipse

Cliquez sur Masquer , votre installation Eclipse est désormais entièrement disponible !

Fig 4 — Tableau de bord Eclipse après la première installation

Comme vous pouvez le constater, Eclipse pour Java Enterprise est livré avec des outils très utiles, comme le montre la vue Afficher dans le menu d’options IDE d’Eclipse :

Fig 5 — Vue Eclipse pour Java Enterprise

Comparez cette vue avec la vue disponible dans l’application groupée Anypoint Studio :

Fig 6 — Vue standard à tout point

Gérer vos données

Passons en revue quelques plugins installés, en particulier l’outil de plugin Data Management .

Pour rappel, la plateforme d’outils de données Eclipse pour Eclipse fournit des frameworks extensibles et des outils exemplaires, permettant un ensemble diversifié de plug-ins offrant des technologies spécifiques et particulières centrées sur les données.

Sélectionnez la vue correspondante et cliquez sur Ouvrir :

Fig 7 — Vue de l’explorateur de sources de données Eclipse

Cliquez sur Connexions à la base de données , vous verrez de nombreux profils de connexion disponibles pour gérer votre base de données préférée dans Eclipse. Vous pouvez également effectuer quelques requêtes SQL :

Fig 8 — Profil de connexion à la base de données Eclipse

Ceci est intéressant lorsque vous utilisez un connecteur DB dans Anypoint Studio et testez vos données.

Comme vous pouvez le voir dans cette vue avec la version fournie d’Eclipse, vous avez accès à tous les outils de l’environnement Java pour gérer vos projets. Cela peut inclure l’outil de construction Maven si vous souhaitez développer votre projet d’intégration Mule et l’intégrer harmonieusement à un framework Java comme Spring Boot, ou si vous souhaitez utiliser Spring Beans comme composants Flow, ou Spring Application Context, ou utiliser certains composants EJB et profitez de l’assistant disponible comme JPA (voir en haut dans la vue Eclipse).

Ajoutons quelques plugins utiles dans notre IDE Eclipse avant d’intégrer l’écosystème Mule.

Améliorer votre cycle de construction avec M2Eclipse pour Maven

L’un des moyens les plus utiles de gérer votre projet Maven et votre projet Mule consiste à utiliser le plugin M2Eclipse Eclipse .

M2Eclipse est l’un des principaux plugins utilisés pour développer des projets Maven dans Eclipse. Il permet l’exécution des objectifs Maven et gère les dépendances Maven.

Il est différent du plugin maven-eclipse standard, qui est un plugin Maven qui tente de gérer/modifier les fichiers de projet Eclipse pour tenir compte des dépendances Maven.

Le plugin M2Eclipse pour Eclipse sera très utile pour vos projets Anypoint spécifiquement dans une phase OPS, dans le cycle de vie de déploiement de votre projet sur CloudHub, et si vous devez appliquer certaines fonctionnalités de déploiement spécifiques à l’aide du plugin Mule Maven, illustrées ci- dessous :

Fig 9 — Gestion du cycle de vie de votre build avec le plugin Maven pour Mulesoft à l’aide du plugin M2Eclipse

Avec ce plugin Eclipse, vous pouvez utiliser votre propre projet Maven et utiliser un archétype utile :

https://maven.apache.org/archetype/ma…

Nous allons maintenant explorer plus en détail ce sujet de l’archétype Maven. Cet archétype est très utile si vous souhaitez standardiser vos actifs et votre projet Mule, mais pour l’instant, découvrons comment l’installer et le configurer.

Cliquez sur Installer un nouveau logiciel et remplissez le travail avec le texte d’entrée l’URL suivante https://download.eclipse.org/technology/m2e/releases/latest/ comme indiqué ci-dessous :

Fig 10 — Installation de M2Eclipse Eclipse à l’aide de la mise à jour du référentiel Eclipse

Cochez la case M2E — Complete Development Kit et M2E — PDE Integration et cliquez deux fois sur Suivant et Terminer pour lancer l’installation du plugin.

Redémarrez votre installation Eclipse pour finaliser votre installation.

Vous pouvez vérifier l’installation de ce plugin en utilisant le menu d’options À propos d’Eclipse :

Fig 11 — Vérification de la post-installation de m2Eclipse

Prise en charge de la spécification OpenAPI dans Anypoint Studio

Souvent, lors du développement de nos API, nous avons besoin d’un éditeur amélioré pour spécifier et prendre en charge la spécification OpenAPI. Pour un développeur Java, vous souhaiterez peut-être considérer les riches fonctionnalités de Swagger-OpenAPI version 2.0 et d’OpenAPI version 3.0 .

OpenAPI (Swagger) Editor est un outil qui prend en charge une spécification OpenAPI et est disponible sur le Marketplace d’Eclipse et offrira des fonctionnalités intéressantes :

Fig 12 — Installation du plugin OpenAPI Swagger Eclipse

OpenAPI est livré avec un autre plugin que vous pouvez installer gratuitement, KaiZen OpenAPI Editor for Eclipse . Ceci est disponible dans la boutique Eclipse et vous donne la possibilité de modéliser, documenter, visualiser, tester et générer du code à partir de votre API, dans votre IDE Eclipse.

Redémarrez votre IDE, et vous aurez accès dans la vue à toutes les fonctionnalités de ce plugin éditeur OpenAPI complet :

Fig 13 — Vue OpenAPI après l’installation du plugin

Voici un exemple de l’éditeur OpenAPI en action avec un OpenAPI généré dans API Designer et importé en tant que projet dans Eclipse :

Fig 14 — Exemple d’éditeur OpenAPI dans Eclipse

Gérer votre code

Enfin, nous concluons notre visite des outils Anypoint Studio Eclipse. SonarQube est un outil utile pour gérer notre processus de révision de code au sein de nos projets MuleSoft, ce qui est, comme vous le savez, très essentiel au succès du projet, en particulier si vous développez un connecteur Java dans votre diagramme de flux.

Voici une capture de ce plugin disponible dans Eclipse Marketplace :

Figure 15 — Installation de SonarLint

Voici la vue dédiée SonarQube disponible après installation du plugin :

Fig 16 — Vue d’installation de SonarQube

Dans la prochaine partie de cette série, nous développerons un didacticiel spécial approfondi pour expliquer les étapes d’utilisation de ce plugin SonarQube dans notre projet de la vie quotidienne Anypoint Studio pour Devops. Il est important de noter qu’Anypoint API Governance est également un composant de la plateforme Anypoint qui vous permet d’appliquer des règles de gouvernance à vos API dans le cadre du cycle de vie des API. Vous pouvez utiliser cette option pour améliorer la qualité de l’API de votre organisation et identifier les problèmes de conformité dans les spécifications d’API publiées et prendre des mesures pour les résoudre.

Maintenant que nous avons finalisé l’installation des plugins dans notre processus d’installation Eclipse, il est temps de procéder à l’installation du plugin Anypoint Studio dans notre environnement fourni Eclipse.

Installation d’Anypoint sur la version fournie avec Eclipse

Nous concluons notre installation en installant Anypoint Studio dans notre installation Eclipse.

Version plug-in Eclipse d’Anypoint Studio : En savoir plus sur l’installation d’Anypoint Studio en tant que plug-in Eclipse .

Cliquez sur Aide > Installer un nouveau logiciel dans le menu Eclipse et remplissez le lien de mise à jour suivant : http://studio.mulesoft.org/r6/plugin . Ensuite, vérifiez les options suivantes comme illustré ci-dessous :

Sélectionnez les composants suivants :

Fig 17 — Choix et installation des composants Anypoint dans Eclipse 1/2

Cliquez sur Suivant

Fig 18 — Installation d’Anypoint 2/2 dans Eclipse Étape finale

REMARQUE : Parfois, il y a une certaine incompatibilité lorsque vous essayez d’installer des fonctionnalités spécifiques d’Anypoint Studio, veuillez vérifier la version de votre version Eclipse que vous utilisez et consulter les exigences de votre distribution Anypoint Studio dans la documentation MuleSoft disponible.

Cliquez sur Suivant , acceptez les termes du contrat de licence et Terminer pour finaliser l’installation et redémarrer votre installation Eclipse. Votre nouvel Eclipse personnalisé et groupé avec les composants Mule est maintenant prêt à fonctionner !

Cliquez sur l’icône Eclipse pour démarrer votre nouvel environnement Mule Anypoint Studio Eclipse :

Fig 19 — Eclipse Anypoint Studio fourni après l’installation

Comme vous pouvez le constater, la perspective Mule est enrichie de l’autre perspective que nous avons installée auparavant.

Pour valider notre bundle Mule Studio spécifique, je vais créer un projet Maven en utilisant https://github.com/kloudtek/mule4-api-archetype , qui est un projet API Mule 4, en utilisant APIkit :

Fig 20 — Création d’un projet Mule à partir d’un archétype Maven

Cliquez sur Suivant pour remplir le projet Maven Group Id et Artifact Id :

Fig 21 — Remplissage des informations POM à l’aide de l’archétype Mule Maven

Cliquez sur Terminer et cliquez sur Entrée au message suivant dans votre console Mule :

Fig 22 — Générez votre projet Maven Mule dans le terminal Mule

Votre premier projet API Anypoint est généré et vous pouvez commencer à utiliser votre nouvel environnement personnalisé :

Fig 23 — Projet Mule généré

De conclure

Nous avons complété notre version personnalisée d’Anypoint Studio en utilisant les plugins les plus utiles qui vous aident dans le développement du cycle de vie de votre projet Mule.

Nous continuerons dans nos prochains articles sur la façon dont nous pouvons améliorer et rendre plus amusant notre bundle Anypoint Studio en créant des archétypes spécifiques pour les projets Maven.

Profitez de votre codage Mule et restez à l’écoute !

Ressources

https://github.com/RepreZen/KaiZen-OpenApi-Editor

Installation de Mule Studio via le site de mise à jour ou Eclipse Marketplace