Hive: その概要、NoSQLストレージ、ネイティブコード不要の開発

Hiveとは？

Hiveは、完全にDartで書かれたNoSQLデータベースで、ネイティブライブラリを必要としません。2019年にSimon LeiterによってFlutterプロジェクト向けのSQLiteの代替として作成されました。Hiveはモバイルデバイスでの高速な読み書きに最適化されたバイナリ.hive形式でデータを保存します。.hive形式は、各データ型に独自のバイトプレフィックスを持つカスタムシリアライゼーションスキームを使用しており、Protocol BuffersやFlatBuffersとは異なり、事前のスキーマ知識なしでファイルを読み取ることができます。

Hiveの核となるアイデアは最大限のシンプルさです。データベースはネイティブエンジンの初期化を必要とせず、SQLパーサーを含まず、リフレクションも使用しません。すべての操作は、WriteBufferとReadBufferによるバイナリシリアライゼーションを伴う直接のDart関数呼び出しです。

Flutter Communityの調査（2023年）によると、HiveはFlutterで最も使用されているデータストレージパッケージのトップ5に入り、人気ではshared_preferencesに次ぐ第2位ですが、機能性と速度ではそれを上回っています。

Hiveのアーキテクチャ

HiveはBoxの概念を使用します — これはリレーショナルデータベースのテーブルに類似しています。各Boxは、キーと値のペアのセットを含むディスク上のファイルです。キーはintまたはString、値は任意のプリミティブ型、リスト、Map、またはTypeAdapterを介したカスタムオブジェクトにできます。Boxは互いに分離されており、独立して開かれます。

ネイティブソリューションに対する利点

Hiveはプラットフォームチャネルを必要としません。つまり、追加設定なしでAndroid、iOS、Web、macOS、Windows、Linuxで同じように動作します。Webビルドを対象とするプロジェクトでは、Hiveが唯一の軽量NoSQLソリューションです — SQLiteはブラウザでは動作しません。HiveはWebのバックエンドとしてIndexedDBを使用し、ブラウザ環境でもデータの永続性を保証します。

Hiveの仕組み

Hiveは書き込み時にデータをバイナリ形式にシリアライズし、読み取り時にデシリアライズします。内部メカニズムはBinaryWriterとBinaryReaderに基づいており、データをコンパクトなバイト配列にパッケージ化します。ディスク上のストレージサイズは、同じデータのJSON表現よりも平均して2～3倍小さくなります。

Boxを開くとき、Hiveはファイル全体をRAMにロードします。これにより高速な読み取り（マイクロ秒）が実現しますが、サイズ制限が課されます：1 Boxあたり50～100 MBを超えて保存しないことを推奨します。より大きなボリュームの場合は、LazyBox（ディスクからのレコードの遅延ロード）を使用してください。

トランザクションと並行性

HiveはDartアイソレート内でシングルスレッドで動作します。書き込み操作はファイルロックを伴う同期的に実行されます。非同期アクセスには、await付きのHive.openBox()を使用してください。複数のアイソレートからの同時アクセスは直接サポートされていません — 別の同期メカニズムが必要です。

Hive vs SharedPreferences vs SQLite

HiveはSharedPreferencesとSQLiteの間のニッチを占めています。SharedPreferencesよりも複雑（カスタムオブジェクトをサポート）ですが、SQLiteよりもシンプル（SQLクエリ不要）です。主な特徴を比較してみましょう。

Hiveを選ぶべき場合

Hiveは少量のデータに最適です：アプリ設定、APIレスポンスのキャッシュ、ローカル同期キュー、お気に入り、閲覧履歴。データが50 MBを超えず、リレーショナルクエリを必要としない場合、HiveはSQLiteよりも高速でシンプルです。

Hiveが適さない場合

Hiveは複数フィールドによるフィルタリング、JOIN、集計関数を含むクエリをサポートしていません。「今日の優先度3以上のタスクをすべて選択」のような複雑なクエリが必要な場合は、driftやfloorと一緒にSQLiteを使用してください。Hiveはメモリにロードされるため、100 MBを超えるデータの保存にも適していません。

Hiveのコード例

Hiveは初期化とBoxのオープンから始まります。以下は典型的なシナリオ（Flutterアプリケーションでのタスクリストの保存）の基本操作です。すべての例はネイティブプラットフォーム呼び出しなしで動作します。

初期化とBoxのオープン

Hiveを使用する前に、main関数でHive.initFlutter()を呼び出す必要があります。その後、Hive.openBox()を介してBoxを開きます — 結果は読み取りと書き込みの準備ができた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メソッドと、すべてのエントリを走査するイテレータを提供します。キーと値はジェネリックスを介して型付けされます — デフォルトでは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内の値が変更されると、setStateを呼び出さずにウィジェットが自動的に再構築されます。

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

// ウィジェット内
ValueListenableBuilder(
    valueListenable: watchBox.listenable(),
    builder: (context, box, _) {
        final counter = box.get('counter') ?? 0;
        return Text('カウンター: $counter');
    },
)

TypeAdapterとカスタムオブジェクト

TypeAdapterは、カスタムDartオブジェクトをシリアライズするためのHiveのメカニズムです。アダプターは、オブジェクトをバイナリ形式に変換する方法（write）と元に戻す方法（read）を記述します。json_serializableとは異なり、TypeAdapterはリフレクションを必要とせず、より高速です。

TypeAdapterの作成

アダプターはTypeAdapterインターフェースをreadとwriteの2つのメソッドで実装します。クラスはBoxを開く前にHive.registerAdapter()を介して登録されます。各アダプターには数値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()（同期的ゲッター）を使用してください — 新しいインスタンスを作成せずに既に開かれているBoxを返します。

ProviderおよびRiverpodとのHive連携

Hiveは人気のあるFlutter状態管理と簡単に統合できます。Providerの場合は、初期化時にBoxからデータを読み取り、listenableを介して更新するChangeNotifierProviderを使用します。Riverpodの場合は、WatchBoxにサブスクライブしたStreamProviderが適しています。この組み合わせにより、手動のsetState呼び出しなしで、Hiveのデータ変更ごとにリアクティブなUI更新が提供されます。典型的なFlutterプロジェクトでは、このアーキテクチャによりグローバルシングルトンなしで画面間の状態同期が可能になります。