Investigation on using Async-api for clamp messaging doc.
Tool:
- Java AsyncAPI: This tool stores modules, which simplifies interacting with AsyncAPI in jvm ecosystem.
SCS MultiApi Plugin: This is a plugin designed to help developers automatizing the creation of code classes from YML files based on AsyncApi and OpenAPI. It…
- ZenWave SDK: DDD and API-First for Event-Driven Microservices
- Springwolf: Automated documentation for event-driven applications built with Spring Boot
SCS MultiApi Plugin
This is a plugin designed to help developers automatizing the creation of code classes from YML files based on AsyncApi and OpenAPI. It is presented in 2 flavours Maven and Gradle (MPL-2.0 license).
This plugin allows developers to automatize the creation of code classes for REST and Kafka connections, based on YML files under the AsyncApi and OpenApi specifications. In the latter case, many of the configuration options and classes that are generated are based on reimplementation or modification of the OpenAPI Generator models and template designs.
The generation of the REST and Kafka connections is independent each other and could be used only one, or both at the same time.
Link: (https://github.com/sngular/scs-multiapi-plugin)
ZenWave SDK
ZenWave SDK is a configurable and extensible toolkit for Domain Driven Design (DDD) and API-First that can generate code from a mix of different models including (MIT license):
- ZDL Domain Language
- AsyncAPI
- OpenAPI
Link: (https://github.com/zenwave360/zenwave-sdk)
Springwolf
It documents asynchronous APIs using the AsyncAPI specification. (Apache License 2.0).
springwolf-ui adds a web UI, much like that of Springfox, and allows easy publishing of auto-generated payload examples.
Using @AsyncListener
and @AsyncPublisher
any protocol can be documented, although the binding in the AsyncAPI document will remain empty.
The protocols with native support come along with a @_ProtocolName_Binding
annotation to define protocol specific properties.
Springwolf Kafka Plugin
Automated documentation for Spring Boot application with Kafka consumers.
This plugin generates an AsyncAPI document from @KafkaListener
methods.