Reo.Core.Infrastructure.Abstractions 6.0.377

Reo.Core.Infrastructure.Abstractions

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

Пакет Reo.Core.Infrastructure.Abstractions предоставляет абстрактные интерфейсы и базовые реализации для работы с репозиториями и сущностями в приложениях на C#. Он решает задачу унификации и абстракции доступа к данным, позволяя разделять логику приложения и реализацию хранилищ. Это упрощает тестирование, модульность и поддержку кода.

Функции:

• Обобщённые интерфейсы для чтения и записи данных (IReoReadOnlyRepository, IReoWriteOnlyRepository).
• Поддержка сущностей с идентификаторами Id (для справочников) и Uuid (для универсальных сущностей).
• Асинхронные методы для взаимодействия с репозиториями.

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

1. IEntityReference

• Интерфейс для сущностей-справочников с целочисленным идентификатором Id.

2. IEntityUuid

• Интерфейс для сущностей с универсальным уникальным идентификатором Uuid.

3. IReoReferenceReadOnlyRepository<TEntity>

• Репозиторий для чтения сущностей-справочников.
• Методы: GetAsync(int id, CancellationToken token), GetAsync(Expression<Func<TEntity, bool>> filter, CancellationToken token).

4. IReoReadOnlyRepository<TEntity>

• Репозиторий для чтения сущностей с Uuid.
• Методы: GetAsync(Guid id, CancellationToken token), GetAsync(Expression<Func<TEntity, bool>> filter, CancellationToken token).

5. IReoWriteOnlyRepository<TEntity>

• Репозиторий для записи данных.
• Методы: SaveAsync(TEntity entity, CancellationToken token), SaveAsync(IReadOnlyCollection<TEntity> entities, CancellationToken token).

6. ReoReadOnlyRepositoryBase<TEntity>

• Базовый класс для реализации IReoReadOnlyRepository<TEntity>.

7. ReoWriteOnlyRepositoryBase<TEntity>

• Базовый класс для реализации IReoWriteOnlyRepository<TEntity>.

Требования

• .NET: Совместим с версиями .NET 8.0 и .NET 9.0.
• Зависимости:
  • System.Linq.Expressions (для фильтрации сущностей).
  • JetBrains.Annotations (для атрибутов аннотаций, например, [UsedImplicitly]).

Установка

Установите пакет через NuGet Package Manager или .NET CLI:

Install-Package Reo.Core.Infrastructure.Abstractions

или

dotnet add package Reo.Core.Infrastructure.Abstractions

Настройка

Для использования в ASP.NET Core:

1. Регистрируйте репозитории в DI-контейнере (например, через AddScoped или AddTransient).
2. Если требуется, добавьте реализации репозиториев (например, на основе EF Core или другого ORM).

Пример регистрации в DI:

services.AddScoped<IReoReferenceReadOnlyRepository<MyEntity>, MyEntityRepository>();
services.AddScoped<IReoWriteOnlyRepository<MyEntity>, MyEntityRepository>();

Конфигурационные параметры: N/A (пакет не требует внешней настройки).

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

Пример 1: Чтение сущности по Id

var repository = serviceProvider.GetRequiredService<IReoReferenceReadOnlyRepository<MyEntity>>();
var entity = await repository.GetAsync(123, CancellationToken.None);

Пример 2: Сохранение сущности

var repository = serviceProvider.GetRequiredService<IReoWriteOnlyRepository<MyEntity>>();
var newEntity = new MyEntity { Uuid = Guid.NewGuid(), Name = "Test" };
var savedId = await repository.SaveAsync(newEntity, CancellationToken.None);

Пример 3: Батч-сохранение

var entities = new List<MyEntity>
{
    new MyEntity { Uuid = Guid.NewGuid(), Name = "Item 1" },
    new MyEntity { Uuid = Guid.NewGuid(), Name = "Item 2" }
};

var count = await repository.SaveAsync(entities, CancellationToken.None);
Console.WriteLine($"Сохранено {count} записей.");

Лицензия

Этот пакет распространяется под лицензией MIT. См. файл LICENSE для подробностей.