Arbeiten mit Events

Domänenereignisse

Domänenereignisse stellen wichtige Fakten dar, die im Kontext der Anwendung aufgetreten sind. Sie werden intern im System erzeugt und konsumiert, wodurch Zustandsänderungen entkoppelt propagiert werden können, das heißt, die Objekte müssen sich nicht direkt kennen.

Wann sollte ein Domänenereignis verwendet werden?

• Immer dann, wenn eine Operation eine signifikante Änderung im Domänenmodell erzeugt und es notwendig ist, andere Teile des Systems zu benachrichtigen oder auszulösen.
• Um das Domänenmodell kohärent zu halten und es zu ermöglichen, dass verschiedene Prozesse ausgelöst werden, ohne direkte Abhängigkeiten zwischen Modulen oder Services zu erzeugen.

In Lino ist das Erstellen eines neuen Domänenereignisses einfach. Sie können ausführen:

lino event new

Der CLI-Assistent wird Folgendes abfragen:

• Service – Der Service, in dem das Ereignis erstellt wird.
• Modul – Das Modul, in dem das Ereignis erstellt wird (nur in modularen Services).
• Entität – Die Entität, in der das Ereignis erstellt/assoziiert wird.
• Ereignistyp – Domänenereignis oder Integrationsereignis.
• Ereignisname – Im Domänenkontext verwendeter Name, der mit der Entität verknüpft wird.

Beispiel

Beim Erstellen des Domänenereignisses UserCreated, das mit der Entität User verknüpft ist, erstellt das System automatisch ein Ereignis mit dem Namen UserCreatedDomainEvent. Dieser Name macht für jeden Teil des Systems, der das Ereignis konsumiert, deutlich, dass die Benutzererstellung bereits abgeschlossen ist.

Von Lino generierte Struktur:

MyApp/
└── src/
    └── Services/
        └── MyService/
            └── Domain/
                ├── MyApp.MyService.Domain.csproj
                └── Aggregates/
                    └── Users/
                        ├── User.cs
                        ├── Errors/
                        ├── Events/
                        │   └── UserCreatedDomainEvent.cs
                        ├── Repositories/
                        └── Resources/

Domänen-Ereignis-Handler

Ein Domain Event Handler ist eine Klasse, die dafür verantwortlich ist, auf ein Domänen-Ereignis zu reagieren und Aktionen im Zusammenhang mit dem internen Zustand der Anwendung auszuführen, immer innerhalb desselben Transaktionskontexts.

Der Hauptzweck dieser Handler besteht darin, das System kohärent und entkoppelt zu halten, sodass zusätzliche Regeln angewendet werden können, ohne die zentrale Logik der Entität oder des Aggregats zu überlasten.

Zum Beispiel kann es nach der Erstellung eines User erforderlich sein, Statistiken zu aktualisieren, ein internes Protokoll zu erstellen oder ein anderes Aggregat zu benachrichtigen. Diese Aktionen machen im Kontext der Domäne Sinn und können synchron erfolgen, wodurch sofortige Konsistenz gewährleistet wird.

Operationen, die jedoch von externen Ressourcen abhängen – wie das Versenden von E-Mails oder das Aufrufen von Drittanbieter-APIs – sollten nicht direkt aus Domänenereignissen ausgeführt werden, da dies die Transaktion an langsame oder instabile Aufgaben binden würde. In solchen Fällen kann die Domäne ein Integrationsereignis erzeugen (im Outbox-Mechanismus protokolliert), das später asynchron und resilient verarbeitet wird.

Hauptmerkmale:

• Reagiert auf ein Ereignis, ändert es jedoch niemals.
• Führt nur In-Process-Operationen aus, die mit der Konsistenz der Domäne zusammenhängen.
• Stellt sicher, dass alles innerhalb derselben Transaktion ausgeführt wird.

Um einen neuen Domänen-Ereignis-Handler zu erstellen, führen Sie einfach den Befehl aus:

lino event-handler new

Der CLI-Assistent wird Folgendes abfragen:

• Service – Der Service, in dem der Ereignis-Handler erstellt wird.
• Modul – Das Modul, in dem der Ereignis-Handler erstellt wird (nur in modularen Services).
• Entität – Die Entität, in der der Ereignis-Handler erstellt wird.
• Ereignistyp – Domänenereignis oder Integrationsereignis.
• Ereignis – Das zu konsumierende Ereignis.
• Name des Ereignis-Handlers – Der Name, der mit der Entität und dem Domänenereignis verknüpft wird.

Beispiel

Beim Erstellen des Domänen-Ereignis-Handlers UserCreated, der mit der Entität User und dem Ereignis UserCreatedDomainEvent verknüpft ist, erstellt das System automatisch einen Ereignis-Handler mit dem Namen UserCreatedDomainEventHandler.

Von Lino generierte Struktur:

MyApp/
└── src/
    └── Services/
        └── MyService/
            └── Application/
                ├── MyApp.MyService.Application.csproj
                └── UseCases/
                    └── Users/
                        ├── Commands/
                        ├── EventHandlers/
                        │   └── Domain/
                        │       └── UserCreatedDomainEventHandler.cs
                        ├── Logging/
                        ├── Queries/
                        └── Resources/

Integrationsereignisse

Integrationsereignisse sind Nachrichten, die darauf hinweisen, dass etwas Wichtiges passiert ist, und die mit externen Systemen oder anderen Microservices geteilt werden müssen.

Im Gegensatz zu Domänenereignissen besteht hier das Ziel in der Kommunikation zwischen Systemen und der Synchronisation von Zuständen.

Wann ein Integrationsereignis erstellen:

• Wenn eine Änderung in Ihrem System in einem anderen System widergespiegelt werden muss.
• Wenn Ihr Microservice Änderungen veröffentlichen muss, damit andere Microservices darauf reagieren können.

Hauptunterschiede zwischen Domain Events und Integration Events:

In Lino ist das Erstellen eines neuen Integrationsereignisses einfach. Sie können ausführen:

lino event new

Der CLI-Assistent fragt nach:

• Service – Der Service, in dem das Ereignis erstellt wird.
• Modul – Das Modul, in dem das Ereignis erstellt wird (nur für modulare Services).
• Entität – Die Entität, in der das Ereignis erstellt / zugeordnet wird.
• Ereignistyp – Domänenereignis oder Integrationsereignis.
• Ereignisname – Name, der für das Integrationsereignis verwendet wird und mit der Entität verknüpft ist.

Beispiel

Wenn das Integrationsereignis UserCreated mit der Entität User erstellt wird, erstellt das System automatisch ein Ereignis mit dem Namen UserCreatedIntegrationEvent. Dieser Name macht für jeden Teil des Systems, der das Ereignis konsumiert, deutlich, dass die Benutzererstellung bereits abgeschlossen ist.

Von Lino generierte Struktur:

MyApp/
└── src/
    └── Services/
        └── MyService/
            └── IntegrationEvents/
                ├── MyApp.MyService.IntegrationEvents.csproj
                └── Users/
                    └── UserCreatedIntegrationEvent.cs

Integrations-Event-Handler

Ein Integration Event Handler ist eine Klasse, die dafür verantwortlich ist, ein Integrationsereignis zu konsumieren, das normalerweise von einem anderen Service oder Kontext veröffentlicht wird, und anschließend spezifische Aktionen in der eigenen Domäne auszuführen.

Diese Handler empfangen Ereignisse über Messaging-Systeme (wie RabbitMQ, Kafka, Azure Service Bus usw.), meist in Kombination mit dem Outbox-Pattern, das eine zuverlässige Zustellung und asynchrone Verarbeitung sicherstellt.

Zum Beispiel kann, wenn ein UserCreated-Ereignis von einem Identity-Service veröffentlicht wird, der entsprechende Handler in einem anderen Kontext reagieren, indem er eine Willkommens-E-Mail sendet oder externe APIs aufruft. Diese Vorgänge können langsamer oder fehleranfällig sein, beeinträchtigen jedoch die interne Konsistenz der Anwendung nicht, da sie außerhalb der Haupttransaktion behandelt werden.

Hauptmerkmale:

• Reagiert auf Ereignisse, die geschäftlich relevante Fakten für andere Kontexte darstellen.
• Führt Vorgänge aus, die langsam oder extern sein können (z. B. E-Mail-Versand, API-Aufrufe).
• Wird asynchron und resilient verarbeitet, oft mit Wiederholungen und Monitoring.
• Stellt sicher, dass externe Fehler die ursprüngliche Domänentransaktion nicht beeinflussen.
• Erleichtert die Integration zwischen Bounded Contexts und verteilten Systemen.

Um einen neuen Integrations-Event-Handler zu erstellen, führen Sie einfach folgenden Befehl aus:

lino event-handler

Der CLI-Assistent fragt Folgendes ab:

• Service – Der Service, in dem der Event-Handler erstellt wird.
• Modul – Das Modul, in dem der Event-Handler erstellt wird (nur in modularen Services).
• Entität – Die Entität, in der der Event-Handler erstellt wird.
• Ereignistyp – Domänenereignis oder Integrationsereignis.
• Service – Der Service, in dem das zu konsumierende Ereignis existiert.
• Modul – Das Modul, in dem das zu konsumierende Ereignis existiert (nur in modularen Services).
• Entität – Die Entität, in der das zu konsumierende Ereignis existiert.
• Ereignis – Das zu konsumierende Ereignis.
• Name des Event-Handlers – Name, der mit der Entität und dem Integrationsereignis verknüpft wird.

Beispiel

Beim Erstellen des Integrations-Event-Handlers SendEmailOnUserCreated, der mit der Entität User und dem Ereignis UserCreatedIntegrationEvent verknüpft ist, erstellt das System automatisch einen Event-Handler mit dem Namen SendEmailOnUserCreatedIntegrationEventHandler.

Von Lino generierte Struktur:

MyApp/
└── src/
    └── Services/
        └── MyService/
            └── Application/
                ├── MyApp.MyService.Application.csproj
                └── UseCases/
                    └── Users/
                        ├── Commands/
                        ├── EventHandlers/
                        │   └── Integration/
                        │       └── SendEmailOnUserCreatedIntegrationEventHandler.cs
                        ├── Logging/
                        ├── Queries/
                        └── Resources/