Reo.Core.Hosting 10.0.210

Reo.Core.Hosting

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

Reo.Core.Hosting — это библиотека, предназначенная для упрощения разработки приложений на основе ASP.NET Core. Пакет предоставляет набор утилит, сервисов и абстракций, которые помогают решать типичные задачи, такие как:

• Реализация фоновых задач с поддержкой распределённой синхронизации (через RedLock).
• Управление конфигурацией (включая настройки GIS, адреса сервисов и т.д.).
• Работа с временем и датами (локализация, преобразования).
• Обработка параметров запросов (например, преобразование в формат kebab-case).

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

1. DistributedPeriodicBackgroundRoutine

• Описание: Абстрактный класс для реализации фоновых задач, которые выполняются периодически и синхронизируются между несколькими экземплярами приложения (например, в кластере).
• Функции: Использует RedLock для обеспечения уникальности выполнения задачи на уровне кластера.

2. GisProviderService

• Описание: Сервис для получения настроек, связанных с ГИС (географической информационной системой), таких как код ГИС, адреса сервисов (IdentityServer, API Gateway, UI и т.д.).
• Функции: Читает конфигурацию из appsettings.json или переменных окружения.

3. ReoTimeProvider

• Описание: Утилита для работы с временем, включая локализацию и преобразование дат в формат, соответствующий требованиям приложения.
• Функции: Поддерживает работу с часовыми поясами, преобразование дат в формат ISO 8601.

4. KebabParameterTransformer

• Описание: Класс для преобразования параметров запросов в формат kebab-case (например, myParam → my-param).
• Функции: Используется в маршрутизации и обработке HTTP-запросов.

Требования

• .NET: Совместим с .NET 6 и выше.
• Зависимости:
  • Microsoft.Extensions.Hosting
  • RedLockNet
  • Microsoft.Extensions.Configuration

Установка

NuGet Package Manager

Install-Package Reo.Core.Hosting

.NET CLI

dotnet add package Reo.Core.Hosting

Настройка

Регистрация в DI-контейнере (ASP.NET Core)

public void ConfigureServices(IServiceCollection services)
{
 services.AddHostedService<DistributedPeriodicBackgroundRoutine>();
 services.Configure<GisOptions>(Configuration.GetSection("Gis"));
 services.AddSingleton<IGisProviderService, GisProviderService>();
}

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

Пример appsettings.json:

{
 "Gis": {
 "Code": "GIS-123",
 "IdentityServerAddress": "https://identity.example.com",
 "ApiGatewayAddress": "https://api.example.com",
 "UiAddress": "https://ui.example.com"
 }
}

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

Пример 1: Реализация фоновой задачи

public class MyDistributedTask : DistributedPeriodicBackgroundRoutine
{
 protected override string LockName => "my-task-lock";
 protected override string TaskDisplayName => "My Distributed Task";

 protected override async ValueTask ExecutePeriodicWorkAsync(CancellationToken cancellationToken)
 {
 // Логика задачи
 await Console.Out.WriteLineAsync("Executing distributed task...");
 }
}

Пример 2: Использование GisProviderService

public class MyService
{
 private readonly IGisProviderService _gisProvider;

 public MyService(IGisProviderService gisProvider)
 {
 _gisProvider = gisProvider;
 }

 public void GetGisInfo()
 {
 var code = _gisProvider.GetCode();
 var identityServerAddress = _gisProvider.GetIdentityServerAddress();
 Console.WriteLine($"GIS Code: {code}, Identity Server: {identityServerAddress}");
 }
}

Пример 3: Работа с временем

var timeProvider = new ReoTimeProvider();
var localizedDate = timeProvider.GetLocalizedNow("Europe/Moscow");
Console.WriteLine($"Current time in Moscow: {localizedDate}");

Лицензия

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