Drift (Moor) — bu nima, reaktiv ORM va ma'lumotlar bazalari bilan ishlash

Drift nima?

Drift — Dart va Flutter uchun ORM, ilgari Moor nomi bilan tanilgan. Simon Binder tomonidan 2019-yilda yaratilgan va bir nechta asosiy versiyalarni bosib o'tgan. Drift Dart so'rovlarini drift_dev va build_runner yordamida qurilish bosqichida SQLga kompilyatsiya qiladi, bu to'liq tip xavfsizligini ta'minlaydi va runtime da SQL sintaksis xatolarini bartaraf etadi.

Floor dan farqli o'laroq, Drift so'rovlarni qurish uchun o'z DSLidan (Domain-Specific Language) foydalanadi — dasturchi Dartda yozadi, generator esa buni SQLga tarjima qiladi. Bu IDE ga sintaksisni tekshirish, jadval maydonlarini avtomatik to'ldirish va so'rovni buzish qo'rquvisiz ma'lumot modelini refaktor qilish imkonini beradi.

Drift (2024) ma'lumotlariga ko'ra, kutubxona 8000 dan ortiq Flutter loyihalarida qo'llaniladi. Barcha mashhur platformalarni qo'llab-quvvatlaydi: Android sqflite orqali, iOS sqflite orqali, web sqlite3 WASM orqali, desktop mahalliy sqlite3 drayveri orqali.

Nom o'zgarishi tarixi: Moor → Drift

Moor 2.0 versiyasida (2022) Drift ga o'zgartirildi. Sabab — boshqa loyihalar bilan nom ziddiyati va eski koddan uzoqlashish istagi. API mos qoldi: migratsiya uchun import ni moordan driftga o'zgartirish va bog'liqliklarni yangilash kifoya.

Asosiy imkoniyatlar

Drift ta'minlaydi: ma'lumot o'zgarishida avtomatik yangilanadigan o'rnatilgan Stream so'rovlari, qaytarish bilan tranzaksiyalarni qo'llab-quvvatlash, rawQuery orqali maxsus SQL so'rovlari, mantiqni inkapsulyatsiya qilish uchun DAO namunasi, platformalararo migratsiyalar va drift_riverpod va drift_bloc paketlari orqali Riverpod va BLoC bilan integratsiya.

Drift qanday ishlaydi?

Drift kompilyatsiya bosqichida kod generatsiyasidan foydalanadi. Dasturchi jadvallarni @DataClass annotatsiyalari yoki Table ni kengaytiruvchi Dart sinflari orqali tavsiflaydi. Generator yordamchi sinflarni yaratadi: Companion (qo'shish/yangilashda nullable maydonlar uchun), DriftDatabase (kirish nuqtasi) va DAO tatbiqlari.

SQLite so'rovlarini Drift bevosita bajarmaydi. Buning o'rniga dasturchi Dartda yozadi: select(tasks).where(tasks.priority.greaterThan(3)).build(). Generator buni SQLga tarjima qiladi va ijro vaqtida Drift shunchaki tayyor SQL so'rovini SQLite ga yuboradi. Bu Dart sintaksisining qulayligini mahalliy SQL samaradorligi bilan birlashtiradi.

So'rov arxitekturasi

Drift ikkita so'rov rejimini qo'llab-quvvatlaydi: DSL (tavsiya etiladi) va raw SQL. DSL so'rovlari xavfsizroq — kompilyator maydon nomlari, turlari va moslikni tekshiradi. Raw SQL DSL bilan qamrab olinmagan murakkab so'rovlar uchun kerak: oyna funksiyalari, rekursiv CTE, maxsus SQLite kengaytmalari.

Drift DSL vs SQL: yondashuvlarni taqqoslash

Drift ikkita so'rov yozish usulini taklif etadi: Dart DSL (mahalliy) va raw SQL (murakkab holatlar uchun). DSL 90% ssenariylar uchun afzal: xavfsizroq, o'qilishi oson va refaktoringni qo'llab-quvvatlaydi. Raw SQL faqat DSL talab qilinadigan konstruksiyani qamrab olmaganida ishlatiladi.

DSL qachon ishlatiladi

Drift DSL — asosiy ish usuli. SELECT, INSERT, UPDATE, DELETE, WHERE, ORDER BY, LIMIT, JOIN va guruhlashni qamrab oladi. Barcha odatiy CRUD so'rovlari uchun DSL dan foydalaning: qisqaroq, xavfsizroq va o'zgarishlarda Stream ni avtomatik yangilaydi.

Raw SQL qachon ishlatiladi

Raw SQL Drift da quyidagilar uchun kerak: maxsus SQLite funksiyalari (FTS5, JSON1), EXISTS bilan murakkab quyi so'rovlar, INSERT OR REPLACE, CASE bilan ommaviy UPDATE, shuningdek samaradorlik muhim bo'lgan va DSL optimal ijro rejasini yaratmaydigan so'rovlar. Raw SQL drift_dev orqali tiplash qo'llab-quvvatlashi bilan .sql fayllarida yozilishi mumkin.

Drift bilan kod misollari

Drift Table ni kengaytiruvchi sinflar yoki @DataClass annotatsiyasidan foydalanadi. Quyida — DSL, raw SQL va reaktiv yangilash bilan Task modelining to'liq namunasi. build_runner ishga tushirilgandan so'ng, barcha yaratilgan sinflar tayyor.

Jadval va ma'lumotlar bazasini aniqlash

Tasks sinfi Table ni kengaytiradi va ustunlarni belgilaydi. Har bir ustun Column tipidagi ifodadir. Parametrlar: withDefault() standart qiymatni o'rnatadi, autoIncrement() avtomatik o'sishni ta'minlaydi. Ma'lumotlar bazasi $DriftDatabase ni kengaytiruvchi abstrakt sinfdir.

class Tasks extends Table {
    IntColumn get id => integer().autoIncrement();
    TextColumn get title => text().withDefault(const Constant(''))();
    BoolColumn get isCompleted => boolean().withDefault(const Constant(false))();
    IntColumn get priority => integer().withDefault(const Constant(0))();
}

@DriftDatabase(tables: [Tasks])
class AppDatabase extends $AppDatabase {
    AppDatabase(QueryExecutor e) : super(e);
}

CRUD operatsiyalari DSL orqali

Drift jadvallar uchun into(tasks).insert(), select(tasks), update(tasks) va delete(tasks) metodlarini yaratadi. Barcha operatsiyalar Future qaytaradi — SQLite bilan ishlash asinxrondir. O'zgarishlarni kuzatish uchun .get() o'rniga .watch() dan foydalaning.

// Yozish
await into(tasks).insert(TasksCompanion.insert(
    title: Value('Mahsulotlarni sotib olish'),
    priority: Value(3),
));

// Filtrlash bilan o'qish
final highPriority = await (select(tasks)
    ..where((t) => t.priority.greaterThan(2))
    ..orderBy([(t) => OrderingTerm(expression: t.priority, mode: OrderingMode.desc)]))
    .get();

// Reaktiv kuzatish
select(tasks).watch().listen((tasksList) {
    // tasksList — List, jadval har o'zgarganida yangilanadi
    updateUi(tasksList);
});

Raw SQL tiplangan natija bilan

Murakkab so'rovlar uchun Drift raw SQL yozishga imkon beradi, bir vaqtning o'zida tiplashni saqlaydi. customSelect metodi so'rov satrini qabul qiladi va kod generatori orqali tiplangan natija qaytaradi. Bu yondashuv SQL egiluvchanligini Drift tip xavfsizligi bilan birlashtiradi.

final result = await customSelect(
    'SELECT title, COUNT(*) as cnt FROM tasks GROUP BY title',
    readsFrom: { tasks },
).get();

for (final row in result) {
    print('${row.readString("title")}: ${row.readInt("cnt")}');
}

Driftda migratsiyalar va versiyalash

Drift ham avtomatik migratsiyalarni (oddiy o'zgarishlar uchun), ham qo'l migratsiyalarni (murakkab transformatsiyalar uchun) qo'llab-quvvatlaydi. Ma'lumotlar bazasi versiyasi AppDatabase konstruktorida o'rnatiladi. Versiya mos kelmasa, Drift barcha yopilmagan migratsiyalarni ketma-ket qo'llaydi.

Avtomatik migratsiyalar

Standart qiymatga ega ustun qo'shish uchun Drift MigrationStrategy orqali avtomatik migratsiya yaratishi mumkin. Agar o'zgarish mavjud ma'lumotlarni buzmasa (nullable maydon qo'shish), versiya tekshiruvi va ALTER TABLE bajarilishi bilan beforeOpen dan foydalanish mumkin.

Qo'l migratsiyalari

Murakkab o'zgarishlar (jadval nomini o'zgartirish, ma'lumotlarni birlashtirish, ustun turini o'zgartirish) uchun Drift qo'l SQL migratsiyasini talab qiladi. Migratsiyalar ma'lumotlar bazasi sinfidagi migrations parametri orqali belgilanadi. Har bir migratsiya from/to raqamlari va SQL so'rovlari bo'lgan obyektdir.

Drift va testlash

Drift NativeDatabase.memory() orqali test rejimida ishga tushirishni qo'llab-quvvatlaydi. Xotiradagi ma'lumotlar bazasi har bir testdan oldin noldan yaratiladi va testdan keyin yo'q qilinadi. Mock qilish uchun mocklangan QueryExecutor bilan mocktail paketidan foydalaning. Drift shuningdek migratsiyalar va so'rovlarni tekshirish bilan integrasion testlar uchun DatabaseTestHelper ni taqdim etadi.

DAO namunasi Driftda

Drift @DriftAccessor annotatsiyasi bilan abstrakt sinflar orqali DAO (Data Access Object) ni qo'llab-quvvatlaydi. DAO bir yoki bir nechta jadvalga so'rovlarni inkapsulyatsiya qiladi va ma'lumotlar bazasidan alohida sinovdan o'tkazilishi mumkin. To'g'ridan-to'g'ri Database so'rovlaridan farqli o'laroq, DAO so'rov mantiqini ilovaning turli qismlari o'rtasida qayta ishlatish imkonini beradi va modul testlarini soddalashtiradi.

@DriftDatabase(tables: [Tasks])
class AppDatabase extends $AppDatabase {
    AppDatabase(QueryExecutor e) : super(e) {
        migrations.add(Migration(1, 2, (m) async {
            await m.addColumn(tasks, tasks.dueDate);
            await m.createIndex(tasks.idxPriority);
        }));
    }
}