Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jupiter-tools/spring-test-kafka
Tools for integration testing of Apache Kafka with SpringBoot applications
https://github.com/jupiter-tools/spring-test-kafka
kafka spring-boot spring-boot-test spring-framework spring-kafka test-containers testcontainers
Last synced: about 1 month ago
JSON representation
Tools for integration testing of Apache Kafka with SpringBoot applications
- Host: GitHub
- URL: https://github.com/jupiter-tools/spring-test-kafka
- Owner: jupiter-tools
- License: apache-2.0
- Created: 2019-08-18T11:32:07.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2020-09-01T12:21:06.000Z (about 4 years ago)
- Last Synced: 2024-09-29T00:05:27.953Z (about 2 months ago)
- Topics: kafka, spring-boot, spring-boot-test, spring-framework, spring-kafka, test-containers, testcontainers
- Language: Java
- Homepage: http://jupiter-tools.com
- Size: 500 KB
- Stars: 17
- Watchers: 2
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.adoc
- License: LICENSE.txt
Awesome Lists containing this project
README
:toc: preamble
# Spring Test Kafka
image:https://travis-ci.com/jupiter-tools/spring-test-kafka.svg?branch=master["Build Status", link="https://travis-ci.com/jupiter-tools/spring-test-kafka"]
image:https://codecov.io/gh/jupiter-tools/spring-test-kafka/branch/master/graph/badge.svg["", link="https://codecov.io/gh/jupiter-tools/spring-test-kafka"]
Tools to write integration tests of Spring Framework with the Apache Kafka.
## Overview
image:./images/spring-test-kafka-containers.png[redis container scheme]
## How to write integration tests on Spring Boot with Apache Kafka
Add this library in dependencies:
[source,xml]
----
com.jupiter-tools
spring-test-kafka
0.2
----
Now, you can start Kafka in docker (TestContainers) by the using of `@KafkaTestContainer` annotation in tests:
[source, java]
----
@SpringBootTest
@KafkaTestContainer
class RedisTestContainerTest {
@Autowired
private KafkaTemplate kafkaTemplate;
@Test
void sendAndReceiveTest() throws InterruptedException {
assertThat(kafkaTemplate).isNotNull();
kafkaTemplate.send("test-topic", "flight of a dragon");
...
}
}
----
You can use this annotation to start Kafka container in tests both with JUnit5 and JUnit4.
The implementation doesn't depend on some test framework, just on the Spring Framework.
## How to use multiple Kafka containers in the one test case:
[source, java]
----
@SpringBootTest
@KafkaTestContainer <1>
@KafkaTestContainer(bootstrapServersPropertyName = "second.kafka.server") <2>
class MultipleContainerInOneTest {
...
}
----
<1> start a first Kafka test container and set a bootstrap servers of started container to default Spring Boot properties (`spring.kafka.bootstrap-servers`)
<2> start one more Kafka container and set a bootstrap servers to specified property, exactly in this property you can read an actual value of bootstrap servers after run the application context.
## A better way to test your data in integration tests
You can test received messages after test execution if you use JSON format.
Just describe expected dataset for a test case by the using `@ExpectedDataSet` annotation:
[source, java]
----
@SpringBootTest
@KafkaTestContainer
@EnableKafkaTest(topics = {"test-topic", "another-topic"})
class ExpectedMessagesTest {
@Autowired
private KafkaTemplate kafkaTemplate;
@Test
@ExpectedMessages(topic = "test-topic", datasetFile = "/datasets/expected_event.json")
void firstTopic() {
kafkaTemplate.send("test-topic", new Foo("qwert"));
kafkaTemplate.send("test-topic", new Bar("baaark"));
}
@Test
@ExpectedMessages(topic = "another-topic", datasetFile = "/datasets/expected_another_event.json")
void anotherTopic() {
kafkaTemplate.send("another-topic", Bar.builder().time(new Date()).build());
}
}
class Foo {
String value;
}
class Bar {
String name;
Date time;
}
----
And after test execution, we will wait for messages declared in this JSON file.
The content of JSON dataset file:
[source, json]
----
{
"com.kafkatest.example.events.Foo": [
{
"value": "qwert"
}
],
"com.kafkatest.example.events.Bar": [
{
"name": "baaark"
}
]
}
----
Also, you can use `@NoMessagesExpected` to check the silence on air.
Receiving any messages will fail the test case.
[source, java]
----
@Test
@NoMessagesExpected(timeout = 3000)
void silence() {
}
----
Waits during the timeout for messages in Kafka topics(set in `@EnableKafkaTest`),
if receive something then throws an exception.