https://github.com/teedjay/quarkus-kafka-reactive
Testing reactive messaging principles using Kafka and Quarkus
https://github.com/teedjay/quarkus-kafka-reactive
Last synced: 20 days ago
JSON representation
Testing reactive messaging principles using Kafka and Quarkus
- Host: GitHub
- URL: https://github.com/teedjay/quarkus-kafka-reactive
- Owner: teedjay
- Created: 2020-11-28T14:28:36.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2020-12-01T22:58:49.000Z (over 5 years ago)
- Last Synced: 2025-01-13T15:53:22.880Z (over 1 year ago)
- Language: Java
- Size: 29.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# quarkus-kafka-reactive project
This project uses [Quarkus](https://quarkus.io/), the Supersonic Subatomic Java Framework.
## Start a local Kafka server
```
docker run -d \
--name kafka26 \
-p 9092:9092 \
-e KAFKA_ADVERTISED_HOST_NAME=localhost \
-e KAFKA_CREATE_TOPICS="test-input:1:8" \
-e KAFKA_CREATE_TOPICS="test-processing:1:8" \
-e KAFKA_CREATE_TOPICS="test-output:1:8" \
blacktop/kafka:2.6
```
## Prerequisite
You need JDK 15 to compile and run this project and you also need to enable preview mode since record are used.
Right now enabling preview mode for compiling and dev mode works out of the box, not need to do anthing specific.
But for some test and some more advanced build processing you might need to set this ENV variable.
```
export _JAVA_OPTIONS="--enable-preview"
```
## Push to Docker Hub
Configured with JIB, will push directly to docker hub
```
./mvnw clean package -Dmaven.test.skip=true -Dquarkus.container-image.push=true
```
## Running the application in dev mode and Java 15 with preview features enabled
You can run your application in dev mode that enables live coding using:
```
export _JAVA_OPTIONS="--enable-preview"
./mvnw quarkus:dev
```
## Testing the application
MessageGenerator will push a new message to `test-input` topic each second.
MessagePusher can be triggered manually to quickly send 9 new messages onto `test-input` topic.
MessageProcessor will read for `test-input` simulate work for random ms (max 1 second) and put onto `test-output`
MessageStreamer will read from `test-input` topic and push to in-memory `sse` channel for MessageSSE to handle.
Here are the different endpoints you can use for test.
```
curl http://localhost:8080/push <== push 9 new messages quickly
curl http://localhost:8080/stream <== connect and stream SSE events
http://localhost:8080/health-ui/
http://localhost:8080/swagger-ui/
http://localhost:8080/metrics/
http://localhost:8080/openapi
```
## Packaging and running the application
The application can be packaged using `./mvnw package`.
It produces the `quarkus-kafka-reactive-1.0-SNAPSHOT-runner.jar` file in the `/target` directory.
Be aware that it’s not an _über-jar_ as the dependencies are copied into the `target/lib` directory.
The application is now runnable using `java -jar target/quarkus-kafka-reactive-1.0-SNAPSHOT-runner.jar`.
## Creating a native executable
You can create a native executable using: `./mvnw package -Pnative`.
Or, if you don't have GraalVM installed, you can run the native executable build in a container using: `./mvnw package -Pnative -Dquarkus.native.container-build=true`.
You can then execute your native executable with: `./target/quarkus-kafka-reactive-1.0-SNAPSHOT-runner`
If you want to learn more about building native executables, please consult https://quarkus.io/guides/building-native-image.