1个不稳定版本

0.1.3 2023年11月3日

#244 in 缓存


anor-api 中使用

MIT 协议

74KB
1.5K SLoC

Anor内存数据存储

crates.io docs build & test MIT

Anor存储是一个用Rust编写的开源内存键值数据存储。

存储当前支持本地磁盘上的基于时间点的快照持久化。

项目阶段

开发:该项目已有里程碑版本,但仍在积极开发中,您不应期望完全稳定。

用法

请参阅 示例

用法示例

存储字符串的示例: sample_string.rs

use anor::storage::{storage_item::*, Storage};

let key = "my_string";
let sample_string = String::from("abc");

// storage would be dropped after leaving the scope
{
    // open a storage according to the configuration given in config.yaml
    let storage = Storage::open();

    // create a new item with an inner string object
    let storage_item = StorageItem::new(key, &sample_string).unwrap();

    // insert item into storage
    storage.insert(storage_item);

    // get the string from the storage by key
    let mut string_value: String = storage.get_inner_object(key).unwrap();
    assert_eq!(string_value, sample_string);

    // modify the string
    string_value += "def";

    // update the storage
    storage.update_inner_object(key, &string_value);

    // storage would be dropped here as it going out from the scope
    // this will persist storage content
    // the storage can be manually dropped also by using: drop(storage)
}

// open the storage
let storage_loaded = Storage::open();

// get the string from the storage by key
let loaded_value = storage_loaded.get_inner_object::<String>(key).unwrap();
assert_eq!(loaded_value, "abcdef");

存储映射的示例: sample_map.rs

use anor::storage::{storage_item::*, Storage};
use std::collections::HashMap;

let key = "my_map";

let mut sample_map = HashMap::<u8, String>::new();
sample_map.insert(1, "One".into());
sample_map.insert(2, "Two".into());
sample_map.insert(3, "Three".into());

// storage would be dropped after leaving the scope
{
    // open a storage according to the configuration given in config.yaml
    let storage = Storage::open();

    // define item type
    let storage_type = ItemType::Complex(ComplexType::Map(BasicType::U8, BasicType::String));

    // create a new item with an inner map object
    let mut storage_item = StorageItem::with_type(key, storage_type, &sample_map).unwrap();
    storage_item.set_description("My sample spelling dictionary");
    storage_item.add_tag("dictionary");
    storage_item.add_metafield("language", "en");

    // insert item into storage
    storage.insert(storage_item);

    // get the map from the storage by key
    let mut map: HashMap<u8, String> = storage.get_inner_object(key).unwrap();
    assert_eq!(map, sample_map);

    // modify the map
    map.insert(4, "Four".into());

    // update the storage
    storage.update_inner_object(key, &map);

    // storage would be dropped here as it going out from the scope
    // this will persist storage content
    // the storage can be manually dropped also by using: drop(storage)
}

// open the storage
let storage_loaded = Storage::open();

// get the map from the storage by key
let map_loaded: HashMap<u8, String> = storage_loaded.get_inner_object(key).unwrap();
assert_eq!(
    map_loaded,
    HashMap::from([
        (1, "One".into()),
        (2, "Two".into()),
        (3, "Three".into()),
        (4, "Four".into())
    ])
);

依赖

~5–7.5MB
~137K SLoC