sdk-java/api
Francesco Guardiani 394347db07
CloudEventAttributesWriter and CloudEventExtensionsWriter accepts only not nil attributes/extensions (#287)
Signed-off-by: Francesco Guardiani <francescoguard@gmail.com>
2020-11-23 11:28:56 +01:00
..
src CloudEventAttributesWriter and CloudEventExtensionsWriter accepts only not nil attributes/extensions (#287) 2020-11-23 11:28:56 +01:00
README.md Bump to 2.0.0-milestone4 (#254) 2020-11-09 14:06:44 +01:00
pom.xml Bump to 2.0.0-SNAPSHOT (#255) 2020-11-09 14:13:56 +01:00

README.md

CloudEvents API

Javadocs

For Maven based projects, use the following dependency:

<dependency>
    <groupId>io.cloudevents</groupId>
    <artifactId>cloudevents-api</artifactId>
    <version>2.0.0-milestone4</version>
</dependency>

Features

This package provides the base interfaces used by the SDK. In particular:

  • CloudEvent is the main interface representing a read only CloudEvent in-memory representation
  • Extension represents a materialized in-memory representation of a CloudEvent extension
  • SpecVersion is an enum of CloudEvents' specification versions supported by this SDK version.
  • CloudEventVisitor/CloudEventVisitable are the interfaces used by the SDK to implement protocol bindings/event formats. A 3rd party implementer can implement these interfaces directly in its CloudEvent in order to customize/implement efficiently the marshalling/unmarshalling process. These interfaces are optional and, if your CloudEvent doesn't implement it, a default implementation is provided by the SDK.

cloudevents-core provides the implementation of these interfaces, and a 3rd party implementer can grab this package to implement specialized CloudEvent in-memory representations.