Skip to content

cloudevents/sdk-java

Repository files navigation

Java SDK for CloudEvents API

License Maven Central Javadocs

The Java SDK for CloudEvents is a collection of Java packages to adopt CloudEvents in your Java application.

Using the Java SDK you can:

  • Access, create and manipulate CloudEvent inside your application.
  • Serialize and deserialize CloudEvent back and forth using the CloudEvents Event Format, like Json.
  • Read and write CloudEvent back and forth to HTTP, Kafka, AMQP using the CloudEvents Protocol Binding implementations we provide for a wide range of well known Java frameworks/libraries.

To check out the complete documentation and how to get started, look at the dedicated website https://cloudevents.github.io/sdk-java/.

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 ✔️ ✔️
- Spring ✔️ ✔️
- http4k ✔️ ✔️
JSON Event Format ✔️ ✔️
- Jackson ✔️ ✔️
Protobuf Event Format ✔️ ✔️
- Proto ✔️ ✔️
Kafka Protocol Binding ✔️ ✔️
MQTT Protocol Binding
NATS Protocol Binding
Web hook

† Source/artifacts hosted externally

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 http4k
Occurrent http4k

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.

If there is a security concern with one of the CloudEvents specifications, or with one of the project's SDKs, please send an email to cncf-cloudevents-security@lists.cncf.io.

Additional SDK Resources