Українська
Часові мітки з перехоплювачем
Крок 1. Єдине місце для годинника
Навіщо. У темі 3 сутності отримали інтерфейси IHasCreatedAt і IHasUpdatedAt. Тепер хтось має їх заповнювати. Писати chat.CreatedAt = DateTimeOffset.UtcNow у кожному сервісі – дві проблеми:
- хтось забуде це зробити, і чат буде створено 1 січня першого року (
default(DateTimeOffset)); - тести не можуть керувати часом. Тест «токен оновлення спливає через 30 днів» або «непідтверджене завантаження видаляється через 24 години» довелося б чекати.
EF Core пропонує перехоплювачі (interceptors): об’єкти, які EF Core викликає в певні моменти, наприклад безпосередньо перед збереженням. SaveChangesInterceptor бачить кожну сутність, яку контекст збирається вставити або оновити, і може її змінити. Це єдине місце, де задають часові мітки.
Поточний час теж береться не з DateTimeOffset.UtcNow, а з упровадженого TimeProvider – абстрактного класу з .NET 8 і новіших. Застосунок використовує TimeProvider.System, справжній годинник; тести замінюють його на FakeTimeProvider – годинник, який вони пересувають уручну (тема 7).
Що зробити. Створіть папку Interceptors і перехоплювач у ній:
cs
using Chatex.Data.Entities;
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Diagnostics;
namespace Chatex.Data.Interceptors;
/// <summary>Fills <see cref="IHasCreatedAt"/> and <see cref="IHasUpdatedAt"/> before every save.</summary>
internal sealed class TimestampInterceptor(TimeProvider timeProvider) : SaveChangesInterceptor
{
public override InterceptionResult<int> SavingChanges(DbContextEventData eventData, InterceptionResult<int> result)
{
Stamp(eventData.Context);
return result;
}
public override ValueTask<InterceptionResult<int>> SavingChangesAsync(
DbContextEventData eventData,
InterceptionResult<int> result,
CancellationToken cancellationToken = default)
{
Stamp(eventData.Context);
return ValueTask.FromResult(result);
}
private void Stamp(DbContext? context)
{
if (context is null)
{
return;
}
var now = timeProvider.GetUtcNow();
foreach (var entry in context.ChangeTracker.Entries())
{
if (entry.State == EntityState.Added && entry.Entity is IHasCreatedAt created && created.CreatedAt == default)
{
created.CreatedAt = now;
if (entry.Entity is Chat chat && chat.LastActivityAt == default)
{
chat.LastActivityAt = now;
}
}
if (entry.State is EntityState.Added or EntityState.Modified && entry.Entity is IHasUpdatedAt updated)
{
updated.UpdatedAt = now;
}
}
}
}Як це працює:
- Два перевизначення.
SaveChangesіSaveChangesAsync– окремі точки входу EF Core; якби перевизначити лише одну, часові мітки для іншої було б пропущено. Обидві викликаютьStampі повертаютьresultбез змін, що наказує EF Core продовжити збереження як звичайно. ChangeTracker.Entries()перелічує кожну сутність, яку відстежує контекст, разом з її станом:Added(буде вставлено),Modified(буде оновлено),Deleted,Unchanged.- Додані сутності отримують
CreatedAt– але лише якщо він досіdefault. Тест або імпорт даних може навмисно задати час створення, і перехоплювач це поважає. Новий чат також отримуєLastActivityAt, бо порожній чат усе одно має посісти місце в списку чатів. - Додані або змінені сутності отримують
UpdatedAt. ШаблонEntityState.Added or EntityState.Modified– це той самий комбінаторor, що ми використали вCanPost. - Одне
nowна все збереження. Усі сутності, що зберігаються разом, отримують точно той самий час, тож чат і його перші учасники мають однакові мітки.
ChatMember реалізує IHasCreatedAt.CreatedAt явно, відображаючи його на JoinedAt (тема 3). Перехоплювач бачить лише інтерфейс, тож нові учасники отримують JoinedAt, а перехоплювач про цю властивість не знає.
Чому не значення за замовчуванням у базі даних?
PostgreSQL міг би заповнювати created_at через DEFAULT now(). Але тоді значення задавав би годинник бази даних, а не TimeProvider тесту, і EF Core довелося б читати його після кожної вставки. Задавання значення в C# зберігає один годинник для всього.
Перехоплювачу потрібен TimeProvider, тож його створює механізм впровадження залежностей і додає до параметрів контексту під час реєстрації рівня даних – це буде разом з іншими сервісами в темі 5. До того контексти, створені інструментом dotnet ef, просто не проставляють часу, і це нормально: інструмент лише читає модель.
Перевірка
dotnet build успішний. Перехоплювач перевіряється в темі 6: зареєстрований користувач має мати CreatedAt, що не дорівнює default.