Українська
Unit of Work і транзакції
Крок 1. Інтерфейс
Навіщо. Репозиторії збирають зміни; «одиниця роботи» (Unit of Work) фіксує їх. У межах одного запиту всі репозиторії спільно використовують той самий ChatexDbContext (впровадження залежностей створює по одному на область, див. Файли й реєстрація), тож один SaveChangesAsync записує все, що змінила операція, в одній транзакції бази даних. Надсилання повідомлення додає повідомлення, пов’язує його вкладення й пересуває час активності чату – або все, або нічого.
Деяким операціям потрібно більше одного збереження в одній транзакції. Реєстрація (тема 8) створює користувача через UserManager з Identity, який зберігає сам, а потім профіль; якщо профіль не вдався, користувач теж має зникнути. Для таких випадків Unit of Work виконує шматок коду в явній транзакції.
Що зробити.
cs
namespace Chatex.Data.Abstractions;
/// <summary>Commits the changes collected by the repositories of the current scope.</summary>
public interface IUnitOfWork
{
Task<int> SaveChangesAsync(CancellationToken cancellationToken = default);
/// <summary>
/// Runs <paramref name="action"/> in a database transaction and commits it if the action returns normally.
/// If it throws, the transaction is rolled back and pending changes are discarded.
/// Identity's UserManager shares the same DbContext, so its writes join the transaction too.
/// </summary>
Task<T> ExecuteInTransactionAsync<T>(Func<CancellationToken, Task<T>> action, CancellationToken cancellationToken = default);
Task ExecuteInTransactionAsync(Func<CancellationToken, Task> action, CancellationToken cancellationToken = default);
}Func<CancellationToken, Task<T>> – це делегат: асинхронна функція, що отримує токен скасування й повертає T. Викликач передає лямбду async ct => { ... }.
Крок 2. Порушення унікальності як наш власний виняток
Навіщо. Деякі правила надійно забезпечити може лише база даних: один особистий чат на пару, унікальні публічні псевдоніми, унікальні імена користувачів. Два запити в один і той самий момент можуть обидва пройти перевірку в C#; унікальний індекс дозволить зберегтися лише одному. Другий отримає від EF Core DbUpdateException з PostgresException від Npgsql усередині, чий SqlState дорівнює 23505, «порушення унікальності».
Бізнес-рівень має обробити цей випадок – «цей ідентифікатор уже зайнято» – але не повинен залежати від типів EF Core чи Npgsql. Unit of Work перетворює виняток на наш власний.
Що зробити. Створіть папку Exceptions:
cs
namespace Chatex.Data.Exceptions;
/// <summary>
/// A save broke a unique index, e.g. a second direct chat for the same pair of users or a taken public handle.
/// Lets callers handle such races without depending on EF Core or Npgsql.
/// </summary>
public sealed class UniqueConstraintException(string? constraintName, Exception innerException)
: Exception($"Unique constraint '{constraintName}' was violated.", innerException)
{
public string? ConstraintName { get; } = constraintName;
}ConstraintName повідомляє, яке правило порушено, наприклад ix_chats_public_handle, тож сервіс може повернути правильну помилку. Початковий виняток зберігається як InnerException для журналів.
Крок 3. Реалізація
Навіщо. SaveChangesAsync простий; транзакція потребує уваги через повторні спроби, увімкнені в темі 4 (EnableRetryOnFailure). Якщо з’єднання обривається посеред транзакції, EF Core не може знати, які команди було застосовано до обриву. Безпечно повторити він може лише повторивши всю транзакцію. Тому EF Core відмовляється від зробленого вручну BeginTransaction, поки увімкнено повторні спроби; натомість транзакцію треба виконувати всередині стратегії виконання (execution strategy), що повторює весь блок у разі тимчасового збою.
Що зробити. Створіть папку Repositories:
cs
using Chatex.Data.Abstractions;
using Chatex.Data.Exceptions;
using Microsoft.EntityFrameworkCore;
using Npgsql;
namespace Chatex.Data.Repositories;
internal sealed class UnitOfWork(ChatexDbContext db) : IUnitOfWork
{
public async Task<int> SaveChangesAsync(CancellationToken cancellationToken = default)
{
try
{
return await db.SaveChangesAsync(cancellationToken);
}
catch (DbUpdateException ex) when (ex.InnerException is PostgresException { SqlState: PostgresErrorCodes.UniqueViolation } pg)
{
// The failed entities would be saved again by the next call; drop them.
db.ChangeTracker.Clear();
throw new UniqueConstraintException(pg.ConstraintName, ex);
}
}
public async Task<T> ExecuteInTransactionAsync<T>(
Func<CancellationToken, Task<T>> action, CancellationToken cancellationToken = default)
{
var strategy = db.Database.CreateExecutionStrategy();
return await strategy.ExecuteAsync(async ct =>
{
await using var transaction = await db.Database.BeginTransactionAsync(ct);
try
{
var result = await action(ct);
await transaction.CommitAsync(ct);
return result;
}
catch
{
// Disposing the transaction rolls it back; drop the changes it would have saved.
db.ChangeTracker.Clear();
throw;
}
}, cancellationToken);
}
public Task ExecuteInTransactionAsync(Func<CancellationToken, Task> action, CancellationToken cancellationToken = default) =>
ExecuteInTransactionAsync(async ct =>
{
await action(ct);
return true;
}, cancellationToken);
}Крок за кроком:
- Фільтр винятків
catch (...) when (...)перехоплює лишеDbUpdateException, внутрішній виняток якої –PostgresExceptionіз кодом порушення унікальності. Шаблон властивостейPostgresException { SqlState: PostgresErrorCodes.UniqueViolation } pgодним виразом перевіряє тип і властивість та називає результатpg. Усі інші винятки проходять без змін. ChangeTracker.Clear()забуває всі відстежувані сутності. Інакше невдала сутність лишилася б позначеною якAdded, і наступнийSaveChangesAsyncтого самого запиту спробував би вставити її знову.CreateExecutionStrategy().ExecuteAsync(...)виконує лямбду й, у разі тимчасового збою, виконує її знову з початку. Усередині починається транзакція, виконуєтьсяactionвикликача, і транзакція фіксується.- За будь-якого винятку
await usingзвільняє транзакцію, що її відкочує, а відстежувані зміни очищаються. Виняток повторно викидається черезthrow;, що зберігає його початковий стек викликів. - Неузагальнене перевантаження обгортає дію у функцію, що повертає
true, тож логіка існує лише в одному екземплярі.
Усе, що зберігає транзакція, має відбуватися всередині лямбди
Оскільки лямбда може виконатися двічі, вона має сама створювати й відстежувати свої сутності. Сутність, створена до ExecuteInTransactionAsync і лише збережена всередині, після повторної спроби зникла б з очищеного контексту. Коментар до DependencyInjection.Configure (наступні розділи) повторює це правило для читачів коду.
Перевірка
dotnet build успішний. UnitOfWork має модифікатор internal і поки що ніким не використовується; його реєструють для впровадження залежностей у розділі Файли й реєстрація і тестують у темі 6.