feat: Added AsyncAPI internal implementation

Author: ctasada

.github/workflows/springwolf-asyncapi.yml

@@ -0,0 +1,45 @@
+name: springwolf-asyncapi
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    types: [ opened, synchronize, ready_for_review ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up JDK
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      - name: Setup Gradle
+        uses: gradle/gradle-build-action@v2
+
+      - name: Check formatting (before running tests)
+        run: ./gradlew -p springwolf-asyncapi spotlessCheck
+
+      - name: Build with Gradle
+        run: ./gradlew -p springwolf-asyncapi build
+
+      - name: Publish package
+        if: github.ref == 'refs/heads/master'
+        run: ./gradlew -p springwolf-asyncapi publish
+        env:
+          ORG_GRADLE_PROJECT_SNAPSHOT: true
+
+          ORG_GRADLE_PROJECT_SIGNINGKEY: ${{secrets.ORG_GRADLE_PROJECT_SIGNINGKEY}}
+          ORG_GRADLE_PROJECT_SIGNINGPASSWORD: ${{secrets.ORG_GRADLE_PROJECT_SIGNINGPASSWORD}}
+
+          ORG_GRADLE_PROJECT_MAVEN_URL: https://s01.oss.sonatype.org/content/repositories/snapshots/
+          ORG_GRADLE_PROJECT_MAVEN_USERNAME: ${{ secrets.MAVEN_USERNAME }}
+          ORG_GRADLE_PROJECT_MAVEN_PASSWORD: ${{ secrets.MAVEN_PASSWORD }}

README.md

@@ -5,6 +5,7 @@
 ![Last Version](https://img.shields.io/github/tag-pre/springwolf/springwolf-core.svg)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![springwolf-core](https://github.com/springwolf/springwolf-core/actions/workflows/springwolf-core.yml/badge.svg)](https://github.com/springwolf/springwolf-core/actions/workflows/springwolf-core.yml)
+[![springwolf-asyncapi](https://github.com/springwolf/springwolf-core/actions/workflows/springwolf-asyncapi.yml/badge.svg)](https://github.com/springwolf/springwolf-core/actions/workflows/springwolf-asyncapi.yml)
 [![springwolf-ui](https://github.com/springwolf/springwolf-core/actions/workflows/springwolf-ui.yml/badge.svg)](https://github.com/springwolf/springwolf-core/actions/workflows/springwolf-ui.yml)
 [![springwolf-plugins](https://github.com/springwolf/springwolf-core/actions/workflows/springwolf-plugins.yml/badge.svg)](https://github.com/springwolf/springwolf-core/actions/workflows/springwolf-plugins.yml)
 [![springwolf-addons](https://github.com/springwolf/springwolf-core/actions/workflows/springwolf-addons.yml/badge.svg)](https://github.com/springwolf/springwolf-core/actions/workflows/springwolf-addons.yml)

build.gradle

@@ -117,6 +117,7 @@ allprojects {
     }
 
     var publishingEnabled = (
+            project.name == 'springwolf-asyncapi' ||
             project.name == 'springwolf-core' ||
             project.name == 'springwolf-amqp' ||
             project.name == 'springwolf-cloud-stream' ||

settings.gradle

@@ -1,6 +1,15 @@
+pluginManagement {
+    plugins {
+        id 'org.jetbrains.kotlin.jvm' version '1.9.21'
+    }
+}
+plugins {
+    id 'org.gradle.toolchains.foojay-resolver-convention' version '0.5.0'
+}
 rootProject.name = 'springwolf-core'
 
 include(
+        'springwolf-asyncapi',
         'springwolf-core',
         'springwolf-plugins:springwolf-amqp-plugin',
         'springwolf-plugins:springwolf-cloud-stream-plugin',

springwolf-asyncapi/README.md

@@ -0,0 +1,55 @@
+# Springwolf AsyncAPI
+
+### About
+
+This library provides a JVM-friendly binding to generate [AsyncAPI document](https://www.asyncapi.com/). 
+It allows to create specifications for AsyncAPI from code.
+
+Even when this library can be use by any JVM system, it's main goal is to support Springwolf-Core.
+
+### Usage
+
+Add the following dependencies and configuration class to enable this plugin.
+
+#### Dependencies
+
+```groovy
+dependencies {
+    // Provides the JVM Builders to create an AsyncAPI Spec file    
+    implementation 'io.github.springwolf:springwolf-asyncapi:<springwolf-version>'
+}
+```
+
+### Configuration class
+
+```java
+        AsyncAPI asyncAPI = AsyncAPI.builder()
+                .info(Info.builder()
+                        .title("Account Service")
+                        .version("1.0.0")
+                        .description("This service is in charge of processing user signups")
+                        .build())
+                .channels(Map.of(
+                        "userSignedup",
+                        Channel.builder().build()))
+                .operations(Map.of(
+                        "sendUserSignedup",
+                        Operation.builder().build()))
+                .build();
+```
+
+## TODO:
+
+* Test that the serialization is always respecting the case format
+* Test that the validations are applied
+* Finish to implement and test all the Bindings
+* Deserialize a JSON/YAML file to Java instances
+
+## PENDING:
+
+* [[Docs Bug 🐞 report]: JMS Server Binding Example doesn't match AsyncAPI v3 specification #232](https://github.com/asyncapi/bindings/issues/232) - In Review
+* [Confusing Operation Object Example #1007](https://github.com/asyncapi/spec/issues/1007) - In Review
+
+## Convert AsyncAPI v2.x to v3.0.0
+
+See https://github.com/asyncapi/converter-js#conversion-2xx-to-3xx

springwolf-asyncapi/build.gradle

@@ -0,0 +1,54 @@
+plugins {
+    id 'java'
+    id 'java-library'
+
+    id 'org.springframework.boot'
+    id 'io.spring.dependency-management'
+    id 'ca.cutterslade.analyze'
+}
+
+dependencies {
+    implementation "io.swagger.core.v3:swagger-core-jakarta:${swaggerVersion}"
+    implementation "jakarta.validation:jakarta.validation-api"
+
+    implementation "com.fasterxml.jackson.core:jackson-core:${jacksonVersion}"
+    implementation "com.fasterxml.jackson.core:jackson-annotations:${jacksonVersion}"
+    implementation "com.fasterxml.jackson.core:jackson-databind:${jacksonVersion}"
+    implementation "com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:${jacksonVersion}"
+
+    compileOnly "org.projectlombok:lombok:${lombokVersion}"
+
+    annotationProcessor "org.projectlombok:lombok:${lombokVersion}"
+
+    testAnnotationProcessor "org.projectlombok:lombok:${lombokVersion}"
+
+    testImplementation "org.junit.jupiter:junit-jupiter-api:${junitJupiterVersion}"
+    testImplementation "com.fasterxml.jackson.core:jackson-databind:${jacksonVersion}"
+    testImplementation "com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:${jacksonVersion}"
+    testImplementation "io.swagger.core.v3:swagger-core-jakarta:${swaggerVersion}"
+    testImplementation "net.javacrumbs.json-unit:json-unit-assertj:3.2.2"
+
+    testRuntimeOnly "org.junit.jupiter:junit-jupiter:${junitJupiterVersion}"
+}
+
+jar {
+    enabled = true
+    archiveClassifier = ''
+}
+bootJar.enabled = false
+
+java {
+    withJavadocJar()
+    withSourcesJar()
+}
+
+publishing {
+    publications {
+        mavenJava(MavenPublication) {
+            pom {
+                name = 'springwolf-asyncapi'
+                description = 'AsyncAPI schema generator'
+            }
+        }
+    }
+}

springwolf-asyncapi/src/main/java/io/github/stavshamir/springwolf/asyncapi/core/v3/bindings/ChannelBinding.java

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: Apache-2.0
+package io.github.stavshamir.springwolf.asyncapi.core.v3.bindings;
+
+import io.github.stavshamir.springwolf.asyncapi.core.v3.model.ExtendableObject;
+import lombok.EqualsAndHashCode;
+
+/**
+ * Describes AsyncAPI channel binding.
+ */
+@EqualsAndHashCode(callSuper = true)
+public abstract class ChannelBinding extends ExtendableObject {}

springwolf-asyncapi/src/main/java/io/github/stavshamir/springwolf/asyncapi/core/v3/bindings/MessageBinding.java

@@ -0,0 +1,8 @@
+// SPDX-License-Identifier: Apache-2.0
+package io.github.stavshamir.springwolf.asyncapi.core.v3.bindings;
+
+import io.github.stavshamir.springwolf.asyncapi.core.v3.model.ExtendableObject;
+import lombok.EqualsAndHashCode;
+
+@EqualsAndHashCode(callSuper = true)
+public class MessageBinding extends ExtendableObject {}

springwolf-asyncapi/src/main/java/io/github/stavshamir/springwolf/asyncapi/core/v3/bindings/OperationBinding.java

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: Apache-2.0
+package io.github.stavshamir.springwolf.asyncapi.core.v3.bindings;
+
+import io.github.stavshamir.springwolf.asyncapi.core.v3.model.ExtendableObject;
+import lombok.EqualsAndHashCode;
+
+/**
+ * Describes AsyncAPI operation binding.
+ */
+@EqualsAndHashCode(callSuper = true)
+public abstract class OperationBinding extends ExtendableObject {}

springwolf-asyncapi/src/main/java/io/github/stavshamir/springwolf/asyncapi/core/v3/bindings/ServerBinding.java

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: Apache-2.0
+package io.github.stavshamir.springwolf.asyncapi.core.v3.bindings;
+
+import io.github.stavshamir.springwolf.asyncapi.core.v3.model.ExtendableObject;
+import lombok.EqualsAndHashCode;
+
+/**
+ * Describes AsyncAPI operation binding.
+ */
+@EqualsAndHashCode(callSuper = true)
+public abstract class ServerBinding extends ExtendableObject {}