https://github.com/fireflyframework/fireflyframework-eda
Event-Driven Architecture library with Kafka and RabbitMQ publishers/consumers, dead-letter queues, event filtering, and Protobuf serialization.
https://github.com/fireflyframework/fireflyframework-eda
Last synced: 4 months ago
JSON representation
Event-Driven Architecture library with Kafka and RabbitMQ publishers/consumers, dead-letter queues, event filtering, and Protobuf serialization.
- Host: GitHub
- URL: https://github.com/fireflyframework/fireflyframework-eda
- Owner: fireflyframework
- License: apache-2.0
- Created: 2026-02-06T12:33:08.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-10T19:47:40.000Z (4 months ago)
- Last Synced: 2026-02-10T20:44:57.786Z (4 months ago)
- Language: Java
- Size: 359 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Firefly Framework - Event-Driven Architecture (EDA)
[](https://github.com/fireflyframework/fireflyframework-eda/actions/workflows/ci.yml)
[](LICENSE)
[](https://openjdk.org)
[](https://spring.io/projects/spring-boot)
> Unified event-driven architecture library with Kafka, RabbitMQ, and Spring Application Events support.
---
## Table of Contents
- [Overview](#overview)
- [Features](#features)
- [Requirements](#requirements)
- [Installation](#installation)
- [Quick Start](#quick-start)
- [Configuration](#configuration)
- [Documentation](#documentation)
- [Contributing](#contributing)
- [License](#license)
## Overview
Firefly Framework EDA provides a standardized messaging abstraction for event-driven architectures, supporting multiple broker implementations through a unified publisher/consumer API. It enables reactive event publishing and consumption with built-in support for Apache Kafka, RabbitMQ, and Spring Application Events as transport mechanisms.
The library features annotation-driven event publishing (`@EventPublisher`, `@PublishResult`), declarative event listeners (`@EventListener`), and a comprehensive set of event filtering, serialization, and error handling capabilities. It includes support for JSON, Avro, and Protobuf message serialization formats.
The resilient publisher wrapper provides circuit breaker integration, while the dead letter queue handler ensures no events are lost during processing failures. Metrics collection and health indicators provide full observability into the messaging infrastructure.
## Features
- Multi-broker support: Apache Kafka, RabbitMQ, Spring Application Events
- Annotation-driven publishing: `@EventPublisher`, `@PublishResult`
- Declarative event listening: `@EventListener` with SpEL-based filtering
- Event envelope pattern with metadata propagation
- Pluggable serialization: JSON, Avro, Protobuf
- Event filtering: type-based, header-based, destination-based, composite
- Dead letter queue (DLQ) handling for failed messages
- Resilient publisher with circuit breaker support
- Dynamic event listener registration at runtime
- AMQP admin auto-configuration for RabbitMQ exchanges and queues
- Custom error handling strategies with metrics and notification handlers
- Health indicators and metrics for Actuator integration
- Spring Boot auto-configuration for Kafka and RabbitMQ
## Requirements
- Java 21+
- Spring Boot 3.x
- Maven 3.9+
- Apache Kafka or RabbitMQ (depending on chosen broker)
## Installation
```xml
org.fireflyframework
fireflyframework-eda
26.02.06
```
## Quick Start
```java
import org.fireflyframework.eda.annotation.EventPublisher;
import org.fireflyframework.eda.annotation.EventListener;
import org.fireflyframework.eda.event.EventEnvelope;
@Service
public class OrderService {
@EventPublisher(topic = "orders")
public Mono createOrder(OrderRequest request) {
// Business logic - return value is automatically published
return Mono.just(new OrderCreatedEvent(request.getId()));
}
}
@Component
public class OrderEventHandler {
@EventListener(topic = "orders")
public Mono onOrderCreated(EventEnvelope envelope) {
// Handle the event
return processOrder(envelope.getPayload());
}
}
```
## Configuration
```yaml
firefly:
eda:
broker: kafka # kafka, rabbitmq, spring
kafka:
bootstrap-servers: localhost:9092
consumer:
group-id: my-service
rabbitmq:
host: localhost
port: 5672
```
## Documentation
Additional documentation is available in the [docs/](docs/) directory:
- [Quickstart](docs/QUICKSTART.md)
- [Architecture](docs/ARCHITECTURE.md)
- [Configuration](docs/CONFIGURATION.md)
- [Annotations](docs/ANNOTATIONS.md)
- [Api Reference](docs/API_REFERENCE.md)
- [Publisher Types](docs/PUBLISHER_TYPES.md)
- [Dynamic Topic Selection](docs/DYNAMIC_TOPIC_SELECTION.md)
- [Eventlistener Examples](docs/EVENTLISTENER_EXAMPLES.md)
- [Custom Error Handling](docs/CUSTOM_ERROR_HANDLING.md)
- [Examples](docs/EXAMPLES.md)
- [Developer Guide](docs/DEVELOPER_GUIDE.md)
- [Contributing](docs/CONTRIBUTING.md)
## Contributing
Contributions are welcome. Please read the [CONTRIBUTING.md](CONTRIBUTING.md) guide for details on our code of conduct, development process, and how to submit pull requests.
## License
Copyright 2024-2026 Firefly Software Solutions Inc.
Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.