Українська
Прості запити
Крок 1. Безпечні шаблони пошуку
Навіщо. Користувачі шукають людей і публічні чати за частиною імені: «ali» знаходить alice. У SQL це ILIKE '%ali%' (ILIKE – це регістронезалежний LIKE у PostgreSQL). Але % і _ – це шаблонні символи (wildcards) у шаблоні LIKE: _ відповідає будь-якому одному символу. Пошук bob_ знайшов би й bobby, а пошук % повернув би всіх користувачів. Символи, які вводить користувач, треба екранувати, щоб вони означали самих себе.
Що зробити.
cs
namespace Chatex.Data.Repositories;
internal static class LikePattern
{
/// <summary>Pass to <c>EF.Functions.ILike</c>; without it Npgsql emits <c>ESCAPE ''</c> and the escaping is ignored.</summary>
public const string Escape = @"\";
/// <summary>Builds a LIKE pattern matching <paramref name="text"/> anywhere, with wildcards in it escaped.</summary>
public static string Contains(string text) =>
"%" + text.Replace(Escape, Escape + Escape).Replace("%", Escape + "%").Replace("_", Escape + "_") + "%";
}Contains("bob_") повертає %bob\_%: зовнішні % – шаблонні символи, екранований \_ – звичайне підкреслення. Зворотну скісну риску екранують першою, інакше введена \ екранувала б наступний символ. @"\" – це дослівний рядок (verbatim string): усередині @"..." зворотна скісна риска – звичайний символ.
Крок 2. Користувачі
Навіщо. Репозиторій користувачів показує три засоби, що трапляються майже в кожному запиті Chatex:
Includeзавантажує пов’язану сутність у тому самому запиті:Include(u => u.Profile)додаєJOINдоuser_profiles. Без ньогоuser.Profileлишаєтьсяnull.AsNoTrackingнаказує контексту не відстежувати результати. Відстеження коштує пам’яті й часу та потрібне лише для сутностей, які ми збираємося змінити й зберегти. Результати пошуку лише показують, тож вони тільки для читання.ExecuteUpdateAsyncзмінює рядки безпосередньо в базі даних однимUPDATE … WHERE …, не завантажуючи їх. Для «встановитиlast_seen_atцього користувача» не потрібен цілий користувач у пам’яті. Такі методи пишуть негайно, незалежно відSaveChangesAsync, як сказано в коментарях до їхніх інтерфейсів.
Що зробити.
cs
using Chatex.Data.Abstractions;
using Chatex.Data.Entities;
using Microsoft.EntityFrameworkCore;
namespace Chatex.Data.Repositories;
internal sealed class UserRepository(ChatexDbContext db) : IUserRepository
{
public Task<User?> GetByIdAsync(Guid id, CancellationToken cancellationToken = default) =>
db.Users.FirstOrDefaultAsync(u => u.Id == id, cancellationToken);
public Task<User?> GetWithProfileAsync(Guid id, CancellationToken cancellationToken = default) =>
db.Users.Include(u => u.Profile).FirstOrDefaultAsync(u => u.Id == id, cancellationToken);
public async Task<IReadOnlyList<User>> SearchAsync(string query, int limit, CancellationToken cancellationToken = default)
{
var pattern = LikePattern.Contains(query);
return await db.Users
.AsNoTracking()
.Include(u => u.Profile)
.Where(u => EF.Functions.ILike(u.UserName!, pattern, LikePattern.Escape)
|| (u.Profile != null && EF.Functions.ILike(u.Profile.DisplayName, pattern, LikePattern.Escape)))
.OrderBy(u => u.UserName)
.Take(limit)
.ToListAsync(cancellationToken);
}
public async Task<IReadOnlyList<Guid>> GetExistingIdsAsync(
IReadOnlyCollection<Guid> ids, CancellationToken cancellationToken = default) =>
await db.Users.Where(u => ids.Contains(u.Id)).Select(u => u.Id).ToListAsync(cancellationToken);
public void AddProfile(UserProfile profile) => db.UserProfiles.Add(profile);
public Task UpdateLastSeenAsync(Guid userId, DateTimeOffset lastSeenAt, CancellationToken cancellationToken = default) =>
db.Users
.Where(u => u.Id == userId)
.ExecuteUpdateAsync(s => s.SetProperty(u => u.LastSeenAt, lastSeenAt), cancellationToken);
}- Клас має модифікатори
internal sealed: поза рівнем даних видно лише інтерфейс. - Параметр первинного конструктора
dbзахоплюється методами; поле не потрібне. - Методи-вирази повертають
Taskз EF Core напряму (=> db.Users...FirstOrDefaultAsync(...)), безasync/await, бо після запиту нічого робити не треба. Методам, що перетворюютьList<T>наIReadOnlyList<T>,awaitпотрібен. EF.Functions.ILike(column, pattern, escape)перетворюється наcolumn ILIKE pattern ESCAPE '\'. Символ екранування треба передавати явно – чому, пояснює коментар уLikePattern.u.UserName!– в IdentityUserNameмає типstring?; знак!повідомляє компілятору, що в цьому запиті він неnull(кожен користувач Chatex має ім’я).ids.Contains(u.Id)перетворюється наid = ANY (@ids): один запит для цілого списку ідентифікаторів.
Крок 3. Токени оновлення
Що зробити.
cs
using Chatex.Data.Abstractions;
using Chatex.Data.Entities;
using Microsoft.EntityFrameworkCore;
namespace Chatex.Data.Repositories;
internal sealed class RefreshTokenRepository(ChatexDbContext db) : IRefreshTokenRepository
{
public void Add(RefreshToken token) => db.RefreshTokens.Add(token);
public Task<RefreshToken?> GetByHashAsync(string tokenHash, CancellationToken cancellationToken = default) =>
db.RefreshTokens.Include(t => t.User).FirstOrDefaultAsync(t => t.TokenHash == tokenHash, cancellationToken);
public Task<int> RevokeAllForUserAsync(Guid userId, DateTimeOffset revokedAt, CancellationToken cancellationToken = default) =>
db.RefreshTokens
.Where(t => t.UserId == userId && t.RevokedAt == null && t.ExpiresAt > revokedAt)
.ExecuteUpdateAsync(s => s.SetProperty(t => t.RevokedAt, revokedAt), cancellationToken);
public Task<int> DeleteStaleAsync(DateTimeOffset before, CancellationToken cancellationToken = default) =>
db.RefreshTokens
.Where(t => t.ExpiresAt < before || t.RevokedAt < before)
.ExecuteDeleteAsync(cancellationToken);
}GetByHashAsyncвідстежується: сервіс автентифікації відкличе токен і збереже його.RevokeAllForUserAsync(«вийти всюди») оновлює кожен активний токен користувача однимUPDATEі повертає, скільки рядків змінилося.DeleteStaleAsyncвикористовуєExecuteDeleteAsync– одинDELETE … WHERE ….t.RevokedAt < beforeдаєfalseдляNULLуRevokedAtі в C# (піднесене порівняння), і в SQL, тож токени, які ніколи не відкликали, видаляються лише після закінчення строку.
Крок 4. Вкладення
Що зробити.
cs
using Chatex.Data.Abstractions;
using Chatex.Data.Entities;
using Microsoft.EntityFrameworkCore;
namespace Chatex.Data.Repositories;
internal sealed class AttachmentRepository(ChatexDbContext db) : IAttachmentRepository
{
public void Add(Attachment attachment) => db.Attachments.Add(attachment);
public void Remove(Attachment attachment) => db.Attachments.Remove(attachment);
public Task<Attachment?> GetByIdAsync(Guid id, CancellationToken cancellationToken = default) =>
db.Attachments.Include(a => a.Message).FirstOrDefaultAsync(a => a.Id == id, cancellationToken);
public async Task<IReadOnlyList<Attachment>> GetPendingAsync(
Guid uploaderId, IReadOnlyCollection<Guid> ids, CancellationToken cancellationToken = default) =>
await db.Attachments
.Where(a => a.UploaderId == uploaderId && a.MessageId == null && ids.Contains(a.Id))
.ToListAsync(cancellationToken);
public async Task<IReadOnlyList<Attachment>> GetStalePendingAsync(
DateTimeOffset before, int limit, CancellationToken cancellationToken = default) =>
await db.Attachments
.Where(a => a.MessageId == null && a.CreatedAt < before)
.OrderBy(a => a.CreatedAt)
.Take(limit)
.ToListAsync(cancellationToken);
}GetPendingAsync – це перевірка безпеки, записана як запит: з ідентифікаторів, які клієнт надсилає разом із повідомленням, вона повертає лише завантаження, що належать цьому користувачеві й ще не прикріплені до повідомлення. Клієнт не може прикріпити чужий файл чи повторно використати файл з іншого повідомлення, вгадуючи ідентифікатори. GetStalePendingAsync повертає найстаріші ненадіслані завантаження першими, не більше limit, тож завдання очищення з теми 13 працює невеликими порціями.
Перевірка
dotnet build успішний.