A maven plugin that support the AsyncAPI CLI

[M3lkior]

Hi everybody,

Since i work with AsyncAPI on my java projects, i always had to do some workaround things to deal with the asyncapi ecosystem (javascript) in a java ecosystem like using a frontend-maven-plugin to get node & npm in order to install the generator or using the exec-maven-plugin to run the ag command in order to generate source code into the project

My idea is to provide a first version of an async api maven plugin in order to quickly be able to play with the tooling in a maven ecosystem. After some discussions with @derberg ; it appears that the perfect candidate is the AsyncAPI CLI for now (not the generator)

Concerning my implementation ideas:

• the Google Closure compiler java lib to run the CLI
• create (automate the creation of) a webjar of the Async CLI in order to have a standard maven dependency

In a future, this plugin can achieve the same tasks as the openapi-maven-plugin

Any other ideas ? or feedbacks about this ?
Any volunteers to help me maintain this future new project ?

[rivancic]

Hi @M3lkior
I need AsyncAPI myself in pure Java backend projects, while using Gradle as a build tool. I would be willing to help out creating a Gradle plugin wrapper and test the Maven plugin.

I'm not sure really whats required to produce a webjar, but then it could be reused by both Maven and Gradle.

For Gradle could be done directly wrapping npm in Gradle (https://dzone.com/articles/integrating-java-and-npm-builds-using-gradle).

[rivancic]

I just tested the the com.github.node-gradle.node Gradle plugin and seems quite promising.

https://github.com/rivancic/asyncapi-generator-gradle-script

It has the possibility to download node or delegate to node installation on a machine. Then it offers a task to invoke npm methods. This way Gradle can delegate generation commands through Gradle tasks.

Will try to make this logic configurable and extract it to standalone Gradle plugin.

[rivancic]

I have created PoC Gradle plugin that wraps npm asyncapi generator
https://github.com/rivancic/asyncapi-generator-gradle-plugin
https://plugins.gradle.org/plugin/com.rivancic.asyncapi-gradle-plugin