이벤트 다루기

도메인 이벤트

도메인 이벤트는 애플리케이션 컨텍스트 내에서 발생한 중요한 사실을 나타냅니다. 이 이벤트는 시스템 내부에서 생성 및 소비되며, 상태 변경을 느슨하게 결합된 방식으로 전파할 수 있습니다. 즉, 객체들이 서로를 직접 알 필요가 없습니다.

도메인 이벤트를 언제 사용해야 하나요?

• 어떤 작업이 도메인에 중요한 변화를 일으키고, 시스템의 다른 부분에 알림 또는 트리거가 필요할 때.
• 도메인 모델의 응집력을 유지하고, 서로 직접 의존하지 않고도 다양한 프로세스를 트리거할 수 있도록 할 때.

Lino에서는 새로운 도메인 이벤트를 쉽게 생성할 수 있습니다. 다음 명령을 실행하세요:

lino event new

CLI 마법사가 다음을 요청합니다:

• 서비스 – 이벤트가 생성될 서비스.
• 모듈 – 이벤트가 생성될 모듈(모듈형 서비스만 해당).
• 엔티티 – 이벤트가 생성/연결될 엔티티.
• 이벤트 유형 – 도메인 이벤트 또는 통합 이벤트.
• 이벤트 이름 – 도메인에서 사용되며 엔티티와 연결되는 이름.

예시

User 엔티티와 연결된 도메인 이벤트 UserCreated를 생성하면, 시스템은 자동으로 UserCreatedDomainEvent라는 이름의 이벤트를 생성합니다. 이 이름은 이벤트를 소비하는 시스템의 어느 부분에서도 사용자 생성 작업이 이미 완료되었음을 명확히 보여줍니다.

Lino가 생성한 구조:

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

도메인 이벤트 핸들러

Domain Event Handler는 도메인 이벤트에 반응하고 애플리케이션 내부 상태와 관련된 작업을 수행하는 클래스이며, 항상 동일한 트랜잭션 컨텍스트 내에서 실행됩니다.

이러한 핸들러의 주요 목적은 시스템을 응집력 있고 느슨하게 결합된 상태로 유지하여 엔티티나 애그리게이트의 핵심 로직을 과부하하지 않고 추가 규칙을 적용할 수 있도록 하는 것입니다.

예를 들어 User를 생성한 후 통계를 업데이트하거나 내부 로그를 생성하거나 다른 애그리게이트에 알림을 보내야 할 수 있습니다. 이러한 작업은 도메인 내에서 의미가 있으며 동기적으로 수행될 수 있어 즉각적인 일관성을 보장합니다.

그러나 외부 리소스에 의존하는 작업 — 이메일 전송 또는 서드파티 API 호출 등 — 은 도메인 이벤트에서 직접 수행해서는 안 됩니다. 이렇게 하면 트랜잭션이 느리거나 불안정한 작업에 묶이게 되기 때문입니다. 이 경우 도메인은 통합 이벤트(Outbox에 기록)를 생성하고 나중에 비동기적이고 회복력 있게 처리됩니다.

주요 특징:

• 이벤트에 반응하지만 절대 수정하지 않습니다.
• 도메인 일관성과 관련된 인프로세스 작업만 수행합니다.
• 모든 작업이 동일한 트랜잭션 내에서 실행되도록 보장합니다.

새로운 도메인 이벤트 핸들러를 생성하려면 다음 명령어를 실행하세요:

lino event-handler new

CLI 마법사가 다음을 요청합니다:

• 서비스 – 이벤트 핸들러가 생성될 서비스.
• 모듈 – 이벤트 핸들러가 생성될 모듈(모듈형 서비스에서만 해당).
• 엔티티 – 이벤트 핸들러가 생성될 엔티티.
• 이벤트 유형 – 도메인 이벤트 또는 통합 이벤트.
• 이벤트 – 소비될 이벤트.
• 이벤트 핸들러 이름 – 엔티티 및 도메인 이벤트에 연결될 이름.

예시

User 엔티티와 UserCreatedDomainEvent 이벤트에 연결된 도메인 이벤트 핸들러 UserCreated를 생성하면, 시스템은 자동으로 UserCreatedDomainEventHandler라는 이름의 이벤트 핸들러를 생성합니다.

Lino가 생성한 구조:

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

통합 이벤트

통합 이벤트는 중요한 일이 발생했음을 알리는 메시지이며, 외부 시스템이나 다른 마이크로서비스와 공유해야 합니다.

도메인 이벤트와 달리, 여기서의 목적은 시스템 간 통신 및 상태 동기화입니다.

통합 이벤트를 생성할 때:

• 시스템의 변경 사항을 다른 시스템에 반영해야 할 때.
• 마이크로서비스가 변경 사항을 게시하여 다른 마이크로서비스가 반응해야 할 때.

도메인 이벤트와 통합 이벤트의 주요 차이점:

Lino에서는 새 통합 이벤트를 쉽게 생성할 수 있습니다. 다음 명령어를 실행하세요:

lino event new

CLI 마법사가 요청하는 항목:

• 서비스 – 이벤트를 생성할 서비스.
• 모듈 – 이벤트를 생성할 모듈 (모듈형 서비스에서만).
• 엔티티 – 이벤트를 생성/연결할 엔티티.
• 이벤트 유형 – 도메인 이벤트 또는 통합 이벤트.
• 이벤트 이름 – 엔티티와 연결된 통합 이벤트 이름.

예시

User 엔티티와 연결된 통합 이벤트 UserCreated를 생성하면, 시스템은 자동으로 UserCreatedIntegrationEvent라는 이름의 이벤트를 생성합니다. 이 이름은 이벤트를 소비하는 시스템의 모든 부분에서 사용자 생성 작업이 이미 완료되었음을 명확하게 나타냅니다.

Lino가 생성한 구조:

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

통합 이벤트 핸들러

Integration Event Handler 는 일반적으로 다른 서비스나 컨텍스트에서 발행된 Integration Event 를 소비하고, 자신의 도메인 내에서 특정 작업을 수행하는 클래스입니다.

이러한 핸들러는 RabbitMQ, Kafka, Azure Service Bus 등과 같은 메시징 메커니즘을 통해 이벤트를 수신하며, 일반적으로 Outbox 패턴과 함께 사용되어 안정적인 전달과 비동기 처리를 보장합니다.

예를 들어, Identity 서비스에서 UserCreated 이벤트를 발행하면, 다른 컨텍스트의 해당 핸들러는 환영 이메일을 보내거나 외부 API를 호출하는 등의 반응을 수행할 수 있습니다. 이러한 작업은 느리거나 실패할 수 있지만, 메인 트랜잭션 외부에서 처리되므로 애플리케이션의 내부 일관성에는 영향을 주지 않습니다.

주요 특징:

• 다른 컨텍스트와 관련된 비즈니스 사실을 나타내는 이벤트에 반응합니다.
• 느리거나 외부 작업(예: 이메일 발송, API 호출)을 수행합니다.
• 비동기적이고 복원력 있게 처리되며, 종종 재시도 및 모니터링이 포함됩니다.
• 외부 실패가 원래 도메인 트랜잭션에 영향을 주지 않도록 보장합니다.
• 바운디드 컨텍스트 및 분산 시스템 간의 통합을 용이하게 합니다.

새 통합 이벤트 핸들러를 생성하려면 다음 명령을 실행하세요:

lino event-handler

CLI 마법사가 요청하는 항목:

• 서비스 – 이벤트 핸들러가 생성될 서비스.
• 모듈 – 이벤트 핸들러가 생성될 모듈(모듈형 서비스만 해당).
• 엔티티 – 이벤트 핸들러가 생성될 엔티티.
• 이벤트 유형 – 도메인 이벤트 또는 통합 이벤트.
• 서비스 – 소비할 이벤트가 존재하는 서비스.
• 모듈 – 소비할 이벤트가 존재하는 모듈(모듈형 서비스만 해당).
• 엔티티 – 소비할 이벤트가 존재하는 엔티티.
• 이벤트 – 소비할 이벤트.
• 이벤트 핸들러 이름 – 엔티티 및 통합 이벤트와 연결될 이름.

예제

User 엔티티 및 UserCreatedIntegrationEvent 이벤트와 연결된 통합 이벤트 핸들러 SendEmailOnUserCreated 를 생성하면, 시스템은 자동으로 SendEmailOnUserCreatedIntegrationEventHandler 라는 이름의 핸들러를 생성합니다.

Lino가 생성한 구조:

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