Como instalar la herramienta de MuleSoft para diseñar e implementar API’s

La “programación” o el desarrollo en MuleSoft no se realiza escribiendo líneas de código como en los lenguajes de programación comunes. Aparte de que MuleSoft no es un lenguaje de programación, sino más bien es una plataforma de integración en la nube. Que cuenta con un IDE de escritorio que te permite implementar la lógica de negocio de los casos de uso, arrastrando y soltando componentes es de las famosas “drag and drop tool”.

MuleSoft recientemente lanzó Anypoint Code Builder el cual está basado en la nube, es decir es un web IDE. Pero en este post se hablará del desktop IDE “Anypoint Studio” ya que aún se sigue y se seguirá utilizando por unos años más en lo que se publique una versión estable de Code Builder, pero puedes revisar su documentación en el sitio oficial, utilizarlo y compartir tus reseñas para contribuir a que la version estable esté más pronto de lo esperado.

Anypoint Studio

Anypoint Studio es el nombre del IDE de MuleSoft. El cual está basado en Eclipse IDE y te permitirá diseñar, implementar y probar aplicaciones Mule, también conocidas como Mule apps o Mule Applications.

Ventajas de Anypoint Studio:

• Cuenta con cientos de módulos prefabricados que se utilizan comúnmente en cualquier integración tales como consultas a los sistemas backend, ruteo de eventos, transformación de lógica de negocios, manejo de errores entre otros.
• Cuenta con un servidor local de Mule “Mule runtime”, el cual te permitirá ejecutar tus Mule apps en tu laptop.
• Te permite hacer debugs en tus Mule Apps de manera muy simple y precisa.
• Puedes combinar, filtrar, mapear o transformar datos (usando DataWeave) a diferentes formatos como: json, xml, csv, plain text, etc.
• Cuenta con un framework (MUnit) muy sofisticado para implementar las pruebas de tus Mule Applications con una interfaz muy parecida a la que utilizas para desarrollarlas.
• Gracias a que las Mule Apps están basadas en maven, se pueden incorporar fácilmente a cualquier herramienta de CI/CD.
• Ahora ya incorpora el diseño y mocking de APIs en lenguajes OAS o RAML.
• Te proporciona la opción de desplegar tus APIs o Mule apps en la nube o de manera on-premise.

Como Instalar Anypoint Studio en Windows

1.-Descargue el instalador de la pagina oficial “aqui”.

2.-Rellene el formulario solicitado, agregue el correo que utiliza actualmente puesto que ahí le enviaran el link de descarga.

Ejemplo del llenado del formulario:

Después de dar clic el botón de descarga “Download”, y si relleno todos los campos obligatorios le llegará al correo el link de descarga y le aparecerá este mensaje en el sitio web:

Localiza el correo que contiene el link de la descarga y haga clic en “Go to download page”.

Esto lo llevará nuevamente al sitio web de descarga, pero esta vez solo le aparecerá el botón para descargar el archivo, dar clic en “Download” y esperar a que se descargue el archivo zip.

3.-Una vez descargado el archivo localice y renombrelo a manera de agregarle un nombre corto y sin espacios. El nombre corto evitará errores al extraer el archivo.

Ejemplo: “AnyPS715.zip”

4.-Copie el archivo renombrado a una carpeta en su disco local, en windows es muy común tener el disco local C. El nombre de la carpeta también se recomienda que sea corto y sin espacios, con el objetivo de evitar errores al extraer el archivo.

Ejemplo de nombre de carpeta “AnyPS”:

5.-Extraiga el archivo e ingrese a la carpeta extraída y seleccione el archivo “AnypointStudio.exe” para abrir el IDE.

6.-Seleccione la carpeta “Workspace” donde se almacenarán sus Mule Apps y de clic en “Launch”.

7.-Conceda el acceso al OpenJDK que viene por default con Anypoint Studio. Esta es la Java VM “virtual machine” que utiliza el IDE para poder ejecutarse de forma correcta.

Nota: También puede configurar el IDE con alguna versión de Java VM que usted ya utilice, solo debe asegurarse que sea una versión aceptada por Anypoint Studio.

8.-¡Felicidades! ya puedes empezar a crear tu primera aplicación Mule App.

Tour en Anypoint Studio

1. Barra de menú principal: donde podrás seleccionar la mayoría de las funciones que puedes realizar en este IDE, como crear, abrir, importar, exportar una mule app o API, abrir, cerrar, construir (build), ejecutar o debuguear un proyecto/Mule App, podrás también encontrar la opción de configurar algunas características del IDE o del proyecto, tambien podras instalar, actualizar o eliminar extensiones/plugins, etc.

2. Explorador de paquetes/archivos: en este apartado (en color azul) podrás visualizar la estructura de carpetas y archivos de tu proyecto, con clic derecho -> propiedades podrás encontrar la ubicación exacta de tu proyecto en el sistema de archivos. También puedes agregar o eliminar archivos al proyecto.

3. Área de trabajo principal: Aquí es donde ocurre la magia de MuleSoft, es el área donde implementarás la lógica de negocio de todos tus casos de uso, únicamente arrastrando y soltando los componentes de la paleta de componentes.

• a) Message Flow: es la vista gráfica de nuestro proyecto, donde veremos los componentes, flujos y sub-flujos de manera gráfica.
• b) Global elements: También es una vista gráfica pero en esta podras configurar los conectores que se conectan a los sistemas backend o sistemas externos que el proyecto se encuentre utilizando, ejemplo: configuración de conectores a bases de datos, a sistemas de archivos, conectores a plataformas como Salesforce, Netsuite, Oracle ERP, Amazon, SAP y demás, también puedes configurar los conectores que consumen REST/SOAP APIs, configuraciones adicionales demandadas por el proyecto o que se quieran agregar por concepto de buenas prácticas.
• c) Configuration XML: Es la vista del proyecto en lenguaje xml, también puedes editar o configurar el proyecto desde esta vista, es más recomendable hacerlo cuando ya se tiene un conocimiento intermedio o avanzado.

4. Mule Palette: Es la zona donde encontraremos los componentes o módulos prefabricados que MuleSoft nos ofrece para agilizar el desarrollo de las Mule Apps. Puedes agregar más módulos a tu proyecto seleccionando la opción (+ Add Modules), en caso de requerir de algún módulo que no se encuentre en esta opción, lo puedes agregar desde el marketplace de Anypoint Platform llamado “Exchange” haciendo clic en (Search in Exchange).

5. En esta area “en amarillo” podras encontrar vistas adicionales que te ayudaran a configurar o monitorear el estado de la aplicacion Mule, los mas comunes son:

• Mule Properties: En esta ventana se visualizan las configuraciones que se le pueden realizar al componente seleccionado en el área de trabajo.
• Console: Se visualiza la salida de datos al momento de ejecutar o debuguear la aplicación.
• Problems: Aquí podrás encontrar los problemas en caso de que el proyecto presente alguno, se recomienda revisar esta sección antes de ejecutar el proyecto.
• Progress: Se visualiza de forma gráfica el progreso de la aplicación de los cambios/configuraciones o actualizaciones del proyecto.
• Mule Debugger: En esta sección podrás observar el paso a paso del proceso de debug del proyecto, encontrarás el valor de los atributos, variables y del payload respectivos al punto de ejecución en el flujo del proyecto.

6. Perspectiva para debug (Mule Debug) del proyecto, se debe seleccionar cuando queremos hacer debug al proyecto, si no es seleccionada, al momento de que el proyecto inicie a compilar le preguntará si gusta cambiar a la perspectiva “debug”, seleccionar sí/yes.

7. Perspectiva de trabajo normal (Mule Design), podemos volver a esta perspectiva dando clic al icono que aparece debajo del número “7” (tomado como referencia en la captura de pantalla)

8. Perspectiva de trabajo para diseño de APIs (API Design), puede cambiar a esta perspectiva seleccionando el icono que aparece debajo del número “8” en la captura de pantalla.

Conclusión

MuleSoft brinda constantemente mejoras sobre todos sus productos, y Anypoint Studio no es la excepción, aquí te dejo el link de la página oficial para que puedas revisar las mejoras u actualizaciones que se implementan en esta grandiosa herramienta.

Ahora que ya tienes una descripción general de este IDE, te invito a que sigas aprendiendo aun más y aquí te comparto el link del curso gratuito que MuleSoft ofrece a todo el público y que además al terminarlo tendrás la oportunidad de certificarte completamente GRATIS, el curso se llama “Anypoint Platform Development: Fundamentals” y la certificacion que obtendras si cumples con la puntuación que pide el examen se llama “MuleSoft Certified Developer — Level 1”