☰ Демоприложение Один плюс один, разработка ПО Логотип
Презентация 01

Слой данных
DataAccessLayer

Как одна сущность превращается в таблицу базы данных — без ручного SQL и без миграций.

Зачем нужен этот слой?

  • Весь доступ к базе данных проходит здесь — ни один другой слой не пишет SQL.
  • Собственный небольшой и узкоспециализированный ORM: Record + атрибуты, без Entity Framework.
  • Поддерживает трёх поставщиков ровно одним и тем же кодом: SQL Server, MySQL, SQLite.
  • Асинхронный от края до края — каждое обращение к базе данных это await, ни один поток не блокируется.
Record IDataSupplier SqlDataAccess MySqlDataAccess SqliteDataAccess

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.

Итог: описываем сущность, помечаем столбцы — и слой делает всё остальное.