Add Or Update Event Handler

핸들러는 DomainEventHandler<T> 인터페이스를 구현하고, @Component로 등록합니다. DomainEventDispatcher가 자동으로 핸들러를 수집하여 이벤트를 분배합니다.

@Component
class SomeEventHandler(
    private val someRepository: SomeRepository,
) : DomainEventHandler<SomeEventPayload.Completed> {

    override fun handle(event: DomainEvent<SomeEventPayload.Completed>) {
        val payload = event.payload
        // 이벤트 처리 로직
    }

    override fun supports(payloadType: KClass<*>): Boolean =
        payloadType == SomeEventPayload.Completed::class
}

4. 페이로드 작성 규칙

이벤트 페이로드는 common/event/payload/ 디렉토리에 sealed interface로 정의합니다. 페이로드 필드에는 common/domain/의 VO 클래스를 사용합니다.

sealed interface SomeEventPayload {
    data class Completed(
        val someId: SomeId,
        val memberId: MemberId,
    ) : SomeEventPayload
}

5. 이벤트 발행

이벤트를 발행하는 쪽(주로 application service)에서는 DomainEventPublisher를 주입받아 사용합니다.

@Service
class SomeService(
    private val eventPublisher: DomainEventPublisher,
) {
    fun doSomething() {
        // 비즈니스 로직 수행
        eventPublisher.publish(SomeEventPayload.Completed(...))
    }
}

6. 주의사항

• 이벤트 핸들러는 수신하는 BC의 infrastructure에 위치합니다. 발행하는 BC에 두지 않습니다.
• 핸들러 내부에서는 자신의 BC의 domain repository/service만 사용합니다.
• DomainEventDispatcher는 TransactionPhase.BEFORE_COMMIT 단계에서 실행되므로, 핸들러의 작업은 발행자와 같은 트랜잭션 내에서 수행됩니다.