Hive: какво е, NoSQL хранилище и разработка без нативен код

Какво е Hive?

Hive — е NoSQL база данни, написана изцяло на Dart, която не изисква нативни библиотеки. Създадена е от Simon Leiter през 2019 г. като алтернатива на SQLite за Flutter проекти. Hive съхранява данни в двоичен формат .hive, който е оптимизиран за бързо четене и запис на мобилни устройства. Форматът .hive използва персонализирана схема за сериализация, при която всеки тип данни има свой собствен байтов префикс, което позволява четене на файла без предварително познаване на схемата — за разлика от Protocol Buffers или FlatBuffers.

Основната идея на Hive — максимална простота. Базата данни не изисква инициализация на нативни двигатели, не включва SQL парсер и не използва рефлексия. Всички операции са директни извиквания на Dart функции с двоична сериализация чрез WriteBuffer и ReadBuffer.

Според проучване на Flutter Community (2023), Hive е в топ 5 на най-използваните пакети за съхранение на данни в Flutter, като отстъпва по популярност само на shared_preferences, но го превъзхожда по функционалност и скорост.

Архитектура на Hive

Hive използва концепцията Box — аналог на таблица в релационни бази данни. Всеки Box е файл на диска с набор от двойки ключ-стойност. Ключът може да бъде int или String, стойността — всеки примитивен тип, списък, Map или персонализиран обект чрез TypeAdapter. Box-овете са изолирани един от друг и се отварят независимо.

Предимства пред нативните решения

Hive не изисква платформени канали (platform channels). Това означава, че работи еднакво на Android, iOS, Web, macOS, Windows и Linux без допълнителна конфигурация. За проекти, насочени към уеб компилация, Hive остава единственото леко NoSQL решение — SQLite не работи в браузъра. В същото време Hive използва IndexedDB като backend за уеб, което осигурява устойчивост на данните и в браузърна среда.

Как работи Hive?

Hive сериализира данни в двоичен формат при запис и десериализира при четене. Вътрешният механизъм се основава на BinaryWriter и BinaryReader, които опаковат данните в компактни байтови масиви. Размерът на хранилището на диска е средно 2–3 пъти по-малък от JSON представянето на същите данни.

При отваряне на Box, Hive зарежда целия файл в RAM. Това осигурява висока скорост на четене (микросекунди), но налага ограничение върху размера на данните: препоръчва се съхраняване на не повече от 50–100 MB на един Box. За по-големи обеми използвайте LazyBox — мързеливо зареждане на записи от диска.

Транзакции и конкурентност

Hive работи еднонишково в изолация на Dart-изолат. Операциите за запис се изпълняват синхронно с заключване на файла. За асинхронен достъп използвайте Hive.openBox() с await. Конкурентният достъп от множество изолати не се поддържа директно — за това е необходим отделен механизъм за синхронизация.

Hive срещу SharedPreferences и срещу SQLite

Hive заема ниша между SharedPreferences и SQLite. По-сложен е от SharedPreferences (поддържа персонализирани обекти), но по-прост от SQLite (не изисква SQL заявки). Нека сравним ключовите характеристики.

Кога да изберете Hive

Hive е оптимален за малки обеми данни: настройки на приложение, кеш на API отговори, локална опашка за синхронизация, любими и история на разглеждане. Ако данните не надвишават 50 MB и не изискват релационни заявки — Hive е по-бърз и по-прост от SQLite.

Кога Hive не е подходящ

Hive не поддържа заявки с филтриране по множество полета, JOIN, агрегатни функции. Ако имате нужда от сложни заявки като “избери всички задачи за днес с приоритет над 3” — използвайте SQLite с drift или floor. Hive също не е подходящ за съхранение на над 100 MB данни поради зареждане в паметта.

Примери за код с Hive

Hive започва с инициализация и отваряне на Box. По-долу са показани основните операции за типичен сценарий — съхраняване на списък със задачи в Flutter приложение. Всички примери работят без нативни платформени извиквания.

Инициализация и отваряне на Box

Преди използване на Hive трябва да се извика Hive.initFlutter() в main функцията. След това отворете Box чрез Hive.openBox() — резултатът ще бъде инстанция на Box, готова за четене и запис.

import 'package:hive/hive.dart';
import 'package:hive_flutter/hive_flutter.dart';

void async main() {
    await Hive.initFlutter();
    final settingsBox = await Hive.openBox('settings');
    runApp(MyApp());
}

CRUD операции

Box предоставя методите put, get, delete и съдържа итератор за обхождане на всички записи. Ключовете и стойностите се типизират чрез generics — по подразбиране Box<dynamic> допуска всякакви типове, но се препоръчва задаване на конкретен тип.

// Запис на данни
final box = await Hive.openBox<String>('tasks');
await box.put('task_1', 'Купуване на продукти');

// Четене
final task = box.get('task_1');

// Всички ключове
final allTasks = box.values.toList();

// Изтриване
await box.delete('task_1');

// Изчистване на Box
await box.clear();

Реактивно наблюдение чрез WatchBox

WatchBox — разширение на Box, което уведомява абонатите за промени. В Flutter това се интегрира с ValueListenableBuilder: при промяна на всяка стойност в Box, widget-ът се преизгражда автоматично без извикване на setState.

final watchBox = await Hive.openBox('settings');

// В widget-а
ValueListenableBuilder(
    valueListenable: watchBox.listenable(),
    builder: (context, box, _) {
        final counter = box.get('counter') ?? 0;
        return Text('Брояч: $counter');
    },
)

TypeAdapter и персонализирани обекти

TypeAdapter — механизмът на Hive за сериализация на персонализирани Dart обекти. Адаптерът описва как да се преобразува обект в двоичен формат (write) и обратно (read). За разлика от json_serializable, TypeAdapter не изисква рефлексия и работи по-бързо.

Създаване на TypeAdapter

Адаптерът имплементира интерфейса TypeAdapter с два метода: read и write. Класът се регистрира чрез Hive.registerAdapter() преди отваряне на Box. На всеки адаптер се присвоява цифров ID — запазва се във файла за идентификация на типа.

// Модел на данни
class Task {
    final String title;
    final bool isCompleted;
    Task({required this.title, this.isCompleted = false});
}

// TypeAdapter
class TaskAdapter extends TypeAdapter<Task> {
    @override
    final int typeId = 0;

    @override
    Task read(BinaryReader reader) {
        return Task(
            title: reader.readString(),
            isCompleted: reader.readBool(),
        );
    }

    @override
    void write(BinaryWriter writer, Task obj) {
        writer.writeString(obj.title);
        writer.writeBool(obj.isCompleted);
    }
}

Генериране на адаптери чрез кодогенерация

За проекти с голям брой модели Hive предоставя hive_generator и build_runner. Анотацията @HiveType върху класа и @HiveField върху полетата генерира адаптера автоматично. Това е удобно, когато моделът съдържа 10+ полета — ръчното писане на read/write става трудоемко.

Оптимизация на производителността на Hive

Hive извършва четене от паметта, а не от диска, което дава скорост до 30 000 операции в секунда. За оптимизация: отваряйте Box веднъж и го използвайте повторно в цялото приложение, не извиквайте openBox отново. Използвайте Hive.box() (синхронен getter) след инициализация — връща вече отворен Box без създаване на нова инстанция.

Hive в комбинация с Provider и Riverpod

Hive лесно се интегрира с популярните Flutter мениджъри на състояние. За Provider използвайте ChangeNotifierProvider, който чете данни от Box при инициализация и се актуализира чрез listenable. За Riverpod е подходящ StreamProvider, абониран за WatchBox. Такава комбинация осигурява реактивни актуализации на UI при всяка промяна на данни в Hive без ръчно извикване на setState. В типичен Flutter проект такава архитектура позволява синхронизиране на състоянието между екраните без глобален singleton.