Reo.Core.Application.Abstractions.MediatR 10.0.210

Reo.Core.Application.Abstractions.MediatR

Описание пакета

Пакет Reo.Core.Application.Abstractions.MediatR предоставляет абстракции для интеграции с библиотекой MediatR в приложениях на C#. Он упрощает обработку доменных команд, событий и команд с результатами, добавляя логирование, обработку ошибок и стандартные шаблоны для работы с архитектурой CQRS. Пакет решает проблему стандартизации обработки операций в приложениях, где требуется разделение команд (commands), событий (events) и операций с возвращаемым результатом (commands with results).

Основные компоненты

• IReoApplicationService<TDomainCommandsExecutor, TQuery> Интерфейс для сервисов приложения, которые выполняют операции с использованием доменных команд. Предоставляет метод ExecuteAsync для асинхронного выполнения запросов.

• ReoDomainCommandHandler<TDomainCommand> Абстрактный класс для обработки доменных команд. Реализует IRequestHandler<TDomainCommand> и добавляет логирование и обработку ошибок.

• ReoDomainCommandWithResultHandler<TDomainCommand> Абстрактный класс для обработки команд с возвращаемым результатом. Реализует IRequestHandler<TDomainCommand, bool> и добавляет логирование результата выполнения.

• ReoDomainEventHandler<TDomainEvent> Абстрактный класс для обработки доменных событий. Реализует INotificationHandler<TDomainEvent> и добавляет логирование и обработку ошибок.

• ServiceCollectionExtensions Методы расширения для регистрации сервисов приложения в контейнере зависимостей (DI) в ASP.NET Core.

Требования

• .NET версии: .NET 8 и выше.
• Зависимости:
  • MediatR
  • Microsoft.Extensions.Logging

Установка

Используйте следующие команды для установки пакета:

Install-Package Reo.Core.Application.Abstractions.MediatR

dotnet add package Reo.Core.Application.Abstractions.MediatR

Настройка

Регистрация в DI (ASP.NET Core)

Добавьте сервисы в контейнер зависимостей с помощью метода расширения:

services.AddReoApplicationServices<YourAssembly>();

Замените Reo.Core.Application.Abstractions.MediatR на сборку вашего проекта.

Конфигурационные параметры

N/A. Пакет не требует дополнительной конфигурации.

Использование

Пример 1: Обработка команды

public class CreateUserCommand : IRequest
{
 public string Username { get; set; }
}

public class CreateUserCommandHandler : ReoDomainCommandHandler<CreateUserCommand>
{
 protected override Task InnerHandleAsync(CreateUserCommand command, CancellationToken cancellationToken)
 {
 // Логика создания пользователя
 return Task.CompletedTask;
 }
}

Пример 2: Обработка команды с результатом

public class ValidateUserCommand : IRequest<bool>
{
 public string Username { get; set; }
}

public class ValidateUserCommandHandler : ReoDomainCommandWithResultHandler<ValidateUserCommand>
{
 protected override Task<bool> InnerHandleAsync(ValidateUserCommand command, CancellationToken cancellationToken)
 {
 // Проверка пользователя
 return Task.FromResult(true);
 }
}

Пример 3: Использование сервиса в контроллере

[ApiController]
[Route("api/[controller]")]
public class UserController : ControllerBase
{
 private readonly IReoApplicationService<..., CreateUserCommand> _service;

 public UserController(IReoApplicationService<..., CreateUserCommand> service)
 {
 _service = service;
 }

 [HttpPost]
 public async Task<IActionResult> CreateUser([FromBody] CreateUserCommand command)
 {
 await _service.ExecuteAsync(command, CancellationToken.None);
 return Ok();
 }
}

Лицензия

Данный пакет распространяется под лицензией MIT.