Reo.Core.Application.Abstractions 10.0.210

Reo.Core.Application.Abstractions

Пакет Reo.Core.Application.Abstractions представляет собой библиотеку, предназначенную для реализации прикладного слоя в архитектуре DDD (Domain-Driven Design). Он предоставляет абстракции и утилиты для работы с доменными командами, событиями, запросами и маппингом между доменными моделями и DTO (Data Transfer Objects). Ниже приведены ключевые аспекты и функции пакета:

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

1. Обработка доменных команд и событий

• ReoDomainCommandHandler<TDomainCommand> и ReoDomainCommandWithResultHandler<TDomainCommand>:

  • Реализуют обработчики для доменных команд (команд, изменяющих состояние системы) и команд с результатом (например, валидации).
  • Используют MediatR для обработки запросов и интеграции с пайплайн-поведениями (например, логирование, транзакции).
  • Поддерживают кастомные псевдонимы для команд и логирование дополнительной информации.

• ReoDomainEventHandler<TDomainEvent> и ReoDomainEventWithResultHandler<TDomainEvent>:

  • Обрабатывают доменные события (события, возникающие в результате изменений в домене).
  • Поддерживают возврат результатов (например, для проверки условий).

2. Сервисы приложения

• ReoApplicationServiceBase:

  • Базовый класс для прикладных сервисов, предоставляющий общую логику (например, транзакции, логирование).
  • Может использоваться для оркестрации доменных команд и событий.

• ReoApplicationServiceFactory:

  • Фабрика для создания экземпляров прикладных сервисов, интегрируется с контейнером DI (Dependency Injection).

3. Маппинг между доменными моделями и DTO

• ReoDomainToDtoMapper и ReoDtoToDomainMapper:
  • Утилиты для преобразования данных между доменными объектами и DTO, используемыми в API или внешних слоях.

4. Расширения для MediatR

• ReoApplicationServiceExtensions:
  • Методы расширения для обработки команд, событий и запросов через MediatR.
  • Поддерживают интеграцию с пайплайн-поведениями (например, валидация, логирование).

Архитектурные особенности

• DDD-ориентированная структура:

  • Разделение на доменные команды, события, запросы и прикладные сервисы.
  • Использование CQRS (Command Query Responsibility Segregation) для разделения операций чтения и записи.

• Интеграция с MediatR:

  • Обработка команд и событий через паттерн Request/Response.
  • Поддержка pipeline behaviors для добавления общей логики (например, логирование, транзакции).

• Декуплирование слоев:

  • Зависимость от Reo.Core.BaseDomainModels (доменные модели) через ProjectReference.
  • Отсутствие прямой зависимости от инфраструктурных слоев (например, базы данных), что позволяет использовать пакет в различных контекстах.

Пример использования

// Пример обработчика команды
public class CreateUserCommandHandler : ReoDomainCommandHandler<CreateUserCommand>
{
 protected override async Task InnerHandleAsync(CreateUserCommand command, CancellationToken cancellationToken)
 {
 // Логика создания пользователя
 await _userRepository.AddAsync(new User(command.Name, command.Email), cancellationToken);
 }
}

// Пример прикладного сервиса
public class UserService : ReoApplicationServiceBase
{
 public async Task CreateUserAsync(CreateUserCommand command)
 {
 await HandleCommandAsync(command);
 }
}

Зависимости

• .NET 8.0 (указано в csproj).
• MediatR (используется для обработки команд и событий).
• Reo.Core.BaseDomainModels (доменные модели и сущности).

Цель пакета

Пакет Reo.Core.Application.Abstractions служит абстракцией для прикладного слоя, позволяя:

• Реализовывать бизнес-логику через доменные команды и события.
• Использовать MediatR для обработки запросов и интеграции с пайплайн-поведениями.
• Разделять доменные модели и DTO для обеспечения чистоты архитектуры.

Этот пакет подходит для проектов, следующих DDD, CQRS и Clean Architecture.

Лицензия

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