Java SDK for CloudEvents
Go to file
Dave Syer 5099b31f6c
HTTP converters for CloudEvent in Spring (#312)
Supports MVC and WebFlux (blocking and non-blocking) HTTP.
User can work with `CloudEvent` as a `POJO` type and inject it
into `@ReqestMapping` methods.

Signed-off-by: Dave Syer <dsyer@vmware.com>

Co-authored-by: Oleg Zhurakousky <ozhurakousky@pivotal.io>
2020-11-30 11:27:44 +01:00
.github/workflows Release process docs (#248) 2020-09-29 13:35:57 +02:00
.mvn/wrapper Add Maven wrapper (#144) 2020-04-29 18:21:22 +02:00
amqp Bump to 2.0.0-SNAPSHOT (#310) 2020-11-26 16:48:45 +01:00
api Bump to 2.0.0-SNAPSHOT (#310) 2020-11-26 16:48:45 +01:00
benchmarks Bump to 2.0.0-SNAPSHOT (#310) 2020-11-26 16:48:45 +01:00
core Bump to 2.0.0-SNAPSHOT (#310) 2020-11-26 16:48:45 +01:00
docs Update website deps to latest version (#265) 2020-11-13 09:58:52 +01:00
examples Bump to 2.0.0-SNAPSHOT (#310) 2020-11-26 16:48:45 +01:00
formats/json-jackson Bump to 2.0.0-SNAPSHOT (#310) 2020-11-26 16:48:45 +01:00
http Bump to 2.0.0-SNAPSHOT (#310) 2020-11-26 16:48:45 +01:00
kafka Bump to 2.0.0-SNAPSHOT (#310) 2020-11-26 16:48:45 +01:00
spring HTTP converters for CloudEvent in Spring (#312) 2020-11-30 11:27:44 +01:00
.editorconfig Added editorconfig check during the verify phase (#239) 2020-09-28 10:00:21 +02:00
.gitignore Introduce CloudEventContext (#296) 2020-11-23 21:05:26 +01:00
LICENSE Formatted code and added copyright headers (#140) 2020-04-28 13:56:06 +02:00
README.md Examples readme (#298) 2020-11-24 10:17:44 +01:00
maintainer_guidelines.md Release process docs (#248) 2020-09-29 13:35:57 +02:00
mvnw Add Maven wrapper (#144) 2020-04-29 18:21:22 +02:00
mvnw.cmd Add Maven wrapper (#144) 2020-04-29 18:21:22 +02:00
pom.xml HTTP converters for CloudEvent in Spring (#312) 2020-11-30 11:27:44 +01:00
pr_guidelines.md copy guidance from javascript repo (#159) 2020-06-04 15:02:20 +02:00

README.md

Java SDK for CloudEvents API

License Maven Central Javadocs

A Java API for the CloudEvents specification

Look at https://cloudevents.github.io/sdk-java/ for more documentation.

Status

This SDK is considered work in progress. The community is working hard to bring you a new major version of the SDK with major enhancements both to APIs and to implementation.

If you want to know more about v1 of this SDK, check out the v1 readme

Stay tuned!

Supported features of the specification:

v0.3 v1.0
CloudEvents Core ✔️ ✔️
AMQP Protocol Binding
- Proton ✔️ ✔️
AVRO Event Format
HTTP Protocol Binding ✔️ ✔️
- Vert.x ✔️ ✔️
- Jakarta Restful WS ✔️ ✔️
- Basic ✔️ ✔️
JSON Event Format ✔️ ✔️
- Jackson ✔️ ✔️
Kafka Protocol Binding ✔️ ✔️
MQTT Protocol Binding
NATS Protocol Binding
Web hook

Motivation

The CloudEvents specification is a vendor-neutral specification for defining the format of event data that is being exchanged between different cloud systems. The specification basically defines an abstract envelope for any event data payload, without knowing specific implementation details of the actual underlying event. The current version of the spec is at 1.0 and it describes a simple event format, which was demonstrated at KubeCon 2018 using different Serverless platforms, such as Apache Openwhisk.

Documentation

Documentation is available at https://cloudevents.github.io/sdk-java/

Javadocs are available on javadoc.io:

You can check out the examples in the examples directory.

Used By

Occurrent Knative Eventing
Occurrent

Community

Each SDK may have its own unique processes, tooling and guidelines, common governance related material can be found in the CloudEvents community directory. In particular, in there you will find information concerning how SDK projects are managed, guidelines for how PR reviews and approval, and our Code of Conduct information.