Українська
Реєстрація бізнес-рівня
Крок 1. Один виклик для всього, що під API
Навіщо. У темі 5 рівень даних отримав AddData. Бізнес-рівень отримує власний AddCore, і AddCore сам викликає AddData. Тоді API (тема 12) викликатиме лише AddCore: йому не потрібно знати, що бізнес-рівень зберігає дані через EF Core, а також які рядок підключення й папка сховища потрібні рівню даних.
AddCore отримує конфігурацію застосунку – об’єднані налаштування з appsettings.json, appsettings.Development.json, змінних середовища й аргументів командного рядка – і читає з неї все, чого потребують нижні рівні.
Що зробити. Створіть DependencyInjection.cs у корені Chatex.Core:
cs
using Chatex.Data;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
namespace Chatex.Core;
public static class DependencyInjection
{
public static IServiceCollection AddCore(this IServiceCollection services, IConfiguration configuration)
{
var connectionString = configuration.GetConnectionString("Chatex")
?? throw new InvalidOperationException("Connection string 'Chatex' is not configured.");
services.AddData(connectionString, o => o.RootPath = configuration["Storage:RootPath"] ?? "");
return services;
}
}configuration.GetConnectionString("Chatex")читаєConnectionStrings:Chatex. Відсутній рядок підключення – це помилка розгортання, а не очікуваний збій, тому застосунок кидає виняток під час запуску з чітким повідомленням.??з виразомthrow– найкоротший спосіб сказати «або це, або помилка».configuration["Storage:RootPath"]читає вкладене налаштування;:розділяє рівні розділів JSON.
Клас росте з кожною темою цього модуля: кожна функція реєструє тут свої сервіси. У темі 8 він отримає й перший клас параметрів (JwtOptions), що зв’язується з розділом конфігурації та перевіряється під час запуску – той самий патерн, що й FileStorageOptions у рівні даних.
Впровадження через конструктор
Жоден із сервісів, які ми напишемо, не створює власних залежностей. Наприклад, ChatService оголошує в первинному конструкторі, що йому потрібні IChatRepository, IUnitOfWork, IChatNotifier, TimeProvider та інші, а контейнер передає їх. Це впровадження через конструктор (constructor injection): залежності видно в сигнатурі, тест може підставити інші реалізації, а сервіс залежить від інтерфейсів (IChatRepository), а не від класів (ChatRepository). Курс C# пояснює контейнер у розділі Впровадження залежностей.
Крок 2. Випробуйте тип Result
Навіщо. Сервісу для перевірки ще немає, але тип Result уже повний. Невелика програма показує, як ним користуватися: неявні перетворення, IsSuccess, Match і виняток за хибне використання Value.
Що зробити. У своїй папці-«пісочниці» (D:\Work\Playground) створіть results.cs; виправте шлях у першому рядку, якщо ваш репозиторій лежить деінде:
cs
#:project D:\Work\Chatex\Source\Chatex.Core\Chatex.Core.csproj
#:property PublishAot=false
using Chatex.Core.Common;
Result<decimal> Withdraw(decimal balance, decimal amount)
{
if (amount <= 0)
{
return Error.Validation("amount", "invalid_amount", "The amount must be positive.");
}
if (amount > balance)
{
return Error.Conflict("insufficient_funds", "Not enough money on the account.");
}
return balance - amount;
}
foreach (var amount in new[] { 30m, 0m, 500m })
{
var result = Withdraw(100m, amount);
var text = result.Match(
rest => $"OK, {rest} left",
error => $"{error.Kind} {error.Code}: {error.Message}");
Console.WriteLine($"Withdraw {amount}: {text}");
}
var failed = Withdraw(100m, 500m);
if (!failed.IsSuccess)
{
Console.WriteLine($"The compiler knows Error is not null here: {failed.Error.Code}");
}
try
{
Console.WriteLine(failed.Value);
}
catch (InvalidOperationException ex)
{
Console.WriteLine($"Reading Value of a failure is a bug: {ex.Message}");
}Функція Withdraw повертає Result<decimal>, але її оператори return повертають Error або decimal – неявні перетворення обгортають їх.
powershell
dotnet run results.csПеревірка
Withdraw 30: OK, 70 left
Withdraw 0: Validation invalid_amount: The amount must be positive.
Withdraw 500: Conflict insufficient_funds: Not enough money on the account.
The compiler knows Error is not null here: insufficient_funds
Reading Value of a failure is a bug: Result has no value; it failed with 'insufficient_funds'.Наведіть курсор на failed.Error.Code в IDE: попередження про nullable немає завдяки [MemberNotNullWhen]. Приберіть навколишній if – і попередження з’явиться.