Набор библиотек-расширений и шаблонов реализаций для обеспечения взаимодействия с базой данных, Api и клиентом для серверных приложений.

Для работы с базой данных доступны репозитории и фабрика:

public static IServiceCollection AddTestRepositories(this IServiceCollection services) =>
	services
	   .AddScoped(typeof(IRepository<>), typeof(Your_DbRepository<>))
	   .AddScoped(typeof(IRepository<,>), typeof(Your_DbRepository<,>));

public static IServiceCollection AddTestRepositoryFactories(this IServiceCollection services) =>
	services
	   .AddScoped(typeof(IRepository<>), typeof(Your_DbContextFactoryRepository<>))
	   .AddScoped(typeof(IRepository<,>), typeof(Your_DbContextFactoryRepository<,>));

где:

Your_DbRepository - реализация репозитория, унаследованная от базового класса DbRepository Your_DbContextFactoryRepository - реализация фабрики репозитория, унаследованная от базового класса DbContextFactoryRepository

пример реализации

Вызов репозитория происходит при запросе экземпляра интерфейса IRepository<Student>, где Student - некий класс унаследованный от Entity, в данном контексте у сущности id представляет тип int32

При необходимости выбрать другой тип ключа сущность должна быть унаследована от Entity<Tkey>, где Tkey - тип ключа (например Guid), в этом случае обращение к репозиторию происходит при запросе IRepository<Student,Guid>

Вызов фабрики происходит сжожим способом.

Возможности репозитория:

Упростить инициализацию экземпляра БД при старте приложения поможет DBInitializer<TContext> или аналогично DBFactoryInitializer<TContext>

пример реализации

подключаем сервис services.AddTransient<TestContextInitializer>();

Вызываем сервис

public void Configure(IApplicationBuilder app, IWebHostEnvironment env, TestContextInitializer context)
        {
            context.InitializeAsync().Wait();
	...

Для взаимодействия с клиентом реализован WebRepository<TEntity, TKey>

Возможности клиента:

При необходимости реализации можно переопределить унаследовавшись. И например изменить адреса конечных точек, которые в апи реализованы как api/EntytyTypeName', т.е. для сущности студенов - api/Student` Переопределение точки производится в конструкторе с передачей в качестве serviceAddress:

public class TestStudentApiClient : WebRepository<Student>, IRepository<Student>
{
	public TestStudentApiClient(IConfiguration configuration, ILogger<WebRepository<Student>> logger)
		: base(configuration, logger/*,"api/ControllerName"*/) //раскомментировать для замены точки
	{
	}

	public TestStudentApiClient(IConfiguration configuration, ILogger<WebRepository<Student>> logger, string serviceAddress) 
		: base(configuration, logger, serviceAddress)
	{
	}
}
	

регистрация сервиса: servide.AddScoped<IRepository<Student>,TestStudentApiClient>();

полный пример доступен в тестовом консольном проекте (адресс api читается из файла appsettings.json).

Шаблон реализации представлен в ApiController<TEntity, TKey> или ApiController<TEntity> аналогично репозиториям. Конечные точки идентичны точкам WebRepository.