Презентация 01
Слой данных
DataAccessLayer
Как одна сущность превращается в таблицу базы данных — без ручного SQL и без миграций.
Зачем нужен этот слой?
- Весь доступ к базе данных проходит здесь — ни один другой слой не пишет SQL.
- Собственный небольшой и узкоспециализированный ORM:
Record+ атрибуты, без Entity Framework. - Поддерживает трёх поставщиков ровно одним и тем же кодом: SQL Server, MySQL, SQLite.
- Асинхронный от края до края — каждое обращение к базе данных это
await, ни один поток не блокируется.
Record — сердце слоя
- У каждой сущности есть
ID(первичный ключ) иDescription. - Помечаем свойство атрибутом
[Column]— и это столбец в базе данных. - Имя таблицы = имя класса; ключ =
имя+Id. - Никаких ручных ALTER: при старте приложения
SetupAsyncсоздаёт недостающие таблицы, добавляет и расширяет столбцы по коду.
public class Car : Record
{
[Column(Size = 300)]
public override string Description { get; set; }
[Column] public bool IsAutomatic { get; set; }
[Column] public double Volume { get; set; }
[Column] public string Color { get; set; }
[Column] public DateTime ProductionDate { get; set; }
}
Это весь код, который нужен, чтобы таблица Car появилась в базе данных и управлялась с экрана.
Асинхронный CRUD
Car c = new Car { Description = "Mazda 3", Volume = 2.0 };
await c.SaveAsync(); // INSERT (новый ID) или UPDATE — автоматически
Car loaded = await Record.GetAsync<Car>(c.ID); // загрузка по ключу
List<Car> all = await Record.AllAsync<Car>(); // все записи
int n = await Record.CountAsync<Car>(); // подсчёт
c.Color = "Красный";
await c.UpdatePropertiesAsync("Color"); // обновление одного столбца — не полный Save!
await c.DeleteAsync();
- Правило команды: точечное обновление =
UpdatePropertiesAsync, а неSaveAsync— чтобы не тянуть за собой побочные эффекты полного сохранения. DateTime.MinValueозначает «дата отсутствует» — сохраняется как NULL.
Запросы с фильтрами — AndFilter
AndFilter f = new AndFilter();
f.Add("color", "Красный"); // равенство, с параметром
f.Add("volume", 1.6, EqalityOperators.GreaterThan);
f.AddBetween("productionDate", from, to);
List<Car> cars = await Record.PartialAsync<Car>(f, "productionDate desc",
pageNumber: 0, pageSize: 20);
int total = await Record.CountAsync<Car>(f);
- Фильтр строит WHERE с параметрами — без склейки строк и без SQL Injection.
OrFilterдобавляет условия «или»; постраничный вывод — черезPagingTemplateкаждого поставщика.
Как один и тот же код работает с тремя базами данных?
- Поставщик выбирается по строке подключения:
Server=← MySQL,Data Source=*.db← SQLite, иначе ← SQL Server. - Код пишется на T-SQL;
FixSqlкаждого поставщика переводит его:GETDATE(),ISNULL,[скобки],IDENTITY… - SQLite дополнительно получает функции
YEAR/MONTH/DAY, реализованные на C#. - Локальная разработка на SQLite, продакшен на SQL Server/MySQL — без единой изменённой строки.
Что ещё лежит в этом ящике
- Шифрование:
[Column(IsEncrypted = true)]— значение шифруется по AES перед записью и расшифровывается при чтении. - Сериализация:
SerializeType = Jsonхранит объект целиком в текстовом столбце. - Индексы:
CreateIndexAsync("color")— создаётся только если его ещё нет, у любого поставщика. - Импорт:
ImportAsyncраспознаёт существующие записи поIsUniqueIdи обновляет их вместо дублирования. - Транзакции:
BeginTransactionAsync / CommitTransactionAsync.
Итог: описываем сущность, помечаем столбцы — и слой делает всё остальное.