hive_ce 2.23.0

hive_ce: ^2.23.0 copied to clipboard

Fast, Enjoyable & Secure NoSQL Database

Hive is a lightweight and blazing fast key-value database written in pure Dart. Inspired by Bitcask.

Documentation & Samples 📖 #

Features #

• 🚀 Cross platform: mobile, desktop, browser
• ⚡ Great performance (see benchmarks)
• ❤️ Simple, powerful, & intuitive API
• 🔒 Strong encryption built in
• 🎈 NO native dependencies
• 🔋 Batteries included

New features in Hive CE #

Hive CE is a spiritual continuation of Hive v2 with the following new features:

• Tooling
  • Hive CE Inspector DevTools extension to browse and search the contents of your boxes
• Platforms
  • Isolate support through IsolatedHive
  • Flutter web WASM support
• Code generation
  • Generate adapters with the GenerateAdapters annotation instead of annotating every type and field
  • Generate adapters for classes outside the current package
  • Register every generated adapter in one call with the HiveRegistrar extension
  • Support for Freezed, constructor parameter defaults, and named imports
• Types
  • Built-in support for Set and Duration
  • DateTime and Duration keep microsecond precision
  • Type IDs up to 65439 instead of 223
• Performance
  • Faster batch writes and opening of large boxes, including encrypted boxes
  • Lazy boxes open several times faster
  • IsolatedHive individual writes are faster than Hive CE
  • See the benchmarks

Benchmarks #

All times are averaged over several runs

Individual writes #

Writing values one at a time with add:

Batch writes #

Writing all values with a single addAll call:

Opening a box #

Opening a box and reading every value:

Encrypted and lazy boxes #

Hive v2 compared to Hive CE. Lazy boxes only load keys when opened, so the lazy open time doesn't include reading values.

Database size #

Notes #

Database size in Hive v4 is directly affected by the length of field names in model classes which is not ideal. Also Hive v4 is much slower than Hive CE for large numbers of individual writes.

The benchmark was performed on an M3 Max MacBook Pro. You can see the benchmark code here.

Getting Started #

Hive CE requires Dart 3. Ensure that you have the following in your pubspec.yaml file:

environment:
  sdk: ^3.0.0

Usage #

You can use Hive just like a map. Writes are readable immediately, but a write can be lost if the process is killed before its future completes. On the VM, flush() waits for pending writes and flushes them to disk.

import 'package:hive_ce/hive_ce.dart';

void example() {
  final box = Hive.box('myBox');
  box.put('name', 'David');
  final name = box.get('name');
  print('Name: $name');
}