Pakisan/jasyncapi

AsyncAPI spec from Java code

Building the future of event-driven architectures

We're on a mission to standardize message-based communication and increase interoperability of the different systems out there.

---

⚠️ This project doesn't support AsyncAPI 1.x

---

Overview

JVM-friendly bindings for AsyncAPI. It allows you to read or write specifications for your asynchronous API through code

Hints:

• If you are working with AsyncAPI specification in JetBrains IDE, check out our AsyncAPI - IDEA plugin
• If you are working with AsyncAPI specification in VSCode, check out our AsyncAPI - VSCode plugin

Known consumers:

• Springwolf Core - Automated documentation for async APIs built with Spring Boot
• AsyncAPI Quarkus - Generates AsyncAPIRegistry and configuration classes for Quarkus

Known open specifications to check compatibility with:

• adeo-kafka-request-reply-asyncapi.yml
• anyof-asyncapi.yml
• application-headers-asyncapi.yml
• correlation-id-asyncapi.yml
• gitter-streaming-asyncapi.yml
• kraken-websocket-request-reply-message-filter-in-reply-asyncapi.yml
• kraken-websocket-request-reply-multiple-channels-asyncapi.yml
• mercure-asyncapi.yml
• not-asyncapi.yml
• oneof-asyncapi.yml
• operation-security-asyncapi.yml
• rpc-client-asyncapi.yml
• rpc-server-asyncapi.yml
• simple-asyncapi.yml
• slack-rtm-asyncapi.yml
• streetlights-kafka-asyncapi.yml
• streetlights-mqtt-asyncapi.yml
• streetlights-operation-security-asyncapi.yml
• websocket-gemini-asyncapi.yml

Contributors section

Build

Prerequisites

1. JDK 1.8
2. Maven 3+

If you are using SDKMAN! use env to prepare environment

sdk env install

Install locally

Each build is GPG signed. To avoid this, and to not configure GPG locally, you can use this command:

 mvn clean install -Dgpg.skip

Publish new release

Prerequisites

1. Request credentials for one of AsyncAPI's account on Sonatype Jira, which is synced with Sonatype nexus
2. Generate pgp key if it was not generated yet
3. Create /Users/{userName}/.m2/settings.xml

<settings>
  <profiles>
    <profile>
      <id>ossrh</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <properties>
        <gpg.keyname>GPG key name</gpg.keyname>
        <gpg.executable>gpg</gpg.executable>
        <gpg.passphrase>GPG passphrase for selected key</gpg.passphrase>
        <gpg.homedir>/Users/{userName}/.gnupg</gpg.homedir>
      </properties>
    </profile>
  </profiles>
  <servers>
    <server>
      <id>ossrh</id>
      <username>Jira username</username>
      <password>Jira password</password>
    </server>
  </servers>
</settings>

Release

mvn clean deploy -P release 

references:

• Sonatype Instruction with references and clarifications
• Sonatype Instruction for deployment releasing