Hive: qué es, almacenamiento NoSQL y desarrollo sin código nativo

¿Qué es Hive?

Hive es una base de datos NoSQL escrita completamente en Dart que no requiere bibliotecas nativas. Fue creada por Simon Leiter en 2019 como alternativa a SQLite para proyectos Flutter. Hive almacena datos en formato binario .hive optimizado para lectura y escritura rápidas en dispositivos móviles. El formato .hive utiliza un esquema de serialización personalizado donde cada tipo de dato tiene su propio prefijo de byte, permitiendo leer el archivo sin conocimiento previo del esquema — a diferencia de Protocol Buffers o FlatBuffers.

La idea principal de Hive es la máxima simplicidad. La base de datos no requiere inicialización de motores nativos, no incluye analizador SQL ni usa reflexión. Todas las operaciones son llamadas directas a funciones Dart con serialización binaria a través de WriteBuffer y ReadBuffer.

Según la encuesta de Flutter Community (2023), Hive está entre los 5 paquetes de almacenamiento de datos más usados en Flutter, solo superado por shared_preferences en popularidad, pero superándolo en funcionalidad y velocidad.

Arquitectura de Hive

Hive utiliza el concepto de Box — análogo a una tabla en bases de datos relacionales. Cada Box es un archivo en disco con un conjunto de pares clave-valor. La clave puede ser int o String, el valor puede ser cualquier tipo primitivo, lista, Map o un objeto personalizado mediante TypeAdapter. Los Box están aislados entre sí y se abren de forma independiente.

Ventajas sobre las soluciones nativas

Hive no requiere canales de plataforma. Esto significa que funciona igual en Android, iOS, Web, macOS, Windows y Linux sin configuración adicional. Para proyectos orientados a compilación web, Hive sigue siendo la única solución NoSQL ligera — SQLite no funciona en navegadores. Hive utiliza IndexedDB como backend para web, garantizando la persistencia de datos incluso en entornos de navegador.

¿Cómo funciona Hive?

Hive serializa datos en formato binario al escribir y deserializa al leer. El mecanismo interno se basa en BinaryWriter y BinaryReader, que empaquetan los datos en arrays de bytes compactos. El tamaño de almacenamiento en disco es en promedio 2–3 veces menor que la representación JSON de los mismos datos.

Al abrir un Box, Hive carga todo el archivo en RAM. Esto proporciona alta velocidad de lectura (microsegundos) pero impone una limitación de tamaño: se recomienda almacenar no más de 50–100 MB por Box. Para volúmenes mayores, use LazyBox — carga diferida de registros desde el disco.

Transacciones y concurrencia

Hive funciona en un solo hilo dentro de un aislado Dart. Las operaciones de escritura se realizan de forma síncrona con bloqueo de archivo. Para acceso asíncrono, use Hive.openBox() con await. El acceso concurrente desde múltiples aislados no es compatible directamente — se requiere un mecanismo de sincronización independiente.

Hive vs SharedPreferences vs SQLite

Hive ocupa un nicho entre SharedPreferences y SQLite. Es más complejo que SharedPreferences (soporta objetos personalizados) pero más simple que SQLite (no requiere consultas SQL). Comparemos las características clave.

Cuándo elegir Hive

Hive es óptimo para volúmenes pequeños de datos: configuraciones de aplicación, caché de respuestas API, cola de sincronización local, favoritos e historial de navegación. Si los datos no superan los 50 MB y no requieren consultas relacionales — Hive es más rápido y simple que SQLite.

Cuándo Hive no es adecuado

Hive no soporta consultas con filtrado por múltiples campos, JOIN ni funciones agregadas. Si necesita consultas complejas como “seleccionar todas las tareas de hoy con prioridad superior a 3” — use SQLite con drift o floor. Hive tampoco es adecuado para almacenar más de 100 MB de datos debido a la carga en memoria.

Ejemplos de código con Hive

Hive comienza con la inicialización y apertura de un Box. A continuación se presentan las operaciones básicas para un escenario típico — almacenar una lista de tareas en una aplicación Flutter. Todos los ejemplos funcionan sin llamadas nativas de plataforma.

Inicialización y apertura de Box

Antes de usar Hive, debe llamar a Hive.initFlutter() en la función main. Luego abra un Box mediante Hive.openBox() — el resultado será una instancia de Box lista para lectura y escritura.

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());
}

Operaciones CRUD

Box proporciona los métodos put, get, delete y un iterador para recorrer todas las entradas. Las claves y valores se tipifican mediante genéricos — por defecto Box<dynamic> acepta cualquier tipo, pero se recomienda especificar un tipo concreto.

// Escribir datos
final box = await Hive.openBox<String>('tasks');
await box.put('task_1', 'Comprar alimentos');

// Lectura
final task = box.get('task_1');

// Todas las claves
final allTasks = box.values.toList();

// Eliminar
await box.delete('task_1');

// Limpiar Box
await box.clear();

Observación reactiva mediante WatchBox

WatchBox es una extensión de Box que notifica a los suscriptores sobre cambios. En Flutter, esto se integra con ValueListenableBuilder: cuando cualquier valor en el Box cambia, el widget se reconstruye automáticamente sin llamar a setState.

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

// En el widget
ValueListenableBuilder(
    valueListenable: watchBox.listenable(),
    builder: (context, box, _) {
        final counter = box.get('counter') ?? 0;
        return Text('Contador: $counter');
    },
)

TypeAdapter y objetos personalizados

TypeAdapter es el mecanismo de Hive para serializar objetos Dart personalizados. El adaptador describe cómo convertir un objeto a formato binario (write) y viceversa (read). A diferencia de json_serializable, TypeAdapter no requiere reflexión y es más rápido.

Creación de un TypeAdapter

El adaptador implementa la interfaz TypeAdapter con dos métodos: read y write. La clase se registra mediante Hive.registerAdapter() antes de abrir el Box. A cada adaptador se le asigna un ID numérico — se guarda en el archivo para la identificación del tipo.

// Modelo de datos
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);
    }
}

Generación de adaptadores mediante generación de código

Para proyectos con un gran número de modelos, Hive proporciona hive_generator y build_runner. La anotación @HiveType en la clase y @HiveField en los campos generan el adaptador automáticamente. Esto es conveniente cuando el modelo tiene 10+ campos — la escritura manual de read/write se vuelve tediosa.

Optimización del rendimiento de Hive

Hive lee desde la memoria en lugar del disco, proporcionando velocidades de hasta 30 000 operaciones por segundo. Para optimizar: abra un Box una vez y reutilícelo en toda la aplicación, no llame a openBox repetidamente. Use Hive.box() (getter síncrono) después de la inicialización — devuelve un Box ya abierto sin crear una nueva instancia.

Hive con Provider y Riverpod

Hive se integra fácilmente con los gestores de estado populares de Flutter. Para Provider, use ChangeNotifierProvider que lee datos del Box al inicializar y se actualiza mediante listenable. Para Riverpod, un StreamProvider suscrito a WatchBox funciona bien. Esta combinación proporciona actualizaciones reactivas de la interfaz en cada cambio de datos en Hive sin llamadas manuales a setState. En un proyecto Flutter típico, esta arquitectura permite sincronizar el estado entre pantallas sin un singleton global.