Українська
Список чатів
Крок 1. Що потрібно списку чатів
Навіщо. Список чатів – перший екран месенджера; його завантажують під час кожного запуску й після кожного перепідключення. Кожен рядок показує (рис. 5.2):
- сам чат: назву або, для особистого чату, ім’я й аватар співрозмовника;
- попередній перегляд останнього повідомлення та його час;
- кількість непрочитаних повідомлень;
- роль користувача й те, чи вимкнено сповіщення чату.
Рядки впорядковано за активністю: першим іде чат з найновішим повідомленням.
Рис. 5.2. Дані, що стоять за одним рядком списку чатів
Наївна реалізація завантажує чати, а потім для кожного чату виконує ще три запити – 61 запит для 20 чатів (проблема N+1). Chatex будує один запит: LINQ із підзапитами всередині проєкції, який EF Core перетворює на один оператор SQL – корельований підзапит SELECT count(*) для лічильника непрочитаних і з’єднання з пронумерованими рядками (ROW_NUMBER() OVER (PARTITION BY chat_id …)), що вибирають найновіше повідомлення й іншого учасника кожного чату.
Крок 2. Курсор із двох значень
Навіщо. Список відсортовано за LastActivityAt, але два чати можуть мати абсолютно однаковий час активності – наприклад, два чати, створені одним збереженням. Курсор лише з часу пропускав би або повторював такі чати на межі сторінок. Курсору потрібен другий, унікальний розрізнювач: ідентифікатор чату. Порядок стає (LastActivityAt, ChatId) за спаданням, а «наступна сторінка» означає «рядки, що йдуть після пари (t, id)».
SQL може порівнювати такі пари безпосередньо за допомогою кортежу значень (row value): (a, b) < (x, y) істинне, коли a < x або a = x і b < y. EF Core пропонує це як EF.Functions.LessThan(ValueTuple.Create(a, b), ValueTuple.Create(x, y)).
Крок 3. Репозиторій чатів
Що зробити.
cs
using Chatex.Data.Abstractions;
using Chatex.Data.Entities;
using Chatex.Data.Models;
using Microsoft.EntityFrameworkCore;
namespace Chatex.Data.Repositories;
internal sealed class ChatRepository(ChatexDbContext db) : IChatRepository
{
private const int PreviewLength = 100;
private IQueryable<Chat> Chats => db.Chats.Where(c => c.DeletedAt == null);
public void Add(Chat chat) => db.Chats.Add(chat);
public Task<Chat?> GetByIdAsync(Guid id, CancellationToken cancellationToken = default) =>
Chats.FirstOrDefaultAsync(c => c.Id == id, cancellationToken);
public Task<Chat?> GetDirectAsync(Guid userA, Guid userB, CancellationToken cancellationToken = default)
{
var key = Chat.MakeDirectKey(userA, userB);
return Chats.FirstOrDefaultAsync(c => c.DirectKey == key, cancellationToken);
}
public Task<Chat?> GetByHandleAsync(string handle, CancellationToken cancellationToken = default)
{
var normalized = handle.ToLowerInvariant();
return Chats.FirstOrDefaultAsync(c => c.PublicHandle == normalized, cancellationToken);
}
public async Task<IReadOnlyList<Chat>> SearchPublicAsync(string query, int limit, CancellationToken cancellationToken = default)
{
var pattern = LikePattern.Contains(query);
return await Chats
.AsNoTracking()
.Where(c => c.PublicHandle != null
&& (EF.Functions.ILike(c.PublicHandle, pattern, LikePattern.Escape)
|| EF.Functions.ILike(c.Title!, pattern, LikePattern.Escape)))
.OrderBy(c => c.PublicHandle)
.Take(limit)
.ToListAsync(cancellationToken);
}
public async Task<CursorPage<ChatListItem, ChatListCursor>> GetUserChatsAsync(
Guid userId, ChatListCursor? after, int limit, CancellationToken cancellationToken = default)
{
var memberships = db.ChatMembers
.AsNoTracking()
.Where(m => m.UserId == userId && m.Chat.DeletedAt == null);
if (after is { } cursor)
{
memberships = memberships.Where(m => EF.Functions.LessThan(
ValueTuple.Create(m.Chat.LastActivityAt, m.ChatId),
ValueTuple.Create(cursor.LastActivityAt, cursor.ChatId)));
}
var items = await memberships
.OrderByDescending(m => m.Chat.LastActivityAt)
.ThenByDescending(m => m.ChatId)
.Take(limit + 1)
.Select(m => new ChatListItem(
m.Chat,
m.Role,
m.IsMuted,
m.Chat.Messages
.Where(x => x.DeletedAt == null)
.OrderByDescending(x => x.Id)
.Select(x => new MessagePreview(
x.Id,
x.SenderId,
x.Body.Length > PreviewLength ? x.Body.Substring(0, PreviewLength) : x.Body,
x.CreatedAt))
.FirstOrDefault(),
m.Chat.Messages.Count(x => x.DeletedAt == null
&& x.SenderId != userId
&& (m.LastReadMessageId == null || x.Id.CompareTo(m.LastReadMessageId.Value) > 0)),
m.Chat.Type == ChatType.Direct
? m.Chat.Members
.Where(o => o.UserId != userId)
.Select(o => new UserSummary(o.UserId, o.User.UserName!, o.User.Profile!.DisplayName, o.User.Profile.AvatarPath))
.FirstOrDefault()
: null))
.ToListAsync(cancellationToken);
return Paging.ToPage(items, limit, i => new ChatListCursor(i.Chat.LastActivityAt, i.Chat.Id));
}
public Task TouchAsync(Guid chatId, DateTimeOffset at, CancellationToken cancellationToken = default) =>
db.Chats
.Where(c => c.Id == chatId && c.LastActivityAt < at)
.ExecuteUpdateAsync(s => s.SetProperty(c => c.LastActivityAt, at), cancellationToken);
}Згори:
Приватна властивість
Chats– це таблиця без чатів, видалених «м’яко». Кожен метод починається з неї, тож видалений чат не прослизне через забутий фільтр. (У EF Core для цього є й глобальні фільтри запитів; явна властивість тримає фільтр на виду там, де його використано.)GetByHandleAsyncпереводить псевдонім у нижній регістр: псевдоніми зберігаються в нижньому регістрі, тож@DotNetі@dotnet– це той самий чат.SearchPublicAsyncзіставляє ідентифікатор або назву, але лише чатів, що мають ідентифікатор: приватні чати ніколи не з’являються в пошуку.c.Title!– групи й канали завжди мають назву.GetUserChatsAsyncпочинає з членств користувача, а не з чатів, бо чат з’являється в списку лише для своїх учасників. Далі, в одномуSelect:m.Chat.Messages ... .FirstOrDefault()– останнє невидалене повідомлення, обрізане до 100 символів черезSubstring(перетворюється на SQL);m.Chat.Messages.Count(...)рахує непрочитані повідомлення: невидалені, надіслані не користувачем і новіші за позицію прочитаного (або всі, якщо користувач нічого не читав);- співрозмовник – це інший учасник особистого чату, спроєктований у
UserSummary; групи й канали отримуютьnull.
Take(limit + 1)іPaging.ToPageпрацюють так само, як в історії повідомлень; курсор будується з часу активності й ідентифікатора останнього елемента.TouchAsyncпересуваєLastActivityAtуперед однимUPDATE, і лише якщо новий час пізніший. Коли два повідомлення надіслано майже одночасно, порядок фіксації їхніх транзакцій не може посунути час активності назад.
Проєкція замість Include
GetUserChatsAsync не використовує Include. Select у новий тип (проєкція) точно вказує EF Core, які стовпці вибрати, а підзапити стають частиною того самого оператора SQL. Типи результатів ChatListItem, MessagePreview і UserSummary не є сутностями, тож їх ніколи не відстежують.
Перевірка
dotnet build успішний. Щоб побачити SQL списку чатів, запустіть програму з останнього розділу цієї теми з увімкненим журналюванням EF Core (вправа 1 у контрольній точці).