stash_hive 3.1.0 copy "stash_hive: ^3.1.0" to clipboard
stash_hive: ^3.1.0 copied to clipboard

outdated

Hive storage extension for the stash caching API. Provides support to store caches in the Hive database

stash_hive #

A stash storage extension for hive

Pub Package Coverage Status Package Documentation GitHub License

Overview #

This storage extension for stash provides a hive based storage that relies on a highly performing binary serialization of the cache items through the use of msgpack serialization format.

Getting Started #

Add this to your pubspec.yaml (or create it) replacing x.x.x with the latest version of stash_hive:

dependencies:
    stash_hive: ^x.x.x

Run the following command to install dependencies:

dart pub get

Finally, to start developing import the library:

import 'package:stash_hive/stash_hive.dart';

Usage #

The example bellow creates a cache with a Hive storage backend that supports a maximum of 10 Task objects. In the rather simple example bellow the serialization and deserialization of the object is coded by hand but normally it relies on the usage of libraries like json_serializable. Please take a look at the documentation of stash to gather additional information and to explore the full range of capabilities of the Stash library

import 'dart:io';

import 'package:stash/stash_api.dart';
import 'package:stash_hive/stash_hive.dart';

class Task {
  final int id;
  final String title;
  final bool completed;

  Task({required this.id, required this.title, this.completed = false});

  /// Creates a [Task] from json map
  factory Task.fromJson(Map<String, dynamic> json) => Task(
      id: json['id'] as int,
      title: json['title'] as String,
      completed: json['completed'] as bool);

  /// Creates a json map from a [Task]
  Map<String, dynamic> toJson() =>
      <String, dynamic>{'id': id, 'title': title, 'completed': completed};

  @override
  String toString() {
    return 'Task $id: "$title" is ${completed ? "completed" : "not completed"}';
  }
}

void main() async {
  // Temporary path
  final path = Directory.systemTemp.path;

  // Creates cache with a Hive based storage backend with the capacity of 10 entries
  final cache = newHiveCache(path,
      maxEntries: 10,
      eventListenerMode: EventListenerMode.synchronous,
      fromEncodable: (json) => Task.fromJson(json))
    ..on<CreatedEntryEvent>().listen(
        (event) => print('Entry key "${event.entry.key}" added to the cache'));

  // Adds a task with key 'task1' to the cache
  await cache.put(
      'task1', Task(id: 1, title: 'Run stash_hive example', completed: true));
  // Retrieves the value from the cache
  final value = await cache.get('task1');

  print(value);
}

Features and Bugs #

Please file feature requests and bugs at the issue tracker.

License #

This project is licensed under the MIT License - see the LICENSE file for details

10
likes
0
pub points
79%
popularity

Publisher

verified publisherivoleitao.dev

Hive storage extension for the stash caching API. Provides support to store caches in the Hive database

Homepage
Repository (GitHub)
View/report issues

License

unknown (license)

Dependencies

hive, stash

More

Packages that depend on stash_hive