diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/Reference.java b/asyncapi-core/src/main/java/com/asyncapi/v2/Reference.java
similarity index 92%
rename from asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/Reference.java
rename to asyncapi-core/src/main/java/com/asyncapi/v2/Reference.java
index c5ef3856..d7b447b2 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/Reference.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/Reference.java
@@ -1,9 +1,8 @@
-package com.asyncapi.v2._6_0.model;
+package com.asyncapi.v2;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.AllArgsConstructor;
import lombok.Data;
-import lombok.EqualsAndHashCode;
import lombok.NoArgsConstructor;
import org.jetbrains.annotations.NotNull;
@@ -23,7 +22,6 @@
* @author Pavel Bodiachevskii
*/
@Data
-@EqualsAndHashCode
@NoArgsConstructor
@AllArgsConstructor
public class Reference {
@@ -35,6 +33,6 @@ public class Reference {
*/
@NotNull
@JsonProperty(value = "$ref")
- private String ref;
+ private String ref = "";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/ChannelParametersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/ChannelParametersDeserializer.java
index b568deac..c702a0ca 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/ChannelParametersDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/ChannelParametersDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._0_0.jackson.model.channel;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._0_0.model.channel.Parameter;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/message/MessageCorrelationIdDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/message/MessageCorrelationIdDeserializer.java
index eef11f8c..b5dbd0ff 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/message/MessageCorrelationIdDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/message/MessageCorrelationIdDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._0_0.jackson.model.channel.message;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._0_0.model.channel.message.CorrelationId;
import com.asyncapi.v2.jackson.ReferenceOrObjectDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/message/MessageHeadersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/message/MessageHeadersDeserializer.java
index ede8eeb3..e7b62788 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/message/MessageHeadersDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/message/MessageHeadersDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._0_0.jackson.model.channel.message;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2.schema.Schema;
import com.asyncapi.v2.jackson.ReferenceOrObjectDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/message/MessageTraitsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/message/MessageTraitsDeserializer.java
index 5d54e6cb..e80a6148 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/message/MessageTraitsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/message/MessageTraitsDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._0_0.jackson.model.channel.message;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._0_0.model.channel.message.MessageTrait;
import com.asyncapi.v2.jackson.ListOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/operation/OperationMessageDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/operation/OperationMessageDeserializer.java
index cf118584..8f59c963 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/operation/OperationMessageDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/operation/OperationMessageDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._0_0.jackson.model.channel.operation;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._0_0.model.channel.message.Message;
import com.asyncapi.v2.jackson.ReferenceOrObjectDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/operation/OperationTraitsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/operation/OperationTraitsDeserializer.java
index 024d0883..185e271f 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/operation/OperationTraitsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/channel/operation/OperationTraitsDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._0_0.jackson.model.channel.operation;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._0_0.model.channel.operation.OperationTrait;
import com.asyncapi.v2.jackson.ListOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsMessagesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsMessagesDeserializer.java
index b171ff8e..06783ee3 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsMessagesDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsMessagesDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._0_0.jackson.model.component;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._0_0.model.channel.message.Message;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsParametersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsParametersDeserializer.java
index acc7407b..1471ce0c 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsParametersDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsParametersDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._0_0.jackson.model.component;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._0_0.model.channel.Parameter;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsSchemasDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsSchemasDeserializer.java
index 3fcd691e..168d7dd1 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsSchemasDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsSchemasDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._0_0.jackson.model.component;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2.schema.Schema;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsSecuritySchemesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsSecuritySchemesDeserializer.java
index 6ae2323f..91c7d16e 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsSecuritySchemesDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/jackson/model/component/ComponentsSecuritySchemesDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._0_0.jackson.model.component;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
import com.asyncapi.v2.security_scheme.SecurityScheme;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/AsyncAPI.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/AsyncAPI.java
index 59d02084..790ef520 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/AsyncAPI.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/AsyncAPI.java
@@ -13,6 +13,7 @@
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
+import java.util.HashMap;
import java.util.List;
import java.util.Map;
@@ -33,25 +34,26 @@ public class AsyncAPI extends ExtendableObject {
/**
* Required.
- *
+ *
* Specifies the AsyncAPI Specification version being used.
* It can be used by tooling Specifications and clients to interpret the version.
* The structure shall be major.minor.patch, where patch versions must be compatible
* with the existing major.minor tooling.
- *
+ *
* Typically patch versions will be introduced to address errors in the documentation,
* and tooling should typically be compatible with the corresponding major.minor (1.0.*).
* Patch versions will correspond to patches of this document.
*/
@NotNull
- private String asyncapi = "2.0.0";
+ @Builder.Default
+ private final String asyncapi = "2.0.0";
/**
* Identifier of the application the AsyncAPI document is defining.
- *
+ *
* This field represents a unique universal identifier of the application the AsyncAPI document is defining.
* It must conform to the URI format, according to RFC3986.
- *
+ *
* It is RECOMMENDED to use a URN to globally and uniquely identify the application during long periods of time,
* even after it becomes unavailable or ceases to exist.
*/
@@ -62,7 +64,7 @@ public class AsyncAPI extends ExtendableObject {
* A string representing the default content type to use when encoding/decoding a message's payload.
* The value MUST be a specific media type (e.g. application/json).
* This value MUST be used by schema parsers when the contentType property is omitted.
- *
+ *
* In case a message can't be encoded/decoded using this value, schema parsers MUST use their default content type.
*/
@Nullable
@@ -70,11 +72,12 @@ public class AsyncAPI extends ExtendableObject {
/**
* Required.
- *
+ *
* Provides metadata about the API. The metadata can be used by the clients if needed.
*/
@NotNull
- private Info info;
+ @Builder.Default
+ private Info info = new Info();
/**
* Provides connection details of servers.
@@ -84,15 +87,16 @@ public class AsyncAPI extends ExtendableObject {
/**
* Required.
- *
+ *
* The available channels and messages for the API.
- *
+ *
* Holds the relative paths to the individual channel and their operations. Channel paths are relative to servers.
- *
+ *
* Channels are also known as "topics", "routing keys", "event types" or "paths".
*/
@NotNull
- private Map channels;
+ @Builder.Default
+ private Map channels = new HashMap<>();
/**
* An element to hold various schemas for the specification.
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/ExternalDocumentation.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/ExternalDocumentation.java
index 9d907ea7..271780a7 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/ExternalDocumentation.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/ExternalDocumentation.java
@@ -31,10 +31,11 @@ public class ExternalDocumentation extends ExtendableObject {
/**
* Required.
- *
+ *
* The URL for the target documentation. Value MUST be in the format of a URL.
*/
@NotNull
- private String url;
+ @Builder.Default
+ private String url = "";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/Tag.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/Tag.java
index 7c22b4a1..536a3d2a 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/Tag.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/Tag.java
@@ -27,7 +27,8 @@ public class Tag extends ExtendableObject {
* Required. The name of the tag.
*/
@NotNull
- private String name;
+ @Builder.Default
+ private String name = "";
/**
* A short description for the tag. CommonMark syntax can be used for rich text representation.
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/ChannelItem.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/ChannelItem.java
index 4aec38b0..369c4980 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/ChannelItem.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/ChannelItem.java
@@ -2,7 +2,7 @@
import com.asyncapi.v2.ExtendableObject;
import com.asyncapi.v2._0_0.jackson.model.channel.ChannelParametersDeserializer;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._0_0.model.channel.operation.Operation;
import com.asyncapi.v2.binding.channel.ChannelBinding;
import com.asyncapi.v2.jackson.binding.channel.ChannelBindingsDeserializer;
@@ -64,9 +64,9 @@ public class ChannelItem extends ExtendableObject {
/**
* A map of the parameters included in the channel name.
* It SHOULD be present only when using channels with expressions (as defined by RFC 6570 section 2.2).
- *
+ *
* This map MUST contain all the parameters used in the parent channel name.
- *
+ *
* MUST BE:
*
* {@link Reference}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/Parameter.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/Parameter.java
index 09b07170..2b5e192f 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/Parameter.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/Parameter.java
@@ -40,7 +40,7 @@ public class Parameter extends ExtendableObject {
/**
* A runtime expression that specifies the location of the parameter value.
- *
+ *
* Even when a definition for the target field exists, it MUST NOT be used to validate this parameter but,
* instead, the schema property MUST be used.
*/
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/message/CorrelationId.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/message/CorrelationId.java
index 92aa9d96..56f008a7 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/message/CorrelationId.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/message/CorrelationId.java
@@ -33,10 +33,11 @@ public class CorrelationId extends ExtendableObject {
/**
* REQUIRED.
- *
+ *
* A runtime expression that specifies the location of the correlation ID.
*/
@NotNull
- private String location;
+ @Builder.Default
+ private String location = "";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/message/Message.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/message/Message.java
index 5a045617..7f68d20b 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/message/Message.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/message/Message.java
@@ -6,7 +6,7 @@
import com.asyncapi.v2._0_0.jackson.model.channel.message.MessagePayloadDeserializer;
import com.asyncapi.v2._0_0.jackson.model.channel.message.MessageTraitsDeserializer;
import com.asyncapi.v2._0_0.model.ExternalDocumentation;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._0_0.model.Tag;
import com.asyncapi.v2.schema.Schema;
import com.asyncapi.v2.binding.message.MessageBinding;
@@ -40,7 +40,7 @@ public class Message extends ExtendableObject {
/**
* Schema definition of the application headers. Schema MUST be of type "object".
* It MUST NOT define the protocol headers.
- *
+ *
* MUST BE:
*
* {@link Schema}
@@ -53,7 +53,7 @@ public class Message extends ExtendableObject {
/**
* Definition of the message payload. It can be of any type but defaults to Schema object.
- *
+ *
* WILL BE:
*
* {@link Schema}
@@ -66,7 +66,7 @@ public class Message extends ExtendableObject {
/**
* Definition of the correlation ID used for message tracing or matching.
- *
+ *
* MUST BE:
*
* {@link CorrelationId}
@@ -82,7 +82,7 @@ public class Message extends ExtendableObject {
* A string containing the name of the schema format used to define the message payload. If omitted,
* implementations should parse the payload as a Schema object. Check out the supported schema formats
* table for more information. Custom values are allowed but their implementation is OPTIONAL.
- *
+ *
* A custom value MUST NOT refer to one of the schema formats listed in the table.
*/
@Nullable
@@ -161,7 +161,7 @@ public class Message extends ExtendableObject {
/**
* A list of traits to apply to the message object. Traits MUST be merged into the message object using the JSON
* Merge Patch algorithm in the same order they are defined here. The resulting object MUST be a valid Message
- *
+ *
* MUST BE:
*
* {@link Reference}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/message/MessageTrait.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/message/MessageTrait.java
index 34f717a9..a762936a 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/message/MessageTrait.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/message/MessageTrait.java
@@ -4,7 +4,7 @@
import com.asyncapi.v2._0_0.jackson.model.channel.message.MessageCorrelationIdDeserializer;
import com.asyncapi.v2._0_0.jackson.model.channel.message.MessageHeadersDeserializer;
import com.asyncapi.v2._0_0.model.ExternalDocumentation;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._0_0.model.Tag;
import com.asyncapi.v2._0_0.model.channel.operation.OperationTrait;
import com.asyncapi.v2.schema.Schema;
@@ -44,7 +44,7 @@ public class MessageTrait extends ExtendableObject {
/**
* Schema definition of the application headers. Schema MUST be of type "object".
* It MUST NOT define the protocol headers.
- *
+ *
* MUST BE:
*
* {@link Schema}
@@ -57,7 +57,7 @@ public class MessageTrait extends ExtendableObject {
/**
* Definition of the correlation ID used for message tracing or matching.
- *
+ *
* MUST BE:
*
* {@link CorrelationId}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/operation/Operation.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/operation/Operation.java
index 118fc44d..1a243f9d 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/operation/Operation.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/operation/Operation.java
@@ -4,7 +4,7 @@
import com.asyncapi.v2._0_0.jackson.model.channel.operation.OperationMessageDeserializer;
import com.asyncapi.v2._0_0.jackson.model.channel.operation.OperationTraitsDeserializer;
import com.asyncapi.v2._0_0.model.ExternalDocumentation;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._0_0.model.Tag;
import com.asyncapi.v2._0_0.model.channel.message.Message;
import com.asyncapi.v2.binding.operation.OperationBinding;
@@ -40,7 +40,7 @@ public class Operation extends ExtendableObject {
/**
* Unique string used to identify the operation.
- *
+ *
* The id MUST be unique among all operations described in the API. The operationId value is case-sensitive.
* Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED
* to follow common programming naming conventions.
@@ -75,7 +75,7 @@ public class Operation extends ExtendableObject {
/**
* A map where the keys describe the name of the protocol and the values describe protocol-specific definitions
* for the operation.
- *
+ *
* Map describing protocol-specific definitions for an operation.
*/
@Nullable
@@ -85,7 +85,7 @@ public class Operation extends ExtendableObject {
/**
* A list of traits to apply to the operation object. Traits MUST be merged into the operation object using the
* JSON Merge Patch algorithm in the same order they are defined here.
- *
+ *
* MUST BE:
*
* {@link Reference}
@@ -99,7 +99,7 @@ public class Operation extends ExtendableObject {
/**
* A definition of the message that will be published or received on this channel. oneOf is allowed here to
* specify multiple messages, however, a message MUST be valid only against one of the referenced message objects.
- *
+ *
* MUST BE:
*
* {@link Reference}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/operation/OperationTrait.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/operation/OperationTrait.java
index 24f80145..d66d74e3 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/operation/OperationTrait.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/channel/operation/OperationTrait.java
@@ -39,7 +39,7 @@ public class OperationTrait extends ExtendableObject {
/**
* Unique string used to identify the operation.
- *
+ *
* The id MUST be unique among all operations described in the API. The operationId value is case-sensitive.
* Tools and libraries MAY use the operationId to uniquely identify an operation, therefore, it is RECOMMENDED
* to follow common programming naming conventions.
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/component/Components.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/component/Components.java
index 4c3f639c..c6f4660d 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/component/Components.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/component/Components.java
@@ -5,7 +5,7 @@
import com.asyncapi.v2._0_0.jackson.model.component.ComponentsParametersDeserializer;
import com.asyncapi.v2._0_0.jackson.model.component.ComponentsSchemasDeserializer;
import com.asyncapi.v2._0_0.jackson.model.component.ComponentsSecuritySchemesDeserializer;
-import com.asyncapi.v2._0_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._0_0.model.channel.Parameter;
import com.asyncapi.v2._0_0.model.channel.message.CorrelationId;
import com.asyncapi.v2._0_0.model.channel.message.Message;
@@ -49,7 +49,7 @@ public class Components extends ExtendableObject {
/**
* An object to hold reusable Schema Objects.
- *
+ *
* MUST BE:
*
* {@link Schema}
@@ -62,7 +62,7 @@ public class Components extends ExtendableObject {
/**
* An object to hold reusable Message Objects.
- *
+ *
* MUST BE:
*
* {@link Message}
@@ -75,7 +75,7 @@ public class Components extends ExtendableObject {
/**
* An object to hold reusable Security Scheme Objects.
- *
+ *
* MUST BE:
*
* {@link SecurityScheme}
@@ -88,7 +88,7 @@ public class Components extends ExtendableObject {
/**
* An object to hold reusable Parameter Objects.
- *
+ *
* MUST BE:
*
* {@link Reference}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/info/Info.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/info/Info.java
index 9bbe7ca3..61a5a338 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/info/Info.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/info/Info.java
@@ -26,21 +26,23 @@ public class Info extends ExtendableObject {
/**
* Required.
- *
+ *
* The title of the application.
*/
@NotNull
@JsonProperty
- private String title;
+ @Builder.Default
+ private String title = "";
/**
* Required.
- *
+ *
* Provides the version of the application API (not to be confused with the specification version).
*/
@NotNull
@JsonProperty
- private String version;
+ @Builder.Default
+ private String version = "";
/**
* A short description of the application. CommonMark syntax can be used for rich text representation.
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/info/License.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/info/License.java
index 14780d5c..dfb6c6c4 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/info/License.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/info/License.java
@@ -27,7 +27,8 @@ public class License extends ExtendableObject {
* Required. The license name used for the API.
*/
@NotNull
- private String name;
+ @Builder.Default
+ private String name = "";
/**
* A URL to the license used for the API. MUST be in the format of a URL.
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/server/Server.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/server/Server.java
index 36cedb5e..4d707b5a 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/server/Server.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/server/Server.java
@@ -35,24 +35,26 @@ public class Server extends ExtendableObject {
/**
* REQUIRED.
- *
+ *
* A URL to the target host. This URL supports Server Variables and MAY be relative, to indicate that the host
* location is relative to the location where the AsyncAPI document is being served. Variable substitutions will be
* made when a variable is named in {brackets}.
*/
@NotNull
@JsonProperty
- private String url;
+ @Builder.Default
+ private String url = "";
/**
* REQUIRED.
- *
+ *
* The protocol this URL supports for connection. Supported protocol include, but are not limited to:
* amqp, amqps, http, https, jms, kafka, kafka-secure, mqtt, secure-mqtt, stomp, stomps, ws, wss.
*/
@NotNull
@JsonProperty
- private String protocol;
+ @Builder.Default
+ private String protocol = "";
/**
* The version of the protocol used for connection. For instance: AMQP 0.9.1, HTTP 2.0, Kafka 1.0.0, etc.
@@ -80,10 +82,10 @@ public class Server extends ExtendableObject {
* A declaration of which security mechanisms can be used with this server. The list of values includes alternative
* security requirement objects that can be used. Only one of the security requirement objects need to be satisfied
* to authorize a connection or operation.
- *
+ *
* Lists the required security schemes to execute this operation. The name used for each property MUST correspond
* to a security scheme declared in the Security Schemes under the Components Object.
- *
+ *
* When a list of Security Requirement Objects is defined on a Server object, only one of the Security Requirement
* Objects in the list needs to be satisfied to authorize the connection.
*/
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/ChannelParametersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/ChannelParametersDeserializer.java
index 92f9efb7..9bdc2bad 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/ChannelParametersDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/ChannelParametersDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.channel;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.channel.Parameter;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessageCorrelationIdDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessageCorrelationIdDeserializer.java
index c0504a4f..03003e13 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessageCorrelationIdDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessageCorrelationIdDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.channel.message;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.channel.message.CorrelationId;
import com.asyncapi.v2.jackson.ReferenceOrObjectDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessageHeadersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessageHeadersDeserializer.java
index 900a3029..0fa2e91a 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessageHeadersDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessageHeadersDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.channel.message;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2.schema.Schema;
import com.asyncapi.v2.jackson.ReferenceOrObjectDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessageTraitsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessageTraitsDeserializer.java
index ce9c94ba..14099ba2 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessageTraitsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessageTraitsDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.channel.message;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.channel.message.MessageTrait;
import com.asyncapi.v2.jackson.ListOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessagesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessagesDeserializer.java
index 491c423c..12643960 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessagesDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/message/MessagesDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.channel.message;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.channel.message.Message;
import com.asyncapi.v2.jackson.ListOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/operation/OperationMessageDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/operation/OperationMessageDeserializer.java
index 1bcfc2c0..cccadb79 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/operation/OperationMessageDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/operation/OperationMessageDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.channel.operation;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.channel.message.Message;
import com.asyncapi.v2._6_0.model.channel.message.OneOfMessages;
import com.fasterxml.jackson.core.JsonParser;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/operation/OperationTraitsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/operation/OperationTraitsDeserializer.java
index 4380dd69..73df461f 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/operation/OperationTraitsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/channel/operation/OperationTraitsDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.channel.operation;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.channel.operation.OperationTrait;
import com.asyncapi.v2.jackson.ListOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsCorrelationIdsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsCorrelationIdsDeserializer.java
index 61e64fd1..8a371a57 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsCorrelationIdsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsCorrelationIdsDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.component;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.channel.message.CorrelationId;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsMessageTraitsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsMessageTraitsDeserializer.java
index 565cfb96..4b74a8f7 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsMessageTraitsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsMessageTraitsDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.component;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.channel.message.MessageTrait;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsMessagesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsMessagesDeserializer.java
index 1458b780..17e779e2 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsMessagesDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsMessagesDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.component;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.channel.message.Message;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsOperationTraitsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsOperationTraitsDeserializer.java
index 62d33c6d..f9f33397 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsOperationTraitsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsOperationTraitsDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.component;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.channel.operation.OperationTrait;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsParametersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsParametersDeserializer.java
index e3f573de..e11cc46f 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsParametersDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsParametersDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.component;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.channel.Parameter;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsSchemasDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsSchemasDeserializer.java
index 8c0fcd96..d6dd235c 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsSchemasDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsSchemasDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.component;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2.schema.Schema;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsSecuritySchemesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsSecuritySchemesDeserializer.java
index ff674c0e..8b045902 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsSecuritySchemesDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsSecuritySchemesDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.component;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
import com.asyncapi.v2.security_scheme.SecurityScheme;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsServerVariablesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsServerVariablesDeserializer.java
index 1919c12e..1b056b6f 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsServerVariablesDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsServerVariablesDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.component;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.server.ServerVariable;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsServersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsServersDeserializer.java
index 606aa5e3..b7a7c2fc 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsServersDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/component/ComponentsServersDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.component;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.server.Server;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/schema/SchemaDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/schema/SchemaDeserializer.java
index f4c30c52..81940260 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/schema/SchemaDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/schema/SchemaDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.schema;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2.schema.Schema;
import com.asyncapi.v2.jackson.ReferenceOrObjectDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/server/ServerVariablesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/server/ServerVariablesDeserializer.java
index 2f45dd75..9611dfad 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/server/ServerVariablesDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/server/ServerVariablesDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.server;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.server.ServerVariable;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/server/ServersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/server/ServersDeserializer.java
index 8be7037e..17053961 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/server/ServersDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/jackson/model/server/ServersDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2._6_0.jackson.model.server;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2._6_0.model.server.Server;
import com.asyncapi.v2.jackson.MapOfReferencesOrObjectsDeserializer;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/AsyncAPI.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/AsyncAPI.java
index 716b5338..017409dd 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/AsyncAPI.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/AsyncAPI.java
@@ -1,10 +1,12 @@
package com.asyncapi.v2._6_0.model;
import com.asyncapi.v2.ExtendableObject;
+import com.asyncapi.v2._6_0.jackson.model.server.ServersDeserializer;
import com.asyncapi.v2._6_0.model.channel.ChannelItem;
import com.asyncapi.v2._6_0.model.component.Components;
import com.asyncapi.v2._6_0.model.info.Info;
import com.asyncapi.v2._6_0.model.server.Server;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -13,6 +15,7 @@
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
+import java.util.HashMap;
import java.util.List;
import java.util.Map;
@@ -44,7 +47,8 @@ public class AsyncAPI extends ExtendableObject {
* Patch versions will correspond to patches of this document.
*/
@NotNull
- private String asyncapi = "2.6.0";
+ @Builder.Default
+ private final String asyncapi = "2.6.0";
/**
* Identifier of the application the AsyncAPI document is defining.
@@ -64,14 +68,20 @@ public class AsyncAPI extends ExtendableObject {
* Provides metadata about the API. The metadata can be used by the clients if needed.
*/
@NotNull
- private Info info;
+ @Builder.Default
+ private Info info = new Info();
/**
- * TODO: references
* Provides connection details of servers.
+ * MUST BE:
+ *
+ * {@link Server}
+ * {@link com.asyncapi.v2.Reference}
+ *
*/
@Nullable
- private Map servers;
+ @JsonDeserialize(using = ServersDeserializer.class)
+ private Map servers;
/**
* A string representing the default content type to use when encoding/decoding a message's payload.
@@ -93,7 +103,8 @@ public class AsyncAPI extends ExtendableObject {
* Channels are also known as "topics", "routing keys", "event types" or "paths".
*/
@NotNull
- private Map channels;
+ @Builder.Default
+ private Map channels = new HashMap<>();
/**
* An element to hold various schemas for the specification.
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/ExternalDocumentation.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/ExternalDocumentation.java
index 2d4e58ad..d9023f23 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/ExternalDocumentation.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/ExternalDocumentation.java
@@ -35,6 +35,7 @@ public class ExternalDocumentation extends ExtendableObject {
* The URL for the target documentation. Value MUST be in the format of a URL.
*/
@NotNull
- private String url;
+ @Builder.Default
+ private String url = "";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/Tag.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/Tag.java
index 565aa50f..f441e6ab 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/Tag.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/Tag.java
@@ -27,7 +27,8 @@ public class Tag extends ExtendableObject {
* Required. The name of the tag.
*/
@NotNull
- private String name;
+ @Builder.Default
+ private String name = "";
/**
* A short description for the tag. CommonMark syntax can be used for rich text representation.
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/ChannelItem.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/ChannelItem.java
index 787d651c..57fcad88 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/ChannelItem.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/ChannelItem.java
@@ -73,7 +73,7 @@ public class ChannelItem extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link com.asyncapi.v2._6_0.model.channel.Parameter}
*
*/
@@ -86,7 +86,7 @@ public class ChannelItem extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link ChannelBinding}
*
*/
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/Parameter.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/Parameter.java
index 16f2a618..e14cc2d9 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/Parameter.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/Parameter.java
@@ -35,7 +35,7 @@ public class Parameter extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link com.asyncapi.v2.schema.Schema}
*
*/
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/CorrelationId.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/CorrelationId.java
index 66bf407e..c88a7415 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/CorrelationId.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/CorrelationId.java
@@ -37,6 +37,7 @@ public class CorrelationId extends ExtendableObject {
* A runtime expression that specifies the location of the correlation ID.
*/
@NotNull
- private String location;
+ @Builder.Default
+ private String location = "";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/Message.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/Message.java
index eec867c6..6db494a8 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/Message.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/Message.java
@@ -51,7 +51,7 @@ public class Message extends ExtendableObject {
* MUST BE:
*
* {@link com.asyncapi.v2.schema.Schema}
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
*
*/
@Nullable
@@ -78,7 +78,7 @@ public class Message extends ExtendableObject {
* MUST BE:
*
* {@link com.asyncapi.v2._6_0.model.channel.message.CorrelationId}
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
*
*/
@Nullable
@@ -149,7 +149,7 @@ public class Message extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link MessageBinding}
*
*/
@@ -170,7 +170,7 @@ public class Message extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link com.asyncapi.v2._6_0.model.channel.message.MessageTrait}
*
*/
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/MessageTrait.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/MessageTrait.java
index 22420d52..e4fba669 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/MessageTrait.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/MessageTrait.java
@@ -55,7 +55,7 @@ public class MessageTrait extends ExtendableObject {
* MUST BE:
*
* {@link com.asyncapi.v2.schema.Schema}
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
*
*/
@Nullable
@@ -68,7 +68,7 @@ public class MessageTrait extends ExtendableObject {
* MUST BE:
*
* {@link com.asyncapi.v2._6_0.model.channel.message.CorrelationId}
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
*
*/
@Nullable
@@ -139,7 +139,7 @@ public class MessageTrait extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link MessageBinding}
*
*/
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/OneOfMessages.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/OneOfMessages.java
index 816d1c0a..4261338f 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/OneOfMessages.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/message/OneOfMessages.java
@@ -9,6 +9,7 @@
import lombok.NoArgsConstructor;
import org.jetbrains.annotations.NotNull;
+import java.util.LinkedList;
import java.util.List;
/**
@@ -25,12 +26,13 @@ public class OneOfMessages {
* Given message MUST be one of provided messages.
*
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link com.asyncapi.v2._6_0.model.channel.message.Message}
*
*/
@NotNull
+ @Builder.Default
@JsonDeserialize(using = MessagesDeserializer.class)
- private List oneOf;
+ private List oneOf = new LinkedList<>();
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/operation/Operation.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/operation/Operation.java
index a5ff9fb7..0a94bdb7 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/operation/Operation.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/operation/Operation.java
@@ -87,7 +87,7 @@ public class Operation extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link OperationBinding}
*
*/
@@ -101,7 +101,7 @@ public class Operation extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link com.asyncapi.v2._6_0.model.channel.operation.OperationTrait}
*
*/
@@ -116,7 +116,7 @@ public class Operation extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link com.asyncapi.v2._6_0.model.channel.message.Message}
* {@link com.asyncapi.v2._6_0.model.channel.message.OneOfMessages}
*
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/operation/OperationTrait.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/operation/OperationTrait.java
index 22a5e623..aee233b5 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/operation/OperationTrait.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/channel/operation/OperationTrait.java
@@ -92,7 +92,7 @@ public class OperationTrait extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link OperationBinding}
*
*/
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/component/Components.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/component/Components.java
index 4a9a8bef..99b5ec1a 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/component/Components.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/component/Components.java
@@ -52,7 +52,7 @@ public class Components extends ExtendableObject {
* MUST BE:
*
* {@link com.asyncapi.v2.schema.Schema}
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
*
*/
@Nullable
@@ -65,7 +65,7 @@ public class Components extends ExtendableObject {
* MUST BE:
*
* {@link com.asyncapi.v2._6_0.model.server.Server}
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
*
*/
@Nullable
@@ -78,7 +78,7 @@ public class Components extends ExtendableObject {
* MUST BE:
*
* {@link com.asyncapi.v2._6_0.model.server.ServerVariable}
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
*
*/
@Nullable
@@ -96,7 +96,7 @@ public class Components extends ExtendableObject {
* MUST BE:
*
* {@link com.asyncapi.v2._6_0.model.channel.message.Message}
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
*
*/
@Nullable
@@ -109,7 +109,7 @@ public class Components extends ExtendableObject {
* MUST BE:
*
* {@link SecurityScheme}
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
*
*/
@Nullable
@@ -121,7 +121,7 @@ public class Components extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link com.asyncapi.v2._6_0.model.channel.Parameter}
*
*/
@@ -134,7 +134,7 @@ public class Components extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link com.asyncapi.v2._6_0.model.channel.message.CorrelationId}
*
*/
@@ -147,7 +147,7 @@ public class Components extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link com.asyncapi.v2._6_0.model.channel.operation.OperationTrait}
*
*/
@@ -160,7 +160,7 @@ public class Components extends ExtendableObject {
*
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link com.asyncapi.v2._6_0.model.channel.message.MessageTrait}
*
*/
@@ -172,7 +172,7 @@ public class Components extends ExtendableObject {
* An object to hold reusable {@link ServerBinding} Objects.
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link ServerBinding}
*
*/
@@ -184,7 +184,7 @@ public class Components extends ExtendableObject {
* An object to hold reusable {@link ChannelBinding} Objects.
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link ChannelBinding}
*
*/
@@ -196,7 +196,7 @@ public class Components extends ExtendableObject {
* An object to hold reusable {@link OperationBinding} Objects.
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link OperationBinding}
*
*/
@@ -208,7 +208,7 @@ public class Components extends ExtendableObject {
* An object to hold reusable {@link MessageBinding} Objects.
* MUST BE:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link MessageBinding}
*
*/
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/info/Info.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/info/Info.java
index d82738ad..0d659fa6 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/info/Info.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/info/Info.java
@@ -29,7 +29,8 @@ public class Info extends ExtendableObject {
* The title of the application.
*/
@NotNull
- private String title;
+ @Builder.Default
+ private String title = "";
/**
* Required.
@@ -37,7 +38,8 @@ public class Info extends ExtendableObject {
* Provides the version of the application API (not to be confused with the specification version).
*/
@NotNull
- private String version;
+ @Builder.Default
+ private String version = "";
/**
* A short description of the application. CommonMark syntax can be used for rich text representation.
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/info/License.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/info/License.java
index c5191c16..aa38568a 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/info/License.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/info/License.java
@@ -27,7 +27,8 @@ public class License extends ExtendableObject {
* Required. The license name used for the API.
*/
@NotNull
- private String name;
+ @Builder.Default
+ private String name = "";
/**
* A URL to the license used for the API. MUST be in the format of a URL.
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/server/Server.java b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/server/Server.java
index cf9a6a4d..21e2ad1e 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/server/Server.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/_6_0/model/server/Server.java
@@ -42,7 +42,8 @@ public class Server extends ExtendableObject {
* made when a variable is named in {brackets}.
*/
@NotNull
- private String url;
+ @Builder.Default
+ private String url = "";
/**
* REQUIRED.
@@ -51,7 +52,8 @@ public class Server extends ExtendableObject {
* amqp, amqps, http, https, ibmmq, jms, kafka, kafka-secure, anypointmq, mqtt, secure-mqtt, solace, stomp, stomps, ws, wss, mercure, googlepubsub, pulsar.
*/
@NotNull
- private String protocol;
+ @Builder.Default
+ private String protocol = "";
/**
* The version of the protocol used for connection. For instance: AMQP 0.9.1, HTTP 2.0, Kafka 1.0.0, etc.
@@ -71,7 +73,7 @@ public class Server extends ExtendableObject {
*
* MUST be one of:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link com.asyncapi.v2._6_0.model.server.ServerVariable}
*
*/
@@ -105,7 +107,7 @@ public class Server extends ExtendableObject {
*
* MUST be one of:
*
- * {@link com.asyncapi.v2._6_0.model.Reference}
+ * {@link com.asyncapi.v2.Reference}
* {@link ServerBinding}
*
*/
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/AMQPChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/AMQPChannelBinding.java
index 8616e337..616b92ba 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/AMQPChannelBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/AMQPChannelBinding.java
@@ -1,11 +1,17 @@
package com.asyncapi.v2.binding.channel.amqp;
import com.asyncapi.v2.binding.channel.ChannelBinding;
+import com.asyncapi.v2.binding.channel.amqp.exchange.AMQPChannelExchangeProperties;
+import com.asyncapi.v2.binding.channel.amqp.queue.AMQPChannelQueueProperties;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
/**
@@ -22,108 +28,39 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes AMQP 0-9-1 channel binding.")
public class AMQPChannelBinding extends ChannelBinding {
/**
* Defines what type of channel is it. Can be either queue or routingKey (default).
*/
- @Nullable
- private String is;
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "is", required = true, defaultValue = "routingKey")
+ @JsonPropertyDescription("Defines what type of channel is it. Can be either queue or routingKey (default).")
+ private AMQPChannelType is = AMQPChannelType.ROUTING_KEY;
/**
* When is=routingKey, this object defines the exchange properties.
*/
@Nullable
- private ExchangeProperties exchange;
+ @JsonProperty("exchange")
+ @JsonPropertyDescription("When is=routingKey, this object defines the exchange properties.")
+ private AMQPChannelExchangeProperties exchange;
/**
* When is=queue, this object defines the queue properties.
*/
@Nullable
- private QueueProperties queue;
+ @JsonProperty("queue")
+ @JsonPropertyDescription("When is=queue, this object defines the queue properties.")
+ private AMQPChannelQueueProperties queue;
@Nullable
@Builder.Default
- private String bindingVersion = "0.2.0";
-
- @Data
- @Builder
- @NoArgsConstructor
- @AllArgsConstructor
- @EqualsAndHashCode
- public static class ExchangeProperties {
-
- /**
- * The name of the exchange. It MUST NOT exceed 255 characters long.
- */
- @Nullable
- private String name;
-
- /**
- * The type of the exchange. Can be either topic, direct, fanout, default or headers.
- */
- @Nullable
- private String type;
-
- /**
- * Whether the exchange should survive broker restarts or not.
- */
- @Nullable
- private Boolean durable;
-
- /**
- * Whether the exchange should be deleted when the last queue is unbound from it.
- */
- @Nullable
- private Boolean autoDelete;
-
- /**
- * The virtual host of the exchange. Defaults to /.
- */
- @Nullable
- @Builder.Default
- private String vhost = "/";
-
- }
-
- @Data
- @Builder
- @NoArgsConstructor
- @AllArgsConstructor
- @EqualsAndHashCode
- public static class QueueProperties {
-
- /**
- * The name of the queue. It MUST NOT exceed 255 characters long.
- */
- @Nullable
- private String name;
-
- /**
- * Whether the queue should survive broker restarts or not.
- */
- @Nullable
- private Boolean durable;
-
- /**
- * Whether the queue should be used only by one connection or not.
- */
- @Nullable
- private Boolean exclusive;
-
- /**
- * Whether the queue should be deleted when the last consumer unsubscribes.
- */
- @Nullable
- private Boolean autoDelete;
-
- /**
- * The virtual host of the queue. Defaults to /.
- */
- @Nullable
- @Builder.Default
- private String vhost = "/";
-
- }
+ @JsonProperty(value = "bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private final String bindingVersion = "0.2.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/AMQPChannelType.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/AMQPChannelType.java
new file mode 100644
index 00000000..82d13019
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/AMQPChannelType.java
@@ -0,0 +1,24 @@
+package com.asyncapi.v2.binding.channel.amqp;
+
+import com.fasterxml.jackson.annotation.JsonAlias;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes AMQP 0-9-1 channel type.
+ *
+ * Contains information about the type of channel in AMQP.
+ *
+ * @version 0.2.0
+ * @see AMQP channel binding
+ * @author Pavel Bodiachevskii
+ */
+public enum AMQPChannelType {
+
+ @JsonProperty("queue")
+ QUEUE,
+
+ @JsonProperty("routingKey")
+ @JsonAlias("routingKey")
+ ROUTING_KEY
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/exchange/AMQPChannelExchangeProperties.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/exchange/AMQPChannelExchangeProperties.java
new file mode 100644
index 00000000..6b07844d
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/exchange/AMQPChannelExchangeProperties.java
@@ -0,0 +1,75 @@
+package com.asyncapi.v2.binding.channel.amqp.exchange;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes AMQP 0-9-1 channel exchange properties.
+ *
+ * Contains information about the channel exchange properties in AMQP.
+ *
+ * @version 0.2.0
+ * @see AMQP channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describes AMQP 0-9-1 channel exchange properties.")
+public class AMQPChannelExchangeProperties {
+
+ /**
+ * The name of the exchange. It MUST NOT exceed 255 characters long.
+ */
+ @Nullable
+ @javax.validation.constraints.Size(
+ max = 255,
+ message = "Exchange name must not exceed 255 characters long."
+ )
+ @JsonProperty("name")
+ @JsonPropertyDescription("The name of the exchange. It MUST NOT exceed 255 characters long.")
+ private String name;
+
+ /**
+ * The type of the exchange. Can be either topic, direct, fanout, default or headers.
+ */
+ @Nullable
+ @JsonProperty("type")
+ @JsonPropertyDescription("The type of the exchange. Can be either topic, direct, fanout, default or headers.")
+ private AMQPChannelExchangeType type;
+
+ /**
+ * Whether the exchange should survive broker restarts or not.
+ */
+ @Nullable
+ @JsonProperty("durable")
+ @JsonPropertyDescription("Whether the exchange should survive broker restarts or not.")
+ private Boolean durable;
+
+ /**
+ * Whether the exchange should be deleted when the last queue is unbound from it.
+ */
+ @Nullable
+ @JsonProperty("autoDelete")
+ @JsonPropertyDescription("Whether the exchange should be deleted when the last queue is unbound from it.")
+ private Boolean autoDelete;
+
+ /**
+ * The virtual host of the exchange. Defaults to /.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "vhost", defaultValue = "/")
+ @JsonPropertyDescription("The virtual host of the exchange. Defaults to /.")
+ private String vhost = "/";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/exchange/AMQPChannelExchangeType.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/exchange/AMQPChannelExchangeType.java
new file mode 100644
index 00000000..373cff20
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/exchange/AMQPChannelExchangeType.java
@@ -0,0 +1,33 @@
+package com.asyncapi.v2.binding.channel.amqp.exchange;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes AMQP 0-9-1 channel exchange type.
+ *
+ * Contains information about the channel exchange type in AMQP.
+ *
+ * @version 0.2.0
+ * @see AMQP channel binding
+ * @author Pavel Bodiachevskii
+ */
+@JsonClassDescription("Describes AMQP 0-9-1 channel exchange type.")
+public enum AMQPChannelExchangeType {
+
+ @JsonProperty("topic")
+ TOPIC,
+
+ @JsonProperty("direct")
+ DIRECT,
+
+ @JsonProperty("fanout")
+ FANOUT,
+
+ @JsonProperty("default")
+ DEFAULT,
+
+ @JsonProperty("headers")
+ HEADERS
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/queue/AMQPChannelQueueProperties.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/queue/AMQPChannelQueueProperties.java
new file mode 100644
index 00000000..f3a1e09c
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/amqp/queue/AMQPChannelQueueProperties.java
@@ -0,0 +1,75 @@
+package com.asyncapi.v2.binding.channel.amqp.queue;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes AMQP 0-9-1 channel queue properties.
+ *
+ * Contains information about the queue exchange properties in AMQP.
+ *
+ * @version 0.2.0
+ * @see AMQP channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describes AMQP 0-9-1 channel queue properties.")
+public class AMQPChannelQueueProperties {
+
+ /**
+ * The name of the queue. It MUST NOT exceed 255 characters long.
+ */
+ @Nullable
+ @javax.validation.constraints.Size(
+ max = 255,
+ message = "Queue name must not exceed 255 characters long."
+ )
+ @JsonProperty("name")
+ @JsonPropertyDescription("The name of the queue. It MUST NOT exceed 255 characters long.")
+ private String name;
+
+ /**
+ * Whether the queue should survive broker restarts or not.
+ */
+ @Nullable
+ @JsonProperty("durable")
+ @JsonPropertyDescription("Whether the queue should survive broker restarts or not.")
+ private Boolean durable;
+
+ /**
+ * Whether the queue should be used only by one connection or not.
+ */
+ @Nullable
+ @JsonProperty("exclusive")
+ @JsonPropertyDescription("Whether the queue should be used only by one connection or not.")
+ private Boolean exclusive;
+
+ /**
+ * Whether the queue should be deleted when the last consumer unsubscribes.
+ */
+ @Nullable
+ @JsonProperty("autoDelete")
+ @JsonPropertyDescription("Whether the queue should be deleted when the last consumer unsubscribes.")
+ private Boolean autoDelete;
+
+ /**
+ * The virtual host of the queue. Defaults to /.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "vhost", defaultValue = "/")
+ @JsonPropertyDescription("The virtual host of the queue. Defaults to /.")
+ private String vhost = "/";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/anypointmq/AnypointMQChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/anypointmq/AnypointMQChannelBinding.java
index 3e1d3d54..790ef4c0 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/anypointmq/AnypointMQChannelBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/anypointmq/AnypointMQChannelBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.channel.anypointmq;
import com.asyncapi.v2.binding.channel.ChannelBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -20,6 +23,7 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Anypoint MQ channel binding.")
public class AnypointMQChannelBinding extends ChannelBinding {
/**
@@ -29,6 +33,8 @@ public class AnypointMQChannelBinding extends ChannelBinding {
* from the actual destination name, such as when the channel name is not a valid destination name in Anypoint MQ.
*/
@Nullable
+ @JsonProperty("destination")
+ @JsonPropertyDescription("The destination (queue or exchange) name for this channel. SHOULD only be specified if the channel name differs from the actual destination name, such as when the channel name is not a valid destination name in Anypoint MQ.")
private String destination;
/**
@@ -39,13 +45,18 @@ public class AnypointMQChannelBinding extends ChannelBinding {
* supported by this channel.
*/
@Nullable
- private String destinationType;
+ @Builder.Default
+ @JsonProperty(value = "destinationType", defaultValue = "queue")
+ @JsonPropertyDescription("The type of destination, which MUST be either exchange or queue or fifo-queue. SHOULD be specified to document the messaging model (publish/subscribe, point-to-point, strict message ordering) supported by this channel.")
+ private AnypointMQChannelDestinationType destinationType = AnypointMQChannelDestinationType.QUEUE;
/**
- * OPTIONAL, defaults to latest. The version of this binding.
+ * The version of this binding.
*/
@Nullable
@Builder.Default
+ @JsonProperty(value = "bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.0.1";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/anypointmq/AnypointMQChannelDestinationType.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/anypointmq/AnypointMQChannelDestinationType.java
new file mode 100644
index 00000000..0571f156
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/anypointmq/AnypointMQChannelDestinationType.java
@@ -0,0 +1,25 @@
+package com.asyncapi.v2.binding.channel.anypointmq;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes Anypoint MQ channel destination type.
+ *
+ * @version 0.0.1
+ * @see Anypoint MQ channel binding
+ * @author Pavel Bodiachevskii
+ */
+@JsonClassDescription("Describes Anypoint MQ channel destination type.")
+public enum AnypointMQChannelDestinationType {
+
+ @JsonProperty("exchange")
+ EXCHANGE,
+
+ @JsonProperty("queue")
+ QUEUE,
+
+ @JsonProperty("fifo-queue")
+ FIFO_QUEUE
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/googlepubsub/GooglePubSubChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/googlepubsub/GooglePubSubChannelBinding.java
index 89e05cfd..896a88b6 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/googlepubsub/GooglePubSubChannelBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/googlepubsub/GooglePubSubChannelBinding.java
@@ -1,20 +1,23 @@
package com.asyncapi.v2.binding.channel.googlepubsub;
import com.asyncapi.v2.binding.channel.ChannelBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
-import java.util.List;
import java.util.Map;
/**
- * The Channel Bindings Object is used to describe the Google Cloud Pub/Sub specific Topic details with AsyncAPI.
- *
* Describes Google Cloud Pub/Sub channel binding.
+ *
+ * The Channel Bindings Object is used to describe the Google Cloud Pub/Sub specific Topic details with AsyncAPI.
*
* @version 0.1.0
* @see Google Cloud Pub/Sub channel binding
@@ -25,96 +28,60 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Google Cloud Pub/Sub channel binding.")
public class GooglePubSubChannelBinding extends ChannelBinding {
/**
- * The Google Cloud Pub/Sub Topic name
+ * The Google Cloud Pub/Sub Topic name.
*/
- private String topic;
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "topic", required = true)
+ @JsonPropertyDescription("The Google Cloud Pub/Sub Topic name.")
+ private String topic = "";
/**
* An object of key-value pairs (These are used to categorize Cloud Resources like Cloud Pub/Sub Topics.)
*/
@Nullable
+ @JsonProperty("labels")
+ @JsonPropertyDescription("An object of key-value pairs (These are used to categorize Cloud Resources like Cloud Pub/Sub Topics.)")
private Map labels;
/**
* Indicates the minimum duration to retain a message after it is published to the topic (Must be a valid Duration .)
*/
@Nullable
+ @JsonProperty("messageRetentionDuration")
+ @JsonPropertyDescription("Indicates the minimum duration to retain a message after it is published to the topic (Must be a valid https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration.)")
private String messageRetentionDuration;
/**
* Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored
*/
@Nullable
- private MessageStoragePolicy messageStoragePolicy;
+ @JsonProperty("messageStoragePolicy")
+ @JsonPropertyDescription("Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored")
+ private GooglePubSubChannelMessageStoragePolicy messageStoragePolicy;
/**
* Settings for validating messages published against a schema
*/
- @Nullable
- private SchemaSettings schemaSettings;
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "schemaSettings", required = true)
+ @JsonPropertyDescription("Settings for validating messages published against a schema")
+ private GooglePubSubChannelSchemaSettings schemaSettings = new GooglePubSubChannelSchemaSettings();
/**
- * OPTIONAL, defaults to latest. The version of this binding.
+ * The version of this binding.
*/
@Nullable
@Builder.Default
+ @JsonProperty(value = "bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
- /**
- * The Message Storage Policy Object is used to describe the Google Cloud Pub/Sub MessageStoragePolicy Object with AsyncAPI.
- */
- @Data
- @Builder
- @NoArgsConstructor
- @AllArgsConstructor
- @EqualsAndHashCode
- public static class MessageStoragePolicy {
-
- /**
- * A list of IDs of GCP regions where messages that are published to the topic may be persisted in storage
- */
- @Nullable
- private List allowedPersistenceRegions;
-
- }
-
- /**
- * The Schema Settings Object is used to describe the Google Cloud Pub/Sub SchemaSettings Object with AsyncAPI.
- */
- @Data
- @Builder
- @NoArgsConstructor
- @AllArgsConstructor
- @EqualsAndHashCode
- public static class SchemaSettings {
-
- /**
- * The encoding of the message (Must be one of the possible Encoding values.)
- */
- @Nullable
- private String encoding;
-
- /**
- * The minimum (inclusive) revision allowed for validating messages
- */
- @Nullable
- private String firstRevisionId;
-
- /**
- * The maximum (inclusive) revision allowed for validating messages
- */
- @Nullable
- private String lastRevisionId;
-
- /**
- * The name of the schema that messages published should be validated against (The format is projects/{project}/schemas/{schema}.)
- */
- @Nullable
- private String name;
-
- }
-
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/googlepubsub/GooglePubSubChannelMessageStoragePolicy.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/googlepubsub/GooglePubSubChannelMessageStoragePolicy.java
new file mode 100644
index 00000000..9e988335
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/googlepubsub/GooglePubSubChannelMessageStoragePolicy.java
@@ -0,0 +1,40 @@
+package com.asyncapi.v2.binding.channel.googlepubsub;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * Describes Google Cloud Pub/Sub MessageStoragePolicy.
+ *
+ * The Message Storage Policy Object is used to describe the Google Cloud Pub/Sub MessageStoragePolicy Object with AsyncAPI.
+ *
+ * @version 0.1.0
+ * @see Google Cloud Pub/Sub channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describe the Google Cloud Pub/Sub MessageStoragePolicy")
+public class GooglePubSubChannelMessageStoragePolicy {
+
+ /**
+ * A list of IDs of GCP regions where messages that are published to the topic may be persisted in storage
+ */
+ @Nullable
+ @JsonProperty("allowedPersistenceRegions")
+ @JsonPropertyDescription("A list of IDs of GCP regions where messages that are published to the topic may be persisted in storage")
+ private List allowedPersistenceRegions;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/googlepubsub/GooglePubSubChannelSchemaSettings.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/googlepubsub/GooglePubSubChannelSchemaSettings.java
new file mode 100644
index 00000000..76e0fa79
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/googlepubsub/GooglePubSubChannelSchemaSettings.java
@@ -0,0 +1,63 @@
+package com.asyncapi.v2.binding.channel.googlepubsub;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Google Cloud Pub/Sub SchemaSettings.
+ *
+ * The Schema Settings Object is used to describe the Google Cloud Pub/Sub SchemaSettings Object with AsyncAPI.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describe the Google Cloud Pub/Sub SchemaSettings")
+public class GooglePubSubChannelSchemaSettings {
+
+ /**
+ * The encoding of the message (Must be one of the possible Encoding values.)
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "encoding", required = true)
+ @JsonPropertyDescription("The encoding of the message (Must be one of the possible https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.topics#encoding values.)")
+ private String encoding = "";
+
+ /**
+ * The minimum (inclusive) revision allowed for validating messages
+ */
+ @Nullable
+ @JsonProperty("firstRevisionId")
+ @JsonPropertyDescription("The minimum (inclusive) revision allowed for validating messages")
+ private String firstRevisionId;
+
+ /**
+ * The maximum (inclusive) revision allowed for validating messages
+ */
+ @Nullable
+ @JsonProperty("lastRevisionId")
+ @JsonPropertyDescription("The maximum (inclusive) revision allowed for validating messages")
+ private String lastRevisionId;
+
+ /**
+ * The name of the schema that messages published should be validated against (The format is projects/{project}/schemas/{schema}.)
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "name", required = true)
+ @JsonPropertyDescription("The name of the schema that messages published should be validated against (The format is projects/{project}/schemas/{schema}.)")
+ private String name = "";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelBinding.java
index 0a62e9f6..47d14e4f 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelBinding.java
@@ -1,12 +1,14 @@
package com.asyncapi.v2.binding.channel.ibmmq;
import com.asyncapi.v2.binding.channel.ChannelBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.NoArgsConstructor;
-import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
/**
@@ -23,6 +25,7 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes IBM MQ channel binding.")
public class IBMMQChannelBinding extends ChannelBinding {
/**
@@ -31,7 +34,10 @@ public class IBMMQChannelBinding extends ChannelBinding {
* MUST be either topic or queue. For type topic, the AsyncAPI channel name MUST be assumed for the IBM MQ topic string unless overridden.
*/
@Nullable
- private String destinationType;
+ @Builder.Default
+ @JsonProperty(value = "destinationType", defaultValue = "topic")
+ @JsonPropertyDescription("Defines the type of AsyncAPI channel.")
+ private IBMMQChannelDestinationType destinationType = IBMMQChannelDestinationType.TOPIC;
/**
* REQUIRED if destinationType = queue
@@ -39,7 +45,9 @@ public class IBMMQChannelBinding extends ChannelBinding {
* queue and topic fields MUST NOT coexist within a channel binding
*/
@Nullable
- private Queue queue;
+ @JsonProperty("queue")
+ @JsonPropertyDescription("Defines the properties of a queue.")
+ private IBMMQChannelQueueProperties queue;
/**
* Defines the properties of a topic.
@@ -49,7 +57,9 @@ public class IBMMQChannelBinding extends ChannelBinding {
* queue and topic fields MUST NOT coexist within a channel binding.
*/
@Nullable
- private Topic topic;
+ @JsonProperty("topic")
+ @JsonPropertyDescription("Defines the properties of a topic.")
+ private IBMMQChannelTopicProperties topic;
/**
* The maximum length of the physical message (in bytes) accepted by the Topic or Queue. Messages produced that are
@@ -59,97 +69,24 @@ public class IBMMQChannelBinding extends ChannelBinding {
* MUST be 0-104,857,600 bytes (100 MB).
*/
@Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "Maximum length of the physical message (in bytes) must be greater or equals to 0"
+ )
+ @javax.validation.constraints.Max(
+ value = 104857600,
+ message = "Maximum length of the physical message (in bytes) must be lower or equals to 104857600"
+ )
+ @JsonProperty("maxMsgLength")
+ @JsonPropertyDescription("The maximum length of the physical message (in bytes) accepted by the Topic or Queue. Messages produced that are greater in size than this value may fail to be delivered. More information on the maximum message length can be found on this [page](https://www.ibm.com/support/knowledgecenter/SSFKSJ_latest/com.ibm.mq.ref.dev.doc/q097520_.html) in the IBM MQ Knowledge Center.")
private Integer maxMsgLength;
/**
* The version of this binding.
*/
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
- /**
- * Defines the properties of a queue.
- */
- @Data
- @Builder
- @NoArgsConstructor
- @AllArgsConstructor
- @EqualsAndHashCode
- public static class Queue {
-
- /**
- * Defines the name of the IBM MQ queue associated with the channel.
- *
- * A value MUST be specified. MUST NOT exceed 48 characters in length. MUST be a valid IBM MQ queue name
- */
- @NotNull
- private String objectName;
-
- /**
- * Defines if the queue is a cluster queue and therefore partitioned. If true, a binding option MAY be specified
- * when accessing the queue. More information on binding options can be found on this page in the IBM MQ Knowledge Center.
- *
- * If false, binding options SHOULD NOT be specified when accessing the queue.
- */
- @Nullable
- @Builder.Default
- private Boolean isPartitioned = false;
-
- /**
- * Specifies if it is recommended to open the queue exclusively.
- */
- @Nullable
- @Builder.Default
- private Boolean exclusive = false;
-
- }
-
- /**
- * Defines the properties of a topic.
- */
- @Data
- @Builder
- @NoArgsConstructor
- @AllArgsConstructor
- @EqualsAndHashCode
- public static class Topic {
-
- /**
- * The value of the IBM MQ topic string to be used.
- *
- * OPTIONAL
- * Note: if specified, SHALL override AsyncAPI channel name.
- *
- * MUST NOT exceed 10240 characters in length. MAY coexist with topic.objectName
- */
- @Nullable
- private String string;
-
- /**
- * The name of the IBM MQ topic object.
- *
- * OPTIONAL
- * Note: if specified, SHALL override AsyncAPI channel name.
- *
- * MUST NOT exceed 48 characters in length. MAY coexist with topic.string
- */
- @Nullable
- private String objectName;
-
- /**
- * Defines if the subscription may be durable.
- */
- @Nullable
- @Builder.Default
- private Boolean durablePermitted = true;
-
- /**
- * Defines if the last message published will be made available to new subscriptions.
- */
- @Nullable
- @Builder.Default
- private Boolean lastMsgRetained = false;
-
- }
-
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelDestinationType.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelDestinationType.java
new file mode 100644
index 00000000..7b0d7058
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelDestinationType.java
@@ -0,0 +1,20 @@
+package com.asyncapi.v2.binding.channel.ibmmq;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes IBM MQ channel destination type.
+ *
+ * @version 0.1.0
+ * @see IBM MQ channel binding
+ * @author Pavel Bodiachevskii
+ */
+public enum IBMMQChannelDestinationType {
+
+ @JsonProperty("topic")
+ TOPIC,
+
+ @JsonProperty("queue")
+ QUEUE
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelQueueProperties.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelQueueProperties.java
new file mode 100644
index 00000000..fa06b6a2
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelQueueProperties.java
@@ -0,0 +1,66 @@
+package com.asyncapi.v2.binding.channel.ibmmq;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes IBM MQ channel queue properties.
+ *
+ * @version 0.1.0
+ * @see IBM MQ channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describes IBM MQ channel queue properties.")
+public class IBMMQChannelQueueProperties {
+
+ /**
+ * Defines the name of the IBM MQ queue associated with the channel.
+ *
+ * A value MUST be specified. MUST NOT exceed 48 characters in length. MUST be a valid IBM MQ queue name
+ */
+ @NotNull
+ @javax.validation.constraints.NotNull
+ @javax.validation.constraints.Size(
+ max = 48,
+ message = "Name of the IBM MQ queue must be less or equals to 48"
+ )
+ @Builder.Default
+ @JsonProperty("objectName")
+ @JsonPropertyDescription("Defines the name of the IBM MQ queue associated with the channel.")
+ private String objectName = "";
+
+ /**
+ * Defines if the queue is a cluster queue and therefore partitioned. If true, a binding option MAY be specified
+ * when accessing the queue. More information on binding options can be found on this page in the IBM MQ Knowledge Center.
+ *
+ * If false, binding options SHOULD NOT be specified when accessing the queue.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "isPartitioned", defaultValue = "false")
+ @JsonPropertyDescription("Defines if the queue is a cluster queue and therefore partitioned. If 'true', a binding option MAY be specified when accessing the queue. More information on binding options can be found on this page in the IBM MQ Knowledge Center.")
+ private Boolean isPartitioned = false;
+
+ /**
+ * Specifies if it is recommended to open the queue exclusively.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "exclusive", defaultValue = "false")
+ @JsonPropertyDescription("Specifies if it is recommended to open the queue exclusively.")
+ private Boolean exclusive = false;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelTopicProperties.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelTopicProperties.java
new file mode 100644
index 00000000..7d3b54b4
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ibmmq/IBMMQChannelTopicProperties.java
@@ -0,0 +1,78 @@
+package com.asyncapi.v2.binding.channel.ibmmq;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes IBM MQ channel topic properties.
+ *
+ * @version 0.1.0
+ * @see IBM MQ channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+public class IBMMQChannelTopicProperties {
+
+ /**
+ * The value of the IBM MQ topic string to be used.
+ *
+ * OPTIONAL
+ * Note: if specified, SHALL override AsyncAPI channel name.
+ *
+ * MUST NOT exceed 10240 characters in length. MAY coexist with topic.objectName
+ */
+ @Nullable
+ @javax.validation.constraints.Max(
+ value = 10240,
+ message = "Maximum length of topic string must be lower or equals to 10240"
+ )
+ @JsonProperty("string")
+ @JsonPropertyDescription("The value of the IBM MQ topic string to be used.")
+ private String string;
+
+ /**
+ * The name of the IBM MQ topic object.
+ *
+ * OPTIONAL
+ * Note: if specified, SHALL override AsyncAPI channel name.
+ *
+ * MUST NOT exceed 48 characters in length. MAY coexist with topic.string
+ */
+ @Nullable
+ @javax.validation.constraints.Max(
+ value = 48,
+ message = "Maximum length of topic name must be lower or equals to 48"
+ )
+ @JsonProperty("objectName")
+ @JsonPropertyDescription("The name of the IBM MQ topic object.")
+ private String objectName;
+
+ /**
+ * Defines if the subscription may be durable.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "durablePermitted", defaultValue = "true")
+ @JsonPropertyDescription("Defines if the subscription may be durable.")
+ private Boolean durablePermitted = true;
+
+ /**
+ * Defines if the last message published will be made available to new subscriptions.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "lastMsgRetained", defaultValue = "false")
+ @JsonPropertyDescription("Defines if the last message published will be made available to new subscriptions.")
+ private Boolean lastMsgRetained = false;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/kafka/KafkaChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/kafka/KafkaChannelBinding.java
index c625a04b..2408566b 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/kafka/KafkaChannelBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/kafka/KafkaChannelBinding.java
@@ -1,7 +1,9 @@
package com.asyncapi.v2.binding.channel.kafka;
import com.asyncapi.v2.binding.channel.ChannelBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -9,8 +11,6 @@
import lombok.NoArgsConstructor;
import org.jetbrains.annotations.Nullable;
-import java.util.List;
-
/**
* Describes Kafka channel binding.
*
@@ -23,12 +23,15 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Kafka channel binding.")
public class KafkaChannelBinding extends ChannelBinding {
/**
* Kafka topic name if different from channel name.
*/
@Nullable
+ @JsonProperty("topic")
+ @JsonPropertyDescription("Kafka topic name if different from channel name.")
private String topic;
/**
@@ -37,6 +40,12 @@ public class KafkaChannelBinding extends ChannelBinding {
* MUST be positive.
*/
@Nullable
+ @javax.validation.constraints.Min(
+ value = 1,
+ message = "Number of partitions must be greater or equals to 1"
+ )
+ @JsonProperty("partitions")
+ @JsonPropertyDescription("Number of partitions configured on this topic (useful to know how many parallel consumers you may run).")
private Integer partitions;
/**
@@ -45,13 +54,21 @@ public class KafkaChannelBinding extends ChannelBinding {
* MUST be positive.
*/
@Nullable
+ @javax.validation.constraints.Min(
+ value = 1,
+ message = "Number of replicas must be greater or equals to 1"
+ )
+ @JsonProperty("replicas")
+ @JsonPropertyDescription("Number of replicas configured on this topic.")
private Integer replicas;
/**
* Topic configuration properties that are relevant for the API.
*/
@Nullable
- private TopicConfiguration topicConfiguration;
+ @JsonProperty("topicConfiguration")
+ @JsonPropertyDescription("Topic configuration properties that are relevant for the API.")
+ private KafkaChannelTopicConfiguration topicConfiguration;
/**
* The version of this binding. If omitted, "latest" MUST be assumed.
@@ -60,56 +77,4 @@ public class KafkaChannelBinding extends ChannelBinding {
@Builder.Default
private String bindingVersion = "0.4.0";
- /**
- * This objects contains information about the API relevant topic configuration in Kafka.
- *
- * @version 0.4.0
- * @see Kafka channel binding
- * @author Pavel Bodiachevskii
- */
- @Data
- @Builder
- @NoArgsConstructor
- @AllArgsConstructor
- public static class TopicConfiguration {
-
- /**
- * The cleanup.policy configuration option.
- *
- * array may only contain delete and/or compact
- */
- @Nullable
- @JsonProperty("cleanup.policy")
- private List cleanupPolicy;
-
- /**
- * The retention.ms configuration option.
- */
- @Nullable
- @JsonProperty("retention.ms")
- private Integer retentionMs;
-
- /**
- * The retention.bytes configuration option.
- */
- @Nullable
- @JsonProperty("retention.bytes")
- private Integer retentionBytes;
-
- /**
- * The delete.retention.ms configuration option.
- */
- @Nullable
- @JsonProperty("delete.retention.ms")
- private Integer deleteRetentionMs;
-
- /**
- * The max.message.bytes configuration option.
- */
- @Nullable
- @JsonProperty("max.message.bytes")
- private Integer maxMessageBytes;
-
- }
-
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/kafka/KafkaChannelTopicCleanupPolicy.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/kafka/KafkaChannelTopicCleanupPolicy.java
new file mode 100644
index 00000000..06fe5aa2
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/kafka/KafkaChannelTopicCleanupPolicy.java
@@ -0,0 +1,13 @@
+package com.asyncapi.v2.binding.channel.kafka;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+public enum KafkaChannelTopicCleanupPolicy {
+
+ @JsonProperty("compact")
+ COMPACT,
+
+ @JsonProperty("delete")
+ DELETE
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/kafka/KafkaChannelTopicConfiguration.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/kafka/KafkaChannelTopicConfiguration.java
new file mode 100644
index 00000000..0e49c527
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/kafka/KafkaChannelTopicConfiguration.java
@@ -0,0 +1,83 @@
+package com.asyncapi.v2.binding.channel.kafka;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * This objects contains information about the API relevant topic configuration in Kafka.
+ *
+ * @version 0.4.0
+ * @see Kafka channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class KafkaChannelTopicConfiguration {
+
+ /**
+ * The cleanup.policy configuration option.
+ *
+ * array may only contain delete and/or compact
+ */
+ @Nullable
+ @JsonProperty("cleanup.policy")
+ private List cleanupPolicy;
+
+ /**
+ * The retention.ms configuration option.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = -1,
+ message = "retention.ms must be greater or equals to -1"
+ )
+ @JsonProperty("retention.ms")
+ @JsonPropertyDescription("The [`retention.ms`](https://kafka.apache.org/documentation/#topicconfigs_retention.ms) configuration option.")
+ private Integer retentionMs;
+
+ /**
+ * The retention.bytes configuration option.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = -1,
+ message = "retention.bytes must be greater or equals to -1"
+ )
+ @JsonProperty("retention.bytes")
+ @JsonPropertyDescription("The [`retention.bytes`](https://kafka.apache.org/documentation/#topicconfigs_retention.bytes) configuration option.")
+ private Integer retentionBytes;
+
+ /**
+ * The delete.retention.ms configuration option.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "delete.retention.ms must be greater or equals to 0"
+ )
+ @JsonProperty("delete.retention.ms")
+ @JsonPropertyDescription("The [`delete.retention.ms`](https://kafka.apache.org/documentation/#topicconfigs_delete.retention.ms) configuration option.")
+ private Integer deleteRetentionMs;
+
+ /**
+ * The max.message.bytes configuration option.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "max.message.bytes must be greater or equals to 0"
+ )
+ @JsonProperty("max.message.bytes")
+ @JsonPropertyDescription("The [`max.message.bytes`](https://kafka.apache.org/documentation/#topicconfigs_max.message.bytes) configuration option.")
+ private Integer maxMessageBytes;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/pulsar/PulsarChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/pulsar/PulsarChannelBinding.java
index 9bbae92f..8c2e314b 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/pulsar/PulsarChannelBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/pulsar/PulsarChannelBinding.java
@@ -1,7 +1,9 @@
package com.asyncapi.v2.binding.channel.pulsar;
import com.asyncapi.v2.binding.channel.ChannelBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -24,24 +26,39 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Pulsar channel binding.")
public class PulsarChannelBinding extends ChannelBinding {
/**
* The namespace the channel is associated with.
*/
@NotNull
- private String namespace;
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty("namespace")
+ @JsonPropertyDescription("The namespace the channel is associated with.")
+ private String namespace = "";
/**
* Persistence of the topic in Pulsar. It MUST be either persistent or non-persistent.
*/
@NotNull
- private String persistence;
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "persistence", defaultValue = "persistent")
+ @JsonPropertyDescription("Persistence of the topic in Pulsar. It MUST be either persistent or non-persistent.")
+ private PulsarChannelPersistence persistence = PulsarChannelPersistence.PERSISTENT;
/**
* Topic compaction threshold given in Megabytes.
*/
@Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "Topic compaction threshold must be greater or equals to 0."
+ )
+ @JsonProperty("compaction")
+ @JsonPropertyDescription("Topic compaction threshold given in Megabytes.")
private Integer compaction;
/**
@@ -49,24 +66,31 @@ public class PulsarChannelBinding extends ChannelBinding {
*/
@Nullable
@JsonProperty("geo-replication")
+ @JsonPropertyDescription("A list of clusters the topic is replicated to.")
private List geoReplication;
/**
* Topic retention policy.
*/
@Nullable
- private RetentionDefinition retention;
+ @JsonProperty("retention")
+ @JsonPropertyDescription("Topic retention policy.")
+ private PulsarChannelRetentionDefinition retention;
/**
* Message time-to-live in seconds.
*/
@Nullable
+ @JsonProperty("ttl")
+ @JsonPropertyDescription("Message time-to-live in seconds.")
private Integer ttl;
/**
* Message deduplication. When true, it ensures that each message produced on Pulsar topics is persisted to disk only once.
*/
@Nullable
+ @JsonProperty("deduplication")
+ @JsonPropertyDescription("Message deduplication. When true, it ensures that each message produced on Pulsar topics is persisted to disk only once.")
private Boolean deduplication;
/**
@@ -74,32 +98,8 @@ public class PulsarChannelBinding extends ChannelBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
- /**
- * The Retention Definition Object is used to describe the Pulsar Retention policy.
- */
- @Data
- @Builder
- @NoArgsConstructor
- @AllArgsConstructor
- @EqualsAndHashCode
- public static class RetentionDefinition {
-
- /**
- * Time given in Minutes.
- */
- @Nullable
- @Builder.Default
- private Integer time = 0;
-
- /**
- * Size given in MegaBytes.
- */
- @Nullable
- @Builder.Default
- private Integer size = 0;
-
- }
-
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/pulsar/PulsarChannelPersistence.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/pulsar/PulsarChannelPersistence.java
new file mode 100644
index 00000000..14cf634d
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/pulsar/PulsarChannelPersistence.java
@@ -0,0 +1,22 @@
+package com.asyncapi.v2.binding.channel.pulsar;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes Pulsar channel persistence.
+ *
+ * @version 0.1.0
+ * @see Pulsar channel binding
+ * @author Pavel Bodiachevskii
+ */
+@JsonClassDescription("Describes Pulsar channel persistence.")
+public enum PulsarChannelPersistence {
+
+ @JsonProperty("persistent")
+ PERSISTENT,
+
+ @JsonProperty("non-persistent")
+ NON_PERSISTENT
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/pulsar/PulsarChannelRetentionDefinition.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/pulsar/PulsarChannelRetentionDefinition.java
new file mode 100644
index 00000000..9a23fd29
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/pulsar/PulsarChannelRetentionDefinition.java
@@ -0,0 +1,48 @@
+package com.asyncapi.v2.binding.channel.pulsar;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Pulsar channel retention definition.
+ *
+ * The Retention Definition Object is used to describe the Pulsar Retention policy.
+ *
+ * @version 0.1.0
+ * @see Pulsar channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describes Pulsar channel retention definition.")
+public class PulsarChannelRetentionDefinition {
+
+ /**
+ * Time given in Minutes.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("time")
+ @JsonPropertyDescription("Time given in Minutes.")
+ private Integer time = 0;
+
+ /**
+ * Size given in MegaBytes.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("size")
+ @JsonPropertyDescription("Size given in MegaBytes.")
+ private Integer size = 0;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ws/WebSocketsChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ws/WebSocketsChannelBinding.java
index 4a1d7ae2..4d8c66d7 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ws/WebSocketsChannelBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ws/WebSocketsChannelBinding.java
@@ -1,6 +1,10 @@
package com.asyncapi.v2.binding.channel.ws;
import com.asyncapi.v2.binding.channel.ChannelBinding;
+import com.asyncapi.v2.schema.Schema;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -25,39 +29,42 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes WebSockets channel binding.")
public class WebSocketsChannelBinding extends ChannelBinding {
/**
* The HTTP method to use when establishing the connection. Its value MUST be either GET or POST.
*/
@Nullable
- private String method;
+ @JsonProperty("method")
+ @JsonPropertyDescription("The HTTP method to use when establishing the connection. Its value MUST be either GET or POST.")
+ private WebSocketsChannelMethod method;
/**
- * TODO: Schema object
* A Schema object containing the definitions for each query parameter. This schema MUST be of type
* object and have a properties key.
- *
- * @see Schema object
*/
@Nullable
- private Object query;
+ @JsonProperty("query")
+ @JsonPropertyDescription("A Schema object containing the definitions for each query parameter. This schema MUST be of type object and have a properties key.")
+ private Schema query;
/**
- * TODO: Schema object
* A Schema object containing the definitions of the HTTP headers to use when establishing the connection.
* This schema MUST be of type object and have a properties key.
- *
- * @see Schema object
*/
@Nullable
- private Object headers;
+ @JsonProperty("headers")
+ @JsonPropertyDescription("A Schema object containing the definitions of the HTTP headers to use when establishing the connection. This schema MUST be of type object and have a properties key.")
+ private Schema headers;
/**
* The version of this binding. If omitted, "latest" MUST be assumed.
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ws/WebSocketsChannelMethod.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ws/WebSocketsChannelMethod.java
new file mode 100644
index 00000000..cdee8595
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/channel/ws/WebSocketsChannelMethod.java
@@ -0,0 +1,13 @@
+package com.asyncapi.v2.binding.channel.ws;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+public enum WebSocketsChannelMethod {
+
+ @JsonProperty("GET")
+ GET,
+
+ @JsonProperty("POST")
+ POST
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/amqp/AMQPMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/amqp/AMQPMessageBinding.java
index 73d05041..d2281e2b 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/amqp/AMQPMessageBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/amqp/AMQPMessageBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.message.amqp;
import com.asyncapi.v2.binding.message.MessageBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -22,18 +25,23 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes AMQP 0-9-1 message binding.")
public class AMQPMessageBinding extends MessageBinding {
/**
* A MIME encoding for the message content.
*/
@Nullable
+ @JsonProperty("contentEncoding")
+ @JsonPropertyDescription("A MIME encoding for the message content.")
private String contentEncoding;
/**
* Application-specific message type.
*/
@Nullable
+ @JsonProperty("messageType")
+ @JsonPropertyDescription("Application-specific message type.")
private String messageType;
/**
@@ -41,6 +49,8 @@ public class AMQPMessageBinding extends MessageBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty(value = "bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.2.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/anypointmq/AnypointMQMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/anypointmq/AnypointMQMessageBinding.java
index 0fcff490..d424ee88 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/anypointmq/AnypointMQMessageBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/anypointmq/AnypointMQMessageBinding.java
@@ -1,6 +1,10 @@
package com.asyncapi.v2.binding.message.anypointmq;
import com.asyncapi.v2.binding.message.MessageBinding;
+import com.asyncapi.v2.schema.Schema;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -20,23 +24,26 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Anypoint MQ message binding.")
public class AnypointMQMessageBinding extends MessageBinding {
/**
- * OPTIONAL.
- *
* A Schema object containing the definitions for Anypoint MQ-specific headers (so-called protocol headers).
* This schema MUST be of type object and have a properties key. Examples of Anypoint MQ protocol headers are
* messageId and messageGroupId.
*/
@Nullable
- private Object headers;
+ @JsonProperty("headers")
+ @JsonPropertyDescription("A Schema object containing the definitions for Anypoint MQ-specific headers (so-called protocol headers). This schema MUST be of type object and have a properties key. Examples of Anypoint MQ protocol headers are messageId and messageGroupId.")
+ private Schema headers;
/**
- * OPTIONAL, defaults to latest. The version of this binding.
+ * The version of this binding.
*/
@Nullable
@Builder.Default
+ @JsonProperty(value = "bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.0.1";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/googlepubsub/GooglePubSubMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/googlepubsub/GooglePubSubMessageBinding.java
index 55b85375..3f1771cc 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/googlepubsub/GooglePubSubMessageBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/googlepubsub/GooglePubSubMessageBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.message.googlepubsub;
import com.asyncapi.v2.binding.message.MessageBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -9,10 +12,10 @@
import org.jetbrains.annotations.Nullable;
/**
+ * Describes Google Cloud Pub/Sub message binding.
+ *
* The Message Binding Object is used to describe the Google Cloud Pub/Sub specific PubsubMessage details, alongside with
* pertintent parts of the Google Cloud Pub/Sub Schema Object, with AsyncAPI.
- *
- * Describes Google Cloud Pub/Sub message binding.
*
* @version 0.1.0
* @see Google Cloud Pub/Sub message binding
@@ -23,12 +26,15 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Google Cloud Pub/Sub message binding.")
public class GooglePubSubMessageBinding extends MessageBinding {
/**
* If non-empty, identifies related messages for which publish order should be respected (For more information, see ordering messages .)
*/
@Nullable
+ @JsonProperty("orderingKey")
+ @JsonPropertyDescription("If non-empty, identifies related messages for which publish order should be respected (For more information, see https://cloud.google.com/pubsub/docs/ordering messages")
private String orderingKey;
/**
@@ -36,46 +42,25 @@ public class GooglePubSubMessageBinding extends MessageBinding {
* filter messages on the subscription.)
*/
@Nullable
+ @JsonProperty("attributes")
+ @JsonPropertyDescription("Attributes for this message (If this field is empty, the message must contain non-empty data. This can be used to filter messages on the subscription.)")
private Object attributes;
/**
* Describes the schema used to validate the payload of this message
*/
@Nullable
- private SchemaDefinition schema;
+ @JsonProperty("schema")
+ @JsonPropertyDescription("Describes the schema used to validate the payload of this message")
+ private GooglePubSubMessageSchemaDefinition schema;
/**
- * OPTIONAL, defaults to latest. The version of this binding.
+ * The version of this binding.
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
- /**
- * The Schema Definition Object is used to describe the Google Cloud Pub/Sub Schema Object with AsyncAPI.
- * While some of this information could be, or is, described using native AsyncAPI, for consistency it makes sense to
- * provide this information here at all times, especially for cases where AsyncAPI does not natively support describing
- * payloads using a supported Google Cloud Pub/Sub schema format like Protobuf.
- */
- @Data
- @Builder
- @NoArgsConstructor
- @AllArgsConstructor
- @EqualsAndHashCode
- public static class SchemaDefinition {
-
- /**
- * The name of the schema
- */
- @Nullable
- private String name;
-
- /**
- * The type of the schema
- */
- @Nullable
- private String type;
-
- }
-
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/googlepubsub/GooglePubSubMessageSchemaDefinition.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/googlepubsub/GooglePubSubMessageSchemaDefinition.java
new file mode 100644
index 00000000..2f70c8ac
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/googlepubsub/GooglePubSubMessageSchemaDefinition.java
@@ -0,0 +1,53 @@
+package com.asyncapi.v2.binding.message.googlepubsub;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Describes Google Cloud Pub/Sub message schema definition.
+ *
+ * The Schema Definition Object is used to describe the Google Cloud Pub/Sub Schema Object with AsyncAPI.
+ * While some of this information could be, or is, described using native AsyncAPI, for consistency it makes sense to
+ * provide this information here at all times, especially for cases where AsyncAPI does not natively support describing
+ * payloads using a supported Google Cloud Pub/Sub schema format like Protobuf.
+ *
+ * @version 0.1.0
+ * @see Google Cloud Pub/Sub message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describes Google Cloud Pub/Sub message schema definition.")
+public class GooglePubSubMessageSchemaDefinition {
+
+ /**
+ * The name of the schema
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "name", required = true)
+ @JsonPropertyDescription("The name of the schema")
+ private String name = "";
+
+ /**
+ * The type of the schema
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "type", required = true)
+ @JsonPropertyDescription("The type of the schema")
+ private GooglePubSubMessageSchemaDefinitionType type = GooglePubSubMessageSchemaDefinitionType.PROTOBUF;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/googlepubsub/GooglePubSubMessageSchemaDefinitionType.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/googlepubsub/GooglePubSubMessageSchemaDefinitionType.java
new file mode 100644
index 00000000..305b8d51
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/googlepubsub/GooglePubSubMessageSchemaDefinitionType.java
@@ -0,0 +1,23 @@
+package com.asyncapi.v2.binding.message.googlepubsub;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes Google Cloud Pub/Sub message schema definition type.
+ *
+ * @version 0.1.0
+ * @see Google Cloud Pub/Sub message binding
+ * @see Types of schemas
+ * @author Pavel Bodiachevskii
+ */
+@JsonClassDescription("Describes Google Cloud Pub/Sub message schema definition type.")
+public enum GooglePubSubMessageSchemaDefinitionType {
+
+ @JsonProperty("avro")
+ AVRO,
+
+ @JsonProperty("protobuf")
+ PROTOBUF
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/http/HTTPMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/http/HTTPMessageBinding.java
index 02014e14..863d2546 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/http/HTTPMessageBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/http/HTTPMessageBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.message.http;
import com.asyncapi.v2.binding.message.MessageBinding;
+import com.asyncapi.v2.schema.Schema;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -26,18 +29,20 @@ public class HTTPMessageBinding extends MessageBinding {
/**
* A Schema object containing the definitions for each query parameter. This schema MUST be of type object
- * and have a properties key.
- *
- * @see Schema object
+ * and have a properties key.*
*/
@Nullable
- private Object headers;
+ @JsonProperty("headers")
+ @JsonPropertyDescription("A Schema object containing the definitions for each query parameter. This schema MUST be of type object and have a properties key.")
+ private Schema headers;
/**
- * The version of this binding. If omitted, "latest" MUST be assumed.
+ * The version of this binding.
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/ibmmq/IBMMQMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/ibmmq/IBMMQMessageBinding.java
index 381c6062..1b233d53 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/ibmmq/IBMMQMessageBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/ibmmq/IBMMQMessageBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.message.ibmmq;
import com.asyncapi.v2.binding.message.MessageBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -22,6 +25,7 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes IBM MQ message binding.")
public class IBMMQMessageBinding extends MessageBinding {
/**
@@ -30,7 +34,10 @@ public class IBMMQMessageBinding extends MessageBinding {
* MUST be either string, jms or binary
*/
@Nullable
- private String type;
+ @Builder.Default
+ @JsonProperty(value = "type", defaultValue = "string")
+ @JsonPropertyDescription("The type of the message.")
+ private IBMMQMessageType type = IBMMQMessageType.STRING;
/**
* Defines the IBM MQ message headers to include with this message. More than one header can be specified as a comma
@@ -41,6 +48,8 @@ public class IBMMQMessageBinding extends MessageBinding {
* headers MUST NOT be specified if type = string or jms
*/
@Nullable
+ @JsonProperty("headers")
+ @JsonPropertyDescription("Defines the IBM MQ message headers to include with this message. More than one header can be specified as a comma separated list.")
private String headers;
/**
@@ -50,6 +59,8 @@ public class IBMMQMessageBinding extends MessageBinding {
* A minimum markdown syntax as described by CommonMark 0.27 is assumed.
*/
@Nullable
+ @JsonProperty("description")
+ @JsonPropertyDescription("Provides additional information for application developers: describes the message type or format.")
private String description;
/**
@@ -61,13 +72,22 @@ public class IBMMQMessageBinding extends MessageBinding {
* expiry value MUST be either zero (unlimited) or greater than zero.
*/
@Nullable
- private Integer expiry;
+ @Builder.Default
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "Expiry must be greater or equals to 0"
+ )
+ @JsonProperty(value = "expiry", defaultValue = "0")
+ @JsonPropertyDescription("The recommended setting the client should use for the TTL (Time-To-Live) of the message. This is a period of time expressed in milliseconds and set by the application that puts the message. 'expiry' values are API dependant e.g., MQI and JMS use different units of time and default values for 'unlimited'. General information on IBM MQ message expiry can be found on this [page](https://www.ibm.com/docs/en/ibm-mq/9.2?topic=mqmd-expiry-mqlong) in the IBM MQ Knowledge Center.")
+ private Integer expiry = 0;
/**
* The version of this binding.
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/ibmmq/IBMMQMessageType.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/ibmmq/IBMMQMessageType.java
new file mode 100644
index 00000000..02a24a33
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/ibmmq/IBMMQMessageType.java
@@ -0,0 +1,25 @@
+package com.asyncapi.v2.binding.message.ibmmq;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes IBM MQ message type.
+ *
+ * This object contains information about the message type in IBM MQ.
+ *
+ * @version 0.1.0
+ * @see IBM MQ message binding
+ * @author Pavel Bodiachevskii
+ */
+public enum IBMMQMessageType {
+
+ @JsonProperty("string")
+ STRING,
+
+ @JsonProperty("jms")
+ JMS,
+
+ @JsonProperty("binary")
+ BINARY
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/kafka/KafkaMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/kafka/KafkaMessageBinding.java
index 455cc905..e7728c9d 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/kafka/KafkaMessageBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/kafka/KafkaMessageBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.message.kafka;
import com.asyncapi.v2.binding.message.MessageBinding;
+import com.asyncapi.v2.schema.Schema;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -25,30 +28,35 @@
public class KafkaMessageBinding extends MessageBinding {
/**
- * TODO: Avro Schema
* The message key.
- *
- * @see Schema object
*/
@Nullable
- private Object key;
+ @JsonProperty("key")
+ @JsonPropertyDescription("The message key.")
+ private Schema key;
/**
* If a Schema Registry is used when performing this operation, tells where the id of schema is stored (e.g. header or payload).
*/
@Nullable
- private String schemaIdLocation;
+ @JsonProperty("schemaIdLocation")
+ @JsonPropertyDescription("If a Schema Registry is used when performing this operation, tells where the id of schema is stored (e.g. header or payload).")
+ private KafkaMessageSchemaIdLocation schemaIdLocation;
/**
* Number of bytes or vendor specific values when schema id is encoded in payload (e.g confluent/ apicurio-legacy / apicurio-new).
*/
@Nullable
+ @JsonProperty("schemaIdPayloadEncoding")
+ @JsonPropertyDescription("Number of bytes or vendor specific values when schema id is encoded in payload (e.g confluent/ apicurio-legacy / apicurio-new).")
private String schemaIdPayloadEncoding;
/**
* Freeform string for any naming strategy class to use. Clients should default to the vendor default if not supplied.
*/
@Nullable
+ @JsonProperty("schemaLookupStrategy")
+ @JsonPropertyDescription("Freeform string for any naming strategy class to use. Clients should default to the vendor default if not supplied.")
private String schemaLookupStrategy;
/**
@@ -56,6 +64,8 @@ public class KafkaMessageBinding extends MessageBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.4.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/kafka/KafkaMessageSchemaIdLocation.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/kafka/KafkaMessageSchemaIdLocation.java
new file mode 100644
index 00000000..a413bf46
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/kafka/KafkaMessageSchemaIdLocation.java
@@ -0,0 +1,20 @@
+package com.asyncapi.v2.binding.message.kafka;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes Kafka message schema id location.
+ *
+ * @version 0.1.0
+ * @see Kafka message binding
+ * @author Pavel Bodiachevskii
+ */
+public enum KafkaMessageSchemaIdLocation {
+
+ @JsonProperty("header")
+ HEADER,
+
+ @JsonProperty("payload")
+ PAYLOAD
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/mqtt/MQTTMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/mqtt/MQTTMessageBinding.java
index 2e24ebfb..c08ece8f 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/mqtt/MQTTMessageBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/message/mqtt/MQTTMessageBinding.java
@@ -1,6 +1,8 @@
package com.asyncapi.v2.binding.message.mqtt;
import com.asyncapi.v2.binding.message.MessageBinding;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -29,6 +31,8 @@ public class MQTTMessageBinding extends MessageBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/amqp/AMQPOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/amqp/AMQPOperationBinding.java
index 750ad728..034337ae 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/amqp/AMQPOperationBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/amqp/AMQPOperationBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.operation.amqp;
import com.asyncapi.v2.binding.operation.OperationBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -24,12 +27,21 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes AMQP 0-9-1 operation binding.")
public class AMQPOperationBinding extends OperationBinding {
/**
* TTL (Time-To-Live) for the message. It MUST be greater than or equal to zero.
+ *
+ * Applies to: publish, subscribe
*/
@Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "TTL (Time-To-Live) for the message must be greater than or equal to zero"
+ )
+ @JsonProperty("expiration")
+ @JsonPropertyDescription("TTL (Time-To-Live) for the message. It MUST be greater than or equal to zero.")
private Integer expiration;
/**
@@ -38,6 +50,8 @@ public class AMQPOperationBinding extends OperationBinding {
* Applies to: publish, subscribe
*/
@Nullable
+ @JsonProperty("userId")
+ @JsonPropertyDescription("Identifies the user who has sent the message.")
private String userId;
/**
@@ -46,6 +60,8 @@ public class AMQPOperationBinding extends OperationBinding {
* Applies to: publish, subscribe
*/
@Nullable
+ @JsonProperty("cc")
+ @JsonPropertyDescription("The routing keys the message should be routed to at the time of publishing.")
private List cc;
/**
@@ -54,6 +70,8 @@ public class AMQPOperationBinding extends OperationBinding {
* Applies to: publish, subscribe
*/
@Nullable
+ @JsonProperty("priority")
+ @JsonPropertyDescription("A priority for the message.")
private Integer priority;
/**
@@ -62,6 +80,16 @@ public class AMQPOperationBinding extends OperationBinding {
* Applies to: publish, subscribe
*/
@Nullable
+ @javax.validation.constraints.Min(
+ value = 1,
+ message = "Delivery mode of the message must be either 1 (transient) or 2 (persistent)"
+ )
+ @javax.validation.constraints.Max(
+ value = 2,
+ message = "Delivery mode of the message must be either 1 (transient) or 2 (persistent)"
+ )
+ @JsonProperty("deliveryMode")
+ @JsonPropertyDescription("Delivery mode of the message. Its value MUST be either 1 (transient) or 2 (persistent).")
private Integer deliveryMode;
/**
@@ -70,6 +98,8 @@ public class AMQPOperationBinding extends OperationBinding {
* Applies to: publish
*/
@Nullable
+ @JsonProperty("mandatory")
+ @JsonPropertyDescription("Whether the message is mandatory or not.")
private Boolean mandatory;
/**
@@ -78,6 +108,8 @@ public class AMQPOperationBinding extends OperationBinding {
* Applies to: publish
*/
@Nullable
+ @JsonProperty("bcc")
+ @JsonPropertyDescription("Like cc but consumers will not receive this information.")
private List bcc;
/**
@@ -86,6 +118,8 @@ public class AMQPOperationBinding extends OperationBinding {
* Applies to: publish, subscribe
*/
@Nullable
+ @JsonProperty("replyTo")
+ @JsonPropertyDescription("Name of the queue where the consumer should send the response.")
private String replyTo;
/**
@@ -94,6 +128,8 @@ public class AMQPOperationBinding extends OperationBinding {
* Applies to: publish, subscribe
*/
@Nullable
+ @JsonProperty("timestamp")
+ @JsonPropertyDescription("Whether the message should include a timestamp or not.")
private Boolean timestamp;
/**
@@ -102,6 +138,8 @@ public class AMQPOperationBinding extends OperationBinding {
* Applies to: subscribe
*/
@Nullable
+ @JsonProperty("ack")
+ @JsonPropertyDescription("Whether the consumer should ack the message or not.")
private Boolean ack;
/**
@@ -109,6 +147,8 @@ public class AMQPOperationBinding extends OperationBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty(value = "bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.2.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/http/HTTPOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/http/HTTPOperationBinding.java
index 5789296b..50de41dd 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/http/HTTPOperationBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/http/HTTPOperationBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.operation.http;
import com.asyncapi.v2.binding.operation.OperationBinding;
+import com.asyncapi.v2.schema.Schema;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -31,29 +34,37 @@ public class HTTPOperationBinding extends OperationBinding {
* Type of operation. Its value MUST be either request or response.
*/
@NotNull
- private String type;
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "type", required = true)
+ @JsonPropertyDescription("Type of operation. Its value MUST be either request or response.")
+ private HTTPOperationType type = HTTPOperationType.REQUEST;
/**
* When type is request, this is the HTTP method, otherwise it MUST be ignored. Its value MUST be one of
* GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS, CONNECT, and TRACE.
*/
@Nullable
- private String method;
+ @JsonProperty("method")
+ @JsonPropertyDescription("When type is request, this is the HTTP method, otherwise it MUST be ignored. Its value MUST be one of GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS, CONNECT, and TRACE.")
+ private HTTPOperationMethod method;
/**
* A Schema object containing the definitions for each query parameter. This schema MUST be of type object
* and have a properties key.
- *
- * @see Schema object
*/
@Nullable
- private Object query;
+ @JsonProperty("query")
+ @JsonPropertyDescription("A Schema object containing the definitions for each query parameter. This schema MUST be of type object and have a properties key.")
+ private Schema query;
/**
* The version of this binding. If omitted, "latest" MUST be assumed.
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/http/HTTPOperationMethod.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/http/HTTPOperationMethod.java
new file mode 100644
index 00000000..6781a41c
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/http/HTTPOperationMethod.java
@@ -0,0 +1,22 @@
+package com.asyncapi.v2.binding.operation.http;
+
+/**
+ * Describes HTTP operation type.
+ *
+ * Contains information about the operation type.
+ *
+ * @version 0.1.0
+ * @see HTTP operation binding
+ * @author Pavel Bodiachevskii
+ */
+public enum HTTPOperationMethod {
+ GET,
+ PUT,
+ POST,
+ PATCH,
+ DELETE,
+ HEAD,
+ OPTIONS,
+ CONNECT,
+ TRACE
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/http/HTTPOperationType.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/http/HTTPOperationType.java
new file mode 100644
index 00000000..c45309eb
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/http/HTTPOperationType.java
@@ -0,0 +1,13 @@
+package com.asyncapi.v2.binding.operation.http;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+public enum HTTPOperationType {
+
+ @JsonProperty("request")
+ REQUEST,
+
+ @JsonProperty("response")
+ RESPONSE
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/kafka/KafkaOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/kafka/KafkaOperationBinding.java
index 7fba6666..8ca426d2 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/kafka/KafkaOperationBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/kafka/KafkaOperationBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.operation.kafka;
import com.asyncapi.v2.binding.operation.OperationBinding;
+import com.asyncapi.v2.schema.Schema;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -25,22 +28,20 @@
public class KafkaOperationBinding extends OperationBinding {
/**
- * TODO: Schema
* Id of the consumer group.
- *
- * @see Schema object
*/
@Nullable
- private Object groupId;
+ @JsonProperty("groupId")
+ @JsonPropertyDescription("Id of the consumer group.")
+ private Schema groupId;
/**
- * TODO: Schema
* Id of the consumer inside a consumer group.
- *
- * @see Schema object
*/
@Nullable
- private Object clientId;
+ @JsonProperty("clientId")
+ @JsonPropertyDescription("Id of the consumer inside a consumer group.")
+ private Schema clientId;
/**
* The version of this binding. If omitted, "latest" MUST be assumed.
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/mqtt/MQTTOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/mqtt/MQTTOperationBinding.java
index 9938a7a4..d76d9d86 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/mqtt/MQTTOperationBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/mqtt/MQTTOperationBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.operation.mqtt;
import com.asyncapi.v2.binding.operation.OperationBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -22,6 +25,7 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes MQTT operation binding.")
public class MQTTOperationBinding extends OperationBinding {
/**
@@ -31,6 +35,16 @@ public class MQTTOperationBinding extends OperationBinding {
* Applies to: publish, subscribe
*/
@Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "QoS must be greater or equals to 0."
+ )
+ @javax.validation.constraints.Max(
+ value = 2,
+ message = "QoS must be lower or equals to 0."
+ )
+ @JsonProperty("qos")
+ @JsonPropertyDescription("Defines the Quality of Service (QoS) levels for the message flow between client and server. Its value MUST be either 0 (At most once delivery), 1 (At least once delivery), or 2 (Exactly once delivery).")
private Integer qos;
/**
@@ -39,6 +53,8 @@ public class MQTTOperationBinding extends OperationBinding {
* Applies to: publish, subscribe
*/
@Nullable
+ @JsonProperty("retain")
+ @JsonPropertyDescription("Whether the broker should retain the message or not.")
private Boolean retain;
/**
@@ -48,6 +64,8 @@ public class MQTTOperationBinding extends OperationBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/nats/NATSOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/nats/NATSOperationBinding.java
index 4ee0ea3b..6a82e9e6 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/nats/NATSOperationBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/nats/NATSOperationBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.operation.nats;
import com.asyncapi.v2.binding.operation.OperationBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -20,12 +23,19 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes NATS operation binding.")
public class NATSOperationBinding extends OperationBinding {
/**
* Defines the name of the queue to use. It MUST NOT exceed 255 characters.
*/
@Nullable
+ @javax.validation.constraints.Size(
+ max = 255,
+ message = "Queue name must be lower or equals to 255."
+ )
+ @JsonProperty("queue")
+ @JsonPropertyDescription("Defines the name of the queue to use. It MUST NOT exceed 255 characters.")
private String queue;
/**
@@ -33,6 +43,8 @@ public class NATSOperationBinding extends OperationBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/SolaceOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/SolaceOperationBinding.java
index c206866c..ff0a4ef7 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/SolaceOperationBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/SolaceOperationBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.operation.solace;
import com.asyncapi.v2.binding.operation.OperationBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -8,7 +11,6 @@
import lombok.NoArgsConstructor;
import org.jetbrains.annotations.Nullable;
-import java.util.ArrayList;
import java.util.List;
/**
@@ -25,20 +27,24 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Solace operation binding.")
public class SolaceOperationBinding extends OperationBinding {
/**
* List of destinations
*/
@Nullable
- @Builder.Default
- private List destinations = new ArrayList<>();
+ @JsonProperty("destinations")
+ @JsonPropertyDescription("List of destinations")
+ private List destinations;
/**
- * Version of the binding object (e.g. bindingVersion: 0.3.0)
+ * The version of this binding. (e.g. bindingVersion: 0.3.0)
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.3.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/SolaceDestination.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/SolaceOperationDestination.java
similarity index 55%
rename from asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/SolaceDestination.java
rename to asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/SolaceOperationDestination.java
index b4f67d02..fb3b075e 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/SolaceDestination.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/SolaceOperationDestination.java
@@ -1,8 +1,10 @@
package com.asyncapi.v2.binding.operation.solace;
-import com.asyncapi.v2.binding.operation.solace.queue.SolaceQueue;
-import com.asyncapi.v2.binding.operation.solace.topic.SolaceTopic;
+import com.asyncapi.v2.binding.operation.solace.queue.SolaceOperationQueue;
+import com.asyncapi.v2.binding.operation.solace.topic.SolaceOperationTopic;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -22,13 +24,16 @@
@Builder
@NoArgsConstructor
@AllArgsConstructor
-public class SolaceDestination {
+@JsonClassDescription("Describes Solace destination.")
+public class SolaceOperationDestination {
/**
* 'queue' or 'topic'. If the type is queue, then the subscriber can bind to the queue, which in turn will
* subscribe to the topic as represented by the channel name or to the provided topicSubscriptions.
*/
@Nullable
+ @JsonProperty("destinationType")
+ @JsonPropertyDescription("'queue' or 'topic'. If the type is queue, then the subscriber can bind to the queue, which in turn will subscribe to the topic as represented by the channel name or to the provided topicSubscriptions.")
private Type destinationType;
/**
@@ -37,26 +42,32 @@ public class SolaceDestination {
*/
@Nullable
@Builder.Default
+ @JsonProperty(value = "deliveryMode", defaultValue = "persistent")
+ @JsonPropertyDescription("'direct' or 'persistent'. This determines the quality of service for publishing messages as documented at https://docs.solace.com/Get-Started/Core-Concepts-Message-Delivery-Modes.htm. Default is 'persistent'.")
private DeliveryMode deliveryMode = DeliveryMode.PERSISTENT;
/**
* Solace queue destination details.
*/
@Nullable
- private SolaceQueue queue;
+ @JsonProperty("queue")
+ @JsonPropertyDescription("Solace queue destination details.")
+ private SolaceOperationQueue queue;
/**
- * Solace topic destination details
+ * Solace topic destination details.
*/
@Nullable
- private SolaceTopic topic;
+ @JsonProperty("topic")
+ @JsonPropertyDescription("Solace topic destination details.")
+ private SolaceOperationTopic topic;
public enum Type {
@JsonProperty("queue")
QUEUE,
@JsonProperty("topic")
- TOPIC;
+ TOPIC
}
@@ -65,7 +76,7 @@ public enum DeliveryMode {
@JsonProperty("direct")
DIRECT,
@JsonProperty("persistent")
- PERSISTENT;
+ PERSISTENT
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/queue/SolaceQueue.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/queue/SolaceOperationQueue.java
similarity index 59%
rename from asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/queue/SolaceQueue.java
rename to asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/queue/SolaceOperationQueue.java
index ff33a4e9..acd627d1 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/queue/SolaceQueue.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/queue/SolaceOperationQueue.java
@@ -1,6 +1,8 @@
package com.asyncapi.v2.binding.operation.solace.queue;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -22,12 +24,15 @@
@Builder
@NoArgsConstructor
@AllArgsConstructor
-public class SolaceQueue {
+@JsonClassDescription("Describes Solace queue.")
+public class SolaceOperationQueue {
/**
* The name of the queue, only applicable when destinationType is 'queue'.
*/
@Nullable
+ @JsonProperty("name")
+ @JsonPropertyDescription("The name of the queue, only applicable when destinationType is 'queue'.")
private String name;
/**
@@ -35,12 +40,16 @@ public class SolaceQueue {
* If none is given, the queue subscribes to the topic as represented by the channel name.
*/
@Nullable
+ @JsonProperty("topicSubscriptions")
+ @JsonPropertyDescription("A list of topics that the queue subscribes to, only applicable when destinationType is 'queue'. If none is given, the queue subscribes to the topic as represented by the channel name.")
private List topicSubscriptions;
/**
* 'exclusive' or 'nonexclusive'. This is documented here . Only applicable when destinationType is 'queue'.
*/
@Nullable
+ @JsonProperty("accessType")
+ @JsonPropertyDescription("'exclusive' or 'nonexclusive'. This is documented at https://docs.solace.com/Messaging/Guaranteed-Msg/Endpoints.htm#Queues. Only applicable when destinationType is 'queue'.")
private AccessType accessType;
/**
@@ -48,6 +57,8 @@ public class SolaceQueue {
* Only applicable when destinationType is 'queue'.
*/
@Nullable
+ @JsonProperty("maxMsgSpoolSize")
+ @JsonPropertyDescription("The maximum amount of message spool that the given queue may use. This is documented at https://docs.solace.com/Messaging/Guaranteed-Msg/Message-Spooling.htm#max-spool-usage. Only applicable when destinationType is 'queue'.")
private String maxMsgSpoolSize;
/**
@@ -55,6 +66,8 @@ public class SolaceQueue {
* Only applicable when destinationType is 'queue'.
*/
@Nullable
+ @JsonProperty("maxTtl")
+ @JsonPropertyDescription("The maximum TTL to apply to messages to be spooled. This is documented at https://docs.solace.com/Messaging/Guaranteed-Msg/Configuring-Queues.htm. Only applicable when destinationType is 'queue'.")
private String maxTtl;
public enum AccessType {
@@ -62,7 +75,7 @@ public enum AccessType {
@JsonProperty("exclusive")
EXCLUSIVE,
@JsonProperty("non-exclusive")
- NON_EXCLUSIVE;
+ NON_EXCLUSIVE
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/topic/SolaceTopic.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/topic/SolaceOperationTopic.java
similarity index 62%
rename from asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/topic/SolaceTopic.java
rename to asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/topic/SolaceOperationTopic.java
index 69b316ac..bdf54d6d 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/topic/SolaceTopic.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/operation/solace/topic/SolaceOperationTopic.java
@@ -1,5 +1,8 @@
package com.asyncapi.v2.binding.operation.solace.topic;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -21,13 +24,16 @@
@Builder
@NoArgsConstructor
@AllArgsConstructor
-public class SolaceTopic {
+@JsonClassDescription("Describes Solace topic.")
+public class SolaceOperationTopic {
/**
* A list of topics that the client subscribes to, only applicable when destinationType is 'topic'.
* If none is given, the client subscribes to the topic as represented by the channel name.
*/
@Nullable
+ @JsonProperty("topicSubscriptions")
+ @JsonPropertyDescription("A list of topics that the client subscribes to, only applicable when destinationType is 'topic'. If none is given, the client subscribes to the topic as represented by the channel name.")
protected List topicSubscriptions;
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/ibmmq/IBMMQServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/ibmmq/IBMMQServerBinding.java
index 0e63bedc..fdeef6d9 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/ibmmq/IBMMQServerBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/ibmmq/IBMMQServerBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.server.ibmmq;
import com.asyncapi.v2.binding.server.ServerBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -23,6 +26,7 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes IBM MQ server binding.")
public class IBMMQServerBinding extends ServerBinding {
/**
@@ -32,6 +36,8 @@ public class IBMMQServerBinding extends ServerBinding {
* MUST NOT be specified for URI Scheme http:// or file://
*/
@Nullable
+ @JsonProperty("groupId")
+ @JsonPropertyDescription("Defines a logical group of IBM MQ server objects. This is necessary to specify multi-endpoint configurations used in high availability deployments. If omitted, the server object is not part of a group.")
private String groupId;
/**
@@ -41,6 +47,8 @@ public class IBMMQServerBinding extends ServerBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty(value = "ccdtQueueManagerName", defaultValue = "*")
+ @JsonPropertyDescription("The name of the IBM MQ queue manager to bind to in the CCDT file.")
private String ccdtQueueManagerName = "*";
/**
@@ -51,6 +59,8 @@ public class IBMMQServerBinding extends ServerBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty(value = "cipherSpec", defaultValue = "ANY")
+ @JsonPropertyDescription("The recommended cipher specification used to establish a TLS connection between the client and the IBM MQ queue manager. More information on SSL/TLS cipher specifications supported by IBM MQ can be found on this page in the IBM MQ Knowledge Center.")
private String cipherSpec = "ANY";
/**
@@ -61,7 +71,9 @@ public class IBMMQServerBinding extends ServerBinding {
* MUST NOT be specified for URI Scheme file:// or http://
*/
@Builder.Default
- private boolean multiEndpointServer = false;
+ @JsonProperty(value = "multiEndpointServer", defaultValue = "false")
+ @JsonPropertyDescription("If multiEndpointServer is true then multiple connections can be workload balanced and applications should not make assumptions as to where messages are processed. Where message ordering, or affinity to specific message resources is necessary, a single endpoint (multiEndpointServer = false) may be required. MUST NOT be specified for URI Scheme file:// or http://")
+ private Boolean multiEndpointServer = false;
/**
* The recommended value (in seconds) for the heartbeat sent to the queue manager during periods of inactivity.
@@ -71,12 +83,24 @@ public class IBMMQServerBinding extends ServerBinding {
* MUST be 0-999999
*/
@Builder.Default
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "Heart beat interval must be greater or equals to 0"
+ )
+ @javax.validation.constraints.Max(
+ value = 999999,
+ message = "Heart beat interval must be less or equals to 999999"
+ )
+ @JsonProperty(value = "heartBeatInterval", defaultValue = "300")
+ @JsonPropertyDescription("The recommended value (in seconds) for the heartbeat sent to the queue manager during periods of inactivity. A value of zero means that no heart beats are sent. A value of 1 means that the client will use the value defined by the queue manager.")
private int heartBeatInterval = 300;
/**
* The version of this binding.
*/
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/kafka/KafkaServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/kafka/KafkaServerBinding.java
index d1d3994a..87f21cec 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/kafka/KafkaServerBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/kafka/KafkaServerBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.server.kafka;
import com.asyncapi.v2.binding.server.ServerBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -20,12 +23,15 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Kafka server binding.")
public class KafkaServerBinding extends ServerBinding {
/**
* API URL for the Schema Registry used when producing Kafka messages (if a Schema Registry was used)
*/
@Nullable
+ @JsonProperty("schemaRegistryUrl")
+ @JsonPropertyDescription("API URL for the Schema Registry used when producing Kafka messages (if a Schema Registry was used)")
private String schemaRegistryUrl;
/**
@@ -34,6 +40,8 @@ public class KafkaServerBinding extends ServerBinding {
* The vendor of Schema Registry and Kafka serdes library that should be used (e.g. apicurio, confluent, ibm, or karapace)
*/
@Nullable
+ @JsonProperty("schemaRegistryVendor")
+ @JsonPropertyDescription("The vendor of Schema Registry and Kafka serdes library that should be used (e.g. apicurio, confluent, ibm, or karapace)")
private String schemaRegistryVendor;
/**
@@ -41,6 +49,8 @@ public class KafkaServerBinding extends ServerBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.4.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/mqtt/MQTTServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/mqtt/MQTTServerBinding.java
index bf38fc3f..b60dacb7 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/mqtt/MQTTServerBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/mqtt/MQTTServerBinding.java
@@ -1,12 +1,14 @@
package com.asyncapi.v2.binding.server.mqtt;
import com.asyncapi.v2.binding.server.ServerBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.NoArgsConstructor;
-import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
/**
@@ -23,66 +25,48 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes MQTT server binding.")
public class MQTTServerBinding extends ServerBinding {
/**
* The client identifier.
*/
@Nullable
+ @JsonProperty("clientId")
+ @JsonPropertyDescription("The client identifier.")
private String clientId;
/**
* Whether to create a persisten connection or not. When false, the connection will be persistent.
*/
- private boolean cleanSession;
+ @Nullable
+ @JsonProperty("cleanSession")
+ @JsonPropertyDescription("Whether to create a persisten connection or not. When false, the connection will be persistent.")
+ private Boolean cleanSession;
/**
* Last Will and Testament configuration.
*/
@Nullable
- private LastWillConfiguration lastWill;
+ @JsonProperty("lastWill")
+ @JsonPropertyDescription("Last Will and Testament configuration.")
+ private MQTTServerLastWillConfiguration lastWill;
/**
* Interval in seconds of the longest period of time the broker and the client can endure without sending a message.
*/
- private int keepAlive;
+ @Nullable
+ @JsonProperty("keepAlive")
+ @JsonPropertyDescription("Interval in seconds of the longest period of time the broker and the client can endure without sending a message.")
+ private Integer keepAlive;
/**
* The version of this binding. If omitted, "latest" MUST be assumed.
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
- @Data
- @EqualsAndHashCode
- @NoArgsConstructor
- @AllArgsConstructor
- public static class LastWillConfiguration {
-
- /**
- * The topic where the Last Will and Testament message will be sent.
- */
- @NotNull
- private String topic;
-
- /**
- * Defines how hard the broker/client will try to ensure that the Last Will and Testament message is received.
- * Its value MUST be either 0, 1 or 2.
- */
- private int qos;
-
- /**
- * Last Will message.
- */
- @Nullable
- private String message;
-
- /**
- * Whether the broker should retain the Last Will and Testament message or not.
- */
- private boolean retain;
-
- }
-
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/mqtt/MQTTServerLastWillConfiguration.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/mqtt/MQTTServerLastWillConfiguration.java
new file mode 100644
index 00000000..5accb133
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/mqtt/MQTTServerLastWillConfiguration.java
@@ -0,0 +1,65 @@
+package com.asyncapi.v2.binding.server.mqtt;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes MQTT server last will configuration.
+ *
+ * @version 0.1.0
+ * @see MQTT server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@EqualsAndHashCode
+@NoArgsConstructor
+@AllArgsConstructor
+public class MQTTServerLastWillConfiguration {
+
+ /**
+ * The topic where the Last Will and Testament message will be sent.
+ */
+ @Nullable
+ @JsonProperty("topic")
+ @JsonPropertyDescription("The topic where the Last Will and Testament message will be sent.")
+ private String topic;
+
+ /**
+ * Defines how hard the broker/client will try to ensure that the Last Will and Testament message is received.
+ * Its value MUST be either 0, 1 or 2.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "QoS must be greater or equals to 0."
+ )
+ @javax.validation.constraints.Max(
+ value = 2,
+ message = "QoS must be lower or equals to 0."
+ )
+ @JsonProperty("qos")
+ @JsonPropertyDescription("Defines how hard the broker/client will try to ensure that the Last Will and Testament message is received. Its value MUST be either 0, 1 or 2.")
+ private Integer qos;
+
+ /**
+ * Last Will message.
+ */
+ @Nullable
+ @JsonProperty("message")
+ @JsonPropertyDescription("Last Will message.")
+ private String message;
+
+ /**
+ * Whether the broker should retain the Last Will and Testament message or not.
+ */
+ @Nullable
+ @JsonProperty("retain")
+ @JsonPropertyDescription("Whether the broker should retain the Last Will and Testament message or not.")
+ private Boolean retain;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/pulsar/PulsarServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/pulsar/PulsarServerBinding.java
index 29e3db6d..1e6edea8 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/pulsar/PulsarServerBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/pulsar/PulsarServerBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.server.pulsar;
import com.asyncapi.v2.binding.server.ServerBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -20,6 +23,7 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Pulsar server binding.")
public class PulsarServerBinding extends ServerBinding {
/**
@@ -27,6 +31,8 @@ public class PulsarServerBinding extends ServerBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty(value = "tenant", defaultValue = "public")
+ @JsonPropertyDescription("The pulsar tenant. If omitted, \"public\" MUST be assumed.")
private String tenant = "public";
/**
@@ -34,6 +40,8 @@ public class PulsarServerBinding extends ServerBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.1.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/solace/SolaceServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/solace/SolaceServerBinding.java
index 00641525..a8b1467a 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/solace/SolaceServerBinding.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/binding/server/solace/SolaceServerBinding.java
@@ -1,6 +1,9 @@
package com.asyncapi.v2.binding.server.solace;
import com.asyncapi.v2.binding.server.ServerBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
@@ -20,6 +23,7 @@
@NoArgsConstructor
@AllArgsConstructor
@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Solace server binding.")
public class SolaceServerBinding extends ServerBinding {
/**
@@ -28,6 +32,8 @@ public class SolaceServerBinding extends ServerBinding {
* e.g. msgVpn: solace-broker-msg-vpn
*/
@Nullable
+ @JsonProperty("msgVpn")
+ @JsonPropertyDescription("Message VPN of the Solace Broker")
private String msgVpn;
/**
@@ -35,6 +41,8 @@ public class SolaceServerBinding extends ServerBinding {
*/
@Nullable
@Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
private String bindingVersion = "0.3.0";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/SchemaItemsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/SchemaItemsDeserializer.java
new file mode 100644
index 00000000..4b90358f
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/SchemaItemsDeserializer.java
@@ -0,0 +1,51 @@
+package com.asyncapi.v2.jackson;
+
+import com.asyncapi.v2.schema.Schema;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.node.ArrayNode;
+import com.fasterxml.jackson.databind.node.JsonNodeType;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+public class SchemaItemsDeserializer extends JsonDeserializer {
+
+ @Override
+ public Object deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException {
+ ObjectCodec objectCodec = jsonParser.getCodec();
+ JsonNode node = objectCodec.readTree(jsonParser);
+ JsonNodeType nodeType = node.getNodeType();
+ if (nodeType == JsonNodeType.OBJECT) {
+ return readAsSchema(node, objectCodec);
+ }
+ if (nodeType == JsonNodeType.ARRAY) {
+ return readAsListOfSchemas((ArrayNode) node, objectCodec);
+ }
+ return readAsObject(node, objectCodec);
+ }
+
+ private List readAsListOfSchemas(ArrayNode arrayNode, ObjectCodec objectCodec) throws IOException {
+ List schemaList = new ArrayList<>();
+ for (JsonNode childNode : arrayNode) {
+ schemaList.add(readAsSchema(childNode, objectCodec));
+ }
+ return schemaList;
+ }
+
+ private Schema readAsSchema(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser parser = jsonNode.traverse(objectCodec)) {
+ return parser.readValueAs(Schema.class);
+ }
+ }
+
+ private Object readAsObject(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ return jsonParser.readValueAs(Object.class);
+ }
+ }
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/channel/ChannelBindingsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/channel/ChannelBindingsDeserializer.java
index 8ae56749..0ed343fa 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/channel/ChannelBindingsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/channel/ChannelBindingsDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2.jackson.binding.channel;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2.binding.channel.amqp.AMQPChannelBinding;
import com.asyncapi.v2.binding.channel.amqp1.AMQP1ChannelBinding;
import com.asyncapi.v2.binding.channel.anypointmq.AnypointMQChannelBinding;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/message/MessageBindingsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/message/MessageBindingsDeserializer.java
index 1c26dc4b..991d2a06 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/message/MessageBindingsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/message/MessageBindingsDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2.jackson.binding.message;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2.binding.message.amqp.AMQPMessageBinding;
import com.asyncapi.v2.binding.message.amqp1.AMQP1MessageBinding;
import com.asyncapi.v2.binding.message.anypointmq.AnypointMQMessageBinding;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/operation/OperationBindingsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/operation/OperationBindingsDeserializer.java
index aa059747..47392755 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/operation/OperationBindingsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/operation/OperationBindingsDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2.jackson.binding.operation;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2.binding.operation.amqp.AMQPOperationBinding;
import com.asyncapi.v2.binding.operation.amqp1.AMQP1OperationBinding;
import com.asyncapi.v2.binding.operation.anypointmq.AnypointMQOperationBinding;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/server/ServerBindingsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/server/ServerBindingsDeserializer.java
index 7f0b4727..a896051d 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/server/ServerBindingsDeserializer.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/jackson/binding/server/ServerBindingsDeserializer.java
@@ -1,6 +1,6 @@
package com.asyncapi.v2.jackson.binding.server;
-import com.asyncapi.v2._6_0.model.Reference;
+import com.asyncapi.v2.Reference;
import com.asyncapi.v2.binding.server.amqp.AMQPServerBinding;
import com.asyncapi.v2.binding.server.amqp1.AMQP1ServerBinding;
import com.asyncapi.v2.binding.server.anypointmq.AnypointMQServerBinding;
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/schema/Schema.java b/asyncapi-core/src/main/java/com/asyncapi/v2/schema/Schema.java
index aa99503c..c4937bc4 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/schema/Schema.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/schema/Schema.java
@@ -3,6 +3,7 @@
import com.asyncapi.v2.ExtendableObject;
import com.asyncapi.v2._0_0.jackson.model.schema.SchemasAdditionalPropertiesDeserializer;
import com.asyncapi.v2._0_0.model.ExternalDocumentation;
+import com.asyncapi.v2.jackson.SchemaItemsDeserializer;
import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import lombok.AllArgsConstructor;
@@ -362,7 +363,7 @@ Validation Keywords for Numeric Instances (number and integer)
* Omitting this keyword has the same behavior as an empty schema.
*/
@Nullable
- @JsonProperty
+ @JsonDeserialize(using = SchemaItemsDeserializer.class)
public Object items;
/**
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/ApiKeySecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/ApiKeySecurityScheme.java
index 2364f78e..f9dd75d4 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/ApiKeySecurityScheme.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/ApiKeySecurityScheme.java
@@ -17,7 +17,7 @@
@Data
@NoArgsConstructor
@AllArgsConstructor
-@EqualsAndHashCode(callSuper = false)
+@EqualsAndHashCode(callSuper = true)
public class ApiKeySecurityScheme extends SecurityScheme {
/**
@@ -26,13 +26,12 @@ public class ApiKeySecurityScheme extends SecurityScheme {
* The location of the API key.
*/
@NotNull
- private ApiKeyLocation in;
+ private ApiKeyLocation in = ApiKeyLocation.USER;
- @Builder(builderMethodName = "apiKeySecuritySchemeBuilder")
- public ApiKeySecurityScheme(@NotNull Type type,
- @Nullable String description,
+ @Builder(builderMethodName = "apiKeyBuilder")
+ public ApiKeySecurityScheme(@Nullable String description,
@NotNull ApiKeyLocation in) {
- super(type, description);
+ super(Type.API_KEY, description);
this.in = in;
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/OpenIdConnectSecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/OpenIdConnectSecurityScheme.java
index 2d389ba0..e1e52549 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/OpenIdConnectSecurityScheme.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/OpenIdConnectSecurityScheme.java
@@ -25,13 +25,12 @@ public class OpenIdConnectSecurityScheme extends SecurityScheme {
* OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of a URL.
*/
@NotNull
- private String openIdConnectUrl;
+ private String openIdConnectUrl = "";
- @Builder(builderMethodName = "openIdConnectSecurityScheme")
- public OpenIdConnectSecurityScheme(@NotNull Type type,
- @Nullable String description,
+ @Builder(builderMethodName = "openIdBuilder")
+ public OpenIdConnectSecurityScheme(@Nullable String description,
@NotNull String openIdConnectUrl) {
- super(type, description);
+ super(Type.OPENID_CONNECT, description);
this.openIdConnectUrl = openIdConnectUrl;
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/SecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/SecurityScheme.java
index d316ffad..c250e778 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/SecurityScheme.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/SecurityScheme.java
@@ -80,7 +80,8 @@ public class SecurityScheme extends ExtendableObject {
*
*/
@NotNull
- private Type type;
+ @Builder.Default
+ private Type type = Type.USER_PASSWORD;
/**
* A short description for security scheme. CommonMark syntax MAY be used for rich text representation.
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpApiKeySecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpApiKeySecurityScheme.java
index 418098d7..13786bae 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpApiKeySecurityScheme.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpApiKeySecurityScheme.java
@@ -18,7 +18,7 @@
@Data
@NoArgsConstructor
@AllArgsConstructor
-@EqualsAndHashCode(callSuper = false)
+@EqualsAndHashCode(callSuper = true)
public class HttpApiKeySecurityScheme extends SecurityScheme {
/**
@@ -27,7 +27,7 @@ public class HttpApiKeySecurityScheme extends SecurityScheme {
* The name of the header, query or cookie parameter to be used.
*/
@NotNull
- private String name;
+ private String name = "";
/**
* REQUIRED.
@@ -37,12 +37,11 @@ public class HttpApiKeySecurityScheme extends SecurityScheme {
@Nullable
private ApiKeyLocation in;
- @Builder(builderMethodName = "httpApiKeySecuritySchemeBuilder")
- public HttpApiKeySecurityScheme(@NotNull Type type,
- @Nullable String description,
+ @Builder(builderMethodName = "httpApiKeyBuilder")
+ public HttpApiKeySecurityScheme(@Nullable String description,
@NotNull String name,
@Nullable ApiKeyLocation in) {
- super(type, description);
+ super(Type.HTTP_API_KEY, description);
this.name = name;
this.in = in;
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpSecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpSecurityScheme.java
index 3a779403..63b77d0a 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpSecurityScheme.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/http/HttpSecurityScheme.java
@@ -17,7 +17,7 @@
@Data
@NoArgsConstructor
@AllArgsConstructor
-@EqualsAndHashCode(callSuper = false)
+@EqualsAndHashCode(callSuper = true)
public class HttpSecurityScheme extends SecurityScheme {
/**
@@ -26,7 +26,7 @@ public class HttpSecurityScheme extends SecurityScheme {
* The name of the HTTP Authorization scheme to be used in the Authorization header as defined in RFC7235 .
*/
@NotNull
- private String scheme;
+ private String scheme = "";
/**
* A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated
@@ -35,12 +35,11 @@ public class HttpSecurityScheme extends SecurityScheme {
@Nullable
private String bearerFormat;
- @Builder(builderMethodName = "httpSecuritySchemeBuilder")
- public HttpSecurityScheme(@NotNull Type type,
- @Nullable String description,
+ @Builder(builderMethodName = "httpBuilder")
+ public HttpSecurityScheme(@Nullable String description,
@NotNull String scheme,
@Nullable String bearerFormat) {
- super(type, description);
+ super(Type.HTTP, description);
this.scheme = scheme;
this.bearerFormat = bearerFormat;
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/OAuth2SecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/OAuth2SecurityScheme.java
index e3543d35..7bb2b660 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/OAuth2SecurityScheme.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/OAuth2SecurityScheme.java
@@ -17,7 +17,7 @@
@Data
@NoArgsConstructor
@AllArgsConstructor
-@EqualsAndHashCode(callSuper = false)
+@EqualsAndHashCode(callSuper = true)
public class OAuth2SecurityScheme extends SecurityScheme {
/**
@@ -26,13 +26,12 @@ public class OAuth2SecurityScheme extends SecurityScheme {
* An object containing configuration information for the flow types supported.
*/
@NotNull
- private OAuthFlows flows;
+ private OAuthFlows flows = new OAuthFlows();
- @Builder(builderMethodName = "oauth2SecuritySchemeBuilder")
- public OAuth2SecurityScheme(@NotNull Type type,
- @Nullable String description,
+ @Builder(builderMethodName = "oauth2Builder")
+ public OAuth2SecurityScheme(@Nullable String description,
@NotNull OAuthFlows flows) {
- super(type, description);
+ super(Type.OAUTH2, description);
this.flows = flows;
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/AuthorizationCodeOAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/AuthorizationCodeOAuthFlow.java
index 686a0bce..34aeba7f 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/AuthorizationCodeOAuthFlow.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/AuthorizationCodeOAuthFlow.java
@@ -29,7 +29,7 @@ public class AuthorizationCodeOAuthFlow extends OAuthFlow {
* The authorization URL to be used for this flow. This MUST be in the form of an absolute URL.
*/
@NotNull
- private String authorizationUrl;
+ private String authorizationUrl = "";
/**
* REQUIRED.
@@ -37,9 +37,9 @@ public class AuthorizationCodeOAuthFlow extends OAuthFlow {
* The token URL to be used for this flow. This MUST be in the form of an absolute URL.
*/
@NotNull
- private String tokenUrl;
+ private String tokenUrl = "";
- @Builder(builderMethodName = "authorizationCodeOAuthFlowBuilder")
+ @Builder(builderMethodName = "authorizationCodeBuilder")
public AuthorizationCodeOAuthFlow(@Nullable String refreshUrl,
@NotNull Map scopes,
@NotNull String authorizationUrl,
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ClientCredentialsOAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ClientCredentialsOAuthFlow.java
index 749d9ca6..15e05e07 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ClientCredentialsOAuthFlow.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ClientCredentialsOAuthFlow.java
@@ -27,9 +27,9 @@ public class ClientCredentialsOAuthFlow extends OAuthFlow {
* The token URL to be used for this flow. This MUST be in the form of a URL.
*/
@NotNull
- private String tokenUrl;
+ private String tokenUrl = "";
- @Builder(builderMethodName = "clientCredentialsOAuthFlowBuilder")
+ @Builder(builderMethodName = "clientCredentialsBuilder")
public ClientCredentialsOAuthFlow(@Nullable String refreshUrl,
@NotNull Map scopes,
@NotNull String tokenUrl) {
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ImplicitOAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ImplicitOAuthFlow.java
index 704117b4..6518da51 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ImplicitOAuthFlow.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/ImplicitOAuthFlow.java
@@ -27,9 +27,9 @@ public class ImplicitOAuthFlow extends OAuthFlow {
* The authorization URL to be used for this flow. This MUST be in the form of a URL
*/
@NotNull
- private String authorizationUrl;
+ private String authorizationUrl = "";
- @Builder(builderMethodName = "implicitOAuthFlowBuilder")
+ @Builder(builderMethodName = "implicitBuilder")
public ImplicitOAuthFlow(@Nullable String refreshUrl,
@NotNull Map scopes,
@NotNull String authorizationUrl) {
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/OAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/OAuthFlow.java
index 4fec68c3..27e63b29 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/OAuthFlow.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/OAuthFlow.java
@@ -9,6 +9,7 @@
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
+import java.util.HashMap;
import java.util.Map;
/**
@@ -31,7 +32,8 @@ public class OAuthFlow extends ExtendableObject {
* The URL to be used for obtaining refresh tokens. This MUST be in the form of an absolute URL.
*/
@Nullable
- private String refreshUrl;
+ @Builder.Default
+ private String refreshUrl = "";
/**
* REQUIRED.
@@ -39,6 +41,7 @@ public class OAuthFlow extends ExtendableObject {
* The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it.
*/
@NotNull
- private Map scopes;
+ @Builder.Default
+ private Map scopes = new HashMap<>();
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/PasswordOAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/PasswordOAuthFlow.java
index 750ba2d3..693d219c 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/PasswordOAuthFlow.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v2/security_scheme/oauth2/flow/PasswordOAuthFlow.java
@@ -27,9 +27,9 @@ public class PasswordOAuthFlow extends OAuthFlow {
* The token URL to be used for this flow. This MUST be in the form of a URL.
*/
@NotNull
- private String tokenUrl;
+ private String tokenUrl = "";
- @Builder(builderMethodName = "passwordOAuthFlowBuilder")
+ @Builder(builderMethodName = "passwordBuilder")
public PasswordOAuthFlow(@Nullable String refreshUrl,
@NotNull Map scopes,
@NotNull String tokenUrl) {
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/ExtendableObject.java b/asyncapi-core/src/main/java/com/asyncapi/v3/ExtendableObject.java
new file mode 100644
index 00000000..f8bb988a
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/ExtendableObject.java
@@ -0,0 +1,56 @@
+package com.asyncapi.v3;
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter;
+import com.fasterxml.jackson.annotation.JsonAnySetter;
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.HashMap;
+import java.util.Map;
+import java.util.regex.Pattern;
+
+/**
+ * While the AsyncAPI Specification tries to accommodate most use cases,
+ * additional data can be added to extend the specification at certain points.
+ *
+ * The extensions properties are implemented as patterned fields that are always prefixed by "x-".
+ *
+ * The extensions may or may not be supported by the available tooling, but those may be extended as
+ * well to add requested support (if tools are internal or open-sourced).
+ *
+ * @see Specification Extensions
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@JsonIgnoreProperties({"extensionFields"})
+public class ExtendableObject {
+
+ private static final Pattern extensionPropertyNamePattern = Pattern.compile("^x-[\\w.\\x2d_]+$");
+
+ /**
+ * Extension fields in the form x-extension-field-name for the exposed API.
+ */
+ @Nullable
+ @JsonAnyGetter
+ protected Map extensionFields;
+
+ @JsonAnySetter
+ protected final void readExtensionProperty(String name, Object value) {
+ if (extensionPropertyNamePattern.matcher(name).matches()) {
+ if (extensionFields == null) {
+ extensionFields = new HashMap<>();
+ }
+
+ extensionFields.put(name, value);
+ } else {
+ throw new IllegalArgumentException(String.format("\"%s\" is not valid extension property", name));
+ }
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/Reference.java b/asyncapi-core/src/main/java/com/asyncapi/v3/Reference.java
similarity index 59%
rename from asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/Reference.java
rename to asyncapi-core/src/main/java/com/asyncapi/v3/Reference.java
index 3e417e76..05ac7c2f 100644
--- a/asyncapi-core/src/main/java/com/asyncapi/v2/_0_0/model/Reference.java
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/Reference.java
@@ -1,4 +1,4 @@
-package com.asyncapi.v2._0_0.model;
+package com.asyncapi.v3;
import com.fasterxml.jackson.annotation.JsonProperty;
import lombok.AllArgsConstructor;
@@ -8,18 +8,20 @@
/**
* A simple object to allow referencing other components in the specification, internally and externally.
- *
- * The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.
+ *
+ * The Reference Object is defined by JSON Reference and follows the same structure, behavior and rules.
* A JSON Reference SHALL only be used to refer to a schema that is formatted in either JSON or YAML.
* In the case of a YAML-formatted Schema, the JSON Reference SHALL be applied to the JSON representation of
- * that schema. The JSON representation SHALL be made by applying the conversion described here.
- *
+ * that schema. The JSON representation SHALL be made by applying the conversion described here .
+ *
* For this specification, reference resolution is done as defined by the JSON Reference specification and not by
* the JSON Schema specification.
+ *
+ * This object cannot be extended with additional properties and any properties added SHALL be ignored.
*
- * @version 2.0.0
- * @see Reference
+ * @see Reference
* @author Pavel Bodiachevskii
+ * @version 3.0.0
*/
@Data
@NoArgsConstructor
@@ -27,12 +29,12 @@
public class Reference {
/**
- * Required.
- *
+ * Required .
+ *
* The reference string.
*/
@NotNull
@JsonProperty(value = "$ref")
- private String ref;
+ private String ref = "";
}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/ExternalDocumentationDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/ExternalDocumentationDeserializer.java
new file mode 100644
index 00000000..b09ac314
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/ExternalDocumentationDeserializer.java
@@ -0,0 +1,23 @@
+package com.asyncapi.v3._0_0.jackson.model;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.ExternalDocumentation;
+import com.asyncapi.v3.jackson.ReferenceOrObjectDeserializer;
+
+/**
+ * Deserializes external documentation.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class ExternalDocumentationDeserializer extends ReferenceOrObjectDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return ExternalDocumentation.class;
+ }
+
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/TagsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/TagsDeserializer.java
new file mode 100644
index 00000000..71e39397
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/TagsDeserializer.java
@@ -0,0 +1,24 @@
+package com.asyncapi.v3._0_0.jackson.model;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.Tag;
+import com.asyncapi.v3.jackson.ListOfReferencesOrObjectsDeserializer;
+
+/**
+ * Deserializes tags.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class TagsDeserializer extends ListOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return Tag.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/ChannelParametersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/ChannelParametersDeserializer.java
new file mode 100644
index 00000000..88e86b94
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/ChannelParametersDeserializer.java
@@ -0,0 +1,25 @@
+package com.asyncapi.v3._0_0.jackson.model.channel;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.channel.Parameter;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+/**
+ * Serializes {@link com.asyncapi.v3._0_0.model.channel.Parameter} variables map.
+ *
+ * @version 3.0.0
+ * @author Pavel Bodiachevskii
+ */
+public class ChannelParametersDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return Parameter.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/ChannelsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/ChannelsDeserializer.java
new file mode 100644
index 00000000..c5cc3c01
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/ChannelsDeserializer.java
@@ -0,0 +1,24 @@
+package com.asyncapi.v3._0_0.jackson.model.channel;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.channel.Channel;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+/**
+ * Serializes component channels map.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class ChannelsDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return Channel.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessageCorrelationIdDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessageCorrelationIdDeserializer.java
new file mode 100644
index 00000000..7c0988c2
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessageCorrelationIdDeserializer.java
@@ -0,0 +1,23 @@
+package com.asyncapi.v3._0_0.jackson.model.channel.message;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.channel.message.CorrelationId;
+import com.asyncapi.v3.jackson.ReferenceOrObjectDeserializer;
+
+/**
+ * Serializes message correlation id.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class MessageCorrelationIdDeserializer extends ReferenceOrObjectDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return CorrelationId.class;
+ }
+
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessageHeadersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessageHeadersDeserializer.java
new file mode 100644
index 00000000..6bcb98c0
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessageHeadersDeserializer.java
@@ -0,0 +1,77 @@
+package com.asyncapi.v3._0_0.jackson.model.channel.message;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3.schema.Schema;
+import com.asyncapi.v3.schema.MultiFormatSchema;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.IOException;
+
+/**
+ * Serializes message traits list.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class MessageHeadersDeserializer extends JsonDeserializer {
+
+ @Override
+ public Object deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JsonProcessingException {
+ ObjectCodec objectCodec = p.getCodec();
+ JsonNode node = objectCodec.readTree(p);
+
+ /*
+ Problem:
+ Both, Reference class and Schema class have $ref field.
+ So, this is only reason why I receive next exception:
+ "com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException:
+ Unrecognized field "title" (class com.asyncapi.v2._6_0.model.Reference),
+ not marked as ignorable (one known property: "$ref"])"
+ in case when Schema contains $ref.
+ Solution:
+ Try to deserialize reference. In case of exception, try to deserialize it as given ObjectType. In case of
+ one more exception, throw it.
+ TODO: Think how to improve.
+ */
+ try {
+ return chooseKnownPojo(node, objectCodec);
+ } catch (UnrecognizedPropertyException unrecognizedPropertyException) {
+ return readAsObject(node, objectCodec);
+ }
+ }
+
+ private Object chooseKnownPojo(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ JsonNode ref = jsonNode.get("$ref");
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ if (isMultiFormatSchema(jsonNode)) {
+ return jsonParser.readValueAs(MultiFormatSchema.class);
+ }
+
+ if (ref != null) {
+ return jsonParser.readValueAs(Reference.class);
+ } else {
+ return jsonParser.readValueAs(Schema.class);
+ }
+ }
+ }
+
+ private Object readAsObject(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ return jsonParser.readValueAs(Schema.class);
+ }
+ }
+
+ private boolean isMultiFormatSchema(@NotNull JsonNode jsonNode) {
+ JsonNode schemaFormat = jsonNode.get("schemaFormat");
+ JsonNode schema = jsonNode.get("schema");
+
+ return (schemaFormat != null) && (schema != null);
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessagePayloadDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessagePayloadDeserializer.java
new file mode 100644
index 00000000..dcf51156
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessagePayloadDeserializer.java
@@ -0,0 +1,77 @@
+package com.asyncapi.v3._0_0.jackson.model.channel.message;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3.schema.MultiFormatSchema;
+import com.asyncapi.v3.schema.Schema;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.IOException;
+
+/**
+ * Serializes message traits list.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class MessagePayloadDeserializer extends JsonDeserializer {
+
+ @Override
+ public Object deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JsonProcessingException {
+ ObjectCodec objectCodec = p.getCodec();
+ JsonNode node = objectCodec.readTree(p);
+
+ /*
+ Problem:
+ Both, Reference class and Schema class have $ref field.
+ So, this is only reason why I receive next exception:
+ "com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException:
+ Unrecognized field "title" (class com.asyncapi.v2._6_0.model.Reference),
+ not marked as ignorable (one known property: "$ref"])"
+ in case when Schema contains $ref.
+ Solution:
+ Try to deserialize reference. In case of exception, try to deserialize it as given ObjectType. In case of
+ one more exception, throw it.
+ TODO: Think how to improve.
+ */
+ try {
+ return chooseKnownPojo(node, objectCodec);
+ } catch (UnrecognizedPropertyException unrecognizedPropertyException) {
+ return readAsObject(node, objectCodec);
+ }
+ }
+
+ private Object chooseKnownPojo(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ JsonNode ref = jsonNode.get("$ref");
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ if (isMultiFormatSchema(jsonNode)) {
+ return jsonParser.readValueAs(MultiFormatSchema.class);
+ }
+
+ if (ref != null) {
+ return jsonParser.readValueAs(Reference.class);
+ } else {
+ return jsonParser.readValueAs(Schema.class);
+ }
+ }
+ }
+
+ private Object readAsObject(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ return jsonParser.readValueAs(Schema.class);
+ }
+ }
+
+ private boolean isMultiFormatSchema(@NotNull JsonNode jsonNode) {
+ JsonNode schemaFormat = jsonNode.get("schemaFormat");
+ JsonNode schema = jsonNode.get("schema");
+
+ return (schemaFormat != null) && (schema != null);
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessageTraitsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessageTraitsDeserializer.java
new file mode 100644
index 00000000..c5e5058a
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessageTraitsDeserializer.java
@@ -0,0 +1,24 @@
+package com.asyncapi.v3._0_0.jackson.model.channel.message;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.channel.message.MessageTrait;
+import com.asyncapi.v3.jackson.ListOfReferencesOrObjectsDeserializer;
+
+/**
+ * Deserializes message traits.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class MessageTraitsDeserializer extends ListOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return MessageTrait.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessagesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessagesDeserializer.java
new file mode 100644
index 00000000..8438ddc2
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/channel/message/MessagesDeserializer.java
@@ -0,0 +1,25 @@
+package com.asyncapi.v3._0_0.jackson.model.channel.message;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.channel.message.Message;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+/**
+ * Serializes {@link Message} variables map.
+ *
+ * @version 3.0.0
+ * @author Pavel Bodiachevskii
+ */
+public class MessagesDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return Message.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsChannelsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsChannelsDeserializer.java
new file mode 100644
index 00000000..3a233979
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsChannelsDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.channel.Channel;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsChannelsDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return Channel.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsCorrelationIdsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsCorrelationIdsDeserializer.java
new file mode 100644
index 00000000..3ca82f14
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsCorrelationIdsDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.channel.message.CorrelationId;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsCorrelationIdsDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return CorrelationId.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsExternalDocsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsExternalDocsDeserializer.java
new file mode 100644
index 00000000..238f3197
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsExternalDocsDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.ExternalDocumentation;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsExternalDocsDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return ExternalDocumentation.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsMessageTraitsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsMessageTraitsDeserializer.java
new file mode 100644
index 00000000..766c33c1
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsMessageTraitsDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.channel.message.MessageTrait;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsMessageTraitsDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return MessageTrait.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsMessagesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsMessagesDeserializer.java
new file mode 100644
index 00000000..26c6c2e6
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsMessagesDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.channel.message.Message;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsMessagesDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return Message.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsOperationTraitsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsOperationTraitsDeserializer.java
new file mode 100644
index 00000000..23e65e59
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsOperationTraitsDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.operation.OperationTrait;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsOperationTraitsDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return OperationTrait.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsOperationsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsOperationsDeserializer.java
new file mode 100644
index 00000000..d78264e2
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsOperationsDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.operation.Operation;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsOperationsDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return Operation.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsParametersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsParametersDeserializer.java
new file mode 100644
index 00000000..b35829d3
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsParametersDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.channel.Parameter;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsParametersDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return Parameter.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsRepliesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsRepliesDeserializer.java
new file mode 100644
index 00000000..97f5e213
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsRepliesDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.operation.reply.OperationReply;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsRepliesDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return OperationReply.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsReplyAddressesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsReplyAddressesDeserializer.java
new file mode 100644
index 00000000..369f9154
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsReplyAddressesDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.operation.reply.OperationReplyAddress;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsReplyAddressesDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return OperationReplyAddress.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsSchemasDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsSchemasDeserializer.java
new file mode 100644
index 00000000..713d49b5
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsSchemasDeserializer.java
@@ -0,0 +1,95 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3.schema.MultiFormatSchema;
+import com.asyncapi.v3.schema.Schema;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import org.jetbrains.annotations.NotNull;
+
+import java.io.IOException;
+import java.util.HashMap;
+import java.util.Map;
+
+public class ComponentsSchemasDeserializer extends JsonDeserializer {
+
+ public Class objectTypeClass() {
+ return Schema.class;
+ }
+
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+ @Override
+ public Map deserialize(JsonParser jsonParser,
+ DeserializationContext deserializationContext
+ ) throws IOException, JsonProcessingException {
+ ObjectCodec objectCodec = jsonParser.getCodec();
+ JsonNode map = objectCodec.readTree(jsonParser);
+
+ Map parameters = new HashMap<>();
+
+ map.fieldNames().forEachRemaining(
+ fieldName -> {
+ /*
+ Problem:
+ Both, Reference class and Schema class have $ref field.
+ So, this is only reason why I receive next exception:
+ "com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException:
+ Unrecognized field "title" (class com.asyncapi.v2._6_0.model.Reference),
+ not marked as ignorable (one known property: "$ref"])"
+ in case when Schema contains $ref.
+ Solution:
+ Try to deserialize reference. In case of exception, try to deserialize it as given ObjectType. In case of
+ one more exception, throw it.
+ TODO: Think how to improve.
+ */
+ try {
+ parameters.put(fieldName, chooseKnownPojo(map.get(fieldName), objectCodec));
+ } catch (IOException ignore) {
+ try {
+ parameters.put(fieldName, readAsObject(map.get(fieldName), objectCodec));
+ } catch (IOException e) {
+ e.printStackTrace();
+ }
+ }
+ }
+ );
+
+ return parameters;
+ }
+
+ private Object chooseKnownPojo(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ JsonNode ref = jsonNode.get("$ref");
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ if (isMultiFormatSchema(jsonNode)) {
+ return jsonParser.readValueAs(MultiFormatSchema.class);
+ }
+
+ if (ref != null) {
+ return jsonParser.readValueAs(referenceClass());
+ } else {
+ return jsonParser.readValueAs(objectTypeClass());
+ }
+ }
+ }
+
+ private Object readAsObject(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ return jsonParser.readValueAs(objectTypeClass());
+ }
+ }
+
+ private boolean isMultiFormatSchema(@NotNull JsonNode jsonNode) {
+ JsonNode schemaFormat = jsonNode.get("schemaFormat");
+ JsonNode schema = jsonNode.get("schema");
+
+ return (schemaFormat != null) && (schema != null);
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsSecuritySchemesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsSecuritySchemesDeserializer.java
new file mode 100644
index 00000000..57f0dbbd
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsSecuritySchemesDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+import com.asyncapi.v3.security_scheme.SecurityScheme;
+
+public class ComponentsSecuritySchemesDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return SecurityScheme.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsServerVariablesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsServerVariablesDeserializer.java
new file mode 100644
index 00000000..2836d0df
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsServerVariablesDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.server.ServerVariable;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsServerVariablesDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return ServerVariable.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsServersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsServersDeserializer.java
new file mode 100644
index 00000000..64e77bfd
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsServersDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.server.Server;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsServersDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return Server.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsTagsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsTagsDeserializer.java
new file mode 100644
index 00000000..ef193b9f
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/component/ComponentsTagsDeserializer.java
@@ -0,0 +1,19 @@
+package com.asyncapi.v3._0_0.jackson.model.component;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.Tag;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+public class ComponentsTagsDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return Tag.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/operation/OperationTraitsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/operation/OperationTraitsDeserializer.java
new file mode 100644
index 00000000..ee7cf16b
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/operation/OperationTraitsDeserializer.java
@@ -0,0 +1,24 @@
+package com.asyncapi.v3._0_0.jackson.model.operation;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.operation.OperationTrait;
+import com.asyncapi.v3.jackson.ListOfReferencesOrObjectsDeserializer;
+
+/**
+ * Serializes operation traits list.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class OperationTraitsDeserializer extends ListOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return OperationTrait.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/operation/OperationsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/operation/OperationsDeserializer.java
new file mode 100644
index 00000000..12e3b8b8
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/operation/OperationsDeserializer.java
@@ -0,0 +1,24 @@
+package com.asyncapi.v3._0_0.jackson.model.operation;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.operation.Operation;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+/**
+ * Serializes component operations map.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class OperationsDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return Operation.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/operation/reply/OperationReplyAddressDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/operation/reply/OperationReplyAddressDeserializer.java
new file mode 100644
index 00000000..08d220cc
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/operation/reply/OperationReplyAddressDeserializer.java
@@ -0,0 +1,22 @@
+package com.asyncapi.v3._0_0.jackson.model.operation.reply;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.operation.reply.OperationReplyAddress;
+import com.asyncapi.v3.jackson.ReferenceOrObjectDeserializer;
+
+/**
+ * Serializes operation reply address
+ * @author Pavel Bodiachevskii
+ */
+public class OperationReplyAddressDeserializer extends ReferenceOrObjectDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return OperationReplyAddress.class;
+ }
+
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/operation/reply/OperationReplyDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/operation/reply/OperationReplyDeserializer.java
new file mode 100644
index 00000000..b019f92e
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/operation/reply/OperationReplyDeserializer.java
@@ -0,0 +1,22 @@
+package com.asyncapi.v3._0_0.jackson.model.operation.reply;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.operation.reply.OperationReply;
+import com.asyncapi.v3.jackson.ReferenceOrObjectDeserializer;
+
+/**
+ * Serializes operation reply
+ * @author Pavel Bodiachevskii
+ */
+public class OperationReplyDeserializer extends ReferenceOrObjectDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return OperationReply.class;
+ }
+
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/server/ServerVariablesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/server/ServerVariablesDeserializer.java
new file mode 100644
index 00000000..2f31028a
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/server/ServerVariablesDeserializer.java
@@ -0,0 +1,25 @@
+package com.asyncapi.v3._0_0.jackson.model.server;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.server.ServerVariable;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+/**
+ * Serializes {@link com.asyncapi.v3._0_0.model.server.Server} variables map.
+ *
+ * @version 3.0.0
+ * @author Pavel Bodiachevskii
+ */
+public class ServerVariablesDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return ServerVariable.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/server/ServersDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/server/ServersDeserializer.java
new file mode 100644
index 00000000..9639ed77
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/jackson/model/server/ServersDeserializer.java
@@ -0,0 +1,24 @@
+package com.asyncapi.v3._0_0.jackson.model.server;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.server.Server;
+import com.asyncapi.v3.jackson.MapOfReferencesOrObjectsDeserializer;
+
+/**
+ * Serializes component servers map.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class ServersDeserializer extends MapOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return Server.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/AsyncAPI.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/AsyncAPI.java
new file mode 100644
index 00000000..80e68798
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/AsyncAPI.java
@@ -0,0 +1,137 @@
+package com.asyncapi.v3._0_0.model;
+
+import com.asyncapi.v3.ExtendableObject;
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.jackson.model.channel.ChannelsDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.operation.OperationsDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.server.ServersDeserializer;
+import com.asyncapi.v3._0_0.model.channel.Channel;
+import com.asyncapi.v3._0_0.model.component.Components;
+import com.asyncapi.v3._0_0.model.info.Info;
+import com.asyncapi.v3._0_0.model.operation.Operation;
+import com.asyncapi.v3._0_0.model.server.Server;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * This is the root document object for the API specification.
+ * It combines resource listing and API declaration together into one document.
+ *
+ * @version 3.0.0
+ * @see AsyncAPI
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class AsyncAPI extends ExtendableObject {
+
+ /**
+ * Required .
+ *
+ * Specifies the AsyncAPI Specification version being used.
+ * It can be used by tooling Specifications and clients to interpret the version.
+ * The structure shall be major.minor.patch, where patch versions must be compatible
+ * with the existing major.minor tooling.
+ *
+ * Typically patch versions will be introduced to address errors in the documentation,
+ * and tooling should typically be compatible with the corresponding major.minor (1.0.*).
+ * Patch versions will correspond to patches of this document.
+ */
+ @NotNull
+ @Builder.Default
+ private final String asyncapi = "3.0.0";
+
+ /**
+ * Identifier of the application the AsyncAPI document is defining.
+ *
+ * This field represents a unique universal identifier of the application the AsyncAPI document is defining.
+ * It must conform to the URI format, according to RFC3986 .
+ *
+ * It is RECOMMENDED to use a URN to globally and uniquely identify the application during long periods of time,
+ * even after it becomes unavailable or ceases to exist.
+ */
+ @Nullable
+ private String id;
+
+ /**
+ * A string representing the default content type to use when encoding/decoding a message's payload.
+ *
+ * The value MUST be a specific media type (e.g. application/json).
+ *
+ * This value MUST be used by schema parsers when the contentType property is omitted.
+ *
+ * In case a message can't be encoded/decoded using this value, schema parsers MUST use their default content type.
+ */
+ @Nullable
+ private String defaultContentType;
+
+ /**
+ * Required .
+ *
+ * Provides metadata about the API. The metadata can be used by the clients if needed.
+ */
+ @NotNull
+ @Builder.Default
+ private Info info = new Info();
+
+ /**
+ * Provides connection details of servers.
+ *
+ * MUST BE:
+ *
+ * {@link Server}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @Builder.Default
+ @JsonDeserialize(using = ServersDeserializer.class)
+ private Map servers = new HashMap<>();
+
+ /**
+ * The channels used by this application .
+ *
+ * MUST BE:
+ *
+ * {@link Channel}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @Builder.Default
+ @JsonDeserialize(using = ChannelsDeserializer.class)
+ private Map channels = new HashMap<>();
+
+ /**
+ * The operations this application MUST implement.
+ *
+ * MUST BE:
+ *
+ * {@link Operation}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @Builder.Default
+ @JsonDeserialize(using = OperationsDeserializer.class)
+ private Map operations = new HashMap<>();
+
+ /**
+ * An element to hold various reusable objects for the specification.
+ *
+ * Everything that is defined inside this object represents a resource that MAY or MAY NOT be used in the
+ * rest of the document and MAY or MAY NOT be used by the implemented application .
+ */
+ @Nullable
+ private Components components;
+
+}
+
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/ExternalDocumentation.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/ExternalDocumentation.java
new file mode 100644
index 00000000..55b14b20
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/ExternalDocumentation.java
@@ -0,0 +1,37 @@
+package com.asyncapi.v3._0_0.model;
+
+import com.asyncapi.v3.ExtendableObject;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Allows referencing an external resource for extended documentation.
+ *
+ * @see ExternalDocumentation
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class ExternalDocumentation extends ExtendableObject {
+
+ /**
+ * A short description of the target documentation. CommonMark syntax can be used for rich text representation.
+ */
+ @Nullable
+ private String description;
+
+ /**
+ * Required .
+ *
+ * The URL for the target documentation. Value MUST be in the format of a URL.
+ */
+ @NotNull
+ @Builder.Default
+ private String url = "";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/Tag.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/Tag.java
new file mode 100644
index 00000000..7b77f09c
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/Tag.java
@@ -0,0 +1,52 @@
+package com.asyncapi.v3._0_0.model;
+
+import com.asyncapi.v3.ExtendableObject;
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.jackson.model.ExternalDocumentationDeserializer;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Allows adding meta data to a single tag.
+ *
+ * @see Tag
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class Tag extends ExtendableObject {
+
+ /**
+ * Required .
+ *
+ * The name of the tag.
+ */
+ @NotNull
+ @Builder.Default
+ private String name = "";
+
+ /**
+ * A short description for the tag. CommonMark syntax can be used for rich text representation.
+ */
+ @Nullable
+ private String description;
+
+ /**
+ * Additional external documentation for this tag.
+ * MUST BE:
+ *
+ * {@link ExternalDocumentation}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ExternalDocumentationDeserializer.class)
+ private Object externalDocs;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/Channel.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/Channel.java
new file mode 100644
index 00000000..8c93f831
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/Channel.java
@@ -0,0 +1,158 @@
+package com.asyncapi.v3._0_0.model.channel;
+
+import com.asyncapi.v3.ExtendableObject;
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.jackson.model.ExternalDocumentationDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.TagsDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.channel.message.MessagesDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.channel.ChannelParametersDeserializer;
+import com.asyncapi.v3._0_0.model.ExternalDocumentation;
+import com.asyncapi.v3._0_0.model.Tag;
+import com.asyncapi.v3._0_0.model.channel.message.Message;
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import com.asyncapi.v3.jackson.binding.channel.ChannelBindingsDeserializer;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Describes a shared communication channel.
+ *
+ * @see Channel
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class Channel extends ExtendableObject {
+
+ /**
+ * An optional string representation of this channel's address. The address is typically the "topic name",
+ * "routing key", "event type", or "path".
+ *
+ * When null or absent, it MUST be interpreted as unknown.
+ * This is useful when the address is generated dynamically at runtime or can't be known upfront.
+ *
+ * It MAY contain Channel Address Expressions like {@code {userId}}
+ *
+ * Query parameters and fragments SHALL NOT be used, instead use {@link ChannelBinding} to define them.
+ *
+ * @see Channel bindings
+ * @see Channel Address Expressions
+ */
+ @Nullable
+ private String address;
+
+ /**
+ * A human-friendly title for the channel.
+ */
+ @Nullable
+ private String title;
+
+ /**
+ * A short summary of the channel.
+ */
+ @Nullable
+ private String summary;
+
+ /**
+ * An optional description of this channel. CommonMark syntax can be used for rich text representation.
+ */
+ @Nullable
+ private String description;
+
+ /**
+ * An array of $ref pointers to the definition of the servers in which this channel is available.
+ *
+ * If the channel is located in the {@link com.asyncapi.v3._0_0.model.AsyncAPI#getChannels()},
+ * it MUST point to a subset of server definitions located in the {@link com.asyncapi.v3._0_0.model.AsyncAPI#getServers()},
+ * and MUST NOT point to a subset of server definitions located in the {@link com.asyncapi.v3._0_0.model.AsyncAPI#getComponents()} or anywhere else.
+ *
+ * If the channel is located in the {@link com.asyncapi.v3._0_0.model.AsyncAPI#getComponents()}, it MAY point to a Server Objects in any location.
+ *
+ * If servers is absent or empty, this channel MUST be available on all the servers defined in {@link com.asyncapi.v3._0_0.model.AsyncAPI#getServers()}.
+ *
+ * However, it is RECOMMENDED that parsers (or other software) dereference this property
+ * for a better development experience.
+ */
+ @Nullable
+ private List servers;
+
+ /**
+ * A map of the parameters included in the channel address.
+ *
+ * It MUST be present only when the address contains Channel Address Expressions like {@code {userId}}.
+ *
+ * MUST BE:
+ *
+ * {@link Parameter}
+ * {@link Reference}
+ *
+ *
+ * @see Channel Address Expressions
+ */
+ @Nullable
+ @JsonDeserialize(using = ChannelParametersDeserializer.class)
+ private Map parameters;
+
+ /**
+ * A map of the messages that will be sent to this channel by any application at any time.
+ *
+ * Every message sent to this channel MUST be valid against one, and only one, of the {@link Message} defined in this map.
+ *
+ * MUST BE:
+ *
+ * {@link Message}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = MessagesDeserializer.class)
+ private Map messages;
+
+ /**
+ * A map where the keys describe the name of the protocol and the values describe protocol-specific definitions for the channel.
+ *
+ * MUST BE:
+ *
+ * {@link ChannelBinding}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ChannelBindingsDeserializer.class)
+ private Map bindings;
+
+ /**
+ * A list of tags for logical grouping of channels.
+ *
+ * MUST BE:
+ *
+ * {@link Tag}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = TagsDeserializer.class)
+ private List tags;
+
+ /**
+ * Additional external documentation for this channel.
+ *
+ * MUST BE:
+ *
+ * {@link ExternalDocumentation}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ExternalDocumentationDeserializer.class)
+ private Object externalDocs;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/Parameter.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/Parameter.java
new file mode 100644
index 00000000..2196d2e2
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/Parameter.java
@@ -0,0 +1,58 @@
+package com.asyncapi.v3._0_0.model.channel;
+
+import com.asyncapi.v3.ExtendableObject;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * Describes a parameter included in a channel address.
+ *
+ * @see Parameter
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class Parameter extends ExtendableObject {
+
+ /**
+ * An optional description for the parameter. CommonMark syntax MAY be used for rich text representation.
+ */
+ @Nullable
+ private String description;
+
+ /**
+ * The default value to use for substitution, and to send, if an alternate value is not supplied.
+ */
+ @Nullable
+ @JsonProperty("default")
+ private String defaultValue;
+
+ /**
+ * An enumeration of string values to be used if the substitution options are from a limited set.
+ */
+ @Nullable
+ @JsonProperty("enum")
+ private List enumValues;
+
+ /**
+ * An array of examples of the parameter value.
+ */
+ @Nullable
+ private List examples;
+
+ /**
+ * A runtime expression that specifies the location of the parameter value.
+ *
+ * @see Runtime Expression
+ */
+ @Nullable
+ private String location;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/message/CorrelationId.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/message/CorrelationId.java
new file mode 100644
index 00000000..b7bfea89
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/message/CorrelationId.java
@@ -0,0 +1,40 @@
+package com.asyncapi.v3._0_0.model.channel.message;
+
+import com.asyncapi.v3.ExtendableObject;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * An object that specifies an identifier at design time that can used for message tracing and correlation.
+ * Correlation ID
+ * @see Runtime Expression
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class CorrelationId extends ExtendableObject {
+
+ /**
+ * An optional description of the identifier. CommonMark syntax can be used for rich text representation.
+ */
+ @Nullable
+ private String description;
+
+ /**
+ * REQUIRED .
+ *
+ * A runtime expression that specifies the location of the correlation ID.
+ */
+ @NotNull
+ @Builder.Default
+ private String location = "";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/message/Message.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/message/Message.java
new file mode 100644
index 00000000..a25dcb8c
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/message/Message.java
@@ -0,0 +1,181 @@
+package com.asyncapi.v3._0_0.model.channel.message;
+
+import com.asyncapi.v3.ExtendableObject;
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.jackson.model.ExternalDocumentationDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.TagsDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.channel.message.MessageCorrelationIdDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.channel.message.MessageTraitsDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.channel.message.MessageHeadersDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.channel.message.MessagePayloadDeserializer;
+import com.asyncapi.v3._0_0.model.ExternalDocumentation;
+import com.asyncapi.v3._0_0.model.Tag;
+import com.asyncapi.v3.jackson.binding.message.MessageBindingsDeserializer;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Describes a message received on a given channel and operation.
+ *
+ * @see Message
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class Message extends ExtendableObject {
+
+ /**
+ * Schema definition of the application headers.
+ *
+ * Schema MUST be a map of key-value pairs.
+ *
+ * It MUST NOT define the protocol headers.
+ *
+ * If this is a {@link com.asyncapi.v3.schema.Schema}, then the schemaFormat will be assumed to
+ * be "application/vnd.aai.asyncapi+json;version=asyncapi" where the version
+ * is equal to the AsyncAPI Version String.
+ *
+ * MUST BE:
+ *
+ * {@link com.asyncapi.v3.schema.Schema}
+ * {@link com.asyncapi.v3.schema.MultiFormatSchema}
+ * {@link com.asyncapi.v3.Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = MessageHeadersDeserializer.class)
+ private Object headers;
+
+ /**
+ * Definition of the message payload.
+ *
+ * If this is a {@link com.asyncapi.v3.schema.Schema}, then the schemaFormat will be assumed to be
+ * "application/vnd.aai.asyncapi+json;version=asyncapi" where the version is equal to the AsyncAPI Version String.
+ *
+ * MUST BE:
+ *
+ * {@link com.asyncapi.v3.schema.Schema}
+ * {@link com.asyncapi.v3.schema.MultiFormatSchema}
+ * {@link com.asyncapi.v3.Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = MessagePayloadDeserializer.class)
+ private Object payload;
+
+ /**
+ * Definition of the correlation ID used for message tracing or matching.
+ *
+ * MUST BE:
+ *
+ * {@link CorrelationId}
+ * {@link com.asyncapi.v3.Reference}
+ *
+ */
+ @JsonDeserialize(using = MessageCorrelationIdDeserializer.class)
+ private Object correlationId;
+
+ /**
+ * The content type to use when encoding/decoding a message's payload.
+ *
+ * The value MUST be a specific media type (e.g. application/json).
+ *
+ * When omitted, the value MUST be the one specified on the {@link com.asyncapi.v3._0_0.model.AsyncAPI#getDefaultContentType()} field.
+ */
+ @Nullable
+ private String contentType;
+
+ /**
+ * A machine-friendly name for the message.
+ */
+ @Nullable
+ private String name;
+
+ /**
+ * A human-friendly title for the message.
+ */
+ @Nullable
+ private String title;
+
+ /**
+ * A short summary of what the message is about.
+ */
+ @Nullable
+ private String summary;
+
+ /**
+ * A verbose explanation of the message. CommonMark syntax can be used for rich text representation.
+ */
+ @Nullable
+ private String description;
+
+ /**
+ * A map where the keys describe the name of the protocol and the values describe protocol-specific definitions for the message.
+ *
+ * MUST BE:
+ *
+ * {@link com.asyncapi.v3.binding.message.MessageBinding}
+ * {@link com.asyncapi.v3.Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = MessageBindingsDeserializer.class)
+ private Map bindings;
+
+ /**
+ * List of examples.
+ */
+ @Nullable
+ private List examples;
+
+ /**
+ * A list of traits to apply to the message object. Traits MUST be merged using traits merge mechanism.
+ * The resulting object MUST be a valid {@link Message}.
+ *
+ * MUST BE:
+ *
+ * {@link com.asyncapi.v3._0_0.model.channel.message.MessageTrait}
+ * {@link com.asyncapi.v3.Reference}
+ *
+ *
+ * @see Traits Merge Mechanism
+ */
+ @Nullable
+ @JsonDeserialize(using = MessageTraitsDeserializer.class)
+ private List traits;
+
+ /**
+ * A list of tags for logical grouping and categorization of messages.
+ *
+ * MUST BE:
+ *
+ * {@link Tag}
+ * {@link com.asyncapi.v3.Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = TagsDeserializer.class)
+ private List tags;
+
+ /**
+ * Additional external documentation for this message.
+ *
+ * MUST BE:
+ *
+ * {@link ExternalDocumentation}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ExternalDocumentationDeserializer.class)
+ private Object externalDocs;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/message/MessageExample.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/message/MessageExample.java
new file mode 100644
index 00000000..6593ff02
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/message/MessageExample.java
@@ -0,0 +1,47 @@
+package com.asyncapi.v3._0_0.model.channel.message;
+
+import com.asyncapi.v3.ExtendableObject;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Map;
+
+/**
+ * Message Example Object represents an example of a {@link Message} Object and MUST contain either {@link Message} headers and/or {@link Message} fields.
+ *
+ * @see Message Example
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MessageExample extends ExtendableObject {
+
+ /**
+ * The value of this field MUST validate against the {@link Message} headers field.
+ */
+ @Nullable
+ public Map headers;
+
+ /**
+ * The value of this field MUST validate against the Message {@link Message} payload field.
+ */
+ @Nullable
+ public Map payload;
+
+ /**
+ * A machine-friendly name.
+ */
+ @Nullable
+ private String name;
+
+ /**
+ * A short summary of what the example is about.
+ */
+ @Nullable
+ private String summary;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/message/MessageTrait.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/message/MessageTrait.java
new file mode 100644
index 00000000..fc0fad74
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/channel/message/MessageTrait.java
@@ -0,0 +1,148 @@
+package com.asyncapi.v3._0_0.model.channel.message;
+
+import com.asyncapi.v3.ExtendableObject;
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.jackson.model.ExternalDocumentationDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.TagsDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.channel.message.MessageCorrelationIdDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.channel.message.MessageHeadersDeserializer;
+import com.asyncapi.v3._0_0.model.ExternalDocumentation;
+import com.asyncapi.v3._0_0.model.Tag;
+import com.asyncapi.v3.jackson.binding.message.MessageBindingsDeserializer;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Describes a trait that MAY be applied to a {@link Message}.
+ *
+ * This object MAY contain any property from the {@link Message}, except {@link Message} payload and {@link Message} traits.
+ *
+ * @see Message Trait
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MessageTrait extends ExtendableObject {
+
+ /**
+ * Schema definition of the application headers.
+ *
+ * Schema MUST be a map of key-value pairs.
+ *
+ * It MUST NOT define the protocol headers.
+ *
+ * If this is a {@link com.asyncapi.v3.schema.Schema}, then the schemaFormat will be assumed to
+ * be "application/vnd.aai.asyncapi+json;version=asyncapi" where the version
+ * is equal to the AsyncAPI Version String.
+ *
+ * MUST BE:
+ *
+ * {@link com.asyncapi.v3.schema.Schema}
+ * {@link com.asyncapi.v3.schema.MultiFormatSchema}
+ * {@link com.asyncapi.v3.Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = MessageHeadersDeserializer.class)
+ private Object headers;
+
+ /**
+ * Definition of the correlation ID used for message tracing or matching.
+ *
+ * MUST BE:
+ *
+ * {@link CorrelationId}
+ * {@link com.asyncapi.v3.Reference}
+ *
+ */
+ @JsonDeserialize(using = MessageCorrelationIdDeserializer.class)
+ private Object correlationId;
+
+ /**
+ * The content type to use when encoding/decoding a message's payload.
+ *
+ * The value MUST be a specific media type (e.g. application/json).
+ *
+ * When omitted, the value MUST be the one specified on the {@link com.asyncapi.v3._0_0.model.AsyncAPI#getDefaultContentType()} field.
+ */
+ @Nullable
+ private String contentType;
+
+ /**
+ * A machine-friendly name for the message.
+ */
+ @Nullable
+ private String name;
+
+ /**
+ * A human-friendly title for the message.
+ */
+ @Nullable
+ private String title;
+
+ /**
+ * A short summary of what the message is about.
+ */
+ @Nullable
+ private String summary;
+
+ /**
+ * A verbose explanation of the message. CommonMark syntax can be used for rich text representation.
+ */
+ @Nullable
+ private String description;
+
+ /**
+ * A map where the keys describe the name of the protocol and the values describe protocol-specific definitions for the message.
+ *
+ * MUST BE:
+ *
+ * {@link com.asyncapi.v3.binding.message.MessageBinding}
+ * {@link com.asyncapi.v3.Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = MessageBindingsDeserializer.class)
+ private Map bindings;
+
+ /**
+ * List of examples.
+ */
+ @Nullable
+ private List examples;
+
+ /**
+ * A list of tags for logical grouping and categorization of messages.
+ *
+ * MUST BE:
+ *
+ * {@link Tag}
+ * {@link com.asyncapi.v3.Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = TagsDeserializer.class)
+ private List tags;
+
+ /**
+ * Additional external documentation for this message.
+ *
+ * MUST BE:
+ *
+ * {@link ExternalDocumentation}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ExternalDocumentationDeserializer.class)
+ private Object externalDocs;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/component/Components.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/component/Components.java
new file mode 100644
index 00000000..263425fa
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/component/Components.java
@@ -0,0 +1,297 @@
+package com.asyncapi.v3._0_0.model.component;
+
+import com.asyncapi.v3._0_0.jackson.model.component.*;
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.model.ExternalDocumentation;
+import com.asyncapi.v3._0_0.model.Tag;
+import com.asyncapi.v3._0_0.model.channel.Channel;
+import com.asyncapi.v3._0_0.model.channel.Parameter;
+import com.asyncapi.v3._0_0.model.channel.message.CorrelationId;
+import com.asyncapi.v3._0_0.model.channel.message.Message;
+import com.asyncapi.v3._0_0.model.channel.message.MessageTrait;
+import com.asyncapi.v3._0_0.model.operation.Operation;
+import com.asyncapi.v3._0_0.model.operation.OperationTrait;
+import com.asyncapi.v3._0_0.model.operation.reply.OperationReply;
+import com.asyncapi.v3._0_0.model.operation.reply.OperationReplyAddress;
+import com.asyncapi.v3._0_0.model.server.Server;
+import com.asyncapi.v3._0_0.model.server.ServerVariable;
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import com.asyncapi.v3.binding.message.MessageBinding;
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import com.asyncapi.v3.binding.server.ServerBinding;
+import com.asyncapi.v3.jackson.binding.channel.ChannelBindingsDeserializer;
+import com.asyncapi.v3.jackson.binding.message.MessageBindingsDeserializer;
+import com.asyncapi.v3.jackson.binding.operation.OperationBindingsDeserializer;
+import com.asyncapi.v3.jackson.binding.server.ServerBindingsDeserializer;
+import com.asyncapi.v3.schema.MultiFormatSchema;
+import com.asyncapi.v3.schema.Schema;
+import com.asyncapi.v3.security_scheme.SecurityScheme;
+import com.asyncapi.v3.ExtendableObject;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Map;
+
+/**
+ * Holds a set of reusable objects for different aspects of the AsyncAPI specification.
+ * All objects defined within the components object will have no effect on the API unless they are explicitly referenced
+ * from properties outside the components object.
+ *
+ * @see Components Object
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class Components extends ExtendableObject {
+
+ /**
+ * An object to hold reusable Schema Object.
+ *
+ * If this is a {@link Schema}, then the schemaFormat will be assumed to be "application/vnd.aai.asyncapi+json;version=asyncapi"
+ * where the version is equal to the AsyncAPI Version String.
+ *
+ * MUST BE:
+ *
+ * {@link Schema}
+ * {@link MultiFormatSchema}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsSchemasDeserializer.class)
+ private Map schemas;
+
+ /**
+ * An object to hold reusable {@link Server} Objects.
+ *
+ * MUST BE:
+ *
+ * {@link Server}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsServersDeserializer.class)
+ private Map servers;
+
+ /**
+ * An object to hold reusable {@link ServerVariable} Objects.
+ *
+ * MUST BE:
+ *
+ * {@link ServerVariable}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsServerVariablesDeserializer.class)
+ private Map serverVariables;
+
+ /**
+ * An object to hold reusable {@link Channel} Objects.
+ *
+ * MUST BE:
+ *
+ * {@link Channel}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsChannelsDeserializer.class)
+ private Map channels;
+
+ /**
+ * An object to hold reusable {@link Operation} Objects.
+ *
+ * MUST BE:
+ *
+ * {@link Operation}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsOperationsDeserializer.class)
+ private Map operations;
+
+ /**
+ * An object to hold reusable {@link OperationReply} Objects.
+ *
+ * MUST BE:
+ *
+ * {@link OperationReply}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsRepliesDeserializer.class)
+ private Map replies;
+
+ /**
+ * An object to hold reusable {@link OperationReplyAddress} Objects.
+ *
+ * MUST BE:
+ *
+ * {@link OperationReplyAddress}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsReplyAddressesDeserializer.class)
+ private Map replyAddresses;
+
+ /**
+ * An object to hold reusable {@link Message} Objects.
+ *
+ * MUST BE:
+ *
+ * {@link Message}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsMessagesDeserializer.class)
+ private Map messages;
+
+ /**
+ * An object to hold reusable {@link SecurityScheme} Objects.
+ *
+ * MUST BE:
+ *
+ * {@link SecurityScheme}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsSecuritySchemesDeserializer.class)
+ private Map securitySchemes;
+
+ /**
+ * An object to hold reusable {@link Parameter} Objects.
+ *
+ * MUST BE:
+ *
+ * {@link Parameter}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsParametersDeserializer.class)
+ private Map parameters;
+
+ /**
+ * An object to hold reusable {@link CorrelationId} Objects.
+ *
+ * MUST BE:
+ *
+ * {@link CorrelationId}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsCorrelationIdsDeserializer.class)
+ private Map correlationIds;
+
+ /**
+ * An object to hold reusable {@link OperationTrait} Objects.
+ *
+ * MUST BE:
+ *
+ * {@link OperationTrait}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsOperationTraitsDeserializer.class)
+ private Map operationTraits;
+
+ /**
+ * An object to hold reusable {@link MessageTrait} Objects.
+ *
+ * MUST BE:
+ *
+ * {@link MessageTrait}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsMessageTraitsDeserializer.class)
+ private Map messageTraits;
+
+ /**
+ * An object to hold reusable {@link ServerBinding} Objects.
+ * MUST BE:
+ *
+ * {@link ServerBinding}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ServerBindingsDeserializer.class)
+ private Map serverBindings;
+
+ /**
+ * An object to hold reusable {@link ChannelBinding} Objects.
+ * MUST BE:
+ *
+ * {@link ChannelBinding}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ChannelBindingsDeserializer.class)
+ private Map channelBindings;
+
+ /**
+ * An object to hold reusable {@link OperationBinding} Objects.
+ * MUST BE:
+ *
+ * {@link OperationBinding}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = OperationBindingsDeserializer.class)
+ private Map operationBindings;
+
+ /**
+ * An object to hold reusable {@link MessageBinding} Objects.
+ * MUST BE:
+ *
+ * {@link MessageBinding}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = MessageBindingsDeserializer.class)
+ private Map messageBindings;
+
+ /**
+ * An object to hold reusable {@link ExternalDocumentation} Objects.
+ * MUST BE:
+ *
+ * {@link ExternalDocumentation}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsExternalDocsDeserializer.class)
+ private Map externalDocs;
+
+ /**
+ * An object to hold reusable {@link Tag} Objects.
+ * MUST BE:
+ *
+ * {@link Tag}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ComponentsTagsDeserializer.class)
+ private Map tags;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/info/Contact.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/info/Contact.java
new file mode 100644
index 00000000..bd2af1b2
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/info/Contact.java
@@ -0,0 +1,39 @@
+package com.asyncapi.v3._0_0.model.info;
+
+import com.asyncapi.v3.ExtendableObject;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Contact information for the exposed API.
+ *
+ * @see Contact
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class Contact extends ExtendableObject {
+
+ /**
+ * The identifying name of the contact person/organization.
+ */
+ @Nullable
+ private String name;
+
+ /**
+ * The URL pointing to the contact information. This MUST be in the form of an absolute URL.
+ */
+ @Nullable
+ private String url;
+
+ /**
+ * The email address of the contact person/organization. MUST be in the format of an email address.
+ */
+ @Nullable
+ private String email;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/info/Info.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/info/Info.java
new file mode 100644
index 00000000..b9a131c3
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/info/Info.java
@@ -0,0 +1,108 @@
+package com.asyncapi.v3._0_0.model.info;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.jackson.model.ExternalDocumentationDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.TagsDeserializer;
+import com.asyncapi.v3._0_0.model.ExternalDocumentation;
+import com.asyncapi.v3._0_0.model.Tag;
+import com.asyncapi.v3.ExtendableObject;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * The object provides metadata about the API. The metadata can be used by the clients if needed.
+ *
+ * @see Info
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class Info extends ExtendableObject {
+
+ /**
+ * Required .
+ *
+ * The title of the application.
+ */
+ @NotNull
+ @JsonProperty
+ @Builder.Default
+ private String title = "";
+
+ /**
+ * Required .
+ *
+ * Provides the version of the application API (not to be confused with the specification version).
+ */
+ @NotNull
+ @JsonProperty
+ @Builder.Default
+ private String version = "";
+
+ /**
+ * A short description of the application. CommonMark syntax can be used
+ * for rich text representation.
+ */
+ @Nullable
+ @JsonProperty
+ private String description;
+
+ /**
+ * A URL to the Terms of Service for the API. This MUST be in the form of an absolute URL.
+ */
+ @Nullable
+ @JsonProperty
+ private String termsOfService;
+
+ /**
+ * The contact information for the exposed API.
+ */
+ @Nullable
+ @JsonProperty
+ private Contact contact;
+
+ /**
+ * The license information for the exposed API.
+ */
+ @Nullable
+ @JsonProperty
+ private License license;
+
+ /**
+ * A list of tags for application API documentation control. Tags can be used for logical grouping of applications.
+ *
+ * MUST BE:
+ *
+ * {@link Tag}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonProperty
+ @JsonDeserialize(using = TagsDeserializer.class)
+ private List tags;
+
+ /**
+ * Additional external documentation of the exposed API.
+ *
+ * MUST BE:
+ *
+ * {@link ExternalDocumentation}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonProperty
+ @JsonDeserialize(using = ExternalDocumentationDeserializer.class)
+ private Object externalDocs;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/info/License.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/info/License.java
new file mode 100644
index 00000000..415dd90b
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/info/License.java
@@ -0,0 +1,37 @@
+package com.asyncapi.v3._0_0.model.info;
+
+import com.asyncapi.v3.ExtendableObject;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * License information for the exposed API.
+ *
+ * @see License
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class License extends ExtendableObject {
+
+ /**
+ * Required .
+ *
+ * The license name used for the API.
+ */
+ @NotNull
+ @Builder.Default
+ private String name = "";
+
+ /**
+ * A URL to the license used for the API. This MUST be in the form of an absolute URL.
+ */
+ @Nullable
+ private String url;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/Operation.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/Operation.java
new file mode 100644
index 00000000..81310044
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/Operation.java
@@ -0,0 +1,183 @@
+package com.asyncapi.v3._0_0.model.operation;
+
+import com.asyncapi.v3.ExtendableObject;
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.jackson.model.ExternalDocumentationDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.TagsDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.operation.OperationTraitsDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.operation.reply.OperationReplyDeserializer;
+import com.asyncapi.v3._0_0.model.ExternalDocumentation;
+import com.asyncapi.v3._0_0.model.Tag;
+import com.asyncapi.v3._0_0.model.operation.reply.OperationReply;
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import com.asyncapi.v3.jackson.binding.operation.OperationBindingsDeserializer;
+import com.asyncapi.v3.jackson.security_scheme.SecuritySchemesDeserializer;
+import com.asyncapi.v3.security_scheme.SecurityScheme;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Describes a specific operation.
+ *
+ * @see Operation
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class Operation extends ExtendableObject {
+
+ /**
+ * Required .
+ *
+ * Use send when it's expected that the application will send a message to the given {@link com.asyncapi.v3._0_0.model.channel.Channel},
+ * and receive when the application should expect receiving messages from the given {@link com.asyncapi.v3._0_0.model.channel.Channel}.
+ */
+ @NotNull
+ private OperationAction action;
+
+ /**
+ * Required .
+ *
+ * A $ref pointer to the definition of the channel in which this operation is performed.
+ *
+ * If the operation is located in the root {@link com.asyncapi.v3._0_0.model.AsyncAPI#getOperations()}, it MUST point to a channel
+ * definition located in the {@link com.asyncapi.v3._0_0.model.AsyncAPI#getChannels()}, and MUST NOT point to a channel definition located
+ * in the {@link com.asyncapi.v3._0_0.model.AsyncAPI#getComponents()} or anywhere else.
+ *
+ * If the operation is located in the {@link com.asyncapi.v3._0_0.model.AsyncAPI#getComponents()}, it MAY point to a Channel Object in any location.
+ * Please note the channel property value MUST be a Reference Object and, therefore, MUST NOT contain a Channel Object.
+ *
+ * However, it is RECOMMENDED that parsers (or other software) dereference this property for a better development experience.
+ */
+ @NotNull
+ private Reference channel;
+
+ /**
+ * A human-friendly title for the operation.
+ */
+ @Nullable
+ private String title;
+
+ /**
+ * A short summary of what the operation is about.
+ */
+ @Nullable
+ private String summary;
+
+ /**
+ * A verbose explanation of the operation. CommonMark syntax can be used for rich text representation.
+ */
+ @Nullable
+ private String description;
+
+ /**
+ * A declaration of which security schemes are associated with this operation.
+ *
+ * Only one of the {@link SecurityScheme} objects MUST be satisfied to authorize an operation.
+ *
+ * In cases where Server Security also applies, it MUST also be satisfied.
+ *
+ * MUST BE:
+ *
+ * {@link SecurityScheme}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = SecuritySchemesDeserializer.class)
+ private List security;
+
+ /**
+ * A list of tags for logical grouping and categorization of operations.
+ *
+ * MUST BE:
+ *
+ * {@link Tag}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = TagsDeserializer.class)
+ private List tags;
+
+ /**
+ * Additional external documentation for this channel.
+ *
+ * MUST BE:
+ *
+ * {@link ExternalDocumentation}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ExternalDocumentationDeserializer.class)
+ private Object externalDocs;
+
+ /**
+ * A map where the keys describe the name of the protocol and the values describe protocol-specific definitions for the operation.
+ *
+ * MUST BE:
+ *
+ * {@link OperationBinding}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = OperationBindingsDeserializer.class)
+ private Map bindings;
+
+ /**
+ * A list of traits to apply to the operation object. Traits MUST be merged using traits merge mechanism.
+ *
+ * The resulting object MUST be a valid {@link Operation}.
+ *
+ * MUST BE:
+ *
+ * {@link OperationTrait}
+ * {@link Reference}
+ *
+ *
+ * @see Traits Merge Mechanism
+ */
+ @Nullable
+ @JsonDeserialize(using = OperationTraitsDeserializer.class)
+ private List traits;
+
+ /**
+ * A list of $ref pointers pointing to the supported {@link com.asyncapi.v3._0_0.model.channel.message.Message} that can be processed by this operation.
+ *
+ * It MUST contain a subset of the messages defined in the channel referenced in this operation - {@link Operation#getChannel()},
+ * and MUST NOT point to a subset of message definitions located in the {@link com.asyncapi.v3._0_0.model.component.Components#getMessages()} in the {@link com.asyncapi.v3._0_0.model.AsyncAPI#getComponents()} or anywhere else.
+ *
+ * Every message processed by this operation MUST be valid against one, and only one, of the message objects referenced in this list .
+ *
+ * Please note the messages property value MUST be a list of Reference Objects and, therefore, MUST NOT contain Message Objects.
+ *
+ * However, it is RECOMMENDED that parsers (or other software) dereference this property for a better development experience.
+ */
+ @Nullable
+ private List messages;
+
+ /**
+ * The definition of the reply in a request-reply operation.
+ *
+ * MUST BE:
+ *
+ * {@link OperationReply}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = OperationReplyDeserializer.class)
+ private Object reply;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/OperationAction.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/OperationAction.java
new file mode 100644
index 00000000..b4b99d0a
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/OperationAction.java
@@ -0,0 +1,26 @@
+package com.asyncapi.v3._0_0.model.operation;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes a specific operation action.
+ *
+ * @see Operation
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+public enum OperationAction {
+
+ /**
+ * Use send when it's expected that the application will send a message to the given {@link com.asyncapi.v3._0_0.model.channel.Channel}.
+ */
+ @JsonProperty("send")
+ SEND,
+
+ /**
+ * Use receive when the application should expect receiving messages from the given {@link com.asyncapi.v3._0_0.model.channel.Channel}.
+ */
+ @JsonProperty("receive")
+ RECEIVE
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/OperationTrait.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/OperationTrait.java
new file mode 100644
index 00000000..8ea88346
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/OperationTrait.java
@@ -0,0 +1,111 @@
+package com.asyncapi.v3._0_0.model.operation;
+
+import com.asyncapi.v3.ExtendableObject;
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.jackson.model.ExternalDocumentationDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.TagsDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.operation.reply.OperationReplyDeserializer;
+import com.asyncapi.v3._0_0.model.ExternalDocumentation;
+import com.asyncapi.v3._0_0.model.Tag;
+import com.asyncapi.v3._0_0.model.operation.reply.OperationReply;
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import com.asyncapi.v3.jackson.binding.operation.OperationBindingsDeserializer;
+import com.asyncapi.v3.jackson.security_scheme.SecuritySchemesDeserializer;
+import com.asyncapi.v3.security_scheme.SecurityScheme;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Describes a trait that MAY be applied to an {@link Operation}. This object MAY contain any property from the
+ * {@link Operation}, except the action, channel and traits ones.
+ *
+ * @see Operation
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class OperationTrait extends ExtendableObject {
+
+ /**
+ * A human-friendly title for the operation.
+ */
+ @Nullable
+ private String title;
+
+ /**
+ * A short summary of what the operation is about.
+ */
+ @Nullable
+ private String summary;
+
+ /**
+ * A verbose explanation of the operation. CommonMark syntax can be used for rich text representation.
+ */
+ @Nullable
+ private String description;
+
+ /**
+ * A declaration of which security schemes are associated with this operation.
+ *
+ * Only one of the {@link SecurityScheme} objects MUST be satisfied to authorize an operation.
+ *
+ * In cases where Server Security also applies, it MUST also be satisfied.
+ *
+ * MUST BE:
+ *
+ * {@link SecurityScheme}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = SecuritySchemesDeserializer.class)
+ private List security;
+
+ /**
+ * A list of tags for logical grouping and categorization of operations.
+ *
+ * MUST BE:
+ *
+ * {@link Tag}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = TagsDeserializer.class)
+ private List tags;
+
+ /**
+ * Additional external documentation for this channel.
+ *
+ * MUST BE:
+ *
+ * {@link ExternalDocumentation}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ExternalDocumentationDeserializer.class)
+ private Object externalDocs;
+
+ /**
+ * A map where the keys describe the name of the protocol and the values describe protocol-specific definitions for the operation.
+ *
+ * MUST BE:
+ *
+ * {@link OperationBinding}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = OperationBindingsDeserializer.class)
+ private Map bindings;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/reply/OperationReply.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/reply/OperationReply.java
new file mode 100644
index 00000000..1b90ba66
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/reply/OperationReply.java
@@ -0,0 +1,76 @@
+package com.asyncapi.v3._0_0.model.operation.reply;
+
+import com.asyncapi.v3.ExtendableObject;
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.jackson.model.operation.reply.OperationReplyAddressDeserializer;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * Describes the reply part that MAY be applied to an {@link com.asyncapi.v3._0_0.model.operation.Operation}.
+ *
+ * If an operation implements the request/reply pattern, the reply object represents the response message.
+ *
+ * @see Operation
+ * @see Operation Reply
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class OperationReply extends ExtendableObject {
+
+ /**
+ * Definition of the address that implementations MUST use for the reply.
+ *
+ * MUST BE:
+ *
+ * {@link OperationReplyAddress}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = OperationReplyAddressDeserializer.class)
+ private Object address;
+
+ /**
+ * A $ref pointer to the definition of the channel in which this operation is performed.
+ *
+ * When address is specified, the address property of the channel referenced by this property MUST be either null or not defined.
+ *
+ * If the operation reply is located inside a root Operation Object - {@link com.asyncapi.v3._0_0.model.AsyncAPI#getOperations()},
+ * it MUST point to a channel definition located in the root Channels Object - {@link com.asyncapi.v3._0_0.model.AsyncAPI#getChannels()},
+ * and MUST NOT point to a channel definition located in the Components Object - {@link com.asyncapi.v3._0_0.model.AsyncAPI#getComponents()} or anywhere else.
+ *
+ * If the operation reply is located inside an Operation Object in the Components Object - {@link com.asyncapi.v3._0_0.model.AsyncAPI#getComponents()}
+ * or in the Replies Object in the Components Object - {@link com.asyncapi.v3._0_0.model.AsyncAPI#getComponents()}, it MAY point to a Channel Object in any location.
+ *
+ * Please note the channel property value MUST be a Reference Object and, therefore, MUST NOT contain a Channel Object.
+ *
+ * However, it is RECOMMENDED that parsers (or other software) dereference this property for a better development experience.
+ */
+ @Nullable
+ private Reference channel;
+
+ /**
+ * A list of $ref pointers pointing to the supported {@link com.asyncapi.v3._0_0.model.channel.message.Message} that can be processed by this operation as reply.
+ *
+ * It MUST contain a subset of the messages defined in the channel referenced in this operation reply,
+ * and MUST NOT point to a subset of message definitions located in the Components Object or anywhere else.
+ *
+ * Every message processed by this operation MUST be valid against one, and only one, of the message objects referenced in this list.
+ *
+ * Please note the messages property value MUST be a list of Reference Objects and, therefore, MUST NOT contain Message Objects.
+ *
+ * However, it is RECOMMENDED that parsers (or other software) dereference this property for a better development experience.
+ */
+ @Nullable
+ private List messages;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/reply/OperationReplyAddress.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/reply/OperationReplyAddress.java
new file mode 100644
index 00000000..8a9875ba
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/operation/reply/OperationReplyAddress.java
@@ -0,0 +1,40 @@
+package com.asyncapi.v3._0_0.model.operation.reply;
+
+import com.asyncapi.v3.ExtendableObject;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * An object that specifies where an operation has to send the reply.
+ *
+ * For specifying and computing the location of a reply address, a runtime expression is used.
+ *
+ * @see Operation Reply Address
+ * @see Runtime Expression
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class OperationReplyAddress extends ExtendableObject {
+
+ /**
+ * An optional description of the address. CommonMark syntax can be used for rich text representation.
+ */
+ @Nullable
+ private String description;
+
+ /**
+ * REQUIRED .
+ *
+ * A runtime expression that specifies the location of the reply address.
+ *
+ * @see Runtime Expression
+ */
+ @Nullable
+ private String location;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/server/Server.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/server/Server.java
new file mode 100644
index 00000000..8d38cd89
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/server/Server.java
@@ -0,0 +1,178 @@
+package com.asyncapi.v3._0_0.model.server;
+
+import com.asyncapi.v3.jackson.binding.server.ServerBindingsDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.server.ServerVariablesDeserializer;
+import com.asyncapi.v3.binding.server.ServerBinding;
+import com.asyncapi.v3.ExtendableObject;
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3._0_0.jackson.model.ExternalDocumentationDeserializer;
+import com.asyncapi.v3._0_0.jackson.model.TagsDeserializer;
+import com.asyncapi.v3._0_0.model.ExternalDocumentation;
+import com.asyncapi.v3._0_0.model.Tag;
+import com.asyncapi.v3.jackson.security_scheme.SecuritySchemesDeserializer;
+import com.asyncapi.v3.security_scheme.SecurityScheme;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * An object representing a message broker, a server or any other kind of computer program capable of sending and/or
+ * receiving data.
+ *
+ * This object is used to capture details such as URIs, protocols and security configuration.
+ *
+ * Variable substitution can be used so that some details, for example usernames and passwords, can be injected by
+ * code generation tools.
+ *
+ * @see Server
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class Server extends ExtendableObject {
+
+ /**
+ * REQUIRED .
+ *
+ * The server host name. It MAY include the port. This field supports {@link ServerVariable}.
+ *
+ * Variable substitutions will be made when a variable is named in {braces}.
+ */
+ @NotNull
+ @JsonProperty
+ @Builder.Default
+ private String host = "";
+
+ /**
+ * REQUIRED .
+ *
+ * The protocol this URL supports for connection. Supported protocol include, but are not limited to:
+ * amqp, amqps, http, https, jms, kafka, kafka-secure, mqtt, secure-mqtt, stomp, stomps, ws, wss.
+ */
+ @NotNull
+ @JsonProperty
+ @Builder.Default
+ private String protocol = "";
+
+ /**
+ * The version of the protocol used for connection. For instance: AMQP 0.9.1, HTTP 2.0, Kafka 1.0.0, etc.
+ */
+ @Nullable
+ @JsonProperty
+ private String protocolVersion;
+
+ /**
+ * The path to a resource in the host. This field supports {@link ServerVariable}.
+ *
+ * Variable substitutions will be made when a variable is named in {braces}.
+ */
+ @Nullable
+ @JsonProperty
+ private String pathname;
+
+ /**
+ * An optional string describing the server. CommonMark syntax MAY be used for rich text representation.
+ */
+ @Nullable
+ @JsonProperty
+ private String description;
+
+ /**
+ * A human-friendly title for the server.
+ */
+ @Nullable
+ @JsonProperty
+ private String title;
+
+ /**
+ * A short summary of the server.
+ */
+ @Nullable
+ @JsonProperty
+ private String summary;
+
+ /**
+ * A map between a variable name and its value.
+ *
+ * The value is used for substitution in the server's {@link #getHost()} and {@link #getPathname()} template.
+ *
+ * MUST BE:
+ *
+ * {@link ServerVariable}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonProperty
+ @JsonDeserialize(using = ServerVariablesDeserializer.class)
+ private Map variables;
+
+ /**
+ * A declaration of which security schemes can be used with this server. The list of values includes alternative
+ * {@link SecurityScheme} objects that can be used.
+ *
+ * Only one of the security scheme objects need to be satisfied to authorize a connection or operation.
+ *
+ * MUST BE:
+ *
+ * {@link SecurityScheme}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonProperty
+ @JsonDeserialize(using = SecuritySchemesDeserializer.class)
+ private List security;
+
+ /**
+ * A list of tags for logical grouping and categorization of servers.
+ *
+ * MUST BE:
+ *
+ * {@link Tag}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonProperty
+ @JsonDeserialize(using = TagsDeserializer.class)
+ private List tags;
+
+ /**
+ * Additional external documentation of the exposed API.
+ *
+ * MUST BE:
+ *
+ * {@link ExternalDocumentation}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonProperty
+ @JsonDeserialize(using = ExternalDocumentationDeserializer.class)
+ private Object externalDocs;
+
+ /**
+ * A map where the keys describe the name of the protocol and the values describe protocol-specific definitions
+ * for the server.
+ *
+ * MUST be one of:
+ *
+ * {@link ServerBinding}
+ * {@link Reference}
+ *
+ */
+ @Nullable
+ @JsonDeserialize(using = ServerBindingsDeserializer.class)
+ private Map bindings;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/server/ServerVariable.java b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/server/ServerVariable.java
new file mode 100644
index 00000000..87f852e1
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/_0_0/model/server/ServerVariable.java
@@ -0,0 +1,50 @@
+package com.asyncapi.v3._0_0.model.server;
+
+import com.asyncapi.v3.ExtendableObject;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * An object representing a Server Variable for server URL template substitution.
+ *
+ * @see ServerVariable
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class ServerVariable extends ExtendableObject {
+
+ /**
+ * An enumeration of string values to be used if the substitution options are from a limited set.
+ */
+ @Nullable
+ @JsonProperty(value = "enum")
+ private List enumValues;
+
+ /**
+ * The default value to use for substitution, and to send, if an alternate value is not supplied.
+ */
+ @Nullable
+ @JsonProperty("default")
+ private String defaultValue;
+
+ /**
+ * An optional description for the server variable. CommonMark syntax MAY be used for rich text representation.
+ */
+ @Nullable
+ private String description;
+
+ /**
+ * An array of examples of the server variable.
+ */
+ @Nullable
+ private List examples;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ChannelBinding.java
new file mode 100644
index 00000000..825bc97b
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ChannelBinding.java
@@ -0,0 +1,18 @@
+package com.asyncapi.v3.binding.channel;
+
+import com.asyncapi.v3.ExtendableObject;
+import lombok.EqualsAndHashCode;
+
+/**
+ * Describes protocol-specific definition for a channel.
+ *
+ * This object MAY be extended with {@link ExtendableObject}.
+ *
+ * @see Specification Extensions
+ * @see Channel Binding
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@EqualsAndHashCode(callSuper = true)
+public class ChannelBinding extends ExtendableObject {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/AMQPChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/AMQPChannelBinding.java
new file mode 100644
index 00000000..bed4fa16
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/AMQPChannelBinding.java
@@ -0,0 +1,62 @@
+package com.asyncapi.v3.binding.channel.amqp;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import com.asyncapi.v3.binding.channel.amqp.exchange.AMQPChannelExchangeProperties;
+import com.asyncapi.v3.binding.channel.amqp.queue.AMQPChannelQueueProperties;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes AMQP 0-9-1 channel binding.
+ *
+ * Contains information about the channel representation in AMQP.
+ *
+ * @version 0.2.0
+ * @see AMQP channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes AMQP 0-9-1 channel binding.")
+public class AMQPChannelBinding extends ChannelBinding {
+
+ /**
+ * Defines what type of channel is it. Can be either queue or routingKey (default).
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "is", required = true, defaultValue = "routingKey")
+ @JsonPropertyDescription("Defines what type of channel is it. Can be either queue or routingKey (default).")
+ private AMQPChannelType is = AMQPChannelType.ROUTING_KEY;
+
+ /**
+ * When is=routingKey, this object defines the exchange properties.
+ */
+ @Nullable
+ @JsonProperty("exchange")
+ @JsonPropertyDescription("When is=routingKey, this object defines the exchange properties.")
+ private AMQPChannelExchangeProperties exchange;
+
+ /**
+ * When is=queue, this object defines the queue properties.
+ */
+ @Nullable
+ @JsonProperty("queue")
+ @JsonPropertyDescription("When is=queue, this object defines the queue properties.")
+ private AMQPChannelQueueProperties queue;
+
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private final String bindingVersion = "0.2.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/AMQPChannelType.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/AMQPChannelType.java
new file mode 100644
index 00000000..e6fe8c81
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/AMQPChannelType.java
@@ -0,0 +1,24 @@
+package com.asyncapi.v3.binding.channel.amqp;
+
+import com.fasterxml.jackson.annotation.JsonAlias;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes AMQP 0-9-1 channel type.
+ *
+ * Contains information about the type of channel in AMQP.
+ *
+ * @version 0.2.0
+ * @see AMQP channel binding
+ * @author Pavel Bodiachevskii
+ */
+public enum AMQPChannelType {
+
+ @JsonProperty("queue")
+ QUEUE,
+
+ @JsonProperty("routingKey")
+ @JsonAlias("routingKey")
+ ROUTING_KEY
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/exchange/AMQPChannelExchangeProperties.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/exchange/AMQPChannelExchangeProperties.java
new file mode 100644
index 00000000..6c7b0465
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/exchange/AMQPChannelExchangeProperties.java
@@ -0,0 +1,71 @@
+package com.asyncapi.v3.binding.channel.amqp.exchange;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes AMQP 0-9-1 channel exchange properties.
+ *
+ * Contains information about the channel exchange properties in AMQP.
+ *
+ * @version 0.2.0
+ * @see AMQP channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describes AMQP 0-9-1 channel exchange properties.")
+public class AMQPChannelExchangeProperties {
+
+ /**
+ * The name of the exchange. It MUST NOT exceed 255 characters long.
+ */
+ @Nullable
+ @javax.validation.constraints.Size(
+ max = 255,
+ message = "Exchange name must not exceed 255 characters long."
+ )
+ @JsonProperty("name")
+ @JsonPropertyDescription("The name of the exchange. It MUST NOT exceed 255 characters long.")
+ private String name;
+
+ /**
+ * The type of the exchange. Can be either topic, direct, fanout, default or headers.
+ */
+ @Nullable
+ @JsonProperty("type")
+ @JsonPropertyDescription("The type of the exchange. Can be either topic, direct, fanout, default or headers.")
+ private AMQPChannelExchangeType type;
+
+ /**
+ * Whether the exchange should survive broker restarts or not.
+ */
+ @Nullable
+ @JsonProperty("durable")
+ @JsonPropertyDescription("Whether the exchange should survive broker restarts or not.")
+ private Boolean durable;
+
+ /**
+ * Whether the exchange should be deleted when the last queue is unbound from it.
+ */
+ @Nullable
+ @JsonProperty("autoDelete")
+ @JsonPropertyDescription("Whether the exchange should be deleted when the last queue is unbound from it.")
+ private Boolean autoDelete;
+
+ /**
+ * The virtual host of the exchange. Defaults to /.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "vhost", defaultValue = "/")
+ @JsonPropertyDescription("The virtual host of the exchange. Defaults to /.")
+ private String vhost = "/";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/exchange/AMQPChannelExchangeType.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/exchange/AMQPChannelExchangeType.java
new file mode 100644
index 00000000..6a4211bc
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/exchange/AMQPChannelExchangeType.java
@@ -0,0 +1,33 @@
+package com.asyncapi.v3.binding.channel.amqp.exchange;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes AMQP 0-9-1 channel exchange type.
+ *
+ * Contains information about the channel exchange type in AMQP.
+ *
+ * @version 0.2.0
+ * @see AMQP channel binding
+ * @author Pavel Bodiachevskii
+ */
+@JsonClassDescription("Describes AMQP 0-9-1 channel exchange type.")
+public enum AMQPChannelExchangeType {
+
+ @JsonProperty("topic")
+ TOPIC,
+
+ @JsonProperty("direct")
+ DIRECT,
+
+ @JsonProperty("fanout")
+ FANOUT,
+
+ @JsonProperty("default")
+ DEFAULT,
+
+ @JsonProperty("headers")
+ HEADERS
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/queue/AMQPChannelQueueProperties.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/queue/AMQPChannelQueueProperties.java
new file mode 100644
index 00000000..18f49c26
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp/queue/AMQPChannelQueueProperties.java
@@ -0,0 +1,71 @@
+package com.asyncapi.v3.binding.channel.amqp.queue;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes AMQP 0-9-1 channel queue properties.
+ *
+ * Contains information about the queue exchange properties in AMQP.
+ *
+ * @version 0.2.0
+ * @see AMQP channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describes AMQP 0-9-1 channel queue properties.")
+public class AMQPChannelQueueProperties {
+
+ /**
+ * The name of the queue. It MUST NOT exceed 255 characters long.
+ */
+ @Nullable
+ @javax.validation.constraints.Size(
+ max = 255,
+ message = "Queue name must not exceed 255 characters long."
+ )
+ @JsonProperty("name")
+ @JsonPropertyDescription("The name of the queue. It MUST NOT exceed 255 characters long.")
+ private String name;
+
+ /**
+ * Whether the queue should survive broker restarts or not.
+ */
+ @Nullable
+ @JsonProperty("durable")
+ @JsonPropertyDescription("Whether the queue should survive broker restarts or not.")
+ private Boolean durable;
+
+ /**
+ * Whether the queue should be used only by one connection or not.
+ */
+ @Nullable
+ @JsonProperty("exclusive")
+ @JsonPropertyDescription("Whether the queue should be used only by one connection or not.")
+ private Boolean exclusive;
+
+ /**
+ * Whether the queue should be deleted when the last consumer unsubscribes.
+ */
+ @Nullable
+ @JsonProperty("autoDelete")
+ @JsonPropertyDescription("Whether the queue should be deleted when the last consumer unsubscribes.")
+ private Boolean autoDelete;
+
+ /**
+ * The virtual host of the queue. Defaults to /.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "vhost", defaultValue = "/")
+ @JsonPropertyDescription("The virtual host of the queue. Defaults to /.")
+ private String vhost = "/";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp1/AMQP1ChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp1/AMQP1ChannelBinding.java
new file mode 100644
index 00000000..b9d5b157
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/amqp1/AMQP1ChannelBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.channel.amqp1;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes AMQP 1.0 channel binding.
+ *
+ * @version 0.1.0
+ * @see AMQP 1.0 channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class AMQP1ChannelBinding extends ChannelBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/anypointmq/AnypointMQChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/anypointmq/AnypointMQChannelBinding.java
new file mode 100644
index 00000000..84c63a06
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/anypointmq/AnypointMQChannelBinding.java
@@ -0,0 +1,58 @@
+package com.asyncapi.v3.binding.channel.anypointmq;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Anypoint MQ channel binding.
+ *
+ * @version 0.0.1
+ * @see Anypoint MQ channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Anypoint MQ channel binding.")
+public class AnypointMQChannelBinding extends ChannelBinding {
+
+ /**
+ * OPTIONAL, defaults to the channel name.
+ *
+ * The destination (queue or exchange) name for this channel. SHOULD only be specified if the channel name differs
+ * from the actual destination name, such as when the channel name is not a valid destination name in Anypoint MQ.
+ */
+ @Nullable
+ @JsonProperty("destination")
+ @JsonPropertyDescription("The destination (queue or exchange) name for this channel. SHOULD only be specified if the channel name differs from the actual destination name, such as when the channel name is not a valid destination name in Anypoint MQ.")
+ private String destination;
+
+ /**
+ * OPTIONAL, defaults to queue.
+ *
+ * The type of destination, which MUST be either exchange or queue or fifo-queue.
+ * SHOULD be specified to document the messaging model (publish/subscribe, point-to-point, strict message ordering)
+ * supported by this channel.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "destinationType", defaultValue = "queue")
+ @JsonPropertyDescription("The type of destination, which MUST be either exchange or queue or fifo-queue. SHOULD be specified to document the messaging model (publish/subscribe, point-to-point, strict message ordering) supported by this channel.")
+ private AnypointMQChannelDestinationType destinationType = AnypointMQChannelDestinationType.QUEUE;
+
+ /**
+ * The version of this binding.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.0.1";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/anypointmq/AnypointMQChannelDestinationType.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/anypointmq/AnypointMQChannelDestinationType.java
new file mode 100644
index 00000000..3f42233c
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/anypointmq/AnypointMQChannelDestinationType.java
@@ -0,0 +1,25 @@
+package com.asyncapi.v3.binding.channel.anypointmq;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes Anypoint MQ channel destination type.
+ *
+ * @version 0.0.1
+ * @see Anypoint MQ channel binding
+ * @author Pavel Bodiachevskii
+ */
+@JsonClassDescription("Describes Anypoint MQ channel destination type.")
+public enum AnypointMQChannelDestinationType {
+
+ @JsonProperty("exchange")
+ EXCHANGE,
+
+ @JsonProperty("queue")
+ QUEUE,
+
+ @JsonProperty("fifo-queue")
+ FIFO_QUEUE
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/googlepubsub/GooglePubSubChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/googlepubsub/GooglePubSubChannelBinding.java
new file mode 100644
index 00000000..1f93f6c2
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/googlepubsub/GooglePubSubChannelBinding.java
@@ -0,0 +1,83 @@
+package com.asyncapi.v3.binding.channel.googlepubsub;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Map;
+
+/**
+ * Describes Google Cloud Pub/Sub channel binding.
+ *
+ * The Channel Bindings Object is used to describe the Google Cloud Pub/Sub specific Topic details with AsyncAPI.
+ *
+ * @version 0.1.0
+ * @see Google Cloud Pub/Sub channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Google Cloud Pub/Sub channel binding.")
+public class GooglePubSubChannelBinding extends ChannelBinding {
+
+ /**
+ * The Google Cloud Pub/Sub Topic name.
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "topic", required = true)
+ @JsonPropertyDescription("The Google Cloud Pub/Sub Topic name.")
+ private String topic = "";
+
+ /**
+ * An object of key-value pairs (These are used to categorize Cloud Resources like Cloud Pub/Sub Topics.)
+ */
+ @Nullable
+ @JsonProperty("labels")
+ @JsonPropertyDescription("An object of key-value pairs (These are used to categorize Cloud Resources like Cloud Pub/Sub Topics.)")
+ private Map labels;
+
+ /**
+ * Indicates the minimum duration to retain a message after it is published to the topic (Must be a valid Duration .)
+ */
+ @Nullable
+ @JsonProperty("messageRetentionDuration")
+ @JsonPropertyDescription("Indicates the minimum duration to retain a message after it is published to the topic (Must be a valid https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration.)")
+ private String messageRetentionDuration;
+
+ /**
+ * Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored
+ */
+ @Nullable
+ @JsonProperty("messageStoragePolicy")
+ @JsonPropertyDescription("Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored")
+ private GooglePubSubChannelMessageStoragePolicy messageStoragePolicy;
+
+ /**
+ * Settings for validating messages published against a schema
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "schemaSettings", required = true)
+ @JsonPropertyDescription("Settings for validating messages published against a schema")
+ private GooglePubSubChannelSchemaSettings schemaSettings = new GooglePubSubChannelSchemaSettings();
+
+ /**
+ * The version of this binding.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/googlepubsub/GooglePubSubChannelMessageStoragePolicy.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/googlepubsub/GooglePubSubChannelMessageStoragePolicy.java
new file mode 100644
index 00000000..2f236cc6
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/googlepubsub/GooglePubSubChannelMessageStoragePolicy.java
@@ -0,0 +1,36 @@
+package com.asyncapi.v3.binding.channel.googlepubsub;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * Describes Google Cloud Pub/Sub MessageStoragePolicy.
+ *
+ * The Message Storage Policy Object is used to describe the Google Cloud Pub/Sub MessageStoragePolicy Object with AsyncAPI.
+ *
+ * @version 0.1.0
+ * @see Google Cloud Pub/Sub channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describe the Google Cloud Pub/Sub MessageStoragePolicy")
+public class GooglePubSubChannelMessageStoragePolicy {
+
+ /**
+ * A list of IDs of GCP regions where messages that are published to the topic may be persisted in storage
+ */
+ @Nullable
+ @JsonProperty("allowedPersistenceRegions")
+ @JsonPropertyDescription("A list of IDs of GCP regions where messages that are published to the topic may be persisted in storage")
+ private List allowedPersistenceRegions;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/googlepubsub/GooglePubSubChannelSchemaSettings.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/googlepubsub/GooglePubSubChannelSchemaSettings.java
new file mode 100644
index 00000000..ce5f807e
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/googlepubsub/GooglePubSubChannelSchemaSettings.java
@@ -0,0 +1,59 @@
+package com.asyncapi.v3.binding.channel.googlepubsub;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Google Cloud Pub/Sub SchemaSettings.
+ *
+ * The Schema Settings Object is used to describe the Google Cloud Pub/Sub SchemaSettings Object with AsyncAPI.
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describe the Google Cloud Pub/Sub SchemaSettings")
+public class GooglePubSubChannelSchemaSettings {
+
+ /**
+ * The encoding of the message (Must be one of the possible Encoding values.)
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "encoding", required = true)
+ @JsonPropertyDescription("The encoding of the message (Must be one of the possible https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.topics#encoding values.)")
+ private String encoding = "";
+
+ /**
+ * The minimum (inclusive) revision allowed for validating messages
+ */
+ @Nullable
+ @JsonProperty("firstRevisionId")
+ @JsonPropertyDescription("The minimum (inclusive) revision allowed for validating messages")
+ private String firstRevisionId;
+
+ /**
+ * The maximum (inclusive) revision allowed for validating messages
+ */
+ @Nullable
+ @JsonProperty("lastRevisionId")
+ @JsonPropertyDescription("The maximum (inclusive) revision allowed for validating messages")
+ private String lastRevisionId;
+
+ /**
+ * The name of the schema that messages published should be validated against (The format is projects/{project}/schemas/{schema}.)
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "name", required = true)
+ @JsonPropertyDescription("The name of the schema that messages published should be validated against (The format is projects/{project}/schemas/{schema}.)")
+ private String name = "";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/http/HTTPChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/http/HTTPChannelBinding.java
new file mode 100644
index 00000000..3419cdc2
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/http/HTTPChannelBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.channel.http;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes HTTP channel binding.
+ *
+ * @version 0.1.0
+ * @see HTTP channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class HTTPChannelBinding extends ChannelBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ibmmq/IBMMQChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ibmmq/IBMMQChannelBinding.java
new file mode 100644
index 00000000..bb637b2a
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ibmmq/IBMMQChannelBinding.java
@@ -0,0 +1,88 @@
+package com.asyncapi.v3.binding.channel.ibmmq;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes IBM MQ channel binding.
+ *
+ * This object contains information about the channel representation in IBM MQ. Each channel corresponds to a Queue or Topic within IBM MQ.
+ *
+ * @version 0.1.0
+ * @see IBM MQ channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes IBM MQ channel binding.")
+public class IBMMQChannelBinding extends ChannelBinding {
+
+ /**
+ * Defines the type of AsyncAPI channel.
+ *
+ * MUST be either topic or queue. For type topic, the AsyncAPI channel name MUST be assumed for the IBM MQ topic string unless overridden.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "destinationType", defaultValue = "topic")
+ @JsonPropertyDescription("Defines the type of AsyncAPI channel.")
+ private IBMMQChannelDestinationType destinationType = IBMMQChannelDestinationType.TOPIC;
+
+ /**
+ * REQUIRED if destinationType = queue
+ *
+ * queue and topic fields MUST NOT coexist within a channel binding
+ */
+ @Nullable
+ @JsonProperty("queue")
+ @JsonPropertyDescription("Defines the properties of a queue.")
+ private IBMMQChannelQueueProperties queue;
+
+ /**
+ * Defines the properties of a topic.
+ *
+ * OPTIONAL if destinationType = topic
+ *
+ * queue and topic fields MUST NOT coexist within a channel binding.
+ */
+ @Nullable
+ @JsonProperty("topic")
+ @JsonPropertyDescription("Defines the properties of a topic.")
+ private IBMMQChannelTopicProperties topic;
+
+ /**
+ * The maximum length of the physical message (in bytes) accepted by the Topic or Queue. Messages produced that are
+ * greater in size than this value may fail to be delivered. More information on the maximum message length can be
+ * found on this
+ * MUST be 0-104,857,600 bytes (100 MB).
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "Maximum length of the physical message (in bytes) must be greater or equals to 0"
+ )
+ @javax.validation.constraints.Max(
+ value = 104857600,
+ message = "Maximum length of the physical message (in bytes) must be lower or equals to 104857600"
+ )
+ @JsonProperty("maxMsgLength")
+ @JsonPropertyDescription("The maximum length of the physical message (in bytes) accepted by the Topic or Queue. Messages produced that are greater in size than this value may fail to be delivered. More information on the maximum message length can be found on this [page](https://www.ibm.com/support/knowledgecenter/SSFKSJ_latest/com.ibm.mq.ref.dev.doc/q097520_.html) in the IBM MQ Knowledge Center.")
+ private Integer maxMsgLength;
+
+ /**
+ * The version of this binding.
+ */
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ibmmq/IBMMQChannelDestinationType.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ibmmq/IBMMQChannelDestinationType.java
new file mode 100644
index 00000000..13609498
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ibmmq/IBMMQChannelDestinationType.java
@@ -0,0 +1,20 @@
+package com.asyncapi.v3.binding.channel.ibmmq;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes IBM MQ channel destination type.
+ *
+ * @version 0.1.0
+ * @see IBM MQ channel binding
+ * @author Pavel Bodiachevskii
+ */
+public enum IBMMQChannelDestinationType {
+
+ @JsonProperty("topic")
+ TOPIC,
+
+ @JsonProperty("queue")
+ QUEUE
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ibmmq/IBMMQChannelQueueProperties.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ibmmq/IBMMQChannelQueueProperties.java
new file mode 100644
index 00000000..4c4586ab
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ibmmq/IBMMQChannelQueueProperties.java
@@ -0,0 +1,62 @@
+package com.asyncapi.v3.binding.channel.ibmmq;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes IBM MQ channel queue properties.
+ *
+ * @version 0.1.0
+ * @see IBM MQ channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describes IBM MQ channel queue properties.")
+public class IBMMQChannelQueueProperties {
+
+ /**
+ * Defines the name of the IBM MQ queue associated with the channel.
+ *
+ * A value MUST be specified. MUST NOT exceed 48 characters in length. MUST be a valid IBM MQ queue name
+ */
+ @NotNull
+ @javax.validation.constraints.NotNull
+ @javax.validation.constraints.Size(
+ max = 48,
+ message = "Name of the IBM MQ queue must be less or equals to 48"
+ )
+ @Builder.Default
+ @JsonProperty("objectName")
+ @JsonPropertyDescription("Defines the name of the IBM MQ queue associated with the channel.")
+ private String objectName = "";
+
+ /**
+ * Defines if the queue is a cluster queue and therefore partitioned. If true, a binding option MAY be specified
+ * when accessing the queue. More information on binding options can be found on this page in the IBM MQ Knowledge Center.
+ *
+ * If false, binding options SHOULD NOT be specified when accessing the queue.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "isPartitioned", defaultValue = "false")
+ @JsonPropertyDescription("Defines if the queue is a cluster queue and therefore partitioned. If 'true', a binding option MAY be specified when accessing the queue. More information on binding options can be found on this page in the IBM MQ Knowledge Center.")
+ private Boolean isPartitioned = false;
+
+ /**
+ * Specifies if it is recommended to open the queue exclusively.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "exclusive", defaultValue = "false")
+ @JsonPropertyDescription("Specifies if it is recommended to open the queue exclusively.")
+ private Boolean exclusive = false;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ibmmq/IBMMQChannelTopicProperties.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ibmmq/IBMMQChannelTopicProperties.java
new file mode 100644
index 00000000..7fe8544e
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ibmmq/IBMMQChannelTopicProperties.java
@@ -0,0 +1,74 @@
+package com.asyncapi.v3.binding.channel.ibmmq;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes IBM MQ channel topic properties.
+ *
+ * @version 0.1.0
+ * @see IBM MQ channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+public class IBMMQChannelTopicProperties {
+
+ /**
+ * The value of the IBM MQ topic string to be used.
+ *
+ * OPTIONAL
+ * Note: if specified, SHALL override AsyncAPI channel name.
+ *
+ * MUST NOT exceed 10240 characters in length. MAY coexist with topic.objectName
+ */
+ @Nullable
+ @javax.validation.constraints.Max(
+ value = 10240,
+ message = "Maximum length of topic string must be lower or equals to 10240"
+ )
+ @JsonProperty("string")
+ @JsonPropertyDescription("The value of the IBM MQ topic string to be used.")
+ private String string;
+
+ /**
+ * The name of the IBM MQ topic object.
+ *
+ * OPTIONAL
+ * Note: if specified, SHALL override AsyncAPI channel name.
+ *
+ * MUST NOT exceed 48 characters in length. MAY coexist with topic.string
+ */
+ @Nullable
+ @javax.validation.constraints.Max(
+ value = 48,
+ message = "Maximum length of topic name must be lower or equals to 48"
+ )
+ @JsonProperty("objectName")
+ @JsonPropertyDescription("The name of the IBM MQ topic object.")
+ private String objectName;
+
+ /**
+ * Defines if the subscription may be durable.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "durablePermitted", defaultValue = "true")
+ @JsonPropertyDescription("Defines if the subscription may be durable.")
+ private Boolean durablePermitted = true;
+
+ /**
+ * Defines if the last message published will be made available to new subscriptions.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "lastMsgRetained", defaultValue = "false")
+ @JsonPropertyDescription("Defines if the last message published will be made available to new subscriptions.")
+ private Boolean lastMsgRetained = false;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/jms/JMSChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/jms/JMSChannelBinding.java
new file mode 100644
index 00000000..3d74dac6
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/jms/JMSChannelBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.channel.jms;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes JMS channel binding.
+ *
+ * @version 0.1.0
+ * @see JMS channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class JMSChannelBinding extends ChannelBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/kafka/KafkaChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/kafka/KafkaChannelBinding.java
new file mode 100644
index 00000000..66b61ea5
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/kafka/KafkaChannelBinding.java
@@ -0,0 +1,76 @@
+package com.asyncapi.v3.binding.channel.kafka;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Kafka channel binding.
+ *
+ * @version 0.4.0
+ * @see Kafka channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Kafka channel binding.")
+public class KafkaChannelBinding extends ChannelBinding {
+
+ /**
+ * Kafka topic name if different from channel name.
+ */
+ @Nullable
+ @JsonProperty("topic")
+ @JsonPropertyDescription("Kafka topic name if different from channel name.")
+ private String topic;
+
+ /**
+ * Number of partitions configured on this topic (useful to know how many parallel consumers you may run).
+ *
+ * MUST be positive.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 1,
+ message = "Number of partitions must be greater or equals to 1"
+ )
+ @JsonProperty("partitions")
+ @JsonPropertyDescription("Number of partitions configured on this topic (useful to know how many parallel consumers you may run).")
+ private Integer partitions;
+
+ /**
+ * Number of replicas configured on this topic.
+ *
+ * MUST be positive.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 1,
+ message = "Number of replicas must be greater or equals to 1"
+ )
+ @JsonProperty("replicas")
+ @JsonPropertyDescription("Number of replicas configured on this topic.")
+ private Integer replicas;
+
+ /**
+ * Topic configuration properties that are relevant for the API.
+ */
+ @Nullable
+ @JsonProperty("topicConfiguration")
+ @JsonPropertyDescription("Topic configuration properties that are relevant for the API.")
+ private KafkaChannelTopicConfiguration topicConfiguration;
+
+ /**
+ * The version of this binding. If omitted, "latest" MUST be assumed.
+ */
+ @Nullable
+ @Builder.Default
+ private String bindingVersion = "0.4.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/kafka/KafkaChannelTopicCleanupPolicy.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/kafka/KafkaChannelTopicCleanupPolicy.java
new file mode 100644
index 00000000..a58e764a
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/kafka/KafkaChannelTopicCleanupPolicy.java
@@ -0,0 +1,13 @@
+package com.asyncapi.v3.binding.channel.kafka;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+public enum KafkaChannelTopicCleanupPolicy {
+
+ @JsonProperty("compact")
+ COMPACT,
+
+ @JsonProperty("delete")
+ DELETE
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/kafka/KafkaChannelTopicConfiguration.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/kafka/KafkaChannelTopicConfiguration.java
new file mode 100644
index 00000000..63ed484c
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/kafka/KafkaChannelTopicConfiguration.java
@@ -0,0 +1,83 @@
+package com.asyncapi.v3.binding.channel.kafka;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * This objects contains information about the API relevant topic configuration in Kafka.
+ *
+ * @version 0.4.0
+ * @see Kafka channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class KafkaChannelTopicConfiguration {
+
+ /**
+ * The cleanup.policy configuration option.
+ *
+ * array may only contain delete and/or compact
+ */
+ @Nullable
+ @JsonProperty("cleanup.policy")
+ private List cleanupPolicy;
+
+ /**
+ * The retention.ms configuration option.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = -1,
+ message = "retention.ms must be greater or equals to -1"
+ )
+ @JsonProperty("retention.ms")
+ @JsonPropertyDescription("The [`retention.ms`](https://kafka.apache.org/documentation/#topicconfigs_retention.ms) configuration option.")
+ private Integer retentionMs;
+
+ /**
+ * The retention.bytes configuration option.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = -1,
+ message = "retention.bytes must be greater or equals to -1"
+ )
+ @JsonProperty("retention.bytes")
+ @JsonPropertyDescription("The [`retention.bytes`](https://kafka.apache.org/documentation/#topicconfigs_retention.bytes) configuration option.")
+ private Integer retentionBytes;
+
+ /**
+ * The delete.retention.ms configuration option.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "delete.retention.ms must be greater or equals to 0"
+ )
+ @JsonProperty("delete.retention.ms")
+ @JsonPropertyDescription("The [`delete.retention.ms`](https://kafka.apache.org/documentation/#topicconfigs_delete.retention.ms) configuration option.")
+ private Integer deleteRetentionMs;
+
+ /**
+ * The max.message.bytes configuration option.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "max.message.bytes must be greater or equals to 0"
+ )
+ @JsonProperty("max.message.bytes")
+ @JsonPropertyDescription("The [`max.message.bytes`](https://kafka.apache.org/documentation/#topicconfigs_max.message.bytes) configuration option.")
+ private Integer maxMessageBytes;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/mercure/MercureChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/mercure/MercureChannelBinding.java
new file mode 100644
index 00000000..8cdb274b
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/mercure/MercureChannelBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.channel.mercure;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Mercure channel binding.
+ *
+ * @version 0.1.0
+ * @see Mercure channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MercureChannelBinding extends ChannelBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/mqtt/MQTTChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/mqtt/MQTTChannelBinding.java
new file mode 100644
index 00000000..8f1ad80b
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/mqtt/MQTTChannelBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.channel.mqtt;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes MQTT channel binding.
+ *
+ * @version 0.1.0
+ * @see MQTT channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MQTTChannelBinding extends ChannelBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/mqtt5/MQTT5ChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/mqtt5/MQTT5ChannelBinding.java
new file mode 100644
index 00000000..6386770b
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/mqtt5/MQTT5ChannelBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.channel.mqtt5;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes MQTT 5 channel binding.
+ *
+ * @version 0.2.0
+ * @see MQTT 5 channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MQTT5ChannelBinding extends ChannelBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/nats/NATSChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/nats/NATSChannelBinding.java
new file mode 100644
index 00000000..c069aabe
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/nats/NATSChannelBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.channel.nats;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes NATS channel binding.
+ *
+ * @version 0.1.0
+ * @see NATS channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class NATSChannelBinding extends ChannelBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/pulsar/PulsarChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/pulsar/PulsarChannelBinding.java
new file mode 100644
index 00000000..df114f94
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/pulsar/PulsarChannelBinding.java
@@ -0,0 +1,101 @@
+package com.asyncapi.v3.binding.channel.pulsar;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * Describes Pulsar channel binding.
+ *
+ * @version 0.1.0
+ * @see Pulsar channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Pulsar channel binding.")
+public class PulsarChannelBinding extends ChannelBinding {
+
+ /**
+ * The namespace the channel is associated with.
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty("namespace")
+ @JsonPropertyDescription("The namespace the channel is associated with.")
+ private String namespace = "";
+
+ /**
+ * Persistence of the topic in Pulsar. It MUST be either persistent or non-persistent.
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "persistence", defaultValue = "persistent")
+ @JsonPropertyDescription("Persistence of the topic in Pulsar. It MUST be either persistent or non-persistent.")
+ private PulsarChannelPersistence persistence = PulsarChannelPersistence.PERSISTENT;
+
+ /**
+ * Topic compaction threshold given in Megabytes.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "Topic compaction threshold must be greater or equals to 0."
+ )
+ @JsonProperty("compaction")
+ @JsonPropertyDescription("Topic compaction threshold given in Megabytes.")
+ private Integer compaction;
+
+ /**
+ * A list of clusters the topic is replicated to.
+ */
+ @Nullable
+ @JsonProperty("geo-replication")
+ @JsonPropertyDescription("A list of clusters the topic is replicated to.")
+ private List geoReplication;
+
+ /**
+ * Topic retention policy.
+ */
+ @Nullable
+ @JsonProperty("retention")
+ @JsonPropertyDescription("Topic retention policy.")
+ private PulsarChannelRetentionDefinition retention;
+
+ /**
+ * Message time-to-live in seconds.
+ */
+ @Nullable
+ @JsonProperty("ttl")
+ @JsonPropertyDescription("Message time-to-live in seconds.")
+ private Integer ttl;
+
+ /**
+ * Message deduplication. When true, it ensures that each message produced on Pulsar topics is persisted to disk only once.
+ */
+ @Nullable
+ @JsonProperty("deduplication")
+ @JsonPropertyDescription("Message deduplication. When true, it ensures that each message produced on Pulsar topics is persisted to disk only once.")
+ private Boolean deduplication;
+
+ /**
+ * The version of this binding. If omitted, "latest" MUST be assumed.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/pulsar/PulsarChannelPersistence.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/pulsar/PulsarChannelPersistence.java
new file mode 100644
index 00000000..8af581a8
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/pulsar/PulsarChannelPersistence.java
@@ -0,0 +1,22 @@
+package com.asyncapi.v3.binding.channel.pulsar;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes Pulsar channel persistence.
+ *
+ * @version 0.1.0
+ * @see Pulsar channel binding
+ * @author Pavel Bodiachevskii
+ */
+@JsonClassDescription("Describes Pulsar channel persistence.")
+public enum PulsarChannelPersistence {
+
+ @JsonProperty("persistent")
+ PERSISTENT,
+
+ @JsonProperty("non-persistent")
+ NON_PERSISTENT
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/pulsar/PulsarChannelRetentionDefinition.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/pulsar/PulsarChannelRetentionDefinition.java
new file mode 100644
index 00000000..badd4b15
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/pulsar/PulsarChannelRetentionDefinition.java
@@ -0,0 +1,44 @@
+package com.asyncapi.v3.binding.channel.pulsar;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Pulsar channel retention definition.
+ *
+ * The Retention Definition Object is used to describe the Pulsar Retention policy.
+ *
+ * @version 0.1.0
+ * @see Pulsar channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describes Pulsar channel retention definition.")
+public class PulsarChannelRetentionDefinition {
+
+ /**
+ * Time given in Minutes.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("time")
+ @JsonPropertyDescription("Time given in Minutes.")
+ private Integer time = 0;
+
+ /**
+ * Size given in MegaBytes.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("size")
+ @JsonPropertyDescription("Size given in MegaBytes.")
+ private Integer size = 0;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/redis/RedisChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/redis/RedisChannelBinding.java
new file mode 100644
index 00000000..a061a679
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/redis/RedisChannelBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.channel.redis;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Redis channel binding.
+ *
+ * @version 0.1.0
+ * @see Redis channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class RedisChannelBinding extends ChannelBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/sns/SNSChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/sns/SNSChannelBinding.java
new file mode 100644
index 00000000..f2e8b833
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/sns/SNSChannelBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.channel.sns;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes SNS channel binding.
+ *
+ * @version 0.1.0
+ * @see SNS channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class SNSChannelBinding extends ChannelBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/solace/SolaceChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/solace/SolaceChannelBinding.java
new file mode 100644
index 00000000..cbd31a55
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/solace/SolaceChannelBinding.java
@@ -0,0 +1,23 @@
+package com.asyncapi.v3.binding.channel.solace;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Solace channel binding.
+ *
+ * @version 0.3.0
+ * @see Solace channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class SolaceChannelBinding extends ChannelBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/sqs/SQSChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/sqs/SQSChannelBinding.java
new file mode 100644
index 00000000..961a8ad6
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/sqs/SQSChannelBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.channel.sqs;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes SQS channel binding.
+ *
+ * @version 0.1.0
+ * @see SQS channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class SQSChannelBinding extends ChannelBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/stomp/STOMPChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/stomp/STOMPChannelBinding.java
new file mode 100644
index 00000000..f4b13a98
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/stomp/STOMPChannelBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.channel.stomp;
+
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes STOMP channel binding.
+ *
+ * @version 0.1.0
+ * @see STOMP channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class STOMPChannelBinding extends ChannelBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ws/WebSocketsChannelBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ws/WebSocketsChannelBinding.java
new file mode 100644
index 00000000..d1255317
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ws/WebSocketsChannelBinding.java
@@ -0,0 +1,66 @@
+package com.asyncapi.v3.binding.channel.ws;
+
+import com.asyncapi.v3.schema.Schema;
+import com.asyncapi.v3.binding.channel.ChannelBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes WebSockets channel binding.
+ *
+ * When using WebSockets, the channel represents the connection. Unlike other protocols that support multiple virtual
+ * channels (topics, routing keys, etc.) per connection, WebSockets doesn't support virtual channels or, put it another
+ * way, there's only one channel and its characteristics are strongly related to the protocol used for the handshake,
+ * i.e., HTTP.
+ *
+ * @version 0.1.0
+ * @see WebSockets channel binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes WebSockets channel binding.")
+public class WebSocketsChannelBinding extends ChannelBinding {
+
+ /**
+ * The HTTP method to use when establishing the connection. Its value MUST be either GET or POST.
+ */
+ @Nullable
+ @JsonProperty("method")
+ @JsonPropertyDescription("The HTTP method to use when establishing the connection. Its value MUST be either GET or POST.")
+ private WebSocketsChannelMethod method;
+
+ /**
+ * A Schema object containing the definitions for each query parameter. This schema MUST be of type
+ * object and have a properties key.
+ */
+ @Nullable
+ @JsonProperty("query")
+ @JsonPropertyDescription("A Schema object containing the definitions for each query parameter. This schema MUST be of type object and have a properties key.")
+ private Schema query;
+
+ /**
+ * A Schema object containing the definitions of the HTTP headers to use when establishing the connection.
+ * This schema MUST be of type object and have a properties key.
+ */
+ @Nullable
+ @JsonProperty("headers")
+ @JsonPropertyDescription("A Schema object containing the definitions of the HTTP headers to use when establishing the connection. This schema MUST be of type object and have a properties key.")
+ private Schema headers;
+
+ /**
+ * The version of this binding. If omitted, "latest" MUST be assumed.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ws/WebSocketsChannelMethod.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ws/WebSocketsChannelMethod.java
new file mode 100644
index 00000000..48362411
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/channel/ws/WebSocketsChannelMethod.java
@@ -0,0 +1,13 @@
+package com.asyncapi.v3.binding.channel.ws;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+public enum WebSocketsChannelMethod {
+
+ @JsonProperty("GET")
+ GET,
+
+ @JsonProperty("POST")
+ POST
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/MessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/MessageBinding.java
new file mode 100644
index 00000000..2f75d7d8
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/MessageBinding.java
@@ -0,0 +1,13 @@
+package com.asyncapi.v3.binding.message;
+
+import com.asyncapi.v3.ExtendableObject;
+import lombok.EqualsAndHashCode;
+
+/**
+ * Describes AsyncAPI message binding.
+ *
+ * @author Pavel Bodiachevskii
+ */
+@EqualsAndHashCode(callSuper = true)
+public class MessageBinding extends ExtendableObject {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/amqp/AMQPMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/amqp/AMQPMessageBinding.java
new file mode 100644
index 00000000..820202c6
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/amqp/AMQPMessageBinding.java
@@ -0,0 +1,52 @@
+package com.asyncapi.v3.binding.message.amqp;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes AMQP 0-9-1 message binding.
+ *
+ * Contains information about the message representation in AMQP.
+ *
+ * @version 0.2.0
+ * @see AMQP message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes AMQP 0-9-1 message binding.")
+public class AMQPMessageBinding extends MessageBinding {
+
+ /**
+ * A MIME encoding for the message content.
+ */
+ @Nullable
+ @JsonProperty("contentEncoding")
+ @JsonPropertyDescription("A MIME encoding for the message content.")
+ private String contentEncoding;
+
+ /**
+ * Application-specific message type.
+ */
+ @Nullable
+ @JsonProperty("messageType")
+ @JsonPropertyDescription("Application-specific message type.")
+ private String messageType;
+
+ /**
+ * The version of this binding. If omitted, "latest" MUST be assumed.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.2.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/amqp1/AMQP1MessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/amqp1/AMQP1MessageBinding.java
new file mode 100644
index 00000000..73617ca1
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/amqp1/AMQP1MessageBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.message.amqp1;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes AMQP 1.0 message binding.
+ *
+ * @version 0.1.0
+ * @see AMQP message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class AMQP1MessageBinding extends MessageBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/anypointmq/AnypointMQMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/anypointmq/AnypointMQMessageBinding.java
new file mode 100644
index 00000000..07f8b497
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/anypointmq/AnypointMQMessageBinding.java
@@ -0,0 +1,45 @@
+package com.asyncapi.v3.binding.message.anypointmq;
+
+import com.asyncapi.v3.schema.Schema;
+import com.asyncapi.v3.binding.message.MessageBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Anypoint MQ message binding.
+ *
+ * @version 0.0.1
+ * @see Anypoint MQ message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Anypoint MQ message binding.")
+public class AnypointMQMessageBinding extends MessageBinding {
+
+ /**
+ * A Schema object containing the definitions for Anypoint MQ-specific headers (so-called protocol headers).
+ * This schema MUST be of type object and have a properties key. Examples of Anypoint MQ protocol headers are
+ * messageId and messageGroupId.
+ */
+ @Nullable
+ @JsonProperty("headers")
+ @JsonPropertyDescription("A Schema object containing the definitions for Anypoint MQ-specific headers (so-called protocol headers). This schema MUST be of type object and have a properties key. Examples of Anypoint MQ protocol headers are messageId and messageGroupId.")
+ private Schema headers;
+
+ /**
+ * The version of this binding.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.0.1";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/googlepubsub/GooglePubSubMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/googlepubsub/GooglePubSubMessageBinding.java
new file mode 100644
index 00000000..5f6373de
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/googlepubsub/GooglePubSubMessageBinding.java
@@ -0,0 +1,62 @@
+package com.asyncapi.v3.binding.message.googlepubsub;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Google Cloud Pub/Sub message binding.
+ *
+ * The Message Binding Object is used to describe the Google Cloud Pub/Sub specific PubsubMessage details, alongside with
+ * pertintent parts of the Google Cloud Pub/Sub Schema Object, with AsyncAPI.
+ *
+ * @version 0.1.0
+ * @see Google Cloud Pub/Sub message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Google Cloud Pub/Sub message binding.")
+public class GooglePubSubMessageBinding extends MessageBinding {
+
+ /**
+ * If non-empty, identifies related messages for which publish order should be respected (For more information, see ordering messages .)
+ */
+ @Nullable
+ @JsonProperty("orderingKey")
+ @JsonPropertyDescription("If non-empty, identifies related messages for which publish order should be respected (For more information, see https://cloud.google.com/pubsub/docs/ordering messages")
+ private String orderingKey;
+
+ /**
+ * Attributes for this message (If this field is empty, the message must contain non-empty data. This can be used to
+ * filter messages on the subscription.)
+ */
+ @Nullable
+ @JsonProperty("attributes")
+ @JsonPropertyDescription("Attributes for this message (If this field is empty, the message must contain non-empty data. This can be used to filter messages on the subscription.)")
+ private Object attributes;
+
+ /**
+ * Describes the schema used to validate the payload of this message
+ */
+ @Nullable
+ @JsonProperty("schema")
+ @JsonPropertyDescription("Describes the schema used to validate the payload of this message")
+ private GooglePubSubMessageSchemaDefinition schema;
+
+ /**
+ * The version of this binding.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/googlepubsub/GooglePubSubMessageSchemaDefinition.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/googlepubsub/GooglePubSubMessageSchemaDefinition.java
new file mode 100644
index 00000000..277061b3
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/googlepubsub/GooglePubSubMessageSchemaDefinition.java
@@ -0,0 +1,49 @@
+package com.asyncapi.v3.binding.message.googlepubsub;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Describes Google Cloud Pub/Sub message schema definition.
+ *
+ * The Schema Definition Object is used to describe the Google Cloud Pub/Sub Schema Object with AsyncAPI.
+ * While some of this information could be, or is, described using native AsyncAPI, for consistency it makes sense to
+ * provide this information here at all times, especially for cases where AsyncAPI does not natively support describing
+ * payloads using a supported Google Cloud Pub/Sub schema format like Protobuf.
+ *
+ * @version 0.1.0
+ * @see Google Cloud Pub/Sub message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode
+@JsonClassDescription("Describes Google Cloud Pub/Sub message schema definition.")
+public class GooglePubSubMessageSchemaDefinition {
+
+ /**
+ * The name of the schema
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "name", required = true)
+ @JsonPropertyDescription("The name of the schema")
+ private String name = "";
+
+ /**
+ * The type of the schema
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "type", required = true)
+ @JsonPropertyDescription("The type of the schema")
+ private GooglePubSubMessageSchemaDefinitionType type = GooglePubSubMessageSchemaDefinitionType.PROTOBUF;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/googlepubsub/GooglePubSubMessageSchemaDefinitionType.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/googlepubsub/GooglePubSubMessageSchemaDefinitionType.java
new file mode 100644
index 00000000..f7dd4bc3
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/googlepubsub/GooglePubSubMessageSchemaDefinitionType.java
@@ -0,0 +1,23 @@
+package com.asyncapi.v3.binding.message.googlepubsub;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes Google Cloud Pub/Sub message schema definition type.
+ *
+ * @version 0.1.0
+ * @see Google Cloud Pub/Sub message binding
+ * @see Types of schemas
+ * @author Pavel Bodiachevskii
+ */
+@JsonClassDescription("Describes Google Cloud Pub/Sub message schema definition type.")
+public enum GooglePubSubMessageSchemaDefinitionType {
+
+ @JsonProperty("avro")
+ AVRO,
+
+ @JsonProperty("protobuf")
+ PROTOBUF
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/http/HTTPMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/http/HTTPMessageBinding.java
new file mode 100644
index 00000000..664f1e40
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/http/HTTPMessageBinding.java
@@ -0,0 +1,44 @@
+package com.asyncapi.v3.binding.message.http;
+
+import com.asyncapi.v3.schema.Schema;
+import com.asyncapi.v3.binding.message.MessageBinding;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes HTTP message binding.
+ *
+ * Contains information about the message representation in HTTP.
+ *
+ * @version 0.1.0
+ * @see HTTP message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class HTTPMessageBinding extends MessageBinding {
+
+ /**
+ * A Schema object containing the definitions for each query parameter. This schema MUST be of type object
+ * and have a properties key.*
+ */
+ @Nullable
+ @JsonProperty("headers")
+ @JsonPropertyDescription("A Schema object containing the definitions for each query parameter. This schema MUST be of type object and have a properties key.")
+ private Schema headers;
+
+ /**
+ * The version of this binding.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/ibmmq/IBMMQMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/ibmmq/IBMMQMessageBinding.java
new file mode 100644
index 00000000..72efcf1a
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/ibmmq/IBMMQMessageBinding.java
@@ -0,0 +1,89 @@
+package com.asyncapi.v3.binding.message.ibmmq;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes IBM MQ message binding.
+ *
+ * This object contains information about the message representation in IBM MQ.
+ *
+ * @version 0.1.0
+ * @see IBM MQ message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes IBM MQ message binding.")
+public class IBMMQMessageBinding extends MessageBinding {
+
+ /**
+ * The type of the message.
+ *
+ * MUST be either string, jms or binary
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "type", defaultValue = "string")
+ @JsonPropertyDescription("The type of the message.")
+ private IBMMQMessageType type = IBMMQMessageType.STRING;
+
+ /**
+ * Defines the IBM MQ message headers to include with this message. More than one header can be specified as a comma
+ * separated list. Supporting information on IBM MQ message formats can be found on this page in the IBM MQ Knowledge Center.
+ *
+ * OPTIONAL if type = binary
+ *
+ * headers MUST NOT be specified if type = string or jms
+ */
+ @Nullable
+ @JsonProperty("headers")
+ @JsonPropertyDescription("Defines the IBM MQ message headers to include with this message. More than one header can be specified as a comma separated list.")
+ private String headers;
+
+ /**
+ * Provides additional information for application developers: describes the message type or format.
+ *
+ * The description field of the IBM MQ message binding object MAY include CommonMark markdown formatting.
+ * A minimum markdown syntax as described by CommonMark 0.27 is assumed.
+ */
+ @Nullable
+ @JsonProperty("description")
+ @JsonPropertyDescription("Provides additional information for application developers: describes the message type or format.")
+ private String description;
+
+ /**
+ * The recommended setting the client should use for the TTL (Time-To-Live) of the message.
+ * This is a period of time expressed in milliseconds and set by the application that puts the message.
+ * expiry values are API dependant e.g., MQI and JMS use different units of time and default values for unlimited.
+ * General information on IBM MQ message expiry can be found on this page in the IBM MQ Knowledge Center.
+ *
+ * expiry value MUST be either zero (unlimited) or greater than zero.
+ */
+ @Nullable
+ @Builder.Default
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "Expiry must be greater or equals to 0"
+ )
+ @JsonProperty(value = "expiry", defaultValue = "0")
+ @JsonPropertyDescription("The recommended setting the client should use for the TTL (Time-To-Live) of the message. This is a period of time expressed in milliseconds and set by the application that puts the message. 'expiry' values are API dependant e.g., MQI and JMS use different units of time and default values for 'unlimited'. General information on IBM MQ message expiry can be found on this [page](https://www.ibm.com/docs/en/ibm-mq/9.2?topic=mqmd-expiry-mqlong) in the IBM MQ Knowledge Center.")
+ private Integer expiry = 0;
+
+ /**
+ * The version of this binding.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/ibmmq/IBMMQMessageType.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/ibmmq/IBMMQMessageType.java
new file mode 100644
index 00000000..171f8a2f
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/ibmmq/IBMMQMessageType.java
@@ -0,0 +1,25 @@
+package com.asyncapi.v3.binding.message.ibmmq;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes IBM MQ message type.
+ *
+ * This object contains information about the message type in IBM MQ.
+ *
+ * @version 0.1.0
+ * @see IBM MQ message binding
+ * @author Pavel Bodiachevskii
+ */
+public enum IBMMQMessageType {
+
+ @JsonProperty("string")
+ STRING,
+
+ @JsonProperty("jms")
+ JMS,
+
+ @JsonProperty("binary")
+ BINARY
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/jms/JMSMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/jms/JMSMessageBinding.java
new file mode 100644
index 00000000..f44eec50
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/jms/JMSMessageBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.message.jms;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes JMS message binding.
+ *
+ * @version 0.1.0
+ * @see JMS message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class JMSMessageBinding extends MessageBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/kafka/KafkaMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/kafka/KafkaMessageBinding.java
new file mode 100644
index 00000000..52070204
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/kafka/KafkaMessageBinding.java
@@ -0,0 +1,67 @@
+package com.asyncapi.v3.binding.message.kafka;
+
+import com.asyncapi.v3.schema.Schema;
+import com.asyncapi.v3.binding.message.MessageBinding;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Kafka message binding.
+ *
+ * Contains information about the message representation in Kafka.
+ *
+ * @version 0.1.0
+ * @see Kafka message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class KafkaMessageBinding extends MessageBinding {
+
+ /**
+ * The message key.
+ */
+ @Nullable
+ @JsonProperty("key")
+ @JsonPropertyDescription("The message key.")
+ private Schema key;
+
+ /**
+ * If a Schema Registry is used when performing this operation, tells where the id of schema is stored (e.g. header or payload).
+ */
+ @Nullable
+ @JsonProperty("schemaIdLocation")
+ @JsonPropertyDescription("If a Schema Registry is used when performing this operation, tells where the id of schema is stored (e.g. header or payload).")
+ private KafkaMessageSchemaIdLocation schemaIdLocation;
+
+ /**
+ * Number of bytes or vendor specific values when schema id is encoded in payload (e.g confluent/ apicurio-legacy / apicurio-new).
+ */
+ @Nullable
+ @JsonProperty("schemaIdPayloadEncoding")
+ @JsonPropertyDescription("Number of bytes or vendor specific values when schema id is encoded in payload (e.g confluent/ apicurio-legacy / apicurio-new).")
+ private String schemaIdPayloadEncoding;
+
+ /**
+ * Freeform string for any naming strategy class to use. Clients should default to the vendor default if not supplied.
+ */
+ @Nullable
+ @JsonProperty("schemaLookupStrategy")
+ @JsonPropertyDescription("Freeform string for any naming strategy class to use. Clients should default to the vendor default if not supplied.")
+ private String schemaLookupStrategy;
+
+ /**
+ * The version of this binding. If omitted, "latest" MUST be assumed.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.4.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/kafka/KafkaMessageSchemaIdLocation.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/kafka/KafkaMessageSchemaIdLocation.java
new file mode 100644
index 00000000..e0a16f88
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/kafka/KafkaMessageSchemaIdLocation.java
@@ -0,0 +1,20 @@
+package com.asyncapi.v3.binding.message.kafka;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+/**
+ * Describes Kafka message schema id location.
+ *
+ * @version 0.1.0
+ * @see Kafka message binding
+ * @author Pavel Bodiachevskii
+ */
+public enum KafkaMessageSchemaIdLocation {
+
+ @JsonProperty("header")
+ HEADER,
+
+ @JsonProperty("payload")
+ PAYLOAD
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/mercure/MercureMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/mercure/MercureMessageBinding.java
new file mode 100644
index 00000000..aa3ead1c
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/mercure/MercureMessageBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.message.mercure;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Mercure message binding.
+ *
+ * @version 0.1.0
+ * @see Mercure message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MercureMessageBinding extends MessageBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/mqtt/MQTTMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/mqtt/MQTTMessageBinding.java
new file mode 100644
index 00000000..cbaa824d
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/mqtt/MQTTMessageBinding.java
@@ -0,0 +1,34 @@
+package com.asyncapi.v3.binding.message.mqtt;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes MQTT message binding.
+ *
+ * Contains information about the message representation in MQTT.
+ *
+ * @version 0.1.0
+ * @see MQTT message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MQTTMessageBinding extends MessageBinding {
+
+ /**
+ * The version of this binding. If omitted, "latest" MUST be assumed.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/mqtt5/MQTT5MessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/mqtt5/MQTT5MessageBinding.java
new file mode 100644
index 00000000..e344426e
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/mqtt5/MQTT5MessageBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.message.mqtt5;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes MQTT 5 message binding.
+ *
+ * @version 0.2.0
+ * @see MQTT 5 message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MQTT5MessageBinding extends MessageBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/nats/NATSMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/nats/NATSMessageBinding.java
new file mode 100644
index 00000000..8557fc15
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/nats/NATSMessageBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.message.nats;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes NATS message binding.
+ *
+ * @version 0.1.0
+ * @see NATS message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class NATSMessageBinding extends MessageBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/pulsar/PulsarMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/pulsar/PulsarMessageBinding.java
new file mode 100644
index 00000000..257d9948
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/pulsar/PulsarMessageBinding.java
@@ -0,0 +1,23 @@
+package com.asyncapi.v3.binding.message.pulsar;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Describes Pulsar message binding.
+ *
+ * This object MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * @version 0.1.0
+ * @see Pulsar message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class PulsarMessageBinding extends MessageBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/redis/RedisMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/redis/RedisMessageBinding.java
new file mode 100644
index 00000000..37b5980a
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/redis/RedisMessageBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.message.redis;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Redis message binding.
+ *
+ * @version 0.1.0
+ * @see Redis message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class RedisMessageBinding extends MessageBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/sns/SNSMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/sns/SNSMessageBinding.java
new file mode 100644
index 00000000..17a72455
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/sns/SNSMessageBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.message.sns;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes SNS message binding.
+ *
+ * @version 0.1.0
+ * @see SNS message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class SNSMessageBinding extends MessageBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/solace/SolaceMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/solace/SolaceMessageBinding.java
new file mode 100644
index 00000000..29b24c2b
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/solace/SolaceMessageBinding.java
@@ -0,0 +1,23 @@
+package com.asyncapi.v3.binding.message.solace;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Solace message binding.
+ *
+ * @version 0.3.0
+ * @see Solace message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class SolaceMessageBinding extends MessageBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/sqs/SQSMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/sqs/SQSMessageBinding.java
new file mode 100644
index 00000000..9defa798
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/sqs/SQSMessageBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.message.sqs;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes SQS message binding.
+ *
+ * @version 0.1.0
+ * @see SQS message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class SQSMessageBinding extends MessageBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/stomp/STOMPMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/stomp/STOMPMessageBinding.java
new file mode 100644
index 00000000..3e786247
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/stomp/STOMPMessageBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.message.stomp;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes STOMP message binding.
+ *
+ * @version 0.1.0
+ * @see STOMP message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class STOMPMessageBinding extends MessageBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/ws/WebSocketsMessageBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/ws/WebSocketsMessageBinding.java
new file mode 100644
index 00000000..24dd7274
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/message/ws/WebSocketsMessageBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.message.ws;
+
+import com.asyncapi.v3.binding.message.MessageBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes WebSockets message binding.
+ *
+ * @version 0.1.0
+ * @see WebSockets message binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class WebSocketsMessageBinding extends MessageBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/OperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/OperationBinding.java
new file mode 100644
index 00000000..c055ade8
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/OperationBinding.java
@@ -0,0 +1,18 @@
+package com.asyncapi.v3.binding.operation;
+
+import com.asyncapi.v3.ExtendableObject;
+import lombok.EqualsAndHashCode;
+
+/**
+ * Describes protocol-specific definition for an operation.
+ *
+ * This object MAY be extended with {@link ExtendableObject}.
+ *
+ * @see Specification Extensions
+ * @see Operation Binding
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@EqualsAndHashCode(callSuper = true)
+public class OperationBinding extends ExtendableObject {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/amqp/AMQPOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/amqp/AMQPOperationBinding.java
new file mode 100644
index 00000000..56d53677
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/amqp/AMQPOperationBinding.java
@@ -0,0 +1,150 @@
+package com.asyncapi.v3.binding.operation.amqp;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * Describes AMQP 0-9-1 operation binding.
+ *
+ * Contains information about the operation representation in AMQP.
+ *
+ * @version 0.2.0
+ * @see AMQP operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes AMQP 0-9-1 operation binding.")
+public class AMQPOperationBinding extends OperationBinding {
+
+ /**
+ * TTL (Time-To-Live) for the message. It MUST be greater than or equal to zero.
+ *
+ * Applies to: publish, subscribe
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "TTL (Time-To-Live) for the message must be greater than or equal to zero"
+ )
+ @JsonProperty("expiration")
+ @JsonPropertyDescription("TTL (Time-To-Live) for the message. It MUST be greater than or equal to zero.")
+ private Integer expiration;
+
+ /**
+ * Identifies the user who has sent the message.
+ *
+ * Applies to: publish, subscribe
+ */
+ @Nullable
+ @JsonProperty("userId")
+ @JsonPropertyDescription("Identifies the user who has sent the message.")
+ private String userId;
+
+ /**
+ * The routing keys the message should be routed to at the time of publishing.
+ *
+ * Applies to: publish, subscribe
+ */
+ @Nullable
+ @JsonProperty("cc")
+ @JsonPropertyDescription("The routing keys the message should be routed to at the time of publishing.")
+ private List cc;
+
+ /**
+ * A priority for the message.
+ *
+ * Applies to: publish, subscribe
+ */
+ @Nullable
+ @JsonProperty("priority")
+ @JsonPropertyDescription("A priority for the message.")
+ private Integer priority;
+
+ /**
+ * Delivery mode of the message. Its value MUST be either 1 (transient) or 2 (persistent).
+ *
+ * Applies to: publish, subscribe
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 1,
+ message = "Delivery mode of the message must be either 1 (transient) or 2 (persistent)"
+ )
+ @javax.validation.constraints.Max(
+ value = 2,
+ message = "Delivery mode of the message must be either 1 (transient) or 2 (persistent)"
+ )
+ @JsonProperty("deliveryMode")
+ @JsonPropertyDescription("Delivery mode of the message. Its value MUST be either 1 (transient) or 2 (persistent).")
+ private Integer deliveryMode;
+
+ /**
+ * Whether the message is mandatory or not.
+ *
+ * Applies to: publish
+ */
+ @Nullable
+ @JsonProperty("mandatory")
+ @JsonPropertyDescription("Whether the message is mandatory or not.")
+ private Boolean mandatory;
+
+ /**
+ * Like {@link #cc} but consumers will not receive this information.
+ *
+ * Applies to: publish
+ */
+ @Nullable
+ @JsonProperty("bcc")
+ @JsonPropertyDescription("Like cc but consumers will not receive this information.")
+ private List bcc;
+
+ /**
+ * Name of the queue where the consumer should send the response.
+ *
+ * Applies to: publish, subscribe
+ */
+ @Nullable
+ @JsonProperty("replyTo")
+ @JsonPropertyDescription("Name of the queue where the consumer should send the response.")
+ private String replyTo;
+
+ /**
+ * Whether the message should include a timestamp or not.
+ *
+ * Applies to: publish, subscribe
+ */
+ @Nullable
+ @JsonProperty("timestamp")
+ @JsonPropertyDescription("Whether the message should include a timestamp or not.")
+ private Boolean timestamp;
+
+ /**
+ * Whether the consumer should ack the message or not.
+ *
+ * Applies to: subscribe
+ */
+ @Nullable
+ @JsonProperty("ack")
+ @JsonPropertyDescription("Whether the consumer should ack the message or not.")
+ private Boolean ack;
+
+ /**
+ * The version of this binding. If omitted, "latest" MUST be assumed.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.2.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/amqp1/AMQP1OperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/amqp1/AMQP1OperationBinding.java
new file mode 100644
index 00000000..29a7ce02
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/amqp1/AMQP1OperationBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.operation.amqp1;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes AMQP 1.0 operation binding.
+ *
+ * @version 0.1.0
+ * @see AMQP operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class AMQP1OperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/anypointmq/AnypointMQOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/anypointmq/AnypointMQOperationBinding.java
new file mode 100644
index 00000000..8555af46
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/anypointmq/AnypointMQOperationBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.operation.anypointmq;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Anypoint MQ operation binding.
+ *
+ * @version 0.0.1
+ * @see Anypoint MQ operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class AnypointMQOperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/googlepubsub/GooglePubSubOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/googlepubsub/GooglePubSubOperationBinding.java
new file mode 100644
index 00000000..7b074d70
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/googlepubsub/GooglePubSubOperationBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.operation.googlepubsub;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Google Cloud Pub/Sub operation binding.
+ *
+ * @version 0.1.0
+ * @see Google Cloud Pub/Sub operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class GooglePubSubOperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/http/HTTPOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/http/HTTPOperationBinding.java
new file mode 100644
index 00000000..50a6c961
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/http/HTTPOperationBinding.java
@@ -0,0 +1,66 @@
+package com.asyncapi.v3.binding.operation.http;
+
+import com.asyncapi.v3.schema.Schema;
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes HTTP operation binding.
+ *
+ * Contains information about the operation representation in HTTP.
+ *
+ * @version 0.1.0
+ * @see HTTP operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class HTTPOperationBinding extends OperationBinding {
+
+ /**
+ * Required.
+ *
+ * Type of operation. Its value MUST be either request or response.
+ */
+ @NotNull
+ @Builder.Default
+ @javax.validation.constraints.NotNull
+ @JsonProperty(value = "type", required = true)
+ @JsonPropertyDescription("Type of operation. Its value MUST be either request or response.")
+ private HTTPOperationType type = HTTPOperationType.REQUEST;
+
+ /**
+ * When type is request, this is the HTTP method, otherwise it MUST be ignored. Its value MUST be one of
+ * GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS, CONNECT, and TRACE.
+ */
+ @Nullable
+ @JsonProperty("method")
+ @JsonPropertyDescription("When type is request, this is the HTTP method, otherwise it MUST be ignored. Its value MUST be one of GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS, CONNECT, and TRACE.")
+ private HTTPOperationMethod method;
+
+ /**
+ * A Schema object containing the definitions for each query parameter. This schema MUST be of type object
+ * and have a properties key.
+ */
+ @Nullable
+ @JsonProperty("query")
+ @JsonPropertyDescription("A Schema object containing the definitions for each query parameter. This schema MUST be of type object and have a properties key.")
+ private Schema query;
+
+ /**
+ * The version of this binding. If omitted, "latest" MUST be assumed.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/http/HTTPOperationMethod.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/http/HTTPOperationMethod.java
new file mode 100644
index 00000000..d71ddf2a
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/http/HTTPOperationMethod.java
@@ -0,0 +1,22 @@
+package com.asyncapi.v3.binding.operation.http;
+
+/**
+ * Describes HTTP operation type.
+ *
+ * Contains information about the operation type.
+ *
+ * @version 0.1.0
+ * @see HTTP operation binding
+ * @author Pavel Bodiachevskii
+ */
+public enum HTTPOperationMethod {
+ GET,
+ PUT,
+ POST,
+ PATCH,
+ DELETE,
+ HEAD,
+ OPTIONS,
+ CONNECT,
+ TRACE
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/http/HTTPOperationType.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/http/HTTPOperationType.java
new file mode 100644
index 00000000..0c7d5031
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/http/HTTPOperationType.java
@@ -0,0 +1,13 @@
+package com.asyncapi.v3.binding.operation.http;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+public enum HTTPOperationType {
+
+ @JsonProperty("request")
+ REQUEST,
+
+ @JsonProperty("response")
+ RESPONSE
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/ibmmq/IBMMQOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/ibmmq/IBMMQOperationBinding.java
new file mode 100644
index 00000000..0313e97f
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/ibmmq/IBMMQOperationBinding.java
@@ -0,0 +1,23 @@
+package com.asyncapi.v3.binding.operation.ibmmq;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Describes IBM MQ operation binding.
+ *
+ * This object MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * @version 0.1.0
+ * @see IBM MQ operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class IBMMQOperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/jms/JMSOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/jms/JMSOperationBinding.java
new file mode 100644
index 00000000..f3a1f1a8
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/jms/JMSOperationBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.operation.jms;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes JMS operation binding.
+ *
+ * @version 0.1.0
+ * @see JMS operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class JMSOperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/kafka/KafkaOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/kafka/KafkaOperationBinding.java
new file mode 100644
index 00000000..c0558d01
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/kafka/KafkaOperationBinding.java
@@ -0,0 +1,49 @@
+package com.asyncapi.v3.binding.operation.kafka;
+
+import com.asyncapi.v3.schema.Schema;
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Kafka operation binding.
+ *
+ * Contains information about the operation representation in Kafka.
+ *
+ * @version 0.1.0
+ * @see Kafka operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class KafkaOperationBinding extends OperationBinding {
+
+ /**
+ * Id of the consumer group.
+ */
+ @Nullable
+ @JsonProperty("groupId")
+ @JsonPropertyDescription("Id of the consumer group.")
+ private Schema groupId;
+
+ /**
+ * Id of the consumer inside a consumer group.
+ */
+ @Nullable
+ @JsonProperty("clientId")
+ @JsonPropertyDescription("Id of the consumer inside a consumer group.")
+ private Schema clientId;
+
+ /**
+ * The version of this binding. If omitted, "latest" MUST be assumed.
+ */
+ @Nullable
+ @Builder.Default
+ private String bindingVersion = "0.4.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/mercure/MercureOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/mercure/MercureOperationBinding.java
new file mode 100644
index 00000000..10dcaa96
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/mercure/MercureOperationBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.operation.mercure;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Mercure operation binding.
+ *
+ * @version 0.1.0
+ * @see Mercure operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MercureOperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/mqtt/MQTTOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/mqtt/MQTTOperationBinding.java
new file mode 100644
index 00000000..c9f36c7c
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/mqtt/MQTTOperationBinding.java
@@ -0,0 +1,67 @@
+package com.asyncapi.v3.binding.operation.mqtt;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes MQTT operation binding.
+ *
+ * Contains information about the operation representation in MQTT.
+ *
+ * @version 0.1.0
+ * @see MQTT operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes MQTT operation binding.")
+public class MQTTOperationBinding extends OperationBinding {
+
+ /**
+ * Defines how hard the broker/client will try to ensure that a message is received.
+ * Its value MUST be either 0, 1 or 2.
+ *
+ * Applies to: publish, subscribe
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "QoS must be greater or equals to 0."
+ )
+ @javax.validation.constraints.Max(
+ value = 2,
+ message = "QoS must be lower or equals to 0."
+ )
+ @JsonProperty("qos")
+ @JsonPropertyDescription("Defines the Quality of Service (QoS) levels for the message flow between client and server. Its value MUST be either 0 (At most once delivery), 1 (At least once delivery), or 2 (Exactly once delivery).")
+ private Integer qos;
+
+ /**
+ * Whether the broker should retain the message or not.
+ *
+ * Applies to: publish, subscribe
+ */
+ @Nullable
+ @JsonProperty("retain")
+ @JsonPropertyDescription("Whether the broker should retain the message or not.")
+ private Boolean retain;
+
+ /**
+ * The version of this binding. If omitted, "latest" MUST be assumed.
+ *
+ * Applies to: publish, subscribe
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/mqtt5/MQTT5OperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/mqtt5/MQTT5OperationBinding.java
new file mode 100644
index 00000000..2964aad6
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/mqtt5/MQTT5OperationBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.operation.mqtt5;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes MQTT 5 operation binding.
+ *
+ * @version 0.2.0
+ * @see MQTT 5 operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MQTT5OperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/nats/NATSOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/nats/NATSOperationBinding.java
new file mode 100644
index 00000000..9a6c2cf2
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/nats/NATSOperationBinding.java
@@ -0,0 +1,46 @@
+package com.asyncapi.v3.binding.operation.nats;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes NATS operation binding.
+ *
+ * @version 0.1.0
+ * @see NATS operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes NATS operation binding.")
+public class NATSOperationBinding extends OperationBinding {
+
+ /**
+ * Defines the name of the queue to use. It MUST NOT exceed 255 characters.
+ */
+ @Nullable
+ @javax.validation.constraints.Size(
+ max = 255,
+ message = "Queue name must be lower or equals to 255."
+ )
+ @JsonProperty("queue")
+ @JsonPropertyDescription("Defines the name of the queue to use. It MUST NOT exceed 255 characters.")
+ private String queue;
+
+ /**
+ * The version of this binding. If omitted, "latest" MUST be assumed.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/pulsar/PulsarOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/pulsar/PulsarOperationBinding.java
new file mode 100644
index 00000000..3670d242
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/pulsar/PulsarOperationBinding.java
@@ -0,0 +1,23 @@
+package com.asyncapi.v3.binding.operation.pulsar;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * Describes Pulsar operation binding.
+ *
+ * This object MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * @version 0.1.0
+ * @see Pulsar operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class PulsarOperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/redis/RedisOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/redis/RedisOperationBinding.java
new file mode 100644
index 00000000..0c4eb8e0
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/redis/RedisOperationBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.operation.redis;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Redis operation binding.
+ *
+ * @version 0.1.0
+ * @see Redis operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class RedisOperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/sns/SNSOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/sns/SNSOperationBinding.java
new file mode 100644
index 00000000..e0445fc8
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/sns/SNSOperationBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.operation.sns;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes SNS operation binding.
+ *
+ * @version 0.1.0
+ * @see SNS operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class SNSOperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/solace/SolaceOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/solace/SolaceOperationBinding.java
new file mode 100644
index 00000000..bd87d8a7
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/solace/SolaceOperationBinding.java
@@ -0,0 +1,46 @@
+package com.asyncapi.v3.binding.operation.solace;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * Describes Solace operation binding.
+ *
+ * Contains information about the operation representation in Solace PubSub+ Broker.
+ *
+ * @version 0.3.0
+ * @see Solace operation binding
+ * @author Dennis Brinley, Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Solace operation binding.")
+public class SolaceOperationBinding extends OperationBinding {
+
+ /**
+ * List of destinations
+ */
+ @Nullable
+ @JsonProperty("destinations")
+ @JsonPropertyDescription("List of destinations")
+ private List destinations;
+
+ /**
+ * The version of this binding. (e.g. bindingVersion: 0.3.0)
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.3.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/solace/SolaceOperationDestination.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/solace/SolaceOperationDestination.java
new file mode 100644
index 00000000..ef959dfb
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/solace/SolaceOperationDestination.java
@@ -0,0 +1,83 @@
+package com.asyncapi.v3.binding.operation.solace;
+
+import com.asyncapi.v3.binding.operation.solace.queue.SolaceOperationQueue;
+import com.asyncapi.v3.binding.operation.solace.topic.SolaceOperationTopic;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Solace destination.
+ *
+ * Contains information about the destination in Solace PubSub+ Broker.
+ *
+ * @version 0.3.0
+ * @see Solace operation binding
+ * @author Dennis Brinley, Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@JsonClassDescription("Describes Solace destination.")
+public class SolaceOperationDestination {
+
+ /**
+ * 'queue' or 'topic'. If the type is queue, then the subscriber can bind to the queue, which in turn will
+ * subscribe to the topic as represented by the channel name or to the provided topicSubscriptions.
+ */
+ @Nullable
+ @JsonProperty("destinationType")
+ @JsonPropertyDescription("'queue' or 'topic'. If the type is queue, then the subscriber can bind to the queue, which in turn will subscribe to the topic as represented by the channel name or to the provided topicSubscriptions.")
+ private Type destinationType;
+
+ /**
+ * 'direct' or 'persistent'. This determines the quality of service for publishing messages as documented here .
+ * Default is 'persistent'.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "deliveryMode", defaultValue = "persistent")
+ @JsonPropertyDescription("'direct' or 'persistent'. This determines the quality of service for publishing messages as documented at https://docs.solace.com/Get-Started/Core-Concepts-Message-Delivery-Modes.htm. Default is 'persistent'.")
+ private DeliveryMode deliveryMode = DeliveryMode.PERSISTENT;
+
+ /**
+ * Solace queue destination details.
+ */
+ @Nullable
+ @JsonProperty("queue")
+ @JsonPropertyDescription("Solace queue destination details.")
+ private SolaceOperationQueue queue;
+
+ /**
+ * Solace topic destination details.
+ */
+ @Nullable
+ @JsonProperty("topic")
+ @JsonPropertyDescription("Solace topic destination details.")
+ private SolaceOperationTopic topic;
+
+ public enum Type {
+
+ @JsonProperty("queue")
+ QUEUE,
+ @JsonProperty("topic")
+ TOPIC
+
+ }
+
+ public enum DeliveryMode {
+
+ @JsonProperty("direct")
+ DIRECT,
+ @JsonProperty("persistent")
+ PERSISTENT
+
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/solace/queue/SolaceOperationQueue.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/solace/queue/SolaceOperationQueue.java
new file mode 100644
index 00000000..d2c3f5c7
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/solace/queue/SolaceOperationQueue.java
@@ -0,0 +1,82 @@
+package com.asyncapi.v3.binding.operation.solace.queue;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * Describes Solace queue.
+ *
+ * Contains information about the queue in Solace PubSub+ Broker.
+ *
+ * @version 0.3.0
+ * @see Solace operation binding
+ * @author Dennis Brinley, Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@JsonClassDescription("Describes Solace queue.")
+public class SolaceOperationQueue {
+
+ /**
+ * The name of the queue, only applicable when destinationType is 'queue'.
+ */
+ @Nullable
+ @JsonProperty("name")
+ @JsonPropertyDescription("The name of the queue, only applicable when destinationType is 'queue'.")
+ private String name;
+
+ /**
+ * A list of topics that the queue subscribes to, only applicable when destinationType is 'queue'.
+ * If none is given, the queue subscribes to the topic as represented by the channel name.
+ */
+ @Nullable
+ @JsonProperty("topicSubscriptions")
+ @JsonPropertyDescription("A list of topics that the queue subscribes to, only applicable when destinationType is 'queue'. If none is given, the queue subscribes to the topic as represented by the channel name.")
+ private List topicSubscriptions;
+
+ /**
+ * 'exclusive' or 'nonexclusive'. This is documented here . Only applicable when destinationType is 'queue'.
+ */
+ @Nullable
+ @JsonProperty("accessType")
+ @JsonPropertyDescription("'exclusive' or 'nonexclusive'. This is documented at https://docs.solace.com/Messaging/Guaranteed-Msg/Endpoints.htm#Queues. Only applicable when destinationType is 'queue'.")
+ private AccessType accessType;
+
+ /**
+ * The maximum amount of message spool that the given queue may use. This is documented here .
+ * Only applicable when destinationType is 'queue'.
+ */
+ @Nullable
+ @JsonProperty("maxMsgSpoolSize")
+ @JsonPropertyDescription("The maximum amount of message spool that the given queue may use. This is documented at https://docs.solace.com/Messaging/Guaranteed-Msg/Message-Spooling.htm#max-spool-usage. Only applicable when destinationType is 'queue'.")
+ private String maxMsgSpoolSize;
+
+ /**
+ * The maximum TTL to apply to messages to be spooled. This is documented here .
+ * Only applicable when destinationType is 'queue'.
+ */
+ @Nullable
+ @JsonProperty("maxTtl")
+ @JsonPropertyDescription("The maximum TTL to apply to messages to be spooled. This is documented at https://docs.solace.com/Messaging/Guaranteed-Msg/Configuring-Queues.htm. Only applicable when destinationType is 'queue'.")
+ private String maxTtl;
+
+ public enum AccessType {
+
+ @JsonProperty("exclusive")
+ EXCLUSIVE,
+ @JsonProperty("non-exclusive")
+ NON_EXCLUSIVE
+
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/solace/topic/SolaceOperationTopic.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/solace/topic/SolaceOperationTopic.java
new file mode 100644
index 00000000..9d20880d
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/solace/topic/SolaceOperationTopic.java
@@ -0,0 +1,39 @@
+package com.asyncapi.v3.binding.operation.solace.topic;
+
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * Describes Solace topic.
+ *
+ * Contains information about the topic in Solace PubSub+ Broker.
+ *
+ * @version 0.3.0
+ * @see Solace operation binding
+ * @author Dennis Brinley, Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@JsonClassDescription("Describes Solace topic.")
+public class SolaceOperationTopic {
+
+ /**
+ * A list of topics that the client subscribes to, only applicable when destinationType is 'topic'.
+ * If none is given, the client subscribes to the topic as represented by the channel name.
+ */
+ @Nullable
+ @JsonProperty("topicSubscriptions")
+ @JsonPropertyDescription("A list of topics that the client subscribes to, only applicable when destinationType is 'topic'. If none is given, the client subscribes to the topic as represented by the channel name.")
+ protected List topicSubscriptions;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/sqs/SQSOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/sqs/SQSOperationBinding.java
new file mode 100644
index 00000000..de34599b
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/sqs/SQSOperationBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.operation.sqs;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes SQS operation binding.
+ *
+ * @version 0.1.0
+ * @see SQS operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class SQSOperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/stomp/STOMPOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/stomp/STOMPOperationBinding.java
new file mode 100644
index 00000000..5679be40
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/stomp/STOMPOperationBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.operation.stomp;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes STOMP operation binding.
+ *
+ * @version 0.1.0
+ * @see STOMP operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class STOMPOperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/ws/WebSocketsOperationBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/ws/WebSocketsOperationBinding.java
new file mode 100644
index 00000000..a2e14bc5
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/operation/ws/WebSocketsOperationBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.operation.ws;
+
+import com.asyncapi.v3.binding.operation.OperationBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes WebSockets operation binding.
+ *
+ * @version 0.1.0
+ * @see WebSockets operation binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class WebSocketsOperationBinding extends OperationBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/ServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/ServerBinding.java
new file mode 100644
index 00000000..d4c58f0e
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/ServerBinding.java
@@ -0,0 +1,18 @@
+package com.asyncapi.v3.binding.server;
+
+import com.asyncapi.v3.ExtendableObject;
+import lombok.EqualsAndHashCode;
+
+/**
+ * Describes protocol-specific definition for a server.
+ *
+ * This object MAY be extended with {@link ExtendableObject}.
+ *
+ * @see Specification Extensions
+ * @see Server Binding
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@EqualsAndHashCode(callSuper = true)
+public class ServerBinding extends ExtendableObject {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/amqp/AMQPServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/amqp/AMQPServerBinding.java
new file mode 100644
index 00000000..17294433
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/amqp/AMQPServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.amqp;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes AMQP 0-9-1 server binding.
+ *
+ * @version 0.2.0
+ * @see AMQP server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class AMQPServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/amqp1/AMQP1ServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/amqp1/AMQP1ServerBinding.java
new file mode 100644
index 00000000..a97dbc33
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/amqp1/AMQP1ServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.amqp1;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes AMQP 1.0 server binding.
+ *
+ * @version 0.1.0
+ * @see AMQP server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class AMQP1ServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/anypointmq/AnypointMQServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/anypointmq/AnypointMQServerBinding.java
new file mode 100644
index 00000000..5771573a
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/anypointmq/AnypointMQServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.anypointmq;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Anypoint MQ server binding.
+ *
+ * @version 0.0.1
+ * @see Anypoint MQ server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class AnypointMQServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/googlepubsub/GooglePubSubServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/googlepubsub/GooglePubSubServerBinding.java
new file mode 100644
index 00000000..a8ff818f
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/googlepubsub/GooglePubSubServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.googlepubsub;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Google Cloud Pub/Sub server binding.
+ *
+ * @version 0.1.0
+ * @see Google Cloud Pub/Sub server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class GooglePubSubServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/http/HTTPServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/http/HTTPServerBinding.java
new file mode 100644
index 00000000..85c7e333
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/http/HTTPServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.http;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes HTTP server binding.
+ *
+ * @version 0.1.0
+ * @see HTTP server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class HTTPServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/ibmmq/IBMMQServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/ibmmq/IBMMQServerBinding.java
new file mode 100644
index 00000000..5b424552
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/ibmmq/IBMMQServerBinding.java
@@ -0,0 +1,102 @@
+package com.asyncapi.v3.binding.server.ibmmq;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes IBM MQ server binding.
+ *
+ * This object contains server connection information about the IBM MQ server, referred to as an IBM MQ queue manager.
+ * This object contains additional connectivity information not possible to represent within the core AsyncAPI specification.
+ *
+ * @version 0.1.0
+ * @see IBM MQ server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes IBM MQ server binding.")
+public class IBMMQServerBinding extends ServerBinding {
+
+ /**
+ * Defines a logical group of IBM MQ server objects. This is necessary to specify multi-endpoint configurations used
+ * in high availability deployments. If omitted, the server object is not part of a group.
+ *
+ * MUST NOT be specified for URI Scheme http:// or file://
+ */
+ @Nullable
+ @JsonProperty("groupId")
+ @JsonPropertyDescription("Defines a logical group of IBM MQ server objects. This is necessary to specify multi-endpoint configurations used in high availability deployments. If omitted, the server object is not part of a group.")
+ private String groupId;
+
+ /**
+ * The name of the IBM MQ queue manager to bind to in the CCDT file.
+ *
+ * MUST NOT be specified for URI Scheme ibmmq://
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "ccdtQueueManagerName", defaultValue = "*")
+ @JsonPropertyDescription("The name of the IBM MQ queue manager to bind to in the CCDT file.")
+ private String ccdtQueueManagerName = "*";
+
+ /**
+ * The recommended cipher specification used to establish a TLS connection between the client and the IBM MQ queue manager.
+ * More information on SSL/TLS cipher specifications supported by IBM MQ can be found on this page in the IBM MQ Knowledge Center.
+ *
+ * MUST NOT be specified for protocol ibmmq or URI Scheme file:// or http://
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "cipherSpec", defaultValue = "ANY")
+ @JsonPropertyDescription("The recommended cipher specification used to establish a TLS connection between the client and the IBM MQ queue manager. More information on SSL/TLS cipher specifications supported by IBM MQ can be found on this page in the IBM MQ Knowledge Center.")
+ private String cipherSpec = "ANY";
+
+ /**
+ * If multiEndpointServer is true then multiple connections can be workload balanced and applications should not make
+ * assumptions as to where messages are processed. Where message ordering, or affinity to specific message resources
+ * is necessary, a single endpoint (multiEndpointServer = false) may be required.
+ *
+ * MUST NOT be specified for URI Scheme file:// or http://
+ */
+ @Builder.Default
+ @JsonProperty(value = "multiEndpointServer", defaultValue = "false")
+ @JsonPropertyDescription("If multiEndpointServer is true then multiple connections can be workload balanced and applications should not make assumptions as to where messages are processed. Where message ordering, or affinity to specific message resources is necessary, a single endpoint (multiEndpointServer = false) may be required. MUST NOT be specified for URI Scheme file:// or http://")
+ private Boolean multiEndpointServer = false;
+
+ /**
+ * The recommended value (in seconds) for the heartbeat sent to the queue manager during periods of inactivity.
+ * A value of zero means that no heart beats are sent. A value of 1 means that the client will use the value defined by the queue manager.
+ * More information on heart beat interval can be found on this page in the IBM MQ Knowledge Center.
+ *
+ * MUST be 0-999999
+ */
+ @Builder.Default
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "Heart beat interval must be greater or equals to 0"
+ )
+ @javax.validation.constraints.Max(
+ value = 999999,
+ message = "Heart beat interval must be less or equals to 999999"
+ )
+ @JsonProperty(value = "heartBeatInterval", defaultValue = "300")
+ @JsonPropertyDescription("The recommended value (in seconds) for the heartbeat sent to the queue manager during periods of inactivity. A value of zero means that no heart beats are sent. A value of 1 means that the client will use the value defined by the queue manager.")
+ private int heartBeatInterval = 300;
+
+ /**
+ * The version of this binding.
+ */
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/jms/JMSServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/jms/JMSServerBinding.java
new file mode 100644
index 00000000..406ac082
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/jms/JMSServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.jms;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes JMS server binding.
+ *
+ * @version 0.1.0
+ * @see JMS server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class JMSServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/kafka/KafkaServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/kafka/KafkaServerBinding.java
new file mode 100644
index 00000000..b0122269
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/kafka/KafkaServerBinding.java
@@ -0,0 +1,52 @@
+package com.asyncapi.v3.binding.server.kafka;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Kafka server binding.
+ *
+ * @version 0.4.0
+ * @see Kafka server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Kafka server binding.")
+public class KafkaServerBinding extends ServerBinding {
+
+ /**
+ * API URL for the Schema Registry used when producing Kafka messages (if a Schema Registry was used)
+ */
+ @Nullable
+ @JsonProperty("schemaRegistryUrl")
+ @JsonPropertyDescription("API URL for the Schema Registry used when producing Kafka messages (if a Schema Registry was used)")
+ private String schemaRegistryUrl;
+
+ /**
+ * MUST NOT be specified if schemaRegistryUrl is not specified
+ *
+ * The vendor of Schema Registry and Kafka serdes library that should be used (e.g. apicurio, confluent, ibm, or karapace)
+ */
+ @Nullable
+ @JsonProperty("schemaRegistryVendor")
+ @JsonPropertyDescription("The vendor of Schema Registry and Kafka serdes library that should be used (e.g. apicurio, confluent, ibm, or karapace)")
+ private String schemaRegistryVendor;
+
+ /**
+ * The version of this binding.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.4.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/mercure/MercureServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/mercure/MercureServerBinding.java
new file mode 100644
index 00000000..6919e41d
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/mercure/MercureServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.mercure;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Mercure server binding.
+ *
+ * @version 0.1.0
+ * @see Mercure server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MercureServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/mqtt/MQTTServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/mqtt/MQTTServerBinding.java
new file mode 100644
index 00000000..29a261d0
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/mqtt/MQTTServerBinding.java
@@ -0,0 +1,68 @@
+package com.asyncapi.v3.binding.server.mqtt;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes MQTT server binding.
+ *
+ * Contains information about the server representation in MQTT.
+ *
+ * @version 0.1.0
+ * @see MQTT server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes MQTT server binding.")
+public class MQTTServerBinding extends ServerBinding {
+
+ /**
+ * The client identifier.
+ */
+ @Nullable
+ @JsonProperty("clientId")
+ @JsonPropertyDescription("The client identifier.")
+ private String clientId;
+
+ /**
+ * Whether to create a persisten connection or not. When false, the connection will be persistent.
+ */
+ @Nullable
+ @JsonProperty("cleanSession")
+ @JsonPropertyDescription("Whether to create a persisten connection or not. When false, the connection will be persistent.")
+ private Boolean cleanSession;
+
+ /**
+ * Last Will and Testament configuration.
+ */
+ @Nullable
+ @JsonProperty("lastWill")
+ @JsonPropertyDescription("Last Will and Testament configuration.")
+ private MQTTServerLastWillConfiguration lastWill;
+
+ /**
+ * Interval in seconds of the longest period of time the broker and the client can endure without sending a message.
+ */
+ @Nullable
+ @JsonProperty("keepAlive")
+ @JsonPropertyDescription("Interval in seconds of the longest period of time the broker and the client can endure without sending a message.")
+ private Integer keepAlive;
+
+ /**
+ * The version of this binding. If omitted, "latest" MUST be assumed.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/mqtt/MQTTServerLastWillConfiguration.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/mqtt/MQTTServerLastWillConfiguration.java
new file mode 100644
index 00000000..99e63a48
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/mqtt/MQTTServerLastWillConfiguration.java
@@ -0,0 +1,65 @@
+package com.asyncapi.v3.binding.server.mqtt;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes MQTT server last will configuration.
+ *
+ * @version 0.1.0
+ * @see MQTT server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@EqualsAndHashCode
+@NoArgsConstructor
+@AllArgsConstructor
+public class MQTTServerLastWillConfiguration {
+
+ /**
+ * The topic where the Last Will and Testament message will be sent.
+ */
+ @Nullable
+ @JsonProperty("topic")
+ @JsonPropertyDescription("The topic where the Last Will and Testament message will be sent.")
+ private String topic;
+
+ /**
+ * Defines how hard the broker/client will try to ensure that the Last Will and Testament message is received.
+ * Its value MUST be either 0, 1 or 2.
+ */
+ @Nullable
+ @javax.validation.constraints.Min(
+ value = 0,
+ message = "QoS must be greater or equals to 0."
+ )
+ @javax.validation.constraints.Max(
+ value = 2,
+ message = "QoS must be lower or equals to 0."
+ )
+ @JsonProperty("qos")
+ @JsonPropertyDescription("Defines how hard the broker/client will try to ensure that the Last Will and Testament message is received. Its value MUST be either 0, 1 or 2.")
+ private Integer qos;
+
+ /**
+ * Last Will message.
+ */
+ @Nullable
+ @JsonProperty("message")
+ @JsonPropertyDescription("Last Will message.")
+ private String message;
+
+ /**
+ * Whether the broker should retain the Last Will and Testament message or not.
+ */
+ @Nullable
+ @JsonProperty("retain")
+ @JsonPropertyDescription("Whether the broker should retain the Last Will and Testament message or not.")
+ private Boolean retain;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/mqtt5/MQTT5ServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/mqtt5/MQTT5ServerBinding.java
new file mode 100644
index 00000000..a9522e04
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/mqtt5/MQTT5ServerBinding.java
@@ -0,0 +1,29 @@
+package com.asyncapi.v3.binding.server.mqtt5;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.*;
+
+/**
+ * Describes MQTT 5 server binding.
+ *
+ * @version 0.2.0
+ * @see MQTT 5 server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MQTT5ServerBinding extends ServerBinding {
+
+ /**
+ * TODO: support reference, Schema object
+ * Session Expiry Interval in seconds or a Schema Object containing the definition of the interval.
+ */
+ private int sessionExpiryInterval;
+
+ @Builder.Default
+ private String bindingVersion = "0.2.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/nats/NATSServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/nats/NATSServerBinding.java
new file mode 100644
index 00000000..00331b04
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/nats/NATSServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.nats;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes NATS channel binding.
+ *
+ * @version 0.1.0
+ * @see NATS server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class NATSServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/pulsar/PulsarServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/pulsar/PulsarServerBinding.java
new file mode 100644
index 00000000..b67d8ef0
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/pulsar/PulsarServerBinding.java
@@ -0,0 +1,43 @@
+package com.asyncapi.v3.binding.server.pulsar;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Pulsar server binding.
+ *
+ * @version 0.1.0
+ * @see Redis server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Pulsar server binding.")
+public class PulsarServerBinding extends ServerBinding {
+
+ /**
+ * The pulsar tenant. If omitted, "public" MUST be assumed.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty(value = "tenant", defaultValue = "public")
+ @JsonPropertyDescription("The pulsar tenant. If omitted, \"public\" MUST be assumed.")
+ private String tenant = "public";
+
+ /**
+ * The version of this binding.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.1.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/redis/RedisServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/redis/RedisServerBinding.java
new file mode 100644
index 00000000..bea734b6
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/redis/RedisServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.redis;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes Redis server binding.
+ *
+ * @version 0.1.0
+ * @see Redis server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class RedisServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/sns/SNSServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/sns/SNSServerBinding.java
new file mode 100644
index 00000000..87b7dc42
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/sns/SNSServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.sns;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes SNS server binding.
+ *
+ * @version 0.1.0
+ * @see SNS server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class SNSServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/solace/SolaceServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/solace/SolaceServerBinding.java
new file mode 100644
index 00000000..c98e8470
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/solace/SolaceServerBinding.java
@@ -0,0 +1,44 @@
+package com.asyncapi.v3.binding.server.solace;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import com.fasterxml.jackson.annotation.JsonClassDescription;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonPropertyDescription;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Describes Solace server binding.
+ *
+ * @version 0.3.0
+ * @see Solace server binding
+ * @author Dennis Brinley, Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@JsonClassDescription("Describes Solace server binding.")
+public class SolaceServerBinding extends ServerBinding {
+
+ /**
+ * Message VPN of the Solace Broker
+ *
+ * e.g. msgVpn: solace-broker-msg-vpn
+ */
+ @Nullable
+ @JsonProperty("msgVpn")
+ @JsonPropertyDescription("Message VPN of the Solace Broker")
+ private String msgVpn;
+
+ /**
+ * The version of this binding.
+ */
+ @Nullable
+ @Builder.Default
+ @JsonProperty("bindingVersion")
+ @JsonPropertyDescription("The version of this binding.")
+ private String bindingVersion = "0.3.0";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/sqs/SQSServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/sqs/SQSServerBinding.java
new file mode 100644
index 00000000..ce8f6962
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/sqs/SQSServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.sqs;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes SQS server binding.
+ *
+ * @version 0.1.0
+ * @see SQS server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class SQSServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/stomp/STOMPServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/stomp/STOMPServerBinding.java
new file mode 100644
index 00000000..871557c8
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/stomp/STOMPServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.stomp;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes STOMP server binding.
+ *
+ * @version 0.1.0
+ * @see STOMP server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class STOMPServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/ws/WebSocketsServerBinding.java b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/ws/WebSocketsServerBinding.java
new file mode 100644
index 00000000..b76ab214
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/binding/server/ws/WebSocketsServerBinding.java
@@ -0,0 +1,21 @@
+package com.asyncapi.v3.binding.server.ws;
+
+import com.asyncapi.v3.binding.server.ServerBinding;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+
+/**
+ * This class MUST NOT contain any properties. Its name is reserved for future use.
+ *
+ * Describes WebSockets server binding.
+ *
+ * @version 0.1.0
+ * @see WebSockets server binding
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class WebSocketsServerBinding extends ServerBinding {
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/BindingsMapDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/BindingsMapDeserializer.java
new file mode 100644
index 00000000..d4e782c6
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/BindingsMapDeserializer.java
@@ -0,0 +1,44 @@
+package com.asyncapi.v3.jackson;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+
+import java.io.IOException;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * Deserializes AsyncAPI bindings map.
+ */
+public abstract class BindingsMapDeserializer extends JsonDeserializer> {
+
+ public abstract Object chooseKnownPojo(String bindingKey, JsonNode binding, ObjectCodec objectCodec) throws IOException;
+
+ @Override
+ public Map deserialize(
+ JsonParser p,
+ DeserializationContext ctxt
+ ) throws IOException, JsonProcessingException {
+ ObjectCodec objectCodec = p.getCodec();
+ JsonNode node = objectCodec.readTree(p);
+
+ Map bindings = new HashMap<>();
+
+ node.fieldNames().forEachRemaining(
+ fieldName -> {
+ try {
+ bindings.put(fieldName, chooseKnownPojo(fieldName, node.get(fieldName), objectCodec));
+ } catch (IOException e) {
+ e.printStackTrace();
+ }
+ }
+ );
+
+ return bindings;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/ListOfReferencesOrObjectsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/ListOfReferencesOrObjectsDeserializer.java
new file mode 100644
index 00000000..e4212093
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/ListOfReferencesOrObjectsDeserializer.java
@@ -0,0 +1,51 @@
+package com.asyncapi.v3.jackson;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+public abstract class ListOfReferencesOrObjectsDeserializer extends JsonDeserializer> {
+
+ abstract public Class objectTypeClass();
+
+ abstract public Class referenceClass();
+
+ @Override
+ public List deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JsonProcessingException {
+ ObjectCodec objectCodec = p.getCodec();
+ JsonNode node = objectCodec.readTree(p);
+
+ List traits = new ArrayList<>();
+
+ node.forEach(
+ traitsValue -> {
+ try {
+ traits.add(chooseKnownPojo(traitsValue, objectCodec));
+ } catch (IOException e) {
+ e.printStackTrace();
+ }
+ }
+ );
+
+ return traits;
+ }
+
+ private Object chooseKnownPojo(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ JsonNode ref = jsonNode.get("$ref");
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ if (ref != null) {
+ return jsonParser.readValueAs(referenceClass());
+ } else {
+ return jsonParser.readValueAs(objectTypeClass());
+ }
+ }
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/MapOfReferencesOrObjectsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/MapOfReferencesOrObjectsDeserializer.java
new file mode 100644
index 00000000..53d967a7
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/MapOfReferencesOrObjectsDeserializer.java
@@ -0,0 +1,80 @@
+package com.asyncapi.v3.jackson;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+
+import java.io.IOException;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * Deserializes AsyncAPI map of parameters
+ * @param object
+ */
+public abstract class MapOfReferencesOrObjectsDeserializer extends JsonDeserializer> {
+
+ abstract public Class objectTypeClass();
+
+ abstract public Class referenceClass();
+
+ @Override
+ public Map deserialize(JsonParser jsonParser,
+ DeserializationContext deserializationContext
+ ) throws IOException, JsonProcessingException {
+ ObjectCodec objectCodec = jsonParser.getCodec();
+ JsonNode map = objectCodec.readTree(jsonParser);
+
+ Map parameters = new HashMap<>();
+
+ map.fieldNames().forEachRemaining(
+ fieldName -> {
+ /*
+ Problem:
+ Both, Reference class and Schema class have $ref field.
+ So, this is only reason why I receive next exception:
+ "com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException:
+ Unrecognized field "title" (class com.asyncapi.v2._6_0.model.Reference),
+ not marked as ignorable (one known property: "$ref"])"
+ in case when Schema contains $ref.
+ Solution:
+ Try to deserialize reference. In case of exception, try to deserialize it as given ObjectType. In case of
+ one more exception, throw it.
+ TODO: Think how to improve.
+ */
+ try {
+ parameters.put(fieldName, chooseKnownPojo(map.get(fieldName), objectCodec));
+ } catch (IOException ignore) {
+ try {
+ parameters.put(fieldName, readAsObject(map.get(fieldName), objectCodec));
+ } catch (IOException e) {
+ e.printStackTrace();
+ }
+ }
+ }
+ );
+
+ return parameters;
+ }
+
+ private Object chooseKnownPojo(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ JsonNode ref = jsonNode.get("$ref");
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ if (ref != null) {
+ return jsonParser.readValueAs(referenceClass());
+ } else {
+ return jsonParser.readValueAs(objectTypeClass());
+ }
+ }
+ }
+
+ private Object readAsObject(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ return jsonParser.readValueAs(objectTypeClass());
+ }
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/ReferenceOrObjectDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/ReferenceOrObjectDeserializer.java
new file mode 100644
index 00000000..b9b34882
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/ReferenceOrObjectDeserializer.java
@@ -0,0 +1,61 @@
+package com.asyncapi.v3.jackson;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException;
+
+import java.io.IOException;
+
+public abstract class ReferenceOrObjectDeserializer extends JsonDeserializer {
+
+ abstract public Class objectTypeClass();
+
+ abstract public Class referenceClass();
+
+ @Override
+ public Object deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JsonProcessingException {
+ ObjectCodec objectCodec = p.getCodec();
+ JsonNode node = objectCodec.readTree(p);
+
+ /*
+ Problem:
+ Both, Reference class and Schema class have $ref field.
+ So, this is only reason why I receive next exception:
+ "com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException:
+ Unrecognized field "title" (class com.asyncapi.v2._6_0.model.Reference),
+ not marked as ignorable (one known property: "$ref"])"
+ in case when Schema contains $ref.
+ Solution:
+ Try to deserialize reference. In case of exception, try to deserialize it as given ObjectType. In case of
+ one more exception, throw it.
+ TODO: Think how to improve.
+ */
+ try {
+ return chooseKnownPojo(node, objectCodec);
+ } catch (UnrecognizedPropertyException unrecognizedPropertyException) {
+ return readAsObject(node, objectCodec);
+ }
+ }
+
+ private Object chooseKnownPojo(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ JsonNode ref = jsonNode.get("$ref");
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ if (ref != null) {
+ return jsonParser.readValueAs(referenceClass());
+ } else {
+ return jsonParser.readValueAs(objectTypeClass());
+ }
+ }
+ }
+
+ private Object readAsObject(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ return jsonParser.readValueAs(objectTypeClass());
+ }
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/SchemaItemsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/SchemaItemsDeserializer.java
new file mode 100644
index 00000000..c2186164
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/SchemaItemsDeserializer.java
@@ -0,0 +1,51 @@
+package com.asyncapi.v3.jackson;
+
+import com.asyncapi.v3.schema.Schema;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.node.ArrayNode;
+import com.fasterxml.jackson.databind.node.JsonNodeType;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+public class SchemaItemsDeserializer extends JsonDeserializer {
+
+ @Override
+ public Object deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException {
+ ObjectCodec objectCodec = jsonParser.getCodec();
+ JsonNode node = objectCodec.readTree(jsonParser);
+ JsonNodeType nodeType = node.getNodeType();
+ if (nodeType == JsonNodeType.OBJECT) {
+ return readAsSchema(node, objectCodec);
+ }
+ if (nodeType == JsonNodeType.ARRAY) {
+ return readAsListOfSchemas((ArrayNode) node, objectCodec);
+ }
+ return readAsObject(node, objectCodec);
+ }
+
+ private List readAsListOfSchemas(ArrayNode arrayNode, ObjectCodec objectCodec) throws IOException {
+ List schemaList = new ArrayList<>();
+ for (JsonNode childNode : arrayNode) {
+ schemaList.add(readAsSchema(childNode, objectCodec));
+ }
+ return schemaList;
+ }
+
+ private Schema readAsSchema(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser parser = jsonNode.traverse(objectCodec)) {
+ return parser.readValueAs(Schema.class);
+ }
+ }
+
+ private Object readAsObject(JsonNode jsonNode, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ return jsonParser.readValueAs(Object.class);
+ }
+ }
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/binding/channel/ChannelBindingsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/binding/channel/ChannelBindingsDeserializer.java
new file mode 100644
index 00000000..38ffac56
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/binding/channel/ChannelBindingsDeserializer.java
@@ -0,0 +1,68 @@
+package com.asyncapi.v3.jackson.binding.channel;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3.binding.channel.amqp.AMQPChannelBinding;
+import com.asyncapi.v3.binding.channel.amqp1.AMQP1ChannelBinding;
+import com.asyncapi.v3.binding.channel.anypointmq.AnypointMQChannelBinding;
+import com.asyncapi.v3.binding.channel.googlepubsub.GooglePubSubChannelBinding;
+import com.asyncapi.v3.binding.channel.http.HTTPChannelBinding;
+import com.asyncapi.v3.binding.channel.ibmmq.IBMMQChannelBinding;
+import com.asyncapi.v3.binding.channel.jms.JMSChannelBinding;
+import com.asyncapi.v3.binding.channel.kafka.KafkaChannelBinding;
+import com.asyncapi.v3.binding.channel.mercure.MercureChannelBinding;
+import com.asyncapi.v3.binding.channel.mqtt.MQTTChannelBinding;
+import com.asyncapi.v3.binding.channel.mqtt5.MQTT5ChannelBinding;
+import com.asyncapi.v3.binding.channel.nats.NATSChannelBinding;
+import com.asyncapi.v3.binding.channel.pulsar.PulsarChannelBinding;
+import com.asyncapi.v3.binding.channel.redis.RedisChannelBinding;
+import com.asyncapi.v3.binding.channel.sns.SNSChannelBinding;
+import com.asyncapi.v3.binding.channel.solace.SolaceChannelBinding;
+import com.asyncapi.v3.binding.channel.sqs.SQSChannelBinding;
+import com.asyncapi.v3.binding.channel.stomp.STOMPChannelBinding;
+import com.asyncapi.v3.binding.channel.ws.WebSocketsChannelBinding;
+import com.asyncapi.v3.jackson.BindingsMapDeserializer;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.JsonNode;
+
+import java.io.IOException;
+
+/**
+ * Serializes channel bindings map.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class ChannelBindingsDeserializer extends BindingsMapDeserializer {
+
+ public Object chooseKnownPojo(String bindingKey, JsonNode binding, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser jsonParser = binding.traverse(objectCodec)) {
+ if (binding.get("$ref" ) != null) {
+ return jsonParser.readValueAs(Reference.class);
+ }
+
+ switch (bindingKey) {
+ case "amqp": return jsonParser.readValueAs(AMQPChannelBinding.class);
+ case "amqp1": return jsonParser.readValueAs(AMQP1ChannelBinding.class);
+ case "anypointmq": return jsonParser.readValueAs(AnypointMQChannelBinding.class);
+ case "googlepubsub": return jsonParser.readValueAs(GooglePubSubChannelBinding.class);
+ case "http": return jsonParser.readValueAs(HTTPChannelBinding.class);
+ case "ibmmq": return jsonParser.readValueAs(IBMMQChannelBinding.class);
+ case "jms": return jsonParser.readValueAs(JMSChannelBinding.class);
+ case "kafka": return jsonParser.readValueAs(KafkaChannelBinding.class);
+ case "mercure": return jsonParser.readValueAs(MercureChannelBinding.class);
+ case "mqtt": return jsonParser.readValueAs(MQTTChannelBinding.class);
+ case "mqtt5": return jsonParser.readValueAs(MQTT5ChannelBinding.class);
+ case "nats": return jsonParser.readValueAs(NATSChannelBinding.class);
+ case "pulsar": return jsonParser.readValueAs(PulsarChannelBinding.class);
+ case "redis": return jsonParser.readValueAs(RedisChannelBinding.class);
+ case "sns": return jsonParser.readValueAs(SNSChannelBinding.class);
+ case "solace": return jsonParser.readValueAs(SolaceChannelBinding.class);
+ case "sqs": return jsonParser.readValueAs(SQSChannelBinding.class);
+ case "stomp": return jsonParser.readValueAs(STOMPChannelBinding.class);
+ case "ws": return jsonParser.readValueAs(WebSocketsChannelBinding.class);
+ default: return null;
+ }
+ }
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/binding/message/MessageBindingsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/binding/message/MessageBindingsDeserializer.java
new file mode 100644
index 00000000..a40a2fe1
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/binding/message/MessageBindingsDeserializer.java
@@ -0,0 +1,68 @@
+package com.asyncapi.v3.jackson.binding.message;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3.binding.message.amqp.AMQPMessageBinding;
+import com.asyncapi.v3.binding.message.amqp1.AMQP1MessageBinding;
+import com.asyncapi.v3.binding.message.anypointmq.AnypointMQMessageBinding;
+import com.asyncapi.v3.binding.message.googlepubsub.GooglePubSubMessageBinding;
+import com.asyncapi.v3.binding.message.http.HTTPMessageBinding;
+import com.asyncapi.v3.binding.message.ibmmq.IBMMQMessageBinding;
+import com.asyncapi.v3.binding.message.jms.JMSMessageBinding;
+import com.asyncapi.v3.binding.message.kafka.KafkaMessageBinding;
+import com.asyncapi.v3.binding.message.mercure.MercureMessageBinding;
+import com.asyncapi.v3.binding.message.mqtt.MQTTMessageBinding;
+import com.asyncapi.v3.binding.message.mqtt5.MQTT5MessageBinding;
+import com.asyncapi.v3.binding.message.nats.NATSMessageBinding;
+import com.asyncapi.v3.binding.message.pulsar.PulsarMessageBinding;
+import com.asyncapi.v3.binding.message.redis.RedisMessageBinding;
+import com.asyncapi.v3.binding.message.sns.SNSMessageBinding;
+import com.asyncapi.v3.binding.message.solace.SolaceMessageBinding;
+import com.asyncapi.v3.binding.message.sqs.SQSMessageBinding;
+import com.asyncapi.v3.binding.message.stomp.STOMPMessageBinding;
+import com.asyncapi.v3.binding.message.ws.WebSocketsMessageBinding;
+import com.asyncapi.v3.jackson.BindingsMapDeserializer;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.JsonNode;
+
+import java.io.IOException;
+
+/**
+ * Serializes message bindings map.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class MessageBindingsDeserializer extends BindingsMapDeserializer {
+
+ public Object chooseKnownPojo(String bindingKey, JsonNode binding, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser jsonParser = binding.traverse(objectCodec)) {
+ if (binding.get("$ref" ) != null) {
+ return jsonParser.readValueAs(Reference.class);
+ }
+
+ switch (bindingKey) {
+ case "amqp": return jsonParser.readValueAs(AMQPMessageBinding.class);
+ case "amqp1": return jsonParser.readValueAs(AMQP1MessageBinding.class);
+ case "anypointmq": return jsonParser.readValueAs(AnypointMQMessageBinding.class);
+ case "googlepubsub": return jsonParser.readValueAs(GooglePubSubMessageBinding.class);
+ case "http": return jsonParser.readValueAs(HTTPMessageBinding.class);
+ case "ibmmq": return jsonParser.readValueAs(IBMMQMessageBinding.class);
+ case "jms": return jsonParser.readValueAs(JMSMessageBinding.class);
+ case "kafka": return jsonParser.readValueAs(KafkaMessageBinding.class);
+ case "mercure": return jsonParser.readValueAs(MercureMessageBinding.class);
+ case "mqtt": return jsonParser.readValueAs(MQTTMessageBinding.class);
+ case "mqtt5": return jsonParser.readValueAs(MQTT5MessageBinding.class);
+ case "nats": return jsonParser.readValueAs(NATSMessageBinding.class);
+ case "pulsar": return jsonParser.readValueAs(PulsarMessageBinding.class);
+ case "redis": return jsonParser.readValueAs(RedisMessageBinding.class);
+ case "sns": return jsonParser.readValueAs(SNSMessageBinding.class);
+ case "solace": return jsonParser.readValueAs(SolaceMessageBinding.class);
+ case "sqs": return jsonParser.readValueAs(SQSMessageBinding.class);
+ case "stomp": return jsonParser.readValueAs(STOMPMessageBinding.class);
+ case "ws": return jsonParser.readValueAs(WebSocketsMessageBinding.class);
+ default: return null;
+ }
+ }
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/binding/operation/OperationBindingsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/binding/operation/OperationBindingsDeserializer.java
new file mode 100644
index 00000000..0b4b86e1
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/binding/operation/OperationBindingsDeserializer.java
@@ -0,0 +1,69 @@
+package com.asyncapi.v3.jackson.binding.operation;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3.binding.operation.amqp.AMQPOperationBinding;
+import com.asyncapi.v3.binding.operation.amqp1.AMQP1OperationBinding;
+import com.asyncapi.v3.binding.operation.anypointmq.AnypointMQOperationBinding;
+import com.asyncapi.v3.binding.operation.googlepubsub.GooglePubSubOperationBinding;
+import com.asyncapi.v3.binding.operation.http.HTTPOperationBinding;
+import com.asyncapi.v3.binding.operation.ibmmq.IBMMQOperationBinding;
+import com.asyncapi.v3.binding.operation.jms.JMSOperationBinding;
+import com.asyncapi.v3.binding.operation.kafka.KafkaOperationBinding;
+import com.asyncapi.v3.binding.operation.mercure.MercureOperationBinding;
+import com.asyncapi.v3.binding.operation.mqtt.MQTTOperationBinding;
+import com.asyncapi.v3.binding.operation.mqtt5.MQTT5OperationBinding;
+import com.asyncapi.v3.binding.operation.nats.NATSOperationBinding;
+import com.asyncapi.v3.binding.operation.pulsar.PulsarOperationBinding;
+import com.asyncapi.v3.binding.operation.redis.RedisOperationBinding;
+import com.asyncapi.v3.binding.operation.sns.SNSOperationBinding;
+import com.asyncapi.v3.binding.operation.solace.SolaceOperationBinding;
+import com.asyncapi.v3.binding.operation.sqs.SQSOperationBinding;
+import com.asyncapi.v3.binding.operation.stomp.STOMPOperationBinding;
+import com.asyncapi.v3.binding.operation.ws.WebSocketsOperationBinding;
+import com.asyncapi.v3.jackson.BindingsMapDeserializer;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.JsonNode;
+
+import java.io.IOException;
+
+/**
+ * Serializes operation bindings map.
+ *
+ * @version 3.0.0
+ * @author Pavel Bodiachevskii
+ */
+public class OperationBindingsDeserializer extends BindingsMapDeserializer {
+
+ public Object chooseKnownPojo(String bindingKey, JsonNode binding, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser jsonParser = binding.traverse(objectCodec)) {
+ if (binding.get("$ref" ) != null) {
+ return jsonParser.readValueAs(Reference.class);
+ }
+
+ switch (bindingKey) {
+ case "amqp": return jsonParser.readValueAs(AMQPOperationBinding.class);
+ case "amqp1": return jsonParser.readValueAs(AMQP1OperationBinding.class);
+ case "anypointmq": return jsonParser.readValueAs(AnypointMQOperationBinding.class);
+ case "googlepubsub": return jsonParser.readValueAs(GooglePubSubOperationBinding.class);
+ case "http": return jsonParser.readValueAs(HTTPOperationBinding.class);
+ case "ibmmq": return jsonParser.readValueAs(IBMMQOperationBinding.class);
+ case "jms": return jsonParser.readValueAs(JMSOperationBinding.class);
+ case "kafka": return jsonParser.readValueAs(KafkaOperationBinding.class);
+ case "mercure": return jsonParser.readValueAs(MercureOperationBinding.class);
+ case "mqtt": return jsonParser.readValueAs(MQTTOperationBinding.class);
+ case "mqtt5": return jsonParser.readValueAs(MQTT5OperationBinding.class);
+ case "nats": return jsonParser.readValueAs(NATSOperationBinding.class);
+ case "pulsar": return jsonParser.readValueAs(PulsarOperationBinding.class);
+ case "redis": return jsonParser.readValueAs(RedisOperationBinding.class);
+ case "sns": return jsonParser.readValueAs(SNSOperationBinding.class);
+ case "solace": return jsonParser.readValueAs(SolaceOperationBinding.class);
+ case "sqs": return jsonParser.readValueAs(SQSOperationBinding.class);
+ case "stomp": return jsonParser.readValueAs(STOMPOperationBinding.class);
+ case "ws": return jsonParser.readValueAs(WebSocketsOperationBinding.class);
+ default: return null;
+ }
+ }
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/binding/server/ServerBindingsDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/binding/server/ServerBindingsDeserializer.java
new file mode 100644
index 00000000..c6cfbe04
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/binding/server/ServerBindingsDeserializer.java
@@ -0,0 +1,70 @@
+package com.asyncapi.v3.jackson.binding.server;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3.binding.server.amqp.AMQPServerBinding;
+import com.asyncapi.v3.binding.server.amqp1.AMQP1ServerBinding;
+import com.asyncapi.v3.binding.server.anypointmq.AnypointMQServerBinding;
+import com.asyncapi.v3.binding.server.googlepubsub.GooglePubSubServerBinding;
+import com.asyncapi.v3.binding.server.http.HTTPServerBinding;
+import com.asyncapi.v3.binding.server.ibmmq.IBMMQServerBinding;
+import com.asyncapi.v3.binding.server.jms.JMSServerBinding;
+import com.asyncapi.v3.binding.server.kafka.KafkaServerBinding;
+import com.asyncapi.v3.binding.server.mercure.MercureServerBinding;
+import com.asyncapi.v3.binding.server.mqtt.MQTTServerBinding;
+import com.asyncapi.v3.binding.server.mqtt5.MQTT5ServerBinding;
+import com.asyncapi.v3.binding.server.nats.NATSServerBinding;
+import com.asyncapi.v3.binding.server.pulsar.PulsarServerBinding;
+import com.asyncapi.v3.binding.server.redis.RedisServerBinding;
+import com.asyncapi.v3.binding.server.sns.SNSServerBinding;
+import com.asyncapi.v3.binding.server.solace.SolaceServerBinding;
+import com.asyncapi.v3.binding.server.sqs.SQSServerBinding;
+import com.asyncapi.v3.binding.server.stomp.STOMPServerBinding;
+import com.asyncapi.v3.binding.server.ws.WebSocketsServerBinding;
+import com.asyncapi.v3.jackson.BindingsMapDeserializer;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.JsonNode;
+
+import java.io.IOException;
+
+/**
+ * Serializes server bindings map.
+ *
+ * @version 3.0.0
+ * @author Pavel Bodiachevskii
+ */
+public class ServerBindingsDeserializer extends BindingsMapDeserializer {
+
+ @Override
+ public Object chooseKnownPojo(String bindingKey, JsonNode binding, ObjectCodec objectCodec) throws IOException {
+ try (JsonParser jsonParser = binding.traverse(objectCodec)) {
+ if (binding.get("$ref" ) != null) {
+ return jsonParser.readValueAs(Reference.class);
+ }
+
+ switch (bindingKey) {
+ case "amqp": return jsonParser.readValueAs(AMQPServerBinding.class);
+ case "amqp1": return jsonParser.readValueAs(AMQP1ServerBinding.class);
+ case "anypointmq": return jsonParser.readValueAs(AnypointMQServerBinding.class);
+ case "googlepubsub": return jsonParser.readValueAs(GooglePubSubServerBinding.class);
+ case "http": return jsonParser.readValueAs(HTTPServerBinding.class);
+ case "ibmmq": return jsonParser.readValueAs(IBMMQServerBinding.class);
+ case "jms": return jsonParser.readValueAs(JMSServerBinding.class);
+ case "kafka": return jsonParser.readValueAs(KafkaServerBinding.class);
+ case "mercure": return jsonParser.readValueAs(MercureServerBinding.class);
+ case "mqtt": return jsonParser.readValueAs(MQTTServerBinding.class);
+ case "mqtt5": return jsonParser.readValueAs(MQTT5ServerBinding.class);
+ case "nats": return jsonParser.readValueAs(NATSServerBinding.class);
+ case "pulsar": return jsonParser.readValueAs(PulsarServerBinding.class);
+ case "redis": return jsonParser.readValueAs(RedisServerBinding.class);
+ case "sns": return jsonParser.readValueAs(SNSServerBinding.class);
+ case "solace": return jsonParser.readValueAs(SolaceServerBinding.class);
+ case "sqs": return jsonParser.readValueAs(SQSServerBinding.class);
+ case "stomp": return jsonParser.readValueAs(STOMPServerBinding.class);
+ case "ws": return jsonParser.readValueAs(WebSocketsServerBinding.class);
+ default: return null;
+ }
+ }
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/SchemasAdditionalPropertiesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/SchemasAdditionalPropertiesDeserializer.java
new file mode 100644
index 00000000..659d70fe
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/schema/SchemasAdditionalPropertiesDeserializer.java
@@ -0,0 +1,36 @@
+package com.asyncapi.v3.jackson.schema;
+
+import com.asyncapi.v3.schema.Schema;
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.core.ObjectCodec;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+
+import java.io.IOException;
+
+/**
+ * @author Guillaume LAMIRAND (guillaume.lamirand at graviteesource.com)
+ * @author GraviteeSource Team
+ */
+public class SchemasAdditionalPropertiesDeserializer extends JsonDeserializer {
+
+ @Override
+ public Object deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JsonProcessingException {
+ ObjectCodec objectCodec = p.getCodec();
+ JsonNode node = objectCodec.readTree(p);
+
+ return chooseKnownPojo(node, objectCodec);
+ }
+
+ private Object chooseKnownPojo(JsonNode jsonNode, final ObjectCodec objectCodec) throws IOException {
+ try (JsonParser jsonParser = jsonNode.traverse(objectCodec)) {
+ if (jsonNode.isBoolean()) {
+ return jsonNode.asBoolean();
+ } else {
+ return jsonParser.readValueAs(Schema.class);
+ }
+ }
+ }
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/security_scheme/SecuritySchemesDeserializer.java b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/security_scheme/SecuritySchemesDeserializer.java
new file mode 100644
index 00000000..93a1429b
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/jackson/security_scheme/SecuritySchemesDeserializer.java
@@ -0,0 +1,24 @@
+package com.asyncapi.v3.jackson.security_scheme;
+
+import com.asyncapi.v3.Reference;
+import com.asyncapi.v3.jackson.ListOfReferencesOrObjectsDeserializer;
+import com.asyncapi.v3.security_scheme.SecurityScheme;
+
+/**
+ * Deserializes security schemes.
+ *
+ * @author Pavel Bodiachevskii
+ */
+public class SecuritySchemesDeserializer extends ListOfReferencesOrObjectsDeserializer {
+
+ @Override
+ public Class objectTypeClass() {
+ return SecurityScheme.class;
+ }
+
+ @Override
+ public Class referenceClass() {
+ return Reference.class;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/MultiFormatSchema.java b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/MultiFormatSchema.java
new file mode 100644
index 00000000..62dc3d8a
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/MultiFormatSchema.java
@@ -0,0 +1,66 @@
+package com.asyncapi.v3.schema;
+
+import com.asyncapi.v3.ExtendableObject;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * The Multi Format Schema Object represents a schema definition. It differs from the {@link Schema} in that it supports
+ * multiple schema formats or languages (e.g., JSON Schema, Avro, etc.).
+ *
+ * @see Multi Format Schema
+ * @see Schema
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class MultiFormatSchema extends ExtendableObject {
+
+ /**
+ * Required .
+ *
+ * A string containing the name of the schema format that is used to define the information.
+ *
+ * If schemaFormat is missing, it MUST default to application/vnd.aai.asyncapi+json;version={{asyncapi}}
+ * where {{asyncapi}} matches the {@link com.asyncapi.v3._0_0.model.AsyncAPI#getAsyncapi()} version string.
+ *
+ * In such a case, this would make the Multi Format Schema Object equivalent to the {@link Schema}.
+ *
+ * When using {@link com.asyncapi.v3.Reference} within the {@link #getSchema()}, the schemaFormat of the resource being referenced MUST match
+ * the schemaFormat of the {@link #getSchema()} that contains the initial reference.
+ *
+ * For example, if you reference Avro schema, then schemaFormat of referencing resource and the resource being reference MUST match.
+ *
+ *
+ * Check out the supported schema formats table for more information.
+ * Custom values are allowed but their implementation is OPTIONAL.
+ * A custom value MUST NOT refer to one of the schema formats listed in the table.
+ *
+ *
+ * When using {@link com.asyncapi.v3.Reference} within the {@link #getSchema()}, the schemaFormat of the referenced resource MUST
+ * match the schemaFormat of the schema containing the reference.
+ *
+ * @see Schema formats table
+ */
+ @NotNull
+ private String schemaFormat;
+
+ /**
+ * Required .
+ *
+ * Definition of the message payload.
+ *
+ * It can be of any type but defaults to {@link Schema}.
+ *
+ * It MUST match the schema format defined in {@link #getSchemaFormat()}, including the encoding type. E.g., Avro should be
+ * inlined as either a YAML or JSON object instead of as a string to be parsed as YAML or JSON. Non-JSON-based
+ * schemas (e.g., Protobuf or XSD) MUST be inlined as a string.
+ */
+ @NotNull
+ private Object schema;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/Schema.java b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/Schema.java
new file mode 100644
index 00000000..f71302ac
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/Schema.java
@@ -0,0 +1,692 @@
+package com.asyncapi.v3.schema;
+
+import com.asyncapi.v3.jackson.SchemaItemsDeserializer;
+import com.asyncapi.v3.ExtendableObject;
+import com.asyncapi.v3.jackson.schema.SchemasAdditionalPropertiesDeserializer;
+import com.asyncapi.v3._0_0.model.ExternalDocumentation;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+import java.math.BigDecimal;
+import java.util.List;
+import java.util.Map;
+
+// TODO: Finish. Not all properties are present.
+// TODO: Write tests
+
+/**
+ * The Schema Object allows the definition of input and output data types. These types can be objects,
+ * but also primitives and arrays. This object is a superset of the JSON Schema Specification Draft 07 .
+ * JSON Schema Core and JSON Schema Validation .
+ * Unless stated otherwise, the property definitions follow the JSON Schema specification as referenced here.
+ * New properties may appear in this class after community requests.
+ *
+ * @see AnyncAPI Schema Object
+ * @author Pavel Bodiachevskii
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class Schema extends ExtendableObject {
+
+ /*
+ Schema Annotations
+
+ Schema validation is a useful mechanism for annotating instance data
+ with additional information. The rules for determining when and how
+ annotations are associated with an instance are outlined in section
+ 3.3.
+
+ These general-purpose annotation keywords provide commonly used
+ information for documentation and user interface display purposes.
+ They are not intended to form a comprehensive set of features.
+ Rather, additional vocabularies can be defined for more complex
+ annotation-based applications.
+ */
+
+ /**
+ * The value of these keyword MUST be a string.
+ * This property definition was adjusted to the AsyncAPI Specification.
+ * CommonMark syntax can be used for rich text representation.
+ * This property definition was adjusted to the AsyncAPI Specification.
+ * The default value represents what would be assumed by the consumer of the input as the value of the schema if one
+ * is not provided. Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object defined at
+ * the same level. For example, of type is string, then default can be "foo" but cannot be 1.
+ */
+ @Nullable
+ @JsonProperty("default")
+ public Object defaultValue;
+
+ /**
+ * The value of this keyword MUST be a boolean. When multiple occurrences of this keyword are applicable to a
+ * single sub-instance, the resulting value MUST be true if any occurrence specifies a true value, and MUST be false otherwise.
+ * examples;
+
+ @Nullable
+ @JsonProperty("$ref")
+ private String ref;
+
+ /*
+ String-Encoding Non-JSON Data
+
+ Foreword
+
+ Properties defined in this section indicate that an instance contains
+ non-JSON data encoded in a JSON string. They describe the type of
+ content and how it is encoded.
+
+ These properties provide additional information required to interpret
+ JSON data as rich multimedia documents.
+
+ Implementation Requirements
+
+ The content keywords function as both annotations (Section 3.3) and
+ as assertions (Section 3.2). While no special effort is required to
+ implement them as annotations conveying how applications can
+ interpret the data in the string, implementing validation of
+ conformance to the media type and encoding is non-trivial.
+
+ Implementations MAY support the "contentMediaType" and
+ "contentEncoding" keywords as validation assertions. Should they
+ choose to do so, they SHOULD offer an option to disable validation
+ for these keywords.
+ */
+
+ /**
+ * If the instance value is a string, this property defines that the string SHOULD be interpreted as binary data and
+ * decoded using the encoding named by this property. RFC 2045 , Sec 6.1 [RFC2045 ] lists the possible values for this property.
+ * RFC 2046 [RFC2046 ]. This property defines the media
+ * type of instances which this schema defines.
+ * enumValue;
+
+ /**
+ * The value of this keyword MAY be of any type, including null.
+ * RFC 7159 [RFC7159 ].
+ */
+ @Nullable
+ @JsonProperty
+ public Integer maxLength;
+
+ /**
+ * The value of this keyword MUST be a non-negative integer.
+ * RFC 7159 [RFC7159 ].
+ * required;
+
+ /**
+ * The value of "properties" MUST be an object. Each value of this object MUST be a valid JSON Schema.
+ * properties;
+
+ /**
+ * The value of "patternProperties" MUST be an object. Each property name of this object SHOULD be a valid regular
+ * expression, according to the ECMA 262 regular expression dialect. Each property value of this object MUST be a
+ * valid JSON Schema.
+ * patternProperties;
+
+ /**
+ * The value of "additionalProperties" MUST be a valid JSON Schema.
+ * Section 3.3 ) are being collected, they are collected from this keyword's subschema in the usual way,
+ * including when the keyword is present without either "then" or "else".
+ */
+ @JsonProperty("if")
+ @Nullable
+ public Schema ifValue;
+
+ /**
+ * This keyword's value MUST be a valid JSON Schema.
+ * allOf;
+
+ /**
+ * This keyword's value MUST be a non-empty array. Each item of the array MUST be a valid JSON Schema.
+ * anyOf;
+
+ /**
+ * This keyword's value MUST be a non-empty array. Each item of the array MUST be a valid JSON Schema.
+ * oneOf;
+
+ /**
+ * This keyword's value MUST be a valid JSON Schema.
+ * Data Type Formats for further details.
+ * While relying on JSON Schema's defined formats, the AsyncAPI Specification offers a few additional predefined formats.
+ */
+ @Nullable
+ @JsonProperty
+ public Object format;
+
+ /*
+ In addition to the JSON Schema fields, the following AsyncAPI vocabulary fields MAY be used for further schema documentation:
+ */
+ /**
+ * Adds support for polymorphism. The discriminator is the schema property name that is used to differentiate between
+ * other schema that inherit this schema.
+ * required property list.
+ * When used, the value MUST be the name of this schema or any schema that inherits it. See Composition and Inheritance for more details .
+ */
+ @Nullable
+ @JsonProperty
+ public String discriminator;
+ /**
+ * Additional external documentation for this schema.
+ */
+ @Nullable
+ @JsonProperty
+ public ExternalDocumentation externalDocs;
+
+ /**
+ * Specifies that a schema is deprecated and SHOULD be transitioned out of usage. Default value is false.
+ */
+ @Nullable
+ @JsonProperty
+ public Boolean deprecated;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/schema/Type.java b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/Type.java
new file mode 100644
index 00000000..957e6b30
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/schema/Type.java
@@ -0,0 +1,16 @@
+package com.asyncapi.v3.schema;
+
+/**
+ * @author Pavel Bodiachevskii
+ */
+public class Type {
+
+ public final static String NULL = "null";
+ public final static String BOOLEAN = "boolean";
+ public final static String OBJECT = "object";
+ public final static String ARRAY = "array";
+ public final static String NUMBER = "number";
+ public final static String STRING = "string";
+ public final static String INTEGER = "integer";
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/ApiKeySecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/ApiKeySecurityScheme.java
new file mode 100644
index 00000000..8b0b92bc
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/ApiKeySecurityScheme.java
@@ -0,0 +1,45 @@
+package com.asyncapi.v3.security_scheme;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * API Key Security Scheme
+ *
+ * @see SecurityScheme
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class ApiKeySecurityScheme extends SecurityScheme {
+
+ /**
+ * REQUIRED .
+ *
+ * The location of the API key.
+ */
+ @NotNull
+ private ApiKeyLocation in = ApiKeyLocation.USER;
+
+ @Builder(builderMethodName = "apiKeyBuilder")
+ public ApiKeySecurityScheme(@Nullable String description,
+ @NotNull ApiKeyLocation in) {
+ super(Type.API_KEY, description);
+ this.in = in;
+ }
+
+ public enum ApiKeyLocation {
+
+ @JsonProperty("user")
+ USER,
+ @JsonProperty("password")
+ PASSWORD
+
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/OpenIdConnectSecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/OpenIdConnectSecurityScheme.java
new file mode 100644
index 00000000..2ef45095
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/OpenIdConnectSecurityScheme.java
@@ -0,0 +1,45 @@
+package com.asyncapi.v3.security_scheme;
+
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * OpenID Connect Security Scheme
+ *
+ * @see SecurityScheme
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class OpenIdConnectSecurityScheme extends SecurityScheme {
+
+ /**
+ * REQUIRED .
+ *
+ * OpenId Connect URL to discover OAuth2 configuration values. This MUST be in the form of an absolute URL.
+ */
+ @NotNull
+ private String openIdConnectUrl = "";
+
+ /**
+ * List of the needed scope names. An empty array means no scopes are needed.
+ */
+ @Nullable
+ private List scopes;
+
+ @Builder(builderMethodName = "openIdBuilder")
+ public OpenIdConnectSecurityScheme(@Nullable String description,
+ @NotNull String openIdConnectUrl,
+ @Nullable List scopes) {
+ super(Type.OPENID_CONNECT, description);
+ this.openIdConnectUrl = openIdConnectUrl;
+ this.scopes = scopes;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/SecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/SecurityScheme.java
new file mode 100644
index 00000000..ce6a57a3
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/SecurityScheme.java
@@ -0,0 +1,120 @@
+package com.asyncapi.v3.security_scheme;
+
+import com.asyncapi.v3.ExtendableObject;
+import com.asyncapi.v3.security_scheme.http.HttpApiKeySecurityScheme;
+import com.asyncapi.v3.security_scheme.http.HttpSecurityScheme;
+import com.asyncapi.v3.security_scheme.oauth2.OAuth2SecurityScheme;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.fasterxml.jackson.annotation.JsonSubTypes;
+import com.fasterxml.jackson.annotation.JsonTypeInfo;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Defines a security scheme that can be used by the operations. Supported schemes are:
+ *
+ * User/Password.
+ * API key (either as user or as password).
+ * X.509 certificate.
+ * End-to-end encryption (either symmetric or asymmetric).
+ * HTTP authentication.
+ * HTTP API key.
+ * OAuth2’s common flows (Implicit, Resource Owner Protected Credentials, Client Credentials and Authorization Code) as defined in RFC6749 .
+ * OpenID Connect Discovery. SASL (Simple Authentication and Security Layer) as defined in RFC4422 .
+ *
+ *
+ * This object MAY be extended with {@link ExtendableObject}.
+ *
+ * @see Specification Extensions
+ * @see Security Scheme
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@JsonTypeInfo(
+ use = JsonTypeInfo.Id.NAME,
+ include = JsonTypeInfo.As.EXISTING_PROPERTY,
+ property = "type",
+ visible = true
+)
+@JsonSubTypes({
+ @JsonSubTypes.Type(value = SecurityScheme.class, name = "userPassword"),
+ @JsonSubTypes.Type(value = ApiKeySecurityScheme.class, name = "apiKey"),
+ @JsonSubTypes.Type(value = SecurityScheme.class, name = "X509"),
+ @JsonSubTypes.Type(value = SecurityScheme.class, name = "symmetricEncryption"),
+ @JsonSubTypes.Type(value = SecurityScheme.class, name = "asymmetricEncryption"),
+ @JsonSubTypes.Type(value = HttpApiKeySecurityScheme.class, name = "httpApiKey"),
+ @JsonSubTypes.Type(value = HttpSecurityScheme.class, name = "http"),
+ @JsonSubTypes.Type(value = OAuth2SecurityScheme.class, name = "oauth2"),
+ @JsonSubTypes.Type(value = OpenIdConnectSecurityScheme.class, name = "openIdConnect"),
+ @JsonSubTypes.Type(value = SecurityScheme.class, name = "plain"),
+ @JsonSubTypes.Type(value = SecurityScheme.class, name = "scramSha256"),
+ @JsonSubTypes.Type(value = SecurityScheme.class, name = "scramSha512"),
+ @JsonSubTypes.Type(value = SecurityScheme.class, name = "gssapi"),
+})
+@EqualsAndHashCode(callSuper = true)
+public class SecurityScheme extends ExtendableObject {
+
+ /**
+ * REQUIRED .
+ *
+ * The type of the security scheme. Valid values are:
+ *
+ * userPassword
+ * apiKey
+ * X509
+ * symmetricEncryption
+ * asymmetricEncryption
+ * httpApiKey
+ * http
+ * oauth2
+ * openIdConnect
+ *
+ */
+ @NotNull
+ @Builder.Default
+ private Type type = Type.USER_PASSWORD;
+
+ /**
+ * A short description for security scheme. CommonMark syntax MAY be used for rich text representation.
+ */
+ @Nullable
+ private String description;
+
+ public enum Type {
+
+ @JsonProperty("userPassword")
+ USER_PASSWORD,
+ @JsonProperty("apiKey")
+ API_KEY,
+ @JsonProperty("X509")
+ X509,
+ @JsonProperty("symmetricEncryption")
+ SYMMETRIC_ENCRYPTION,
+ @JsonProperty("asymmetricEncryption")
+ ASYMMETRIC_ENCRYPTION,
+ @JsonProperty("httpApiKey")
+ HTTP_API_KEY,
+ @JsonProperty("http")
+ HTTP,
+ @JsonProperty("oauth2")
+ OAUTH2,
+ @JsonProperty("openIdConnect")
+ OPENID_CONNECT,
+ @JsonProperty("plain")
+ PLAIN,
+ @JsonProperty("scramSha256")
+ SCRAM_SHA256,
+ @JsonProperty("scramSha512")
+ SCRAM_SHA512,
+ @JsonProperty("gssapi")
+ GSSAPI
+
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/http/HttpApiKeySecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/http/HttpApiKeySecurityScheme.java
new file mode 100644
index 00000000..4965be62
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/http/HttpApiKeySecurityScheme.java
@@ -0,0 +1,58 @@
+package com.asyncapi.v3.security_scheme.http;
+
+import com.asyncapi.v3.security_scheme.SecurityScheme;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * HTTP API Key Security Scheme
+ *
+ * @see SecurityScheme
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class HttpApiKeySecurityScheme extends SecurityScheme {
+
+ /**
+ * REQUIRED .
+ *
+ * The name of the header, query or cookie parameter to be used.
+ */
+ @NotNull
+ private String name = "";
+
+ /**
+ * REQUIRED .
+ *
+ * The location of the API key.
+ */
+ @Nullable
+ private ApiKeyLocation in;
+
+ @Builder(builderMethodName = "httpApiKeyBuilder")
+ public HttpApiKeySecurityScheme(@Nullable String description,
+ @NotNull String name,
+ @Nullable ApiKeyLocation in) {
+ super(Type.HTTP_API_KEY, description);
+ this.name = name;
+ this.in = in;
+ }
+
+ public enum ApiKeyLocation {
+
+ @JsonProperty("query")
+ QUERY,
+ @JsonProperty("header")
+ HEADER,
+ @JsonProperty("cookie")
+ COOKIE
+
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/http/HttpSecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/http/HttpSecurityScheme.java
new file mode 100644
index 00000000..efb0acaf
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/http/HttpSecurityScheme.java
@@ -0,0 +1,45 @@
+package com.asyncapi.v3.security_scheme.http;
+
+import com.asyncapi.v3.security_scheme.SecurityScheme;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * HTTP Security Scheme
+ *
+ * @see SecurityScheme
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class HttpSecurityScheme extends SecurityScheme {
+
+ /**
+ * REQUIRED .
+ *
+ * The name of the HTTP Authorization scheme to be used in the Authorization header as defined in RFC7235 .
+ */
+ @NotNull
+ private String scheme = "";
+
+ /**
+ * A hint to the client to identify how the bearer token is formatted. Bearer tokens are usually generated
+ * by an authorization server, so this information is primarily for documentation purposes.
+ */
+ @Nullable
+ private String bearerFormat;
+
+ @Builder(builderMethodName = "httpBuilder")
+ public HttpSecurityScheme(@Nullable String description,
+ @NotNull String scheme,
+ @Nullable String bearerFormat) {
+ super(Type.HTTP, description);
+ this.scheme = scheme;
+ this.bearerFormat = bearerFormat;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/OAuth2SecurityScheme.java b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/OAuth2SecurityScheme.java
new file mode 100644
index 00000000..0e3d6224
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/OAuth2SecurityScheme.java
@@ -0,0 +1,46 @@
+package com.asyncapi.v3.security_scheme.oauth2;
+
+import com.asyncapi.v3.security_scheme.SecurityScheme;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+
+/**
+ * OAuth2 Security Scheme
+ *
+ * @see SecurityScheme
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class OAuth2SecurityScheme extends SecurityScheme {
+
+ /**
+ * REQUIRED .
+ *
+ * An object containing configuration information for the flow types supported.
+ */
+ @NotNull
+ private OAuthFlows flows = new OAuthFlows();
+
+ /**
+ * List of the needed scope names.
+ */
+ @Nullable
+ private List scopes;
+
+ @Builder(builderMethodName = "oauth2Builder")
+ public OAuth2SecurityScheme(@Nullable String description,
+ @NotNull OAuthFlows flows,
+ @Nullable List scopes) {
+ super(Type.OAUTH2, description);
+ this.flows = flows;
+ this.scopes = scopes;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/OAuthFlows.java b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/OAuthFlows.java
new file mode 100644
index 00000000..00f2c8ee
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/OAuthFlows.java
@@ -0,0 +1,52 @@
+package com.asyncapi.v3.security_scheme.oauth2;
+
+import com.asyncapi.v3.ExtendableObject;
+import com.asyncapi.v3.security_scheme.oauth2.flow.AuthorizationCodeOAuthFlow;
+import com.asyncapi.v3.security_scheme.oauth2.flow.ClientCredentialsOAuthFlow;
+import com.asyncapi.v3.security_scheme.oauth2.flow.ImplicitOAuthFlow;
+import com.asyncapi.v3.security_scheme.oauth2.flow.PasswordOAuthFlow;
+import lombok.*;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Allows configuration of the supported OAuth Flows.
+ *
+ * This object MAY be extended with {@link ExtendableObject}.
+ *
+ * @see OAuth Flows
+ * @see Security Scheme
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class OAuthFlows extends ExtendableObject {
+
+ /**
+ * Configuration for the OAuth Implicit flow
+ */
+ @Nullable
+ private ImplicitOAuthFlow implicit;
+
+ /**
+ * Configuration for the OAuth Resource Owner Protected Credentials flow
+ */
+ @Nullable
+ private PasswordOAuthFlow password;
+
+ /**
+ * Configuration for the OAuth Client Credentials flow.
+ */
+ @Nullable
+ private ClientCredentialsOAuthFlow clientCredentials;
+
+ /**
+ * Configuration for the OAuth Authorization Code flow
+ */
+ @Nullable
+ private AuthorizationCodeOAuthFlow authorizationCode;
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/AuthorizationCodeOAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/AuthorizationCodeOAuthFlow.java
new file mode 100644
index 00000000..bb0159eb
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/AuthorizationCodeOAuthFlow.java
@@ -0,0 +1,49 @@
+package com.asyncapi.v3.security_scheme.oauth2.flow;
+
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Map;
+
+/**
+ * Configuration for the OAuth Authorization Code flow
+ *
+ * This object MAY be extended with {@link com.asyncapi.v3.ExtendableObject}.
+ *
+ * @see OAuth Flow
+ * @see Specification Extensions
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class AuthorizationCodeOAuthFlow extends OAuthFlow {
+
+ /**
+ * REQUIRED .
+ *
+ * The authorization URL to be used for this flow. This MUST be in the form of an absolute URL.
+ */
+ @NotNull
+ private String authorizationUrl = "";
+
+ /**
+ * The token URL to be used for this flow. This MUST be in the form of an absolute URL.
+ */
+ @Nullable
+ private String tokenUrl = "";
+
+ @Builder(builderMethodName = "authorizationCodeBuilder")
+ public AuthorizationCodeOAuthFlow(@Nullable String refreshUrl,
+ @NotNull Map availableScopes,
+ @NotNull String authorizationUrl,
+ @Nullable String tokenUrl) {
+ super(refreshUrl, availableScopes);
+ this.authorizationUrl = authorizationUrl;
+ this.tokenUrl = tokenUrl;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/ClientCredentialsOAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/ClientCredentialsOAuthFlow.java
new file mode 100644
index 00000000..2f603fae
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/ClientCredentialsOAuthFlow.java
@@ -0,0 +1,41 @@
+package com.asyncapi.v3.security_scheme.oauth2.flow;
+
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Map;
+
+/**
+ * Configuration for the OAuth Client Credentials flow
+ *
+ * This object MAY be extended with {@link com.asyncapi.v3.ExtendableObject}.
+ *
+ * @see OAuth Flow
+ * @see Specification Extensions
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class ClientCredentialsOAuthFlow extends OAuthFlow {
+
+ /**
+ * REQUIRED .
+ *
+ * The token URL to be used for this flow. This MUST be in the form of a URL.
+ */
+ @NotNull
+ private String tokenUrl = "";
+
+ @Builder(builderMethodName = "clientCredentialsBuilder")
+ public ClientCredentialsOAuthFlow(@Nullable String refreshUrl,
+ @NotNull Map availableScopes,
+ @NotNull String tokenUrl) {
+ super(refreshUrl, availableScopes);
+ this.tokenUrl = tokenUrl;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/ImplicitOAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/ImplicitOAuthFlow.java
new file mode 100644
index 00000000..6c71d7a0
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/ImplicitOAuthFlow.java
@@ -0,0 +1,41 @@
+package com.asyncapi.v3.security_scheme.oauth2.flow;
+
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Map;
+
+/**
+ * Configuration for the OAuth Implicit flow
+ *
+ * This object MAY be extended with {@link com.asyncapi.v3.ExtendableObject}.
+ *
+ * @see OAuth Flow
+ * @see Specification Extensions
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class ImplicitOAuthFlow extends OAuthFlow {
+
+ /**
+ * REQUIRED .
+ *
+ * The authorization URL to be used for this flow. This MUST be in the form of a URL
+ */
+ @NotNull
+ private String authorizationUrl = "";
+
+ @Builder(builderMethodName = "implicitBuilder")
+ public ImplicitOAuthFlow(@Nullable String refreshUrl,
+ @NotNull Map scopes,
+ @NotNull String authorizationUrl) {
+ super(refreshUrl, scopes);
+ this.authorizationUrl = authorizationUrl;
+ }
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/OAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/OAuthFlow.java
new file mode 100644
index 00000000..4751cc35
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/OAuthFlow.java
@@ -0,0 +1,44 @@
+package com.asyncapi.v3.security_scheme.oauth2.flow;
+
+import com.asyncapi.v3.ExtendableObject;
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * Configuration details for a supported OAuth Flow
+ *
+ * This object MAY be extended with {@link ExtendableObject}.
+ *
+ * @see OAuth Flow
+ * @see Specification Extensions
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class OAuthFlow extends ExtendableObject {
+
+ /**
+ * The URL to be used for obtaining refresh tokens. This MUST be in the form of an absolute URL.
+ */
+ @Nullable
+ @Builder.Default
+ private String refreshUrl = "";
+
+ /**
+ * REQUIRED .
+ *
+ * The available scopes for the OAuth2 security scheme. A map between the scope name and a short description for it.
+ */
+ @NotNull
+ @Builder.Default
+ private Map availableScopes = new HashMap<>();
+
+}
diff --git a/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/PasswordOAuthFlow.java b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/PasswordOAuthFlow.java
new file mode 100644
index 00000000..6b79f539
--- /dev/null
+++ b/asyncapi-core/src/main/java/com/asyncapi/v3/security_scheme/oauth2/flow/PasswordOAuthFlow.java
@@ -0,0 +1,41 @@
+package com.asyncapi.v3.security_scheme.oauth2.flow;
+
+import lombok.*;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Map;
+
+/**
+ * Configuration for the OAuth Resource Owner Protected Credentials flow
+ *
+ * This object MAY be extended with {@link com.asyncapi.v3.ExtendableObject}.
+ *
+ * @see OAuth Flow
+ * @see Specification Extensions
+ * @author Pavel Bodiachevskii
+ * @version 3.0.0
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+public class PasswordOAuthFlow extends OAuthFlow {
+
+ /**
+ * REQUIRED .
+ *
+ * The token URL to be used for this flow. This MUST be in the form of a URL.
+ */
+ @NotNull
+ private String tokenUrl = "";
+
+ @Builder(builderMethodName = "passwordBuilder")
+ public PasswordOAuthFlow(@Nullable String refreshUrl,
+ @NotNull Map scopes,
+ @NotNull String tokenUrl) {
+ super(refreshUrl, scopes);
+ this.tokenUrl = tokenUrl;
+ }
+
+}
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/AbstractExampleValidationTest.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/AbstractExampleValidationTest.kt
new file mode 100644
index 00000000..1b0d2119
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/AbstractExampleValidationTest.kt
@@ -0,0 +1,93 @@
+package com.asyncapi.examples.v2._6_0
+
+import com.asyncapi.v3.ClasspathUtils
+import com.asyncapi.v2._6_0.model.AsyncAPI
+import com.asyncapi.v2._6_0.model.component.Components
+import com.asyncapi.v2._6_0.model.info.Info
+import com.fasterxml.jackson.annotation.JsonInclude
+import com.fasterxml.jackson.databind.ObjectMapper
+import com.fasterxml.jackson.dataformat.yaml.YAMLFactory
+import org.junit.jupiter.api.Assertions
+import org.junit.jupiter.api.Test
+
+abstract class AbstractExampleValidationTest {
+
+ private val objectMapper = ObjectMapper(YAMLFactory())
+ .setSerializationInclusion(JsonInclude.Include.NON_NULL)
+
+ abstract fun specificationLocation(): String
+
+ private fun specification(): AsyncAPI {
+ return objectMapper.readValue(
+ ClasspathUtils.readAsString(specificationLocation()),
+ AsyncAPI::class.java
+ )
+ }
+
+ open fun expectedId(): String? = null
+
+ @Test
+ fun `ensure that id was read correctly`() {
+ Assertions.assertEquals(
+ specification().id,
+ expectedId(),
+ "id must be read correctly"
+ )
+ }
+
+ open fun expectedDefaultContentType(): String? = null
+
+ @Test
+ fun `ensure that defaultContentType was read correctly`() {
+ Assertions.assertEquals(
+ specification().defaultContentType,
+ expectedDefaultContentType(),
+ "defaultContentType must be read correctly"
+ )
+ }
+
+ abstract fun expectedInfo(): Info
+
+ @Test
+ fun `ensure that info was read correctly`() {
+ Assertions.assertEquals(
+ specification().info,
+ expectedInfo(),
+ "Info must be read correctly"
+ )
+ }
+
+ abstract fun expectedServers(): Map?
+
+ @Test
+ fun `ensure that servers were read correctly`() {
+ Assertions.assertEquals(
+ specification().servers,
+ expectedServers(),
+ "Servers must be read correctly"
+ )
+ }
+
+ abstract fun expectedChannels(): Map
+
+ @Test
+ fun `ensure that channels were read correctly`() {
+ Assertions.assertEquals(
+ specification().channels,
+ expectedChannels(),
+ "Channels must be read correctly"
+ )
+ }
+
+ abstract fun expectedComponents(): Components?
+
+ @Test
+ fun `ensure that components were read correctly`() {
+ Assertions.assertEquals(
+ specification().components,
+ expectedComponents(),
+ "Components must be read correctly"
+ )
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/AnyOf.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/AnyOf.kt
new file mode 100644
index 00000000..e134ce1f
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/AnyOf.kt
@@ -0,0 +1,76 @@
+package com.asyncapi.examples.v2._6_0
+
+import com.asyncapi.v2.Reference
+import com.asyncapi.v2._6_0.model.channel.ChannelItem
+import com.asyncapi.v2._6_0.model.channel.message.Message
+import com.asyncapi.v2._6_0.model.channel.operation.Operation
+import com.asyncapi.v2._6_0.model.component.Components
+import com.asyncapi.v2._6_0.model.info.Info
+import com.asyncapi.v2.schema.Schema
+
+class AnyOf: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v2.6.0/anyof.yml"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("AnyOf example")
+ .version("1.0.0")
+ .build()
+ }
+
+ override fun expectedServers(): Map? = null
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("test", ChannelItem.builder()
+ .publish(Operation.builder()
+ .message(Reference("#/components/messages/testMessages"))
+ .build()
+ )
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components? {
+ return Components.builder()
+ .messages(mapOf(
+ Pair("testMessages", Message.builder()
+ .payload(Schema.builder()
+ .anyOf(listOf(
+ Schema.builder().ref("#/components/schemas/objectWithKey").build(),
+ Schema.builder().ref("#/components/schemas/objectWithKey2").build(),
+ ))
+ .build()
+ )
+ .build()
+ )
+ ))
+ .schemas(mapOf(
+ Pair("objectWithKey", Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("key", Schema.builder()
+ .type("string")
+ .additionalProperties(false)
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("objectWithKey2", Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("key2", Schema.builder()
+ .type("string")
+ .build()
+ )
+ ))
+ .build()
+ )
+ ))
+ .build()
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/ApplicationHeaders.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/ApplicationHeaders.kt
new file mode 100644
index 00000000..84d93287
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/ApplicationHeaders.kt
@@ -0,0 +1,149 @@
+package com.asyncapi.examples.v2._6_0
+
+import com.asyncapi.v2.Reference
+import com.asyncapi.v2._6_0.model.channel.ChannelItem
+import com.asyncapi.v2._6_0.model.channel.Parameter
+import com.asyncapi.v2._6_0.model.channel.message.CorrelationId
+import com.asyncapi.v2._6_0.model.channel.message.Message
+import com.asyncapi.v2._6_0.model.channel.operation.Operation
+import com.asyncapi.v2._6_0.model.component.Components
+import com.asyncapi.v2._6_0.model.info.Info
+import com.asyncapi.v2._6_0.model.info.License
+import com.asyncapi.v2._6_0.model.server.Server
+import com.asyncapi.v2._6_0.model.server.ServerVariable
+import com.asyncapi.v2.schema.Schema
+import java.math.BigDecimal
+
+class ApplicationHeaders: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v2.6.0/application-headers.yml"
+
+ override fun expectedDefaultContentType(): String = "application/json"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("Application Headers example")
+ .version("1.0.0")
+ .description("A cut of the Streetlights API to test application header changes supporting")
+ .license(License(
+ "Apache 2.0",
+ "https://www.apache.org/licenses/LICENSE-2.0"
+ ))
+ .build()
+ }
+
+ override fun expectedServers(): Map {
+ return mapOf(
+ Pair("production", Server.builder()
+ .url("test.mosquitto.org:{port}")
+ .protocol("mqtt")
+ .description("Test broker")
+ .variables(mapOf(
+ Pair("port", ServerVariable.builder()
+ .description("Secure connection (TLS) is available through port 8883.")
+ .defaultValue("1883")
+ .enumValues(listOf("1883", "8883"))
+ .build()
+ )
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("smartylighting/streetlights/1/0/event/{streetlightId}/lighting/measured", ChannelItem.builder()
+ .parameters(mapOf(
+ Pair("streetlightId", Reference("#/components/parameters/streetlightId"))
+ ))
+ .publish(Operation.builder()
+ .summary("Inform about environmental lighting conditions of a particular streetlight.")
+ .operationId("receiveLightMeasurement")
+ .message(Reference("#/components/messages/lightMeasured"))
+ .build()
+ )
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components? {
+ return Components.builder()
+ .messages(mapOf(
+ Pair("lightMeasured", Message.builder()
+ .name("lightMeasured")
+ .title("Light measured")
+ .summary("Inform about environmental lighting conditions of a particular streetlight.")
+ .correlationId(CorrelationId(
+ null,
+ "\$message.header#/MQMD/CorrelId"
+ ))
+ .contentType("application/json")
+ .headers(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("MQMD", Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("CorrelId", Schema.builder()
+ .type("string")
+ .minLength(24)
+ .maxLength(24)
+ .format("binary")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("applicationInstanceId", Schema.builder()
+ .ref("#/components/schemas/applicationInstanceId")
+ .build()
+ )
+ ))
+ .build()
+ )
+ .payload(Schema.builder().ref("#/components/schemas/lightMeasuredPayload").build())
+ .build()
+ )
+ ))
+ .schemas(mapOf(
+ Pair("lightMeasuredPayload", Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("lumens", Schema.builder()
+ .type("integer")
+ .minimum(BigDecimal.ZERO)
+ .description("Light intensity measured in lumens.")
+ .build()
+ ),
+ Pair("sentAt", Schema.builder()
+ .ref("#/components/schemas/sentAt")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("sentAt", Schema.builder()
+ .type("string")
+ .format("date-time")
+ .description("Date and time when the message was sent.")
+ .build()
+ ),
+ Pair("applicationInstanceId", Schema.builder()
+ .type("string")
+ .description("Unique identifier for a given instance of the publishing application")
+ .build()
+ )
+ ))
+ .parameters(mapOf(
+ Pair("streetlightId", Parameter.builder()
+ .description("The ID of the streetlight.")
+ .schema(Schema.builder().type("string").build())
+ .build()
+ )
+ ))
+ .build()
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/CorrelationId.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/CorrelationId.kt
new file mode 100644
index 00000000..d5e8c827
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/CorrelationId.kt
@@ -0,0 +1,230 @@
+package com.asyncapi.examples.v2._6_0
+
+import com.asyncapi.v2.Reference
+import com.asyncapi.v2._6_0.model.channel.ChannelItem
+import com.asyncapi.v2._6_0.model.channel.Parameter
+import com.asyncapi.v2._6_0.model.channel.message.CorrelationId
+import com.asyncapi.v2._6_0.model.channel.message.Message
+import com.asyncapi.v2._6_0.model.channel.operation.Operation
+import com.asyncapi.v2._6_0.model.component.Components
+import com.asyncapi.v2._6_0.model.info.Info
+import com.asyncapi.v2._6_0.model.info.License
+import com.asyncapi.v2._6_0.model.server.Server
+import com.asyncapi.v2._6_0.model.server.ServerVariable
+import com.asyncapi.v2.schema.Schema
+import com.asyncapi.v2.security_scheme.ApiKeySecurityScheme
+import com.asyncapi.v2.security_scheme.OpenIdConnectSecurityScheme
+import com.asyncapi.v2.security_scheme.oauth2.OAuth2SecurityScheme
+import com.asyncapi.v2.security_scheme.oauth2.OAuthFlows
+import com.asyncapi.v2.security_scheme.oauth2.flow.AuthorizationCodeOAuthFlow
+import com.asyncapi.v2.security_scheme.oauth2.flow.ClientCredentialsOAuthFlow
+import com.asyncapi.v2.security_scheme.oauth2.flow.ImplicitOAuthFlow
+import com.asyncapi.v2.security_scheme.oauth2.flow.PasswordOAuthFlow
+import java.math.BigDecimal
+
+class CorrelationId: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v2.6.0/correlation-id.yml"
+
+ override fun expectedDefaultContentType(): String = "application/json"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("Correlation ID Example")
+ .version("1.0.0")
+ .description("A cut of the Streetlights API to test Correlation ID")
+ .license(License(
+ "Apache 2.0",
+ "https://www.apache.org/licenses/LICENSE-2.0"
+ ))
+ .build()
+ }
+
+ override fun expectedServers(): Map {
+ return mapOf(
+ Pair("production", Server.builder()
+ .url("test.mosquitto.org:{port}")
+ .protocol("mqtt")
+ .description("Test broker")
+ .variables(mapOf(
+ Pair("port", ServerVariable.builder()
+ .description("Secure connection (TLS) is available through port 8883.")
+ .defaultValue("1883")
+ .enumValues(listOf("1883", "8883"))
+ .build()
+ )
+ ))
+ .security(listOf(
+ mapOf(Pair("apiKey", emptyList())),
+ mapOf(Pair("supportedOauthFlows", listOf(
+ "streetlights:on", "streetlights:off", "streetlights:dim"
+ ))),
+ mapOf(Pair("openIdConnectWellKnown", emptyList())),
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("smartylighting/streetlights/1/0/event/{streetlightId}/lighting/measured", ChannelItem.builder()
+ .parameters(mapOf(
+ Pair("streetlightId", Reference("#/components/parameters/streetlightId"))
+ ))
+ .publish(Operation.builder()
+ .summary("Inform about environmental lighting conditions of a particular streetlight.")
+ .operationId("receiveLightMeasurement")
+ .message(Reference("#/components/messages/lightMeasured"))
+ .build()
+ )
+ .build()
+ ),
+ Pair("smartylighting/streetlights/1/0/action/{streetlightId}/dim", ChannelItem.builder()
+ .parameters(mapOf(
+ Pair("streetlightId", Reference("#/components/parameters/streetlightId"))
+ ))
+ .subscribe(Operation.builder()
+ .operationId("dimLight")
+ .message(Reference("#/components/messages/dimLight"))
+ .build()
+ )
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components? {
+ return Components.builder()
+ .messages(mapOf(
+ Pair("lightMeasured", Message.builder()
+ .name("lightMeasured")
+ .title("Light measured")
+ .summary("Inform about environmental lighting conditions of a particular streetlight.")
+ .correlationId(CorrelationId(
+ null,
+ "\$message.header#/MQMD/CorrelId"
+ ))
+ .contentType("application/json")
+ .payload(Schema.builder().ref("#/components/schemas/lightMeasuredPayload").build())
+ .build()
+ ),
+ Pair("dimLight", Message.builder()
+ .name("dimLight")
+ .title("Dim light")
+ .summary("Command a particular streetlight to dim the lights.")
+ .correlationId(Reference("#/components/correlationIds/sentAtCorrelator"))
+ .payload(Schema.builder().ref("#/components/schemas/dimLightPayload").build())
+ .build()
+ )
+ ))
+ .schemas(mapOf(
+ Pair("lightMeasuredPayload", Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("lumens", Schema.builder()
+ .type("integer")
+ .minimum(BigDecimal.ZERO)
+ .description("Light intensity measured in lumens.")
+ .build()
+ ),
+ Pair("sentAt", Schema.builder()
+ .ref("#/components/schemas/sentAt")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("sentAt", Schema.builder()
+ .type("string")
+ .format("date-time")
+ .description("Date and time when the message was sent.")
+ .build()
+ ),
+ Pair("dimLightPayload", Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("percentage", Schema.builder()
+ .type("integer")
+ .minimum(BigDecimal.ZERO)
+ .maximum(BigDecimal.valueOf(100))
+ .description("Percentage to which the light should be dimmed to.")
+ .build()
+ ),
+ Pair("sentAt", Schema.builder()
+ .ref("#/components/schemas/sentAt")
+ .build()
+ )
+ ))
+ .build()
+ )
+ ))
+ .parameters(mapOf(
+ Pair("streetlightId", Parameter.builder()
+ .description("The ID of the streetlight.")
+ .schema(Schema.builder().type("string").build())
+ .build()
+ )
+ ))
+ .correlationIds(mapOf(
+ Pair("sentAtCorrelator", CorrelationId(
+ "Data from message payload used as correlation ID",
+ "\$message.payload#/sentAt"
+ ))
+ ))
+ .securitySchemes(mapOf(
+ Pair("apiKey", ApiKeySecurityScheme(
+ "Provide your API key as the user and leave the password empty.",
+ ApiKeySecurityScheme.ApiKeyLocation.USER
+ )),
+ Pair("supportedOauthFlows", OAuth2SecurityScheme(
+ "Flows to support OAuth 2.0",
+ OAuthFlows(
+ ImplicitOAuthFlow(
+ "",
+ mapOf(
+ Pair("streetlights:on", "Ability to switch lights on"),
+ Pair("streetlights:off", "Ability to switch lights off"),
+ Pair("streetlights:dim", "Ability to dim the lights"),
+ ),
+ "https://authserver.example/auth",
+ ),
+ PasswordOAuthFlow(
+ "",
+ mapOf(
+ Pair("streetlights:on", "Ability to switch lights on"),
+ Pair("streetlights:off", "Ability to switch lights off"),
+ Pair("streetlights:dim", "Ability to dim the lights"),
+ ),
+ "https://authserver.example/token",
+ ),
+ ClientCredentialsOAuthFlow(
+ "",
+ mapOf(
+ Pair("streetlights:on", "Ability to switch lights on"),
+ Pair("streetlights:off", "Ability to switch lights off"),
+ Pair("streetlights:dim", "Ability to dim the lights"),
+ ),
+ "https://authserver.example/token",
+ ),
+ AuthorizationCodeOAuthFlow(
+ "https://authserver.example/refresh",
+ mapOf(
+ Pair("streetlights:on", "Ability to switch lights on"),
+ Pair("streetlights:off", "Ability to switch lights off"),
+ Pair("streetlights:dim", "Ability to dim the lights"),
+ ),
+ "https://authserver.example/auth",
+ "https://authserver.example/token",
+ )
+ )
+ )),
+ Pair("openIdConnectWellKnown", OpenIdConnectSecurityScheme(
+ null,
+ "https://authserver.example/.well-known"
+ ))
+ ))
+ .build()
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/GitterStreaming.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/GitterStreaming.kt
new file mode 100644
index 00000000..97849dce
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/GitterStreaming.kt
@@ -0,0 +1,295 @@
+package com.asyncapi.examples.v2._6_0
+
+import com.asyncapi.v2.Reference
+import com.asyncapi.v2._6_0.model.channel.ChannelItem
+import com.asyncapi.v2._6_0.model.channel.Parameter
+import com.asyncapi.v2._6_0.model.channel.message.Message
+import com.asyncapi.v2._6_0.model.channel.message.OneOfMessages
+import com.asyncapi.v2._6_0.model.channel.operation.Operation
+import com.asyncapi.v2._6_0.model.component.Components
+import com.asyncapi.v2._6_0.model.info.Info
+import com.asyncapi.v2._6_0.model.server.Server
+import com.asyncapi.v2.binding.message.http.HTTPMessageBinding
+import com.asyncapi.v2.binding.operation.http.HTTPOperationBinding
+import com.asyncapi.v2.binding.operation.http.HTTPOperationType
+import com.asyncapi.v2.schema.Schema
+import com.asyncapi.v2.security_scheme.http.HttpSecurityScheme
+
+class GitterStreaming: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v2.6.0/gitter-streaming.yml"
+
+ override fun expectedId(): String = "tag:stream.gitter.im,2022:api"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("Gitter Streaming API")
+ .version("1.0.0")
+ .build()
+ }
+
+ override fun expectedServers(): Map {
+ return mapOf(
+ Pair("production", Server.builder()
+ .url("https://stream.gitter.im/v1")
+ .protocol("https")
+ .protocolVersion("1.1")
+ .security(listOf(
+ mapOf(Pair("httpBearerToken", emptyList())),
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("/rooms/{roomId}/{resource}", ChannelItem.builder()
+ .parameters(mapOf(
+ Pair("roomId", Parameter.builder()
+ .description("Id of the Gitter room.")
+ .schema(Schema.builder()
+ .type("string")
+ .examples(listOf("53307860c3599d1de448e19d"))
+ .build()
+ )
+ .build()
+ ),
+ Pair("resource", Parameter.builder()
+ .description("The resource to consume.")
+ .schema(Schema.builder()
+ .type("string")
+ .enumValue(listOf("chatMessages", "events"))
+ .build()
+ )
+ .build()
+ )
+ ))
+ .subscribe(Operation.builder()
+ .bindings(mapOf(
+ Pair("http", HTTPOperationBinding.builder()
+ .type(HTTPOperationType.RESPONSE)
+ .build()
+ )
+ ))
+ .message(OneOfMessages(listOf(
+ Reference("#/components/messages/chatMessage"),
+ Reference("#/components/messages/heartbeat")
+ )))
+ .build()
+ )
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components? {
+ return Components.builder()
+ .securitySchemes(mapOf(
+ Pair("httpBearerToken", HttpSecurityScheme(
+ null,
+ "bearer",
+ null,
+ ))
+ ))
+ .messages(mapOf(
+ Pair("chatMessage", Message.builder()
+ .schemaFormat("application/schema+yaml;version=draft-07")
+ .summary("A message represents an individual chat message sent to a room. They are a sub-resource of a room.")
+ .payload(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("id", Schema.builder()
+ .type("string")
+ .description("ID of the message.")
+ .build()
+ ),
+ Pair("text", Schema.builder()
+ .type("string")
+ .description("Original message in plain-text/markdown.")
+ .build()
+ ),
+ Pair("html", Schema.builder()
+ .type("string")
+ .description("HTML formatted message.")
+ .build()
+ ),
+ Pair("sent", Schema.builder()
+ .type("string")
+ .format("date-time")
+ .description("ISO formatted date of the message.")
+ .build()
+ ),
+ Pair("fromUser", Schema.builder()
+ .type("object")
+ .description("User that sent the message.")
+ .properties(mapOf(
+ Pair("id", Schema.builder()
+ .type("string")
+ .description("Gitter User ID.")
+ .build()
+ ),
+ Pair("username", Schema.builder()
+ .type("string")
+ .description("Gitter/GitHub username.")
+ .build()
+ ),
+ Pair("displayName", Schema.builder()
+ .type("string")
+ .description("Gitter/GitHub user real name.")
+ .build()
+ ),
+ Pair("url", Schema.builder()
+ .type("string")
+ .description("Path to the user on Gitter.")
+ .build()
+ ),
+ Pair("avatarUrl", Schema.builder()
+ .type("string")
+ .format("uri")
+ .description("User avatar URI.")
+ .build()
+ ),
+ Pair("avatarUrlSmall", Schema.builder()
+ .type("string")
+ .format("uri")
+ .description("User avatar URI (small).")
+ .build()
+ ),
+ Pair("avatarUrlMedium", Schema.builder()
+ .type("string")
+ .format("uri")
+ .description("User avatar URI (medium).")
+ .build()
+ ),
+ Pair("v", Schema.builder()
+ .type("number")
+ .description("Version.")
+ .build()
+ ),
+ Pair("gv", Schema.builder()
+ .type("string")
+ .description("Stands for \"Gravatar version\" and is used for cache busting.")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("unread", Schema.builder()
+ .type("boolean")
+ .description("Boolean that indicates if the current user has read the message.")
+ .build()
+ ),
+ Pair("readBy", Schema.builder()
+ .type("number")
+ .description("Number of users that have read the message.")
+ .build()
+ ),
+ Pair("urls", Schema.builder()
+ .type("array")
+ .description("List of URLs present in the message.")
+ .items(Schema.builder()
+ .type("string")
+ .format("uri")
+ .build())
+ .build()
+ ),
+ Pair("mentions", Schema.builder()
+ .type("array")
+ .description("List of @Mentions in the message.")
+ .items(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("screenName", Schema.builder()
+ .type("string")
+ .build()
+ ),
+ Pair("userId", Schema.builder()
+ .type("string")
+ .build()
+ ),
+ Pair("userIds", Schema.builder()
+ .type("array")
+ .items(Schema.builder()
+ .type("string")
+ .build())
+ .build()
+ )
+ ))
+ .build())
+ .build()
+ ),
+ Pair("issues", Schema.builder()
+ .type("array")
+ .description("List of #Issues referenced in the message.")
+ .items(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("number", Schema.builder().type("string").build())
+ ))
+ .build())
+ .build()
+ ),
+ Pair("meta", Schema.builder()
+ .type("array")
+ .description("Metadata. This is currently not used for anything.")
+ .items(Schema.builder().build())
+ .build()
+ ),
+ Pair("v", Schema.builder()
+ .type("number")
+ .description("Version.")
+ .build()
+ ),
+ Pair("gv", Schema.builder()
+ .type("string")
+ .description("Stands for \"Gravatar version\" and is used for cache busting.")
+ .build()
+ ),
+ ))
+ .build()
+ )
+ .bindings(mapOf(
+ Pair("http", Reference("#/components/messageBindings/streamingHeaders"))
+ ))
+ .build()
+ ),
+ Pair("heartbeat", Message.builder()
+ .schemaFormat("application/schema+yaml;version=draft-07")
+ .summary("Its purpose is to keep the connection alive.")
+ .payload(Schema.builder()
+ .type("string")
+ .enumValue(listOf("\r\n"))
+ .build()
+ )
+ .bindings(mapOf(
+ Pair("http", Reference("#/components/messageBindings/streamingHeaders"))
+ ))
+ .build()
+ ),
+ ))
+ .messageBindings(mapOf(
+ Pair("http", HTTPMessageBinding.builder()
+ .headers(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("Transfer-Encoding", Schema.builder()
+ .type("string")
+ .constValue("chunked")
+ .build()
+ ),
+ Pair("Trailer", Schema.builder()
+ .type("string")
+ .constValue("\\r\\n")
+ .build()
+ )
+ ))
+ .build()
+ )
+ .build()
+ )
+ ))
+ .build()
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/Mercure.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/Mercure.kt
new file mode 100644
index 00000000..9bd85324
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/Mercure.kt
@@ -0,0 +1,112 @@
+package com.asyncapi.examples.v2._6_0
+
+import com.asyncapi.v2.Reference
+import com.asyncapi.v2._6_0.model.ExternalDocumentation
+import com.asyncapi.v2._6_0.model.channel.ChannelItem
+import com.asyncapi.v2._6_0.model.channel.Parameter
+import com.asyncapi.v2._6_0.model.channel.message.Message
+import com.asyncapi.v2._6_0.model.channel.message.OneOfMessages
+import com.asyncapi.v2._6_0.model.channel.operation.Operation
+import com.asyncapi.v2._6_0.model.component.Components
+import com.asyncapi.v2._6_0.model.info.Info
+import com.asyncapi.v2._6_0.model.server.Server
+import com.asyncapi.v2.binding.message.http.HTTPMessageBinding
+import com.asyncapi.v2.binding.operation.http.HTTPOperationBinding
+import com.asyncapi.v2.binding.operation.http.HTTPOperationType
+import com.asyncapi.v2.schema.Schema
+import com.asyncapi.v2.security_scheme.http.HttpSecurityScheme
+
+class Mercure: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v2.6.0/mercure.yml"
+
+ override fun expectedDefaultContentType(): String = "application/ld+json"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("Mercure Hub Example")
+ .description("This example demonstrates how to define a Mercure hub.")
+ .version("1.0.0")
+ .build()
+ }
+
+ override fun expectedServers(): Map {
+ return mapOf(
+ Pair("production", Server.builder()
+ .url("https://demo.mercure.rocks/.well-known/mercure")
+ .protocol("mercure")
+ .build()
+ )
+ )
+ }
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("https://example.com/books/{id}", ChannelItem.builder()
+ .description("Every time a resource of type `http://schema.org/Book` is created or modified, a JSON-LD representation of the new version of this resource must be pushed in this Mercure topic.")
+ .parameters(mapOf(
+ Pair("id", Parameter.builder()
+ .schema(Schema.builder()
+ .type("integer")
+ .build()
+ )
+ .build()
+ )
+ ))
+ .subscribe(Operation.builder()
+ .message(Reference("#/components/messages/book"))
+ .build()
+ )
+ .publish(Operation.builder()
+ .message(Reference("#/components/messages/book"))
+ .build()
+ )
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components? {
+ return Components.builder()
+ .messages(mapOf(
+ Pair("book", Message.builder()
+ .summary("The content of a book resource.")
+ .externalDocs(ExternalDocumentation(
+ null,
+ "https://schema.org/Book"
+ ))
+ .payload(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("@id", Schema.builder()
+ .type("string")
+ .format("iri-reference")
+ .build()
+ ),
+ Pair("@type", Schema.builder()
+ .type("string")
+ .format("iri-reference")
+ .build()
+ ),
+ Pair("name", Schema.builder()
+ .type("string")
+ .build()
+ ),
+ Pair("isbn", Schema.builder()
+ .type("string")
+ .build()
+ ),
+ Pair("abstract", Schema.builder()
+ .type("string")
+ .build()
+ ),
+ ))
+ .build()
+ )
+ .build()
+ ),
+ ))
+ .build()
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/Not.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/Not.kt
new file mode 100644
index 00000000..3a108e11
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/Not.kt
@@ -0,0 +1,59 @@
+package com.asyncapi.examples.v2._6_0
+
+import com.asyncapi.v2.Reference
+import com.asyncapi.v2._6_0.model.channel.ChannelItem
+import com.asyncapi.v2._6_0.model.channel.message.Message
+import com.asyncapi.v2._6_0.model.channel.operation.Operation
+import com.asyncapi.v2._6_0.model.component.Components
+import com.asyncapi.v2._6_0.model.info.Info
+import com.asyncapi.v2.schema.Schema
+
+class Not: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v2.6.0/not.yml"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("Not example")
+ .version("1.0.0")
+ .build()
+ }
+
+ override fun expectedServers(): Map? = null
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("test", ChannelItem.builder()
+ .publish(Operation.builder()
+ .message(Reference("#/components/messages/testMessages"))
+ .build()
+ )
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components? {
+ return Components.builder()
+ .messages(mapOf(
+ Pair("testMessages", Message.builder()
+ .payload(Schema.builder().ref("#/components/schemas/testSchema").build())
+ .build()
+ )
+ ))
+ .schemas(mapOf(
+ Pair("testSchema", Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("key", Schema.builder()
+ .not(Schema.builder().type("integer").build())
+ .build()
+ )
+ ))
+ .build()
+ )
+ ))
+ .build()
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/OneOf.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/OneOf.kt
new file mode 100644
index 00000000..36d33248
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/OneOf.kt
@@ -0,0 +1,98 @@
+package com.asyncapi.examples.v2._6_0
+
+import com.asyncapi.v2.Reference
+import com.asyncapi.v2._6_0.model.channel.ChannelItem
+import com.asyncapi.v2._6_0.model.channel.message.Message
+import com.asyncapi.v2._6_0.model.channel.message.OneOfMessages
+import com.asyncapi.v2._6_0.model.channel.operation.Operation
+import com.asyncapi.v2._6_0.model.component.Components
+import com.asyncapi.v2._6_0.model.info.Info
+import com.asyncapi.v2.schema.Schema
+
+class OneOf: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v2.6.0/oneof.yml"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("OneOf example")
+ .version("1.0.0")
+ .build()
+ }
+
+ override fun expectedServers(): Map? = null
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("test", ChannelItem.builder()
+ .publish(Operation.builder()
+ .message(Reference("#/components/messages/testMessages"))
+ .build()
+ )
+ .build()
+ ),
+ Pair("test2", ChannelItem.builder()
+ .subscribe(Operation.builder()
+ .message(OneOfMessages(listOf(
+ Message.builder()
+ .payload(Schema.builder().ref("#/components/schemas/objectWithKey").build())
+ .build(),
+ Message.builder()
+ .payload(Schema.builder().ref("#/components/schemas/objectWithKey2").build())
+ .build(),
+ )))
+ .build()
+ )
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components? {
+ return Components.builder()
+ .messages(mapOf(
+ Pair("testMessages", Message.builder()
+ .payload(Schema.builder()
+ .oneOf(listOf(
+ Schema.builder().ref("#/components/schemas/objectWithKey").build(),
+ Schema.builder().ref("#/components/schemas/objectWithKey2").build()
+ ))
+ .build()
+ )
+ .build()
+ ),
+ Pair("testMessage1", Message.builder()
+ .payload(Schema.builder().ref("#/components/schemas/objectWithKey").build())
+ .build()
+ ),
+ Pair("testMessage2", Message.builder()
+ .payload(Schema.builder().ref("#/components/schemas/objectWithKey2").build())
+ .build()
+ )
+ ))
+ .schemas(mapOf(
+ Pair("objectWithKey", Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("key", Schema.builder()
+ .type("string")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("objectWithKey2", Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("key2", Schema.builder()
+ .type("string")
+ .build()
+ )
+ ))
+ .build()
+ )
+ ))
+ .build()
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/OperationSecurity.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/OperationSecurity.kt
new file mode 100644
index 00000000..0b893a60
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/OperationSecurity.kt
@@ -0,0 +1,202 @@
+package com.asyncapi.examples.v2._6_0
+
+import com.asyncapi.v2.Reference
+import com.asyncapi.v2._6_0.model.channel.ChannelItem
+import com.asyncapi.v2._6_0.model.channel.message.Message
+import com.asyncapi.v2._6_0.model.channel.operation.Operation
+import com.asyncapi.v2._6_0.model.component.Components
+import com.asyncapi.v2._6_0.model.info.Info
+import com.asyncapi.v2.binding.operation.http.HTTPOperationBinding
+import com.asyncapi.v2.binding.operation.http.HTTPOperationMethod
+import com.asyncapi.v2.binding.operation.http.HTTPOperationType
+import com.asyncapi.v2.schema.Schema
+import com.asyncapi.v2.security_scheme.oauth2.OAuthFlows
+import com.asyncapi.v2.security_scheme.oauth2.OAuth2SecurityScheme
+import com.asyncapi.v2.security_scheme.oauth2.flow.ClientCredentialsOAuthFlow
+
+class OperationSecurity: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v2.6.0/operation-security.yml"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("Notifications")
+ .version("1.0.0")
+ .description("This contract defines HTTP Push notification for application authorization revocation topic"
+ )
+ .build()
+ }
+
+ override fun expectedServers(): Map? = null
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("AUTHORIZATION_REVOCATION", ChannelItem.builder()
+ .subscribe(Operation.builder()
+ .message(Reference("#/components/messages/message"))
+ .bindings(mapOf(
+ Pair("http", HTTPOperationBinding.builder()
+ .type(HTTPOperationType.REQUEST)
+ .method(HTTPOperationMethod.POST)
+ .build())
+ ))
+ .security(listOf(
+ mapOf(
+ Pair("petstore_auth", listOf("subscribe:auth_revocations"))
+ )
+ ))
+ .build()
+ )
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components? {
+ return Components.builder()
+ .messages(mapOf(
+ Pair("message", Message.builder()
+ .headers(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("X-SIGNATURE", Schema.builder()
+ .type("string")
+ .description("ECC message signature")
+ .build()
+ )
+ ))
+ .build()
+ )
+ .payload(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("metadata", Schema.builder()
+ .ref("#/components/schemas/MetaData")
+ .build()
+ ),
+ Pair("notification", Schema.builder()
+ .ref("#/components/schemas/Notification")
+ .build()
+ )
+ ))
+ .build()
+ )
+ .build()
+ )
+ ))
+ .schemas(mapOf(
+ Pair("MetaData", Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("topic", Schema.builder()
+ .type("string")
+ .description("Topic subscribed to.")
+ .build()
+ ),
+ Pair("schemaVersion", Schema.builder()
+ .type("string")
+ .description("The schema for this topic.")
+ .build()
+ ),
+ Pair("deprecated", Schema.builder()
+ .type("boolean")
+ .description("If this is a deprecated schema or topic.")
+ .defaultValue("false")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("Notification", Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("notificationId", Schema.builder()
+ .type("string")
+ .description("The notification Id.")
+ .build()
+ ),
+ Pair("eventDate", Schema.builder()
+ .type("string")
+ .description("The event date associated with this notification in UTC.")
+ .build()
+ ),
+ Pair("publishDate", Schema.builder()
+ .type("string")
+ .description("The message publish date in UTC.")
+ .build()
+ ),
+ Pair("publishAttemptCount", Schema.builder()
+ .type("integer")
+ .description("The number of attempts made to publish this message.")
+ .build()
+ ),
+ Pair("publishAttemptCount", Schema.builder()
+ .type("integer")
+ .description("The number of attempts made to publish this message.")
+ .build()
+ ),
+ Pair("data", Schema.builder()
+ .ref("#/components/schemas/AuthorizationRevocationData")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("AuthorizationRevocationData", Schema.builder()
+ .type("object")
+ .description("The Authorization Revocation payload.")
+ .properties(mapOf(
+ Pair("username", Schema.builder()
+ .type("string")
+ .description("The username for the user.")
+ .build()
+ ),
+ Pair("userId", Schema.builder()
+ .type("string")
+ .description("The immutable public userId for the user")
+ .build()
+ ),
+ Pair("eiasToken", Schema.builder()
+ .type("string")
+ .description("The legacy eiasToken specific to the user")
+ .build()
+ ),
+ Pair("revokeReason", Schema.builder()
+ .type("string")
+ .enumValue(listOf(
+ "REVOKED_BY_APP",
+ "REVOKED_BY_USER",
+ "REVOKED_BY_ADMIN",
+ "PASSWORD_CHANGE"
+ ))
+ .description("The reason for authorization revocation")
+ .build()
+ ),
+ Pair("revocationDate", Schema.builder()
+ .type("string")
+ .description("Date and time when the authorization was revoked")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ ))
+ .securitySchemes(mapOf(
+ Pair("petstore_auth", OAuth2SecurityScheme(
+ "The oauth security descriptions",
+ OAuthFlows(
+ null,
+ null,
+ ClientCredentialsOAuthFlow(
+ "",
+ mapOf(Pair("subscribe:auth_revocations", "Scope required for authorization revocation topic")),
+ "https://example.com/api/oauth/dialog"
+ ),
+ null
+ ),
+ ))
+ ))
+ .build()
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/RpcClient.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/RpcClient.kt
new file mode 100644
index 00000000..07c4586f
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/RpcClient.kt
@@ -0,0 +1,135 @@
+package com.asyncapi.examples.v2._6_0
+
+import com.asyncapi.v2._6_0.model.channel.ChannelItem
+import com.asyncapi.v2._6_0.model.channel.Parameter
+import com.asyncapi.v2._6_0.model.channel.message.CorrelationId
+import com.asyncapi.v2._6_0.model.channel.message.Message
+import com.asyncapi.v2._6_0.model.channel.operation.Operation
+import com.asyncapi.v2._6_0.model.component.Components
+import com.asyncapi.v2._6_0.model.info.Info
+import com.asyncapi.v2._6_0.model.server.Server
+import com.asyncapi.v2.binding.channel.amqp.AMQPChannelBinding
+import com.asyncapi.v2.binding.channel.amqp.AMQPChannelType
+import com.asyncapi.v2.binding.channel.amqp.queue.AMQPChannelQueueProperties
+import com.asyncapi.v2.binding.operation.amqp.AMQPOperationBinding
+import com.asyncapi.v2.schema.Schema
+
+class RpcClient: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v2.6.0/rpc-client.yml"
+
+ override fun expectedId(): String = "urn:example:rpcclient"
+
+ override fun expectedDefaultContentType(): String = "application/json"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("RPC Client Example")
+ .version("1.0.0")
+ .description("This example demonstrates how to define an RPC client."
+ )
+ .build()
+ }
+
+ override fun expectedServers(): Map {
+ return mapOf(
+ Pair("production", Server.builder()
+ .url("rabbitmq.example.org")
+ .protocol("amqp")
+ .build()
+ )
+ )
+ }
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("{queue}", ChannelItem.builder()
+ .parameters(mapOf(
+ Pair("queue", Parameter.builder()
+ .schema(Schema.builder()
+ .type("string")
+ .pattern("^amq\\\\.gen\\\\-.+\$")
+ .build())
+ .build()
+ ),
+ ))
+ .bindings(mapOf(
+ Pair("amqp", AMQPChannelBinding.builder()
+ .`is`(AMQPChannelType.QUEUE)
+ .queue(AMQPChannelQueueProperties.builder()
+ .exclusive(true)
+ .build()
+ )
+ .build()
+ )
+ ))
+ .publish(Operation.builder()
+ .operationId("receiveSumResult")
+ .bindings(mapOf(
+ Pair("amqp", AMQPOperationBinding.builder()
+ .ack(false)
+ .build()
+ )
+ ))
+ .message(Message.builder()
+ .correlationId(CorrelationId(null, "\$message.header#/correlation_id"))
+ .payload(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("result", Schema.builder()
+ .type("number")
+ .examples(listOf(7))
+ .build())
+ ))
+ .build()
+ )
+ .build()
+ )
+ .build()
+ )
+ .build()
+ ),
+ Pair("rpc_queue", ChannelItem.builder()
+ .bindings(mapOf(
+ Pair("amqp", AMQPChannelBinding.builder()
+ .`is`(AMQPChannelType.QUEUE)
+ .queue(AMQPChannelQueueProperties.builder()
+ .durable(false)
+ .build()
+ )
+ .build()
+ )
+ ))
+ .subscribe(Operation.builder()
+ .operationId("requestSum")
+ .bindings(mapOf(
+ Pair("amqp", AMQPOperationBinding.builder()
+ .ack(true)
+ .build()
+ )
+ ))
+ .message(Message.builder()
+ .correlationId(CorrelationId(null, "\$message.header#/correlation_id"))
+ .payload(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("numbers", Schema.builder()
+ .type("array")
+ .items(Schema.builder().type("number").build())
+ .examples(listOf(listOf(4, 3)))
+ .build())
+ ))
+ .build()
+ )
+ .build()
+ )
+ .build()
+ )
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components? = null
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/RpcServer.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/RpcServer.kt
new file mode 100644
index 00000000..95fa19f1
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/RpcServer.kt
@@ -0,0 +1,129 @@
+package com.asyncapi.examples.v2._6_0
+
+import com.asyncapi.v2._6_0.model.channel.ChannelItem
+import com.asyncapi.v2._6_0.model.channel.Parameter
+import com.asyncapi.v2._6_0.model.channel.message.CorrelationId
+import com.asyncapi.v2._6_0.model.channel.message.Message
+import com.asyncapi.v2._6_0.model.channel.operation.Operation
+import com.asyncapi.v2._6_0.model.component.Components
+import com.asyncapi.v2._6_0.model.info.Info
+import com.asyncapi.v2._6_0.model.server.Server
+import com.asyncapi.v2.binding.channel.amqp.AMQPChannelBinding
+import com.asyncapi.v2.binding.channel.amqp.AMQPChannelType
+import com.asyncapi.v2.binding.channel.amqp.queue.AMQPChannelQueueProperties
+import com.asyncapi.v2.binding.operation.amqp.AMQPOperationBinding
+import com.asyncapi.v2.schema.Schema
+
+class RpcServer: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v2.6.0/rpc-server.yml"
+
+ override fun expectedId(): String = "urn:example:rpcserver"
+
+ override fun expectedDefaultContentType(): String = "application/json"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("RPC Server Example")
+ .version("1.0.0")
+ .description("This example demonstrates how to define an RPC server."
+ )
+ .build()
+ }
+
+ override fun expectedServers(): Map {
+ return mapOf(
+ Pair("production", Server.builder()
+ .url("rabbitmq.example.org")
+ .protocol("amqp")
+ .build()
+ )
+ )
+ }
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("{queue}", ChannelItem.builder()
+ .parameters(mapOf(
+ Pair("queue", Parameter.builder()
+ .schema(Schema.builder()
+ .type("string")
+ .pattern("^amq\\\\.gen\\\\-.+\$")
+ .build())
+ .build()
+ ),
+ ))
+ .bindings(mapOf(
+ Pair("amqp", AMQPChannelBinding.builder()
+ .`is`(AMQPChannelType.QUEUE)
+ .queue(AMQPChannelQueueProperties.builder()
+ .exclusive(true)
+ .build()
+ )
+ .build()
+ )
+ ))
+ .subscribe(Operation.builder()
+ .operationId("sendSumResult")
+ .bindings(mapOf(
+ Pair("amqp", AMQPOperationBinding.builder()
+ .ack(true)
+ .build()
+ )
+ ))
+ .message(Message.builder()
+ .correlationId(CorrelationId(null, "\$message.header#/correlation_id"))
+ .payload(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("result", Schema.builder()
+ .type("number")
+ .examples(listOf(7))
+ .build())
+ ))
+ .build()
+ )
+ .build()
+ )
+ .build()
+ )
+ .build()
+ ),
+ Pair("rpc_queue", ChannelItem.builder()
+ .bindings(mapOf(
+ Pair("amqp", AMQPChannelBinding.builder()
+ .`is`(AMQPChannelType.QUEUE)
+ .queue(AMQPChannelQueueProperties.builder()
+ .durable(false)
+ .build()
+ )
+ .build()
+ )
+ ))
+ .publish(Operation.builder()
+ .operationId("sum")
+ .message(Message.builder()
+ .correlationId(CorrelationId(null, "\$message.header#/correlation_id"))
+ .payload(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("numbers", Schema.builder()
+ .type("array")
+ .items(Schema.builder().type("number").build())
+ .examples(listOf(listOf(4, 3)))
+ .build())
+ ))
+ .build()
+ )
+ .build()
+ )
+ .build()
+ )
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components? = null
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/Simple.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/Simple.kt
new file mode 100644
index 00000000..c5254350
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v2/_6_0/Simple.kt
@@ -0,0 +1,64 @@
+package com.asyncapi.examples.v2._6_0
+
+import com.asyncapi.v2.Reference
+import com.asyncapi.v2._6_0.model.channel.ChannelItem
+import com.asyncapi.v2._6_0.model.channel.message.Message
+import com.asyncapi.v2._6_0.model.channel.operation.Operation
+import com.asyncapi.v2._6_0.model.component.Components
+import com.asyncapi.v2._6_0.model.info.Info
+import com.asyncapi.v2.schema.Schema
+
+class Simple: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v2.6.0/simple.yml"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("Account Service")
+ .version("1.0.0")
+ .description("This service is in charge of processing user signups")
+ .build()
+ }
+
+ override fun expectedServers(): Map? = null
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("user/signedup", ChannelItem.builder()
+ .subscribe(Operation.builder()
+ .message(Reference("#/components/messages/UserSignedUp"))
+ .build()
+ )
+ .build()
+ ),
+ )
+ }
+
+ override fun expectedComponents(): Components {
+ return Components.builder()
+ .messages(mapOf(
+ Pair("UserSignedUp", Message.builder()
+ .payload(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("displayName", Schema.builder()
+ .type("string")
+ .description("Name of the user")
+ .build()
+ ),
+ Pair("email", Schema.builder()
+ .type("string")
+ .format("email")
+ .description("Email of the user")
+ .build()
+ )
+ ))
+ .build()
+ )
+ .build()
+ )
+ ))
+ .build()
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/AbstractExampleValidationTest.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/AbstractExampleValidationTest.kt
new file mode 100644
index 00000000..a20adde3
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/AbstractExampleValidationTest.kt
@@ -0,0 +1,104 @@
+package com.asyncapi.examples.v3._0_0
+
+import com.asyncapi.v3.ClasspathUtils
+import com.asyncapi.v3._0_0.model.AsyncAPI
+import com.asyncapi.v3._0_0.model.component.Components
+import com.asyncapi.v3._0_0.model.info.Info
+import com.fasterxml.jackson.annotation.JsonInclude
+import com.fasterxml.jackson.databind.ObjectMapper
+import com.fasterxml.jackson.dataformat.yaml.YAMLFactory
+import org.junit.jupiter.api.Assertions
+import org.junit.jupiter.api.Test
+
+abstract class AbstractExampleValidationTest {
+
+ private val objectMapper = ObjectMapper(YAMLFactory())
+ .setSerializationInclusion(JsonInclude.Include.NON_NULL)
+
+ abstract fun specificationLocation(): String
+
+ private fun specification(): AsyncAPI {
+ return objectMapper.readValue(
+ ClasspathUtils.readAsString(specificationLocation()),
+ AsyncAPI::class.java
+ )
+ }
+
+ open fun expectedId(): String? = null
+
+ @Test
+ fun `ensure that id was read correctly`() {
+ Assertions.assertEquals(
+ specification().id,
+ expectedId(),
+ "id must be read correctly"
+ )
+ }
+
+ open fun expectedDefaultContentType(): String? = null
+
+ @Test
+ fun `ensure that defaultContentType was read correctly`() {
+ Assertions.assertEquals(
+ specification().defaultContentType,
+ expectedDefaultContentType(),
+ "defaultContentType must be read correctly"
+ )
+ }
+
+ abstract fun expectedInfo(): Info
+
+ @Test
+ fun `ensure that info was read correctly`() {
+ Assertions.assertEquals(
+ specification().info,
+ expectedInfo(),
+ "Info must be read correctly"
+ )
+ }
+
+ abstract fun expectedServers(): Map
+
+ @Test
+ fun `ensure that servers were read correctly`() {
+ Assertions.assertEquals(
+ specification().servers,
+ expectedServers(),
+ "Servers must be read correctly"
+ )
+ }
+
+ abstract fun expectedChannels(): Map
+
+ @Test
+ fun `ensure that channels were read correctly`() {
+ Assertions.assertEquals(
+ specification().channels,
+ expectedChannels(),
+ "Channels must be read correctly"
+ )
+ }
+
+ abstract fun expectedOperations(): Map
+
+ @Test
+ fun `ensure that operations were read correctly`() {
+ Assertions.assertEquals(
+ specification().operations,
+ expectedOperations(),
+ "Operations must be read correctly"
+ )
+ }
+
+ abstract fun expectedComponents(): Components?
+
+ @Test
+ fun `ensure that components were read correctly`() {
+ Assertions.assertEquals(
+ specification().components,
+ expectedComponents(),
+ "Components must be read correctly"
+ )
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/AdeoKafkaRequestReplyAsyncAPI.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/AdeoKafkaRequestReplyAsyncAPI.kt
new file mode 100644
index 00000000..f5e97ab7
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/AdeoKafkaRequestReplyAsyncAPI.kt
@@ -0,0 +1,388 @@
+package com.asyncapi.examples.v3._0_0
+
+import com.asyncapi.v3.Reference
+import com.asyncapi.v3._0_0.model.Tag
+import com.asyncapi.v3._0_0.model.channel.Channel
+import com.asyncapi.v3._0_0.model.channel.Parameter
+import com.asyncapi.v3._0_0.model.channel.message.CorrelationId
+import com.asyncapi.v3._0_0.model.channel.message.Message
+import com.asyncapi.v3._0_0.model.component.Components
+import com.asyncapi.v3._0_0.model.info.Contact
+import com.asyncapi.v3._0_0.model.info.Info
+import com.asyncapi.v3._0_0.model.operation.Operation
+import com.asyncapi.v3._0_0.model.operation.OperationAction
+import com.asyncapi.v3._0_0.model.operation.reply.OperationReply
+import com.asyncapi.v3._0_0.model.operation.reply.OperationReplyAddress
+import com.asyncapi.v3._0_0.model.server.Server
+import com.asyncapi.v3.binding.channel.kafka.KafkaChannelBinding
+import com.asyncapi.v3.binding.channel.kafka.KafkaChannelTopicCleanupPolicy
+import com.asyncapi.v3.binding.channel.kafka.KafkaChannelTopicConfiguration
+import com.asyncapi.v3.binding.operation.kafka.KafkaOperationBinding
+import com.asyncapi.v3.binding.server.kafka.KafkaServerBinding
+import com.asyncapi.v3.schema.MultiFormatSchema
+import com.asyncapi.v3.schema.Schema
+import com.asyncapi.v3.security_scheme.SecurityScheme
+
+class AdeoKafkaRequestReplyAsyncAPI: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v3.0.0/adeo-kafka-request-reply-asyncapi.yml"
+
+ override fun expectedInfo(): Info {
+ return Info(
+ "Adeo AsyncAPI Case Study",
+ "%REPLACED_BY_MAVEN%",
+ "This Adeo specification illustrates how ADEO uses AsyncAPI to document some of their exchanges.\n",
+ null,
+ Contact(
+ "AsyncAPI Community",
+ null,
+ "case-study@asyncapi.com"
+ ),
+ null,
+ listOf(
+ Tag("costing", "Costing channels, used by Costing clients.", null)
+ ),
+ null
+ )
+ }
+
+ override fun expectedServers(): Map {
+ return mapOf(
+ Pair("production", Server.builder()
+ .host("prod.url:9092")
+ .protocol("kafka")
+ .description("Kafka PRODUCTION cluster")
+ .security(listOf(Reference("#/components/securitySchemes/sasl-ssl")))
+ .bindings(mapOf(
+ Pair("kafka", KafkaServerBinding.builder()
+ .schemaRegistryUrl("https://schema-registry.prod.url/")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("staging", Server.builder()
+ .host("staging.url:9092")
+ .protocol("kafka")
+ .description("Kafka STAGING cluster for `uat` and `preprod` environments")
+ .security(listOf(Reference("#/components/securitySchemes/sasl-ssl")))
+ .bindings(mapOf(
+ Pair("kafka", KafkaServerBinding.builder()
+ .schemaRegistryUrl("https://schema-registry.prod.url/")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("dev", Server.builder()
+ .host("dev.url:9092")
+ .protocol("kafka")
+ .description("Kafka DEV cluster for `dev` and `sit` environments")
+ .security(listOf(Reference("#/components/securitySchemes/sasl-ssl")))
+ .bindings(mapOf(
+ Pair("kafka", KafkaServerBinding.builder()
+ .schemaRegistryUrl("https://schema-registry.prod.url/")
+ .build()
+ )
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedChannels(): Map {
+ val costingResponseChannelKafkaBinding = KafkaChannelBinding()
+ costingResponseChannelKafkaBinding.extensionFields = mapOf(
+ Pair("x-key.subject.name.strategy", mapOf(
+ Pair("type", "string"),
+ Pair("description", "We use the RecordNameStrategy to infer the messages schema. Use `key.subject.name.strategy=io.confluent.kafka.serializers.subject.RecordNameStrategy` in your consumer configuration.\n"),
+ )),
+ Pair("x-value.subject.name.strategy", mapOf(
+ Pair("type", "string"),
+ Pair("description", "We use the RecordNameStrategy to infer the messages schema. Use `value.subject.name.strategy=io.confluent.kafka.serializers.subject.RecordNameStrategy` in your consumer configuration.\n"),
+ ))
+ )
+
+ return mapOf(
+ Pair("costingRequestChannel", Channel.builder()
+ .address("adeo-{env}-case-study-COSTING-REQUEST-{version}")
+ .description(
+ "Use this topic to do a Costing Request to Costing product. We use the " +
+ "[**RecordNameStrategy**](https://docs.confluent.io/platform/current/schema-registry/serdes-develop/index.html#subject-name-strategy) " +
+ "to infer the messages schema. You have to define " +
+ "`value.subject.name.strategy` to " +
+ "`io.confluent.kafka.serializers.subject.RecordNameStrategy` in your " +
+ "producer to use the schema we manage. The schema below illustrates how " +
+ "Costing Request messages are handled. " +
+ "\n"
+ )
+ .parameters(mapOf(
+ Pair("env", Reference("#/components/parameters/Env")),
+ Pair("version", Reference("#/components/parameters/Version"))
+ ))
+ .bindings(mapOf(
+ Pair("kafka", KafkaChannelBinding.builder()
+ .replicas(3)
+ .partitions(3)
+ .topicConfiguration(KafkaChannelTopicConfiguration.builder()
+ .cleanupPolicy(listOf(KafkaChannelTopicCleanupPolicy.DELETE))
+ .retentionMs(60000000)
+ .build()
+ )
+ .build()
+ )
+ ))
+ .messages(mapOf(
+ Pair("CostingRequest", Reference("#/components/messages/costingRequestV1"))
+ ))
+ .build()
+ ),
+ Pair("costingResponseChannel", Channel.builder()
+ .address(null)
+ .description("This topic is used to REPLY Costing Requests and is targeted by the " +
+ "`REPLY_TOPIC` header. **You must grant PUBLISH access to our `svc-ccr-app` " +
+ "service account.**. We use the " +
+ "[**RecordNameStrategy**](https://docs.confluent.io/platform/current/schema-registry/serdes-develop/index.html#subject-name-strategy) " +
+ "to infer the messages schema. " +
+ "\n" +
+ "Topic should follow pattern \"adeo-{env}-case-study-COSTING-RESPONSE-{version}\"" +
+ "\n" +
+ "You have to define " +
+ "`key.subject.name.strategy` and `value.subject.name.strategy` to " +
+ "`io.confluent.kafka.serializers.subject.RecordNameStrategy` in your " +
+ "consumer. The schema below illustrates how Costing Response messages are " +
+ "handled.\n" +
+ " \n"
+ )
+ .bindings(mapOf(
+ Pair("kafka", costingResponseChannelKafkaBinding)
+ ))
+ .tags(listOf(Tag.builder().name("costing").build()))
+ .messages(mapOf(
+ Pair("costingResponse", Reference("#/components/messages/costingResponse"))
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedOperations(): Map {
+ val receiveACostingRequestKafkaBinding = KafkaOperationBinding.builder()
+ .groupId(Schema.builder()
+ .type("string")
+ .description("The groupId must be prefixed by your `svc` account, deliver by the Adeo Kafka team. This `svc` must have the write access to the topic.\n")
+ .build()
+ )
+ .build()
+ receiveACostingRequestKafkaBinding.extensionFields = mapOf(
+ Pair("x-value.subject.name.strategy", mapOf(
+ Pair("type", "string"),
+ Pair("description", "We use the RecordNameStrategy to infer the messages schema. Use `value.subject.name.strategy=io.confluent.kafka.serializers.subject.RecordNameStrategy` in your producer configuration.\n"
+ ),
+ ))
+ )
+
+ return mapOf(
+ Pair("receiveACostingRequest", Operation.builder()
+ .action(OperationAction.RECEIVE)
+ .channel(Reference("#/channels/costingRequestChannel"))
+ .reply(OperationReply.builder()
+ .channel(Reference("#/channels/costingResponseChannel"))
+ .address(OperationReplyAddress(
+ null,
+ "\$message.header#/REPLY_TOPIC"
+ ))
+ .build()
+ )
+ .summary("[COSTING] Request one or more Costing calculation for any product\n")
+ .description("You can try a costing request using our [Conduktor producer template](https://conduktor.url/)\n")
+ .tags(listOf(Tag.builder().name("costing").build()))
+ .bindings(mapOf(
+ Pair("kafka", receiveACostingRequestKafkaBinding)
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components? {
+ val saslSslSecurityScheme = SecurityScheme(
+ SecurityScheme.Type.PLAIN,
+ "Use [SASL authentication with SSL " +
+ "encryption](https://docs.confluent.io/platform/current/security/security_tutorial.html#configure-clients) " +
+ "to connect to the ADEO Broker."
+ )
+ saslSslSecurityScheme.extensionFields = mapOf(
+ Pair("x-sasl.jaas.config", "org.apache.kafka.common.security.plain.PlainLoginModule required " +
+ "username=\"\" password=\"\";"),
+ Pair("x-security.protocol", "SASL_SSL"),
+ Pair("x-ssl.endpoint.identification.algorithm", "https"),
+ Pair("x-sasl.mechanism", "PLAIN")
+ )
+
+ return Components.builder()
+ .correlationIds(mapOf(
+ Pair("costingCorrelationId", CorrelationId(
+ "This correlation ID is used for message tracing and messages " +
+ "correlation. This correlation ID is generated at runtime based on the " +
+ "`REQUEST_ID` and sent to the RESPONSE message.\n",
+ "\$message.header#/REQUEST_ID"
+ ))
+ ))
+ .messages(mapOf(
+ Pair("costingRequestV1", Message.builder()
+ .name("CostingRequestV1")
+ .title("Costing Request V1")
+ .summary("Costing Request V1 inputs.")
+ .tags(listOf(
+ Tag.builder().name("costing").build()
+ ))
+ .correlationId(Reference("#/components/correlationIds/costingCorrelationId"))
+ .headers(Schema.builder()
+ .type("object")
+ .required(listOf(
+ "REQUESTER_ID", "REQUESTER_CODE", "REQUEST_ID", "REPLY_TOPIC"
+ ))
+ .properties(mapOf(
+ Pair("REQUEST_ID", Schema.builder().ref("#/components/schemas/RequestId").build()),
+ Pair("REPLY_TOPIC", Schema.builder().ref("#/components/schemas/ReplyTopic").build()),
+ Pair("REQUESTER_ID", Schema.builder().ref("#/components/schemas/RequesterId").build()),
+ Pair("REQUESTER_CODE", Schema.builder().ref("#/components/schemas/RequesterCode").build()),
+ ))
+ .build()
+ )
+ .payload(MultiFormatSchema(
+ "application/vnd.apache.avro;version=1.9.0",
+ mapOf(Pair("\$ref", "https://www.asyncapi.com/resources/casestudies/adeo/CostingRequestPayload.avsc"))
+ ))
+ .build()
+ ),
+ Pair("costingResponse", Message.builder()
+ .name("CostingResponse")
+ .title("Costing Response")
+ .summary("Costing Response ouputs.")
+ .description("Please refer to the `CostingResponseKey.avsc` schema, available on [our " +
+ "github project](https://github.url/).\n")
+ .tags(listOf(
+ Tag.builder().name("costing").build()
+ ))
+ .correlationId(Reference("#/components/correlationIds/costingCorrelationId"))
+ .headers(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("CALCULATION_ID", Schema.builder().ref("#/components/schemas/MessageId").build()),
+ Pair("CORRELATION_ID", Schema.builder().ref("#/components/schemas/CorrelationId").build()),
+ Pair("REQUEST_TIMESTAMP", Schema.builder()
+ .type("string")
+ .format("date-time")
+ .description("Timestamp of the costing request")
+ .build()
+ ),
+ Pair("CALCULATION_TIMESTAMP", Schema.builder()
+ .type("string")
+ .format("date-time")
+ .description("Technical timestamp for the costing calculation")
+ .build()
+ ),
+ ))
+ .build()
+ )
+ .payload(MultiFormatSchema(
+ "application/vnd.apache.avro;version=1.9.0",
+ mapOf(Pair("\$ref", "https://www.asyncapi.com/resources/casestudies/adeo/CostingResponsePayload.avsc"))
+ ))
+ .build()
+ )
+ ))
+ .schemas(mapOf(
+ Pair("RequesterId", Schema.builder()
+ .type("string")
+ .description("The Costing requester service account used to produce costing request.")
+ .examples(listOf("svc-ecollect-app"))
+ .build()
+ ),
+ Pair("RequesterCode", Schema.builder()
+ .type("string")
+ .description("The Costing requester code (generally the BU Code). The requester code is useful to get the dedicated context (tenant).")
+ .examples(listOf(1))
+ .build()
+ ),
+ Pair("MessageId", Schema.builder()
+ .type("string")
+ .format("uuid")
+ .description("A unique Message ID.")
+ .examples(listOf("1fa6ef40-8f47-40a8-8cf6-f8607d0066ef"))
+ .build()
+ ),
+ Pair("RequestId", Schema.builder()
+ .type("string")
+ .format("uuid")
+ .description("A unique Request ID needed to define a `CORRELATION_ID` for exchanges, " +
+ "which will be sent back in the Costing Responses.")
+ .examples(listOf("1fa6ef40-8f47-40a8-8cf6-f8607d0066ef"))
+ .build()
+ ),
+ Pair("CorrelationId", Schema.builder()
+ .type("string")
+ .format("uuid")
+ .description("A unique Correlation ID defined from the `REQUEST_ID` or the " +
+ "`MESSAGE_ID` provided in the Costing Request.")
+ .examples(listOf("1fa6ef40-8f47-40a8-8cf6-f8607d0066ef"))
+ .build()
+ ),
+ Pair("BuCode", Schema.builder()
+ .type("string")
+ .description("The Business Unit code for which data are applicable.")
+ .examples(listOf(1))
+ .build()
+ ),
+ Pair("ReplyTopic", Schema.builder()
+ .type("string")
+ .description("The Kafka topic where to send the Costing Response. This is required for " +
+ "the [Return Address EIP " +
+ "pattern](https://www.enterpriseintegrationpatterns.com/patterns/messaging/ReturnAddress.html). " +
+ "**You must grant WRITE access to our `svc-ccr-app` service account.**\n")
+ .examples(listOf("adeo-case-study-COSTING-RESPONSE-V1"))
+ .build()
+ ),
+ Pair("ErrorStep", Schema.builder()
+ .type("string")
+ .description("The woker that has thrown the error.\n")
+ .examples(listOf("EXPOSE_RESULT"))
+ .build()
+ ),
+ Pair("ErrorMessage", Schema.builder()
+ .type("string")
+ .description("The error message describing the error.\n")
+ .examples(listOf("Error message"))
+ .build()
+ ),
+ Pair("ErrorCode", Schema.builder()
+ .type("string")
+ .description("The error code.\n")
+ .examples(listOf("CURRENCY_NOT_FOUND"))
+ .build()
+ )
+ ))
+ .parameters(mapOf(
+ Pair("Env", Parameter.builder()
+ .description("Adeo Kafka Environement for messages publications.")
+ .enumValues(listOf(
+ "dev", "sit", "uat1", "preprod", "prod"
+ ))
+ .build()
+ ),
+ Pair("Version", Parameter.builder()
+ .description("the topic version you want to use")
+ .examples(listOf("V1"))
+ .defaultValue("V1")
+ .build()
+ )
+ ))
+ .securitySchemes(mapOf(
+ Pair("sasl-ssl", saslSslSecurityScheme)
+ ))
+ .build()
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/AnyOfAsyncAPI.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/AnyOfAsyncAPI.kt
new file mode 100644
index 00000000..1e1219b1
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/AnyOfAsyncAPI.kt
@@ -0,0 +1,93 @@
+package com.asyncapi.examples.v3._0_0
+
+import com.asyncapi.v3.Reference
+import com.asyncapi.v3._0_0.model.channel.Channel
+import com.asyncapi.v3._0_0.model.channel.message.Message
+import com.asyncapi.v3._0_0.model.component.Components
+import com.asyncapi.v3._0_0.model.info.Info
+import com.asyncapi.v3._0_0.model.operation.Operation
+import com.asyncapi.v3._0_0.model.operation.OperationAction
+import com.asyncapi.v3.schema.Schema
+
+class AnyOfAsyncAPI: AbstractExampleValidationTest() {
+ override fun specificationLocation(): String = "/examples/v3.0.0/anyof-asyncapi.yml"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("AnyOf example")
+ .version("1.0.0")
+ .build()
+ }
+
+ override fun expectedServers(): Map = emptyMap()
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("test",
+ Channel.builder()
+ .address("test")
+ .messages(mapOf(
+ Pair("testMessages", Reference("#/components/messages/testMessages"))
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedOperations(): Map {
+ return mapOf(
+ Pair("test",
+ Operation.builder()
+ .action(OperationAction.RECEIVE)
+ .channel(Reference("#/channels/test"))
+ .messages(listOf(Reference("#/channels/test/messages/testMessages")))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components {
+ return Components.builder()
+ .messages(mapOf(
+ Pair("testMessages",
+ Message.builder()
+ .payload(Schema.builder()
+ .anyOf(listOf(
+ Schema.builder().ref("#/components/schemas/objectWithKey").build(),
+ Schema.builder().ref("#/components/schemas/objectWithKey2").build()
+ ))
+ .build()
+ )
+ .build()
+ )
+ ))
+ .schemas(mapOf(
+ Pair("objectWithKey",
+ Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("key",
+ Schema.builder()
+ .type("string")
+ .additionalProperties(false)
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("objectWithKey2",
+ Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("key2",
+ Schema.builder()
+ .type("string")
+ .build()
+ )
+ ))
+ .build()
+ )
+ ))
+ .build()
+ }
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/ApplicationHeadersAsyncAPI.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/ApplicationHeadersAsyncAPI.kt
new file mode 100644
index 00000000..e5f37000
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/ApplicationHeadersAsyncAPI.kt
@@ -0,0 +1,162 @@
+package com.asyncapi.examples.v3._0_0
+
+import com.asyncapi.v3.Reference
+import com.asyncapi.v3._0_0.model.channel.Channel
+import com.asyncapi.v3._0_0.model.channel.Parameter
+import com.asyncapi.v3._0_0.model.channel.message.CorrelationId
+import com.asyncapi.v3._0_0.model.channel.message.Message
+import com.asyncapi.v3._0_0.model.component.Components
+import com.asyncapi.v3._0_0.model.info.Info
+import com.asyncapi.v3._0_0.model.info.License
+import com.asyncapi.v3._0_0.model.operation.Operation
+import com.asyncapi.v3._0_0.model.operation.OperationAction
+import com.asyncapi.v3._0_0.model.server.Server
+import com.asyncapi.v3._0_0.model.server.ServerVariable
+import com.asyncapi.v3.schema.Schema
+import java.math.BigDecimal
+
+class ApplicationHeadersAsyncAPI: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v3.0.0/application-headers-asyncapi.yml"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("Application Headers example")
+ .version("1.0.0")
+ .description("A cut of the Streetlights API to test application header changes supporting")
+ .license(License(
+ "Apache 2.0",
+ "https://www.apache.org/licenses/LICENSE-2.0"
+ ))
+ .build()
+ }
+
+ override fun expectedDefaultContentType(): String = "application/json"
+
+ override fun expectedServers(): Map {
+ return mapOf(
+ Pair("production",
+ Server.builder()
+ .host("test.mosquitto.org:{port}")
+ .protocol("mqtt")
+ .description("Test broker")
+ .variables(mapOf(
+ Pair("port",
+ ServerVariable.builder()
+ .description("Secure connection (TLS) is available through port 8883.")
+ .defaultValue("1883")
+ .enumValues(listOf("1883", "8883"))
+ .build()
+ )
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("lightingMeasured",
+ Channel.builder()
+ .address("smartylighting/streetlights/1/0/event/{streetlightId}/lighting/measured")
+ .messages(mapOf(
+ Pair("lightMeasured", Reference("#/components/messages/lightMeasured"))
+ ))
+ .parameters(mapOf(
+ Pair("streetlightId", Reference("#/components/parameters/streetlightId"))
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedOperations(): Map {
+ return mapOf(
+ Pair("receiveLightMeasurement",
+ Operation.builder()
+ .action(OperationAction.RECEIVE)
+ .channel(Reference("#/channels/lightingMeasured"))
+ .summary("Inform about environmental lighting conditions of a particular streetlight.")
+ .messages(listOf(
+ Reference("#/channels/lightingMeasured/messages/lightMeasured")
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components {
+ return Components.builder()
+ .messages(mapOf(
+ Pair("lightMeasured",
+ Message.builder()
+ .name("lightMeasured")
+ .title("Light measured")
+ .summary("Inform about environmental lighting conditions of a particular streetlight.")
+ .correlationId(CorrelationId(null, "\$message.header#/MQMD/CorrelId"))
+ .contentType("application/json")
+ .headers(Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("MQMD", Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("CorrelId", Schema.builder()
+ .type("string")
+ .minLength(24)
+ .maxLength(24)
+ .format("binary")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("applicationInstanceId", Schema.builder().ref("#/components/schemas/applicationInstanceId").build())
+ ))
+ .build()
+ )
+ .payload(Reference("#/components/schemas/lightMeasuredPayload"))
+ .build()
+ )
+ ))
+ .schemas(mapOf(
+ Pair("lightMeasuredPayload",
+ Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("lumens",
+ Schema.builder()
+ .type("integer")
+ .minimum(BigDecimal.ZERO)
+ .description("Light intensity measured in lumens.")
+ .build()
+ ),
+ Pair("sentAt", Schema.builder().ref("#/components/schemas/sentAt").build())
+ ))
+ .build()
+ ),
+ Pair("sentAt",
+ Schema.builder()
+ .type("string")
+ .format("date-time")
+ .description("Date and time when the message was sent.")
+ .build()
+ ),
+ Pair("applicationInstanceId",
+ Schema.builder()
+ .type("string")
+ .description("Unique identifier for a given instance of the publishing application")
+ .build()
+ )
+ ))
+ .parameters(mapOf(
+ Pair("streetlightId",
+ Parameter.builder()
+ .description("The ID of the streetlight.")
+ .build()
+ )
+ ))
+ .build()
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/CorrelationIdAsyncAPI.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/CorrelationIdAsyncAPI.kt
new file mode 100644
index 00000000..50249128
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/CorrelationIdAsyncAPI.kt
@@ -0,0 +1,304 @@
+package com.asyncapi.examples.v3._0_0
+
+import com.asyncapi.v3.security_scheme.ApiKeySecurityScheme
+import com.asyncapi.v3.Reference
+import com.asyncapi.v3._0_0.model.channel.Channel
+import com.asyncapi.v3._0_0.model.channel.Parameter
+import com.asyncapi.v3._0_0.model.channel.message.CorrelationId
+import com.asyncapi.v3._0_0.model.channel.message.Message
+import com.asyncapi.v3._0_0.model.component.Components
+import com.asyncapi.v3._0_0.model.info.Info
+import com.asyncapi.v3._0_0.model.info.License
+import com.asyncapi.v3._0_0.model.operation.Operation
+import com.asyncapi.v3._0_0.model.operation.OperationAction
+import com.asyncapi.v3._0_0.model.server.Server
+import com.asyncapi.v3._0_0.model.server.ServerVariable
+import com.asyncapi.v3.schema.Schema
+import com.asyncapi.v3.security_scheme.OpenIdConnectSecurityScheme
+import com.asyncapi.v3.security_scheme.oauth2.OAuth2SecurityScheme
+import com.asyncapi.v3.security_scheme.oauth2.OAuthFlows
+import com.asyncapi.v3.security_scheme.oauth2.flow.AuthorizationCodeOAuthFlow
+import com.asyncapi.v3.security_scheme.oauth2.flow.ClientCredentialsOAuthFlow
+import com.asyncapi.v3.security_scheme.oauth2.flow.ImplicitOAuthFlow
+import com.asyncapi.v3.security_scheme.oauth2.flow.PasswordOAuthFlow
+import java.math.BigDecimal
+
+class CorrelationIdAsyncAPI: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v3.0.0/correlation-id-asyncapi.yml"
+
+ override fun expectedDefaultContentType(): String = "application/json"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("Correlation ID Example")
+ .version("1.0.0")
+ .description("A cut of the Streetlights API to test Correlation ID")
+ .license(License("Apache 2.0", "https://www.apache.org/licenses/LICENSE-2.0"))
+ .build()
+ }
+
+ override fun expectedServers(): Map {
+ return mapOf(
+ Pair("production",
+ Server.builder()
+ .host("test.mosquitto.org:{port}")
+ .protocol("mqtt")
+ .description("Test broker")
+ .variables(mapOf(
+ Pair("port",
+ ServerVariable(
+ listOf("1883", "8883"),
+ "1883",
+ "Secure connection (TLS) is available through port 8883.",
+ null
+ )
+ )
+ ))
+ .security(listOf(
+ Reference("#/components/securitySchemes/apiKey"),
+ OAuth2SecurityScheme(
+ "Flows to support OAuth 2.0",
+ OAuthFlows(
+ ImplicitOAuthFlow(
+ "",
+ mapOf(
+ Pair("streetlights:on", "Ability to switch lights on"),
+ Pair("streetlights:off", "Ability to switch lights off"),
+ Pair("streetlights:dim", "Ability to dim the lights"),
+ ),
+ "https://authserver.example/auth"
+ ),
+ PasswordOAuthFlow(
+ "",
+ mapOf(
+ Pair("streetlights:on", "Ability to switch lights on"),
+ Pair("streetlights:off", "Ability to switch lights off"),
+ Pair("streetlights:dim", "Ability to dim the lights"),
+ ),
+ "https://authserver.example/token"
+ ),
+ ClientCredentialsOAuthFlow(
+ "",
+ mapOf(
+ Pair("streetlights:on", "Ability to switch lights on"),
+ Pair("streetlights:off", "Ability to switch lights off"),
+ Pair("streetlights:dim", "Ability to dim the lights"),
+ ),
+ "https://authserver.example/token"
+ ),
+ AuthorizationCodeOAuthFlow(
+ "https://authserver.example/refresh",
+ mapOf(
+ Pair("streetlights:on", "Ability to switch lights on"),
+ Pair("streetlights:off", "Ability to switch lights off"),
+ Pair("streetlights:dim", "Ability to dim the lights"),
+ ),
+ "https://authserver.example/auth",
+ "https://authserver.example/token"
+ )
+ ),
+ listOf(
+ "streetlights:on",
+ "streetlights:off",
+ "streetlights:dim",
+ ),
+ ),
+ Reference("#/components/securitySchemes/openIdConnectWellKnown"),
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedChannels(): Map {
+ return mapOf(
+ Pair("lightingMeasured",
+ Channel.builder()
+ .address("smartylighting/streetlights/1/0/event/{streetlightId}/lighting/measured")
+ .messages(mapOf(
+ Pair("lightMeasured", Reference("#/components/messages/lightMeasured"))
+ ))
+ .parameters(mapOf(
+ Pair("streetlightId", Reference("#/components/parameters/streetlightId"))
+ ))
+ .build()
+ ),
+ Pair("lightsDim",
+ Channel.builder()
+ .address("smartylighting/streetlights/1/0/action/{streetlightId}/dim")
+ .messages(mapOf(
+ Pair("dimLight", Reference("#/components/messages/dimLight"))
+ ))
+ .parameters(mapOf(
+ Pair("streetlightId", Reference("#/components/parameters/streetlightId"))
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedOperations(): Map {
+ return mapOf(
+ Pair("receiveLightMeasurement",
+ Operation.builder()
+ .action(OperationAction.RECEIVE)
+ .channel(Reference("#/channels/lightingMeasured"))
+ .summary("Inform about environmental lighting conditions of a particular streetlight.")
+ .messages(listOf(
+ Reference("#/channels/lightingMeasured/messages/lightMeasured")
+ ))
+ .build()
+ ),
+ Pair("dimLight",
+ Operation.builder()
+ .action(OperationAction.SEND)
+ .channel(Reference("#/channels/lightsDim"))
+ .messages(listOf(
+ Reference("#/channels/lightsDim/messages/dimLight")
+ ))
+ .build()
+ )
+ )
+ }
+
+ override fun expectedComponents(): Components? {
+ return Components.builder()
+ .messages(mapOf(
+ Pair("lightMeasured",
+ Message.builder()
+ .name("lightMeasured")
+ .title("Light measured")
+ .summary("Inform about environmental lighting conditions of a particular streetlight.")
+ .correlationId(CorrelationId(null, "\$message.header#/MQMD/CorrelId"))
+ .contentType("application/json")
+ .payload(Reference("#/components/schemas/lightMeasuredPayload"))
+ .build()
+ ),
+ Pair("dimLight",
+ Message.builder()
+ .name("dimLight")
+ .title("Dim light")
+ .summary("Command a particular streetlight to dim the lights.")
+ .correlationId(Reference("#/components/correlationIds/sentAtCorrelator"))
+ .payload(Reference("#/components/schemas/dimLightPayload"))
+ .build()
+ )
+ ))
+ .schemas(mapOf(
+ Pair("lightMeasuredPayload",
+ Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("lumens",
+ Schema.builder()
+ .type("integer")
+ .minimum(BigDecimal.ZERO)
+ .description("Light intensity measured in lumens.")
+ .build()
+ ),
+ Pair("sentAt",
+ Schema.builder()
+ .ref("#/components/schemas/sentAt")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("dimLightPayload",
+ Schema.builder()
+ .type("object")
+ .properties(mapOf(
+ Pair("percentage",
+ Schema.builder()
+ .type("integer")
+ .minimum(BigDecimal.ZERO)
+ .maximum(BigDecimal.valueOf(100))
+ .description("Percentage to which the light should be dimmed to.")
+ .build()
+ ),
+ Pair("sentAt",
+ Schema.builder()
+ .ref("#/components/schemas/sentAt")
+ .build()
+ )
+ ))
+ .build()
+ ),
+ Pair("sentAt",
+ Schema.builder()
+ .type("string")
+ .format("date-time")
+ .description("Date and time when the message was sent.")
+ .build()
+ )
+ ))
+ .parameters(mapOf(
+ Pair("streetlightId", Parameter.builder().description("The ID of the streetlight.").build())
+ ))
+ .correlationIds(mapOf(
+ Pair("sentAtCorrelator",
+ CorrelationId(
+ "Data from message payload used as correlation ID",
+ "\$message.payload#/sentAt"
+ )
+ )
+ ))
+ .securitySchemes(mapOf(
+ Pair("apiKey", ApiKeySecurityScheme(
+ "Provide your API key as the user and leave the password empty.",
+ ApiKeySecurityScheme.ApiKeyLocation.USER
+ )),
+ Pair("supportedOauthFlows", OAuth2SecurityScheme(
+ "Flows to support OAuth 2.0",
+ OAuthFlows(
+ ImplicitOAuthFlow(
+ "",
+ mapOf(
+ Pair("streetlights:on", "Ability to switch lights on"),
+ Pair("streetlights:off", "Ability to switch lights off"),
+ Pair("streetlights:dim", "Ability to dim the lights"),
+ ),
+ "https://authserver.example/auth"
+ ),
+ PasswordOAuthFlow(
+ "",
+ mapOf(
+ Pair("streetlights:on", "Ability to switch lights on"),
+ Pair("streetlights:off", "Ability to switch lights off"),
+ Pair("streetlights:dim", "Ability to dim the lights"),
+ ),
+ "https://authserver.example/token"
+ ),
+ ClientCredentialsOAuthFlow(
+ "",
+ mapOf(
+ Pair("streetlights:on", "Ability to switch lights on"),
+ Pair("streetlights:off", "Ability to switch lights off"),
+ Pair("streetlights:dim", "Ability to dim the lights"),
+ ),
+ "https://authserver.example/token"
+ ),
+ AuthorizationCodeOAuthFlow(
+ "https://authserver.example/refresh",
+ mapOf(
+ Pair("streetlights:on", "Ability to switch lights on"),
+ Pair("streetlights:off", "Ability to switch lights off"),
+ Pair("streetlights:dim", "Ability to dim the lights"),
+ ),
+ "https://authserver.example/auth",
+ "https://authserver.example/token"
+ )
+ ),
+ null
+ )),
+ Pair("openIdConnectWellKnown", OpenIdConnectSecurityScheme(
+ null,
+ "https://authserver.example/.well-known",
+ null
+ )),
+ ))
+ .build()
+ }
+
+}
\ No newline at end of file
diff --git a/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/GitterStreamingAsyncAPI.kt b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/GitterStreamingAsyncAPI.kt
new file mode 100644
index 00000000..f460e9dc
--- /dev/null
+++ b/asyncapi-core/src/test/kotlin/com/asyncapi/examples/v3/_0_0/GitterStreamingAsyncAPI.kt
@@ -0,0 +1,285 @@
+package com.asyncapi.examples.v3._0_0
+
+import com.asyncapi.v3.binding.message.http.HTTPMessageBinding
+import com.asyncapi.v3.Reference
+import com.asyncapi.v3._0_0.model.channel.Channel
+import com.asyncapi.v3._0_0.model.channel.Parameter
+import com.asyncapi.v3._0_0.model.channel.message.Message
+import com.asyncapi.v3._0_0.model.component.Components
+import com.asyncapi.v3._0_0.model.info.Info
+import com.asyncapi.v3._0_0.model.operation.Operation
+import com.asyncapi.v3._0_0.model.operation.OperationAction
+import com.asyncapi.v3._0_0.model.server.Server
+import com.asyncapi.v3.binding.operation.http.HTTPOperationBinding
+import com.asyncapi.v3.binding.operation.http.HTTPOperationMethod
+import com.asyncapi.v3.schema.MultiFormatSchema
+import com.asyncapi.v3.schema.Schema
+import com.asyncapi.v3.security_scheme.http.HttpSecurityScheme
+
+class GitterStreamingAsyncAPI: AbstractExampleValidationTest() {
+
+ override fun specificationLocation(): String = "/examples/v3.0.0/gitter-streaming-asyncapi.yml"
+
+ override fun expectedId(): String = "tag:stream.gitter.im,2022:api"
+
+ override fun expectedInfo(): Info {
+ return Info.builder()
+ .title("Gitter Streaming API")
+ .version("1.0.0")
+ .build()
+ }
+
+ override fun expectedServers(): Map