FileKV

This is a key&value storage library, which uses file system to store data.

Install

$ npm install filekv -g

How to use

 
var filekv = require('filekv');
 
var filekvClient = filekv.create({
        //Here is your datafile dir!
        //!!!This config item not have default value!!!
        fileDir:__dirname+'/data', 
 
        //This number can't greater than your OS open file max number!
        //This config item default is 1000
        workMax:1000 
 
});
 
 
 
filekvClient.set('userinfo',{name:'wzy',sex:1,github:'http://www.github.com/zenboss'},3600,function(err){
 
    console.log(err);
 
});
 
filekvClient.get('userinfo',function(err,data){
 
    console.log(err,data);
 
});
 
filekvClient.has('userinfo',function(err,isHas){
 
    console.log(err,isHas);
 
});
 
filekvClient.del('userinfo',function(err){
 
    console.log(err);
 
});
 

API

filekv.set(key,value/object[,lifeTime[,callback]])

Use this function setting a key&value

filekv.get(key[,callback])

Use this function get a key&value

filekv.has(key[,callback])

Use this function check a key exist

filekv.del(key[,callback])

Use this function delete a key

filekv.add(key,value/object[,lifeTime[,callback]])

Note: 1.If the key not exist, the api will be create the key&value. 2.If the key already exist, the api callback function's the 1st variable will is Error object

filekv.replace(key,value/object[,lifeTime[,callback]])

Note: 1.If the key already exist, the api will be replace the key's value. 2.If the key not exist, the api callback function's the 1st variable will is Error object

Events

Event:'set'

When you use "set" api setting a key&value, it will emit 'set' event.

filekvClient.on('set',function(input,output){
    // The "input" variable is "set" api's arguments object
    // The "output" variable is "set" api's callback function's callback variable.
});

Event:'get'

When you use "get" api get a key&value, it will emit 'get' event.

filekvClient.on('get',function(input,output){
    // The "input" variable is "get" api's arguments object
    // The "output" variable is "get" api's callback function's callback variable.
});

Event:'add'

When you use "add" api to create a was not exist key&value, it will emit 'add' event.

filekvClient.on('add',function(input,output){
    // The "input" variable is "add" api's arguments object
    // The "output" variable is "add" api's callback function's callback variable.
});

Event:'replace'

When you use "replace" api to replace a already exist key's new value, it will emit 'replace' event.

filekvClient.on('replace',function(input,output){
    // The "input" variable is "replace" api's arguments object
    // The "output" variable is "replace" api's callback function's callback variable.
});

Event:'delete'

When your use "del"/"delete" api delete a key&value in your store, it will emit 'delete' event.

filekvClient.on('delete',function(input,output){
    // The "input" variable is "del"/"delete" api's arguments object
    // The "output" variable is "del"/"delete" api's callback function's callback variable.
});