new-event-handler

Create New Event Handler

Scaffold domain events with typed handlers using MediatR notifications.

Required Pattern

Domain Event

// Marker interface for domain events
public interface IDomainEvent : INotification
{
    Guid EventId { get; }
    DateTime OccurredAt { get; }
}

// Base record for convenience
public abstract record DomainEvent : IDomainEvent
{
    public Guid EventId { get; } = Guid.NewGuid();
    public DateTime OccurredAt { get; } = DateTime.UtcNow;
}

// Concrete event
public record OrderPlacedEvent(
    Guid OrderId,
    Guid CustomerId,
    decimal TotalAmount) : DomainEvent;

Event Handler

public class OrderPlacedHandler : INotificationHandler<OrderPlacedEvent>
{
    private readonly IEmailService _emailService;
    private readonly ILogger<OrderPlacedHandler> _logger;

    public OrderPlacedHandler(IEmailService emailService, ILogger<OrderPlacedHandler> logger)
    {
        _emailService = emailService;
        _logger = logger;
    }

    public async Task Handle(OrderPlacedEvent notification, CancellationToken ct)
    {
        _logger.LogInformation("Handling OrderPlaced: {OrderId}", notification.OrderId);
        await _emailService.SendOrderConfirmationAsync(notification.OrderId, ct);
    }
}

Publishing Events

public class OrderService
{
    private readonly IMediator _mediator;

    public async Task<Order> PlaceOrderAsync(CreateOrderRequest request, CancellationToken ct)
    {
        var order = new Order(request.CustomerId, request.Items);
        await _repository.AddAsync(order, ct);

        await _mediator.Publish(new OrderPlacedEvent(
            order.Id, order.CustomerId, order.TotalAmount), ct);

        return order;
    }
}

Multiple Handlers per Event

// MediatR publishes to ALL registered handlers for an event
public class OrderPlacedAuditHandler : INotificationHandler<OrderPlacedEvent>
{
    public async Task Handle(OrderPlacedEvent notification, CancellationToken ct)
    {
        // Write to audit log — runs independently of email handler
    }
}