fib-kv v1.3.3

fib-kv

Introduction

general key-value store on sql/level/mongo/redis for fibjs.

Install

npm install fib-kv [--save]

Test

npm run ci

Creating a key-value store

var kvs = new kv(conn, opts);

conn: database connection or connection factory like fib-pool
opts: kvs options

NOTICE sql_value_type is one of below:

• TINYBLOB
• BLOB
• MEDIUMBLOB
• LONGBLOB
• TINYTEXT
• TEXT
• MEDIUMTEXT
• LONGTEXT
• VARCHAR

A key will not expire if timeout is less than or equal to 0.

Simple example (memory backend).

var kv = require("fib-kv");

var kvs = new kv({
    "a": 100,
    "b": 200
});

LevelDB backend.

var kv = require("fib-kv");
var db = require("db");

var kvs = new kv(db.openLevelDB("test.ldb"));

fib-pool backend.

var kv = require("fib-kv");
var db = require("db");
var pool = require("fib-pool");

var kvs = new kv(pool(() => db.openLevelDB("test.ldb")));

Methods

kvs.setup()

setup the backend database.

v = kvs.get(k)

returns the value stored for that key.

kvs.set(k, v)

stores a key-value pair.

e = kvs.has(k)

returns whether a key is set on the store.

e = kvs.keys()

returns all keys in the store.

e = kvs.renew(k)

renews TTL for an unexpired key.

kvs.remove(k)

deletes a key-value pair by key.

e = kvs.cache_has(k)

returns whether a key is set on the cache.

kvs.cache_clear()

removes all the key-value pairs in the cache.