{"id":13807103,"url":"https://github.com/cloudevents/sdk-java","last_synced_at":"2025-05-13T19:02:38.603Z","repository":{"id":33246372,"uuid":"149663208","full_name":"cloudevents/sdk-java","owner":"cloudevents","description":"Java SDK for CloudEvents","archived":false,"fork":false,"pushed_at":"2025-04-22T04:47:22.000Z","size":2157,"stargazers_count":411,"open_issues_count":58,"forks_count":160,"subscribers_count":21,"default_branch":"main","last_synced_at":"2025-04-27T08:36:14.953Z","etag":null,"topics":["cloudevents","hacktoberfest","java-api","kafka","sdk-java"],"latest_commit_sha":null,"homepage":"https://cloudevents.github.io/sdk-java/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudevents.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-09-20T19:56:36.000Z","updated_at":"2025-04-23T11:16:15.000Z","dependencies_parsed_at":"2023-02-17T12:15:21.665Z","dependency_job_id":"e6bd613b-c080-4bf2-8452-3d89639bb4cb","html_url":"https://github.com/cloudevents/sdk-java","commit_stats":{"total_commits":751,"total_committers":68,"mean_commits":"11.044117647058824","dds":0.4873501997336884,"last_synced_commit":"188c3c70859d192986818c6226c958dd7bd5cad0"},"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudevents%2Fsdk-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudevents%2Fsdk-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudevents%2Fsdk-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudevents%2Fsdk-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudevents","download_url":"https://codeload.github.com/cloudevents/sdk-java/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254010790,"owners_count":21998993,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloudevents","hacktoberfest","java-api","kafka","sdk-java"],"created_at":"2024-08-04T01:01:20.855Z","updated_at":"2025-05-13T19:02:38.551Z","avatar_url":"https://github.com/cloudevents.png","language":"Java","funding_links":[],"categories":["微服务库","Integration"],"sub_categories":[],"readme":"# Java SDK for CloudEvents API\n\n[![License](https://img.shields.io/:license-Apache2-blue.svg)](http://www.apache.org/licenses/LICENSE-2.0)\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/io.cloudevents/cloudevents-parent/badge.svg)](https://maven-badges.herokuapp.com/maven-central/io.cloudevents/cloudevents-parent)\n[![Javadocs](http://www.javadoc.io/badge/io.cloudevents/cloudevents-core.svg?color=green)](http://www.javadoc.io/doc/io.cloudevents/cloudevents-core)\n\nThe Java SDK for CloudEvents is a collection of Java packages to adopt\n[CloudEvents](https://github.com/cloudevents/spec) in your Java application.\n\nUsing the Java SDK you can:\n\n-   Access, create and manipulate `CloudEvent` inside your application.\n-   Serialize and deserialize `CloudEvent` back and forth using the _CloudEvents\n    Event Format_, like Json.\n-   Read and write `CloudEvent` back and forth to HTTP, Kafka, AMQP using the\n    _CloudEvents Protocol Binding_ implementations we provide for a wide range\n    of well known Java frameworks/libraries.\n\nTo check out the complete documentation and how to get started, look at the dedicated website\nhttps://cloudevents.github.io/sdk-java/.\n\n## Status\n\nThis SDK is considered **work in progress**. The community is working hard to\nbring you a new major version of the SDK with major enhancements both to APIs\nand to implementation.\n\nIf you want to know more about v1 of this SDK, check out the\n[v1 readme](https://github.com/cloudevents/sdk-java/tree/1.x)\n\nStay tuned!\n\nSupported features of the specification:\n\n|                                         | [v0.3](https://github.com/cloudevents/spec/tree/v0.3) | [v1.0](https://github.com/cloudevents/spec/tree/v1.0) |\n| :-------------------------------------: | :---------------------------------------------------: | :---------------------------------------------------: |\n|            CloudEvents Core             |                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n|          AMQP Protocol Binding          |                          :x:                          |                          :x:                          |\n|            - [Proton](amqp)             |                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n|            AVRO Event Format            |                          :x:                          |                          :x:                          |\n|          HTTP Protocol Binding          |                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n|         - [Vert.x](http/vertx)          |                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n| - [Jakarta Restful WS](http/restful-ws) |                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n|          - [Basic](http/basic)          |                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n|           - [Spring](spring)            |                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n|           - [http4k][http4k]\u003csup\u003e†\u003c/sup\u003e|                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n|            JSON Event Format            |                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n|    - [Jackson](formats/json-jackson)    |                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n|            Protobuf Event Format        |                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n|            - [Proto](formats/protobuf)  |                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n|     [Kafka Protocol Binding](kafka)     |                  :heavy_check_mark:                   |                  :heavy_check_mark:                   |\n|          MQTT Protocol Binding          |                          :x:                          |                          :x:                          |\n|          NATS Protocol Binding          |                          :x:                          |                          :x:                          |\n|                Web hook                 |                          :x:                          |                          :x:                          |\n\n\u003csub\u003e† Source/artifacts hosted externally\u003c/sub\u003e\n\n## Documentation\n\nDocumentation is available at https://cloudevents.github.io/sdk-java/.\n\nJavadocs are available on [javadoc.io](https://www.javadoc.io):\n\n-   [cloudevents-api](https://www.javadoc.io/doc/io.cloudevents/cloudevents-api)\n-   [cloudevents-core](https://www.javadoc.io/doc/io.cloudevents/cloudevents-core)\n-   [cloudevents-avro-compact](https://www.javadoc.io/doc/io.cloudevents/cloudevents-avro-compact)\n-   [cloudevents-json-jackson](https://www.javadoc.io/doc/io.cloudevents/cloudevents-json-jackson)\n-   [cloudevents-protobuf](https://www.javadoc.io/doc/io.cloudevents/cloudevents-protobuf)\n-   [cloudevents-xml](https://www.javadoc.io/doc/io.cloudevents/cloudevents-xml)\n-   [cloudevents-http-basic](https://www.javadoc.io/doc/io.cloudevents/cloudevents-http-basic)\n-   [cloudevents-http-restful-ws](https://www.javadoc.io/doc/io.cloudevents/cloudevents-http-restful-ws)\n-   [cloudevents-http-vertx](https://www.javadoc.io/doc/io.cloudevents/cloudevents-http-vertx)\n-   [cloudevents-kafka](https://www.javadoc.io/doc/io.cloudevents/cloudevents-kafka)\n-   [cloudevents-amqp](https://www.javadoc.io/doc/io.cloudevents/cloudevents-amqp)\n-   [cloudevents-spring](https://www.javadoc.io/doc/io.cloudevents/cloudevents-spring)\n\nYou can check out the examples in the [examples](examples) directory.\n\n## Used By\n\n| [Occurrent](https://occurrent.org) | [Knative Eventing](https://github.com/knative-sandbox/eventing-kafka-broker )| [http4k][http4k] |\n| ---------------------------------- | ---------------------------------------------------------------------------- | ---------------|\n| \u003ca href=\"https://occurrent.org\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/johanhaleby/occurrent/master/occurrent-logo-196x196.png\" width=\"98\" height=\"98\" alt=\"Occurrent\" title=\"Occurrent - Event Sourcing Utilities for the JVM\"\u003e\u003c/img\u003e\u003c/a\u003e | \u003ca href=\"https://github.com/knative-sandbox/eventing-kafka-broker\"\u003e\u003cimg src=\"https://cloudevents.io/img/logos/integrations/knative.png\" height=\"98\"\u003e\u003c/img\u003e\u003c/a\u003e | \u003ca href=\"https://www.http4k.org/guide/modules/cloud_events/\"\u003e\u003cimg src=\"https://http4k.org/img/favicon-310.png\" height=\"98\" alt=\"http4k\" title=\"http4k\"\u003e\u003c/img\u003e\u003c/a\u003e | |\n\n## Community\n\n-   There are bi-weekly calls immediately following the\n    [Serverless/CloudEvents call](https://github.com/cloudevents/spec#meeting-time)\n    at 9am PT (US Pacific). Which means they will typically start at 10am PT,\n    but if the other call ends early then the SDK call will start early as well.\n    See the\n    [CloudEvents meeting minutes](https://docs.google.com/document/d/1OVF68rpuPK5shIHILK9JOqlZBbfe91RNzQ7u_P7YCDE/edit#)\n    to determine which week will have the call.\n-   Slack: #cloudeventssdk channel under\n    [CNCF's Slack workspace](https://slack.cncf.io/).\n-   Email: https://lists.cncf.io/g/cncf-cloudevents-sdk\n-   Contact for additional information: Francesco Guardiani (`@slinkydeveloper`\n    on slack), Fabio José (`@fabiojose` on slack).\n\nEach SDK may have its own unique processes, tooling and guidelines, common\ngovernance related material can be found in the\n[CloudEvents `community`](https://github.com/cloudevents/spec/tree/main/docs)\ndirectory. In particular, in there you will find information concerning how SDK\nprojects are\n[managed](https://github.com/cloudevents/spec/blob/main/docs/SDK-GOVERNANCE.md),\n[guidelines](https://github.com/cloudevents/spec/blob/main/docs/SDK-maintainer-guidelines.md)\nfor how PR reviews and approval, and our\n[Code of Conduct](https://github.com/cloudevents/spec/blob/main/docs/GOVERNANCE.md#additional-information)\ninformation.\n\nIf there is a security concern with one of the CloudEvents specifications, or\nwith one of the project's SDKs, please send an email to\n[cncf-cloudevents-security@lists.cncf.io](mailto:cncf-cloudevents-security@lists.cncf.io).\n\n## Additional SDK Resources\n\n- [List of current active maintainers](MAINTAINERS.md)\n- [How to contribute to the project](CONTRIBUTING.md)\n- [SDK's License](LICENSE)\n- [SDK's Release process](RELEASING.md)\n- [SDK Maintainer's guide](MAINTAINERS_GUIDE.md)\n\n[http4k]: https://www.http4k.org/guide/reference/cloud_events/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudevents%2Fsdk-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudevents%2Fsdk-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudevents%2Fsdk-java/lists"}