Feat/release 1.3.0 (#87)

* docs: Springwolf 1.3.0 release * chore(deps): update dependencies * docs: improve documentation on server name * docs: add new bindings
springwolf · May 31, 2024 · 4b5b833 · 4b5b833
1 parent 8c9a692
commit 4b5b833
Show file tree

Hide file tree

Showing 18 changed files with 1,579 additions and 1,674 deletions.
diff --git a/docs/configuration/configuration.mdx b/docs/configuration/configuration.mdx
@@ -27,6 +27,7 @@ All provided fields will be present in the generated document, but not all will
 ### `Servers` (required)
 
 The `Server` object provides metadata to help the reader understand the protocol, version, login details and more (see [AsyncAPI Server Object](https://www.asyncapi.com/docs/reference/specification/v3.0.0#serversObject)).
+Any name (`kafka-server` in the example) can be chosen.
 
 An AsyncAPI document can contain more than one server, but it's not common.
 

diff --git a/docs/configuration/documenting-consumers.md b/docs/configuration/documenting-consumers.md
@@ -30,7 +30,7 @@ Below is an example to demonstrate the annotation:
 @AsyncListener(operation = @AsyncOperation(
         channelName = "example-consumer-topic",
         description = "Customer uploaded an example payload", // Optional
-        servers = {"kafka"}, // Optional
+        servers = {"kafka-server"}, // Optional
         headers = @AsyncOperation.Headers( // Optional
                 schemaName = "SpringKafkaDefaultHeaders",
                 values = {
@@ -73,7 +73,7 @@ Optional. The headers describing the metadata of the payload.
 ### Servers
 
 Optional. Useful when an application is connect to multiple brokers and wants to indicate to which broker the channel belongs to.
-The server needs to exist in [configuration > Servers](configuration.mdx) as well.
+The server name needs to exist in [configuration > Servers](configuration.mdx) as well.
 
 ## `@JmsListener`, `@KafkaListener`, `@RabbitListener`, `@SqsListener`
 

diff --git a/docs/configuration/documenting-producers.md b/docs/configuration/documenting-producers.md
@@ -24,7 +24,7 @@ Below is an example to demonstrate the annotation:
 @AsyncPublisher(operation = @AsyncOperation(
         channelName = "example-producer-topic",
         description = "Customer uploaded an example payload", // Optional
-        servers = {"kafka"}, // Optional
+        servers = {"kafka-server"}, // Optional
         headers = @AsyncOperation.Headers( // Optional
                 schemaName = "SpringKafkaDefaultHeaders",
                 values = {
@@ -67,4 +67,4 @@ Optional. The headers describing the metadata of the payload.
 ### Servers
 
 Optional. Useful when an application is connect to multiple brokers and wants to indicate to which broker the channel belongs to.
-The server needs to exist in [configuration > Servers](configuration.mdx) as well.
+The server name needs to exist in [configuration > Servers](configuration.mdx) as well.
diff --git a/docs/configuration/snippets/_configuration_properties.properties b/docs/configuration/snippets/_configuration_properties.properties
@@ -3,8 +3,8 @@ springwolf.docket.base-package=io.github.springwolf.example
 springwolf.docket.info.title=${spring.application.name}
 springwolf.docket.info.version=1.0.0
 
-springwolf.docket.servers.kafka.protocol=kafka
-springwolf.docket.servers.kafka.host=${spring.kafka.bootstrap-servers}
+springwolf.docket.servers.kafka-server.protocol=kafka
+springwolf.docket.servers.kafka-server.host=${spring.kafka.bootstrap-servers}
 
 # Springwolf - optional fields
 springwolf.enabled=true

diff --git a/docs/introduction/supported-protocols.md b/docs/introduction/supported-protocols.md
@@ -37,11 +37,14 @@ Springwolf also provides some libraries to document bindings. Those libraries pr
 
 The supported binding annotations are:
 
-| Protocol      | Annotations                         | Latest Plugin Version                                                                                                                                                         |
-|---------------|-------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| GooglePubSub  | `@GooglePubSubAsyncChannelBinding`  | ![Maven Central](https://img.shields.io/maven-central/v/io.github.springwolf/springwolf-googlepubsub-binding?color=green&label=springwolf-googlepubsub-binding&style=plastic) |
-| SNS           | `@SnsAsyncOperationBinding`         | ![Maven Central](https://img.shields.io/maven-central/v/io.github.springwolf/springwolf-sns-binding?color=green&label=springwolf-sns-binding&style=plastic)                   |
-| SQS           | `@SqsAsyncOperationBinding`         | ![Maven Central](https://img.shields.io/maven-central/v/io.github.springwolf/springwolf-sqs-binding?color=green&label=springwolf-sqs-binding&style=plastic)                   |
+| Protocol     | Annotations                        | Latest Plugin Version                                                                                                                                                         |
+|--------------|------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| AMQP         | `@AmqpAsyncOperationBinding`       | ![Maven Central](https://img.shields.io/maven-central/v/io.github.springwolf/springwolf-amqp-binding?color=green&label=springwolf-amqp-binding&style=plastic)                 |
+| GooglePubSub | `@GooglePubSubAsyncChannelBinding` | ![Maven Central](https://img.shields.io/maven-central/v/io.github.springwolf/springwolf-googlepubsub-binding?color=green&label=springwolf-googlepubsub-binding&style=plastic) |
+| JMS          | `@JmsAsyncOperationBinding`        | ![Maven Central](https://img.shields.io/maven-central/v/io.github.springwolf/springwolf-jms-binding?color=green&label=springwolf-jms-binding&style=plastic)                   |
+| Kafka        | `@KafkaAsyncOperationBinding`      | ![Maven Central](https://img.shields.io/maven-central/v/io.github.springwolf/springwolf-kafka-binding?color=green&label=springwolf-kafka-binding&style=plastic)               |
+| SNS          | `@SnsAsyncOperationBinding`        | ![Maven Central](https://img.shields.io/maven-central/v/io.github.springwolf/springwolf-sns-binding?color=green&label=springwolf-sns-binding&style=plastic)                   |
+| SQS          | `@SqsAsyncOperationBinding`        | ![Maven Central](https://img.shields.io/maven-central/v/io.github.springwolf/springwolf-sqs-binding?color=green&label=springwolf-sqs-binding&style=plastic)                   |
 
 :::info
 See [Add-Ons / Generic Annotation Binding](../add-ons#generic-binding)

diff --git a/docs/quickstart.mdx b/docs/quickstart.mdx
@@ -36,8 +36,8 @@ springwolf.docket.base-package=io.github.springwolf.example.consumers
 springwolf.docket.info.title=${spring.application.name}
 springwolf.docket.info.version=1.0.0
 
-springwolf.docket.servers.kafka.protocol=kafka
-springwolf.docket.servers.kafka.host=${kafka.bootstrap.servers:localhost:29092}
+springwolf.docket.servers.kafka-server.protocol=kafka
+springwolf.docket.servers.kafka-server.host=${kafka.bootstrap.servers:localhost:29092}
 ```
 
 *Make sure to change the value of `springwolf.docket.base-package` to the package containing your listeners, so that Springwolf will automatically pick them up.*

diff --git a/docs/snippets/_springwolf_common_model_converters_groovy.gradle b/docs/snippets/_springwolf_common_model_converters_groovy.gradle
@@ -1,3 +1,3 @@
 dependencies {
-    implementation 'io.github.springwolf:springwolf-common-model-converters:1.2.0'
+    implementation 'io.github.springwolf:springwolf-common-model-converters:1.3.0'
 }
diff --git a/docs/snippets/_springwolf_common_model_converters_maven.xml b/docs/snippets/_springwolf_common_model_converters_maven.xml
@@ -2,6 +2,6 @@
     <dependency>
         <groupId>io.github.springwolf</groupId>
         <artifactId>springwolf-common-model-converters</artifactId>
-        <version>1.2.0</version>
+        <version>1.3.0</version>
     </dependency>
 </dependencies>
diff --git a/docs/snippets/_springwolf_generic_binding_groovy.gradle b/docs/snippets/_springwolf_generic_binding_groovy.gradle
@@ -1,3 +1,3 @@
 dependencies {
-    implementation 'io.github.springwolf:springwolf-generic-binding:1.2.0'
+    implementation 'io.github.springwolf:springwolf-generic-binding:1.3.0'
 }
diff --git a/docs/snippets/_springwolf_generic_binding_maven.xml b/docs/snippets/_springwolf_generic_binding_maven.xml
@@ -2,6 +2,6 @@
     <dependency>
         <groupId>io.github.springwolf</groupId>
         <artifactId>springwolf-generic-binding</artifactId>
-        <version>1.2.0</version>
+        <version>1.3.0</version>
     </dependency>
 </dependencies>
diff --git a/docs/snippets/_springwolf_groovy.gradle b/docs/snippets/_springwolf_groovy.gradle
@@ -1,7 +1,7 @@
 dependencies {
     // Provides the documentation API
-    implementation 'io.github.springwolf:springwolf-kafka:1.2.0'
+    implementation 'io.github.springwolf:springwolf-kafka:1.3.0'
 
     // Provides the UI - optional (recommended)
-    runtimeOnly 'io.github.springwolf:springwolf-ui:1.2.0'
+    runtimeOnly 'io.github.springwolf:springwolf-ui:1.3.0'
 }
diff --git a/docs/snippets/_springwolf_json_schema_groovy.gradle b/docs/snippets/_springwolf_json_schema_groovy.gradle
@@ -1,3 +1,3 @@
 dependencies {
-    implementation 'io.github.springwolf:springwolf-json-schema:1.2.0'
+    implementation 'io.github.springwolf:springwolf-json-schema:1.3.0'
 }
diff --git a/docs/snippets/_springwolf_json_schema_maven.xml b/docs/snippets/_springwolf_json_schema_maven.xml
@@ -2,6 +2,6 @@
     <dependency>
         <groupId>io.github.springwolf</groupId>
         <artifactId>springwolf-json-schema</artifactId>
-        <version>1.2.0</version>
+        <version>1.3.0</version>
     </dependency>
 </dependencies>
diff --git a/docs/snippets/_springwolf_kotlinx_serialization_model_converter_groovy.gradle b/docs/snippets/_springwolf_kotlinx_serialization_model_converter_groovy.gradle
@@ -1,3 +1,3 @@
 dependencies {
-    implementation 'io.github.springwolf:springwolf-kotlinx-serialization-model-converter:1.2.0'
+    implementation 'io.github.springwolf:springwolf-kotlinx-serialization-model-converter:1.3.0'
 }
diff --git a/docs/snippets/_springwolf_kotlinx_serialization_model_converter_maven.xml b/docs/snippets/_springwolf_kotlinx_serialization_model_converter_maven.xml
@@ -2,6 +2,6 @@
     <dependency>
         <groupId>io.github.springwolf</groupId>
         <artifactId>springwolf-kotlinx-serialization-model-converter</artifactId>
-        <version>1.2.0</version>
+        <version>1.3.0</version>
     </dependency>
 </dependencies>
diff --git a/docs/snippets/_springwolf_maven.xml b/docs/snippets/_springwolf_maven.xml
@@ -3,12 +3,12 @@
     <dependency>
         <groupId>io.github.springwolf</groupId>
         <artifactId>springwolf-kafka</artifactId>
-        <version>1.2.0</version>
+        <version>1.3.0</version>
     </dependency>
     <!-- Provides the UI - optional (recommended) -->
     <dependency>
         <groupId>io.github.springwolf</groupId>
         <artifactId>springwolf-ui</artifactId>
-        <version>1.2.0</version>
+        <version>1.3.0</version>
     </dependency>
 </dependencies>