Common Kafka

This repository contains common Kafka code supporting Cerner's cloud-based solutions.

For Maven, add the following,

<!-- For client utilities -->
<dependency>
    <groupId>com.cerner.common.kafka</groupId>
    <artifactId>common-kafka</artifactId>
    <version>3.0</version>
</dependency>
<!-- For connect utilities -->
<dependency>
    <groupId>com.cerner.common.kafka</groupId>
    <artifactId>common-kafka-connect</artifactId>
    <version>3.0</version>
</dependency>
<!-- For test utilities -->
<dependency>
    <groupId>com.cerner.common.kafka</groupId>
    <artifactId>common-kafka-test</artifactId>
    <version>3.0</version>
</dependency>

Project Inventory

The following modules are available for use,

common-kafka: Lightweight wrapper for producers and consumers in the kafka-clients library.
common-kafka-connect: Contains Kafka Connect component implementations.
common-kafka-test: Provides infrastructure for integration or "heavy" unit tests that need a running Kafka broker and ZooKeeper service.

Please refer to the project-specific README documentation for content details.

Version Requirements

The 3.0 release of common-kafka uses the following dependency versions.

Kafka: 3.2.0
Metrics: 2.2.0
Scala: 2.13.5

Note that the Scala dependency is only applicable for common-kafka-test.

Upgrading from common-kafka 2.x to 3.0

The common-kafka-admin module has been removed, KafkaAdminClient can be replaced by Kafka's admin client
KafkaBrokerTestHarness has been updated to require TestInfo in the setup method, which requires junit5. By extending AbstractKafkaTests instead of using KafkaBrokerTestHarness directly you can avoid needing to add a junit5 dependency.

Contribute

You are welcome to contribute to Common-Kafka.

Read our Contribution guidelines.

License

Copyright 2017 Cerner Innovation, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

kavvya97 / common-kafka