mcache

A simple and fast memory cache for node.js with async api

mcache

A simple and fast async memory cache for node.js Call only one time set function for many simultaneous get requests. It is designed for quick return of data from the memory - for get operations are performed minimal coding. Api built in asynchronous design, with callbacks.

Install

npm install mcache

Examples

var Mcache = require('mcache');
// ttl = 600 sec, gc_time = 60 sec
cache = new Mcache(60, 10, function(key, callback) {
	// this code will be executed at most once every 600 seconds
	var error = null;
	var value = ...;
	callback(error, value);
});
var id = ... ;
cache.get(id, function(err, data) {
	console.log(err, data);
});  
var Mcache = require('mcache');
// ttl = 60 sec, gc_time = 10 sec
cache = new Mcache(60, 10, function(key, callback) {
	// this code will be executed at most once every 60 seconds
	mysql.query('SELECT ... WHERE id=?', key, callback);  
});
var id = ... ;
cache.get(id, function(err, data) {
	console.log(err, data);
});
var Mcache = require('mcache');
// ttl = 100 ms, gc_time = 60 sec
cache = new Mcache('100 ms', 60, function(key, callback) {
	if (Array.isArray(key) {
		callback(null, [...]);
	} else {
		callback(null, data);
	}
});
var id = ... ;
cache.get(id, function(err, data) {
	console.log(err, data);
});
var ids = [...];
cache.get(ids, function(err, data) {
	console.log(err, data); // data = {key1: data1, ...}
});

API

create new cache object

  • ttl - time to live for item, seconds
  • gc_time - interval for clear expired items, seconds Can be empty - you must call clearOld manually.
  • setfunction(key, callback) - function, get the value by the key, must call callback(error, value)

get item from cache by key

  • key - can be any value
  • callback(error, value) - function

manual item setting without setfunction call

delete item

update set_time (time when the function was called) to the current time

get items count

get all items in hash

delete all expired items