Українська
Контекст бази даних
Крок 1. Додайте пакети EF Core
Навіщо. Entity Framework Core (EF Core) – це об’єктно-реляційний відображувач (ORM): він перекладає між об’єктами C# і рядками реляційної бази даних. Ми описуємо таблиці один раз, мовою C#, а EF Core генерує SQL, щоб створити їх, запитувати через LINQ і зберігати зміни. Сам EF Core не знає жодної конкретної бази даних; ці знання додає провайдер. Chatex потрібні три пакети:
Npgsql.EntityFrameworkCore.PostgreSQL– провайдер PostgreSQL (Npgsql – це драйвер .NET для PostgreSQL). Пакет Identity з теми 3 уже приніс сам EF Core;EFCore.NamingConventions– PostgreSQL зводить імена без лапок до нижнього регістру, тож ім’я C#LastActivityAtдовелося б писати як"LastActivityAt"в лапках у кожному запиті, написаному вручну. Цей пакет називає таблиці й стовпці у snake_case (last_activity_at) – звичному стилі PostgreSQL;Microsoft.EntityFrameworkCore.Design– код, який інструментdotnet efзапускає всередині нашого проєкту, щоб створювати міграції. Він потрібен лише під час проєктування.
Що зробити.
powershell
dotnet add Source/Chatex.Data package Npgsql.EntityFrameworkCore.PostgreSQLpowershell
dotnet add Source/Chatex.Data package EFCore.NamingConventionspowershell
dotnet add Source/Chatex.Data package Microsoft.EntityFrameworkCore.Designxml
<Project Sdk="Microsoft.NET.Sdk">
<ItemGroup>
<PackageReference Include="EFCore.NamingConventions" />
<PackageReference Include="Microsoft.AspNetCore.Identity.EntityFrameworkCore" />
<PackageReference Include="Microsoft.EntityFrameworkCore.Design">
<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
<PrivateAssets>all</PrivateAssets>
</PackageReference>
<PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" />
</ItemGroup>
</Project>dotnet add записав посилання на Design із двома додатковими елементами. PrivateAssets зі значенням all означає, що пакет не передається проєктам, які посилаються на Chatex.Data: Chatex.Core і Chatex.Api не потребують інструментів міграцій, і вони ніколи не потраплять до опублікованого застосунку.
Крок 2. Контекст
Навіщо. DbContext – центральний клас EF Core. Він містить модель – перелік сутностей і те, як кожна відображається на таблицю, – і є «одиницею роботи» (Unit of Work): відстежує об’єкти, завантажені через нього, а SaveChangesAsync записує всі їхні зміни до бази даних за один раз.
Контекст Chatex успадковується не від DbContext, а від IdentityDbContext<TUser, TRole, TKey> з Identity. Цей базовий клас уже відображає таблиці облікових записів, потрібні Identity: користувачів, ролі, твердження (claims), зовнішні входи й токени користувачів. Три аргументи типів означають, що клас користувача – User, ролі використовують власний IdentityRole<Guid> з Identity, а кожен ключ – Guid.
Що зробити. Створіть контекст у кореневій папці проєкту даних:
cs
using Chatex.Data.Entities;
using Microsoft.AspNetCore.Identity;
using Microsoft.AspNetCore.Identity.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore;
namespace Chatex.Data;
public class ChatexDbContext(DbContextOptions<ChatexDbContext> options)
: IdentityDbContext<User, IdentityRole<Guid>, Guid>(options)
{
public DbSet<UserProfile> UserProfiles => Set<UserProfile>();
public DbSet<RefreshToken> RefreshTokens => Set<RefreshToken>();
public DbSet<Chat> Chats => Set<Chat>();
public DbSet<ChatMember> ChatMembers => Set<ChatMember>();
public DbSet<Message> Messages => Set<Message>();
public DbSet<Attachment> Attachments => Set<Attachment>();
protected override void OnModelCreating(ModelBuilder builder)
{
base.OnModelCreating(builder);
// Identity maps to AspNet* tables; use plain names instead. Principal tables (users, roles) are
// renamed first, because the snake_case convention names a foreign key when its dependent table is renamed.
builder.Entity<User>().ToTable("users");
builder.Entity<IdentityRole<Guid>>().ToTable("roles");
builder.Entity<IdentityUserRole<Guid>>().ToTable("user_roles");
builder.Entity<IdentityUserClaim<Guid>>().ToTable("user_claims");
builder.Entity<IdentityUserLogin<Guid>>().ToTable("user_logins");
builder.Entity<IdentityUserToken<Guid>>().ToTable("user_tokens");
builder.Entity<IdentityRoleClaim<Guid>>().ToTable("role_claims");
builder.ApplyConfigurationsFromAssembly(typeof(ChatexDbContext).Assembly);
}
}Рядок за рядком:
- Первинний конструктор
ChatexDbContext(DbContextOptions<ChatexDbContext> options)(C# 12) отримує параметри – провайдер, рядок підключення, перехоплювачі – і передає їх базовому класу. Сам контекст не знає, де база даних; це вирішує той, хто його створює (застосунок у темі 5, інструментdotnet efу розділі Перша міграція). - Властивості
DbSet<T>– це точки входу для запитів:db.Messages.Where(...). Їх записано як властивості-вирази, що повертаютьSet<T>(), тому їм ніколи не потрібне початкове значення і вони ніколи не дорівнюютьnull.Usersуспадковано відIdentityDbContext. OnModelCreatingбудує модель.base.OnModelCreatingмає йти першим: він відображає таблиці Identity, а наші зміни перевизначають його вибір.- Виклики
ToTableперейменовують таблиці Identity. Типово вони називаютьсяAspNetUsers,AspNetRoles, …; у snake_case вони стали бasp_net_users. Прості назви на кшталтusersу SQL читаються краще. Порядок має значення, як пояснює коментар: угода snake_case називає обмеження зовнішнього ключа за його таблицями в момент перейменування залежної таблиці, тому головні таблиці йдуть першими. ApplyConfigurationsFromAssemblyзнаходить кожен клас цієї збірки, що реалізуєIEntityTypeConfiguration<T>, і застосовує його. Кожна сутність отримує власний невеликий клас конфігурації (наступний розділ) замість одного нескінченногоOnModelCreating.
Угода, конфігурація, анотація
EF Core будує модель у три шари. Угоди (conventions) визначають типове: властивість Id є ключем, ChatId разом із навігацією Chat є зовнішнім ключем, string? – стовпець, що допускає NULL. Анотації даних – атрибути на кшталт [MaxLength(64)] на сутності – змінюють типове. Fluent API в OnModelCreating або в класах конфігурації теж змінює його і має останнє слово. Chatex використовує лише угоди та Fluent API, тож сутності з теми 3 лишаються простими класами без атрибутів бази даних.
Перевірка
powershell
dotnet buildЗбірка успішна. Модель ще не завершена – складений ключ ChatMember і ключ UserProfile не можна знайти за угодою – але EF Core перевіряє модель лише під час першого використання, у розділі Перша міграція.