var async = require('async'); var domain = require('domain'); var CallbackFiller = require('./callback_filler'); /** * Module that lets you specify a hierarchy of caches. */ var multiCaching = function(caches) { var self = {}; if (!Array.isArray(caches)) { throw new Error('multiCaching requires an array of caches'); } var callbackFiller = new CallbackFiller(); function getFromHighestPriorityCache(key, options, cb) { if (typeof options === 'function') { cb = options; options = undefined; } var i = 0; async.eachSeries(caches, function(cache, next) { var callback = function(err, result) { if (err) { return cb(err); } if (result) { // break out of async loop. return cb(err, result, i); } i += 1; next(err); }; if (typeof options === 'object') { cache.store.get(key, options, callback); } else { cache.store.get(key, callback); } }, cb); } function setInMultipleCaches(caches, opts, cb) { async.each(caches, function(cache, next) { if (typeof opts.options !== 'object') { cache.store.set(opts.key, opts.value, opts.ttl, next); } else { cache.store.set(opts.key, opts.value, opts.options, next); } }, cb); } /** * Looks for an item in cache tiers. * * When a key is found in a lower cache, all higher levels are updated */ self.getAndPassUp = function(key, cb) { getFromHighestPriorityCache(key, function(err, result, index) { if (err) { return cb(err); } cb(err, result); if (result !== undefined && index) { var cachesToUpdate = caches.slice(0, index); async.each(cachesToUpdate, function(cache, next) { cache.set(key, result, result.ttl, next); }); } }); }; /** * This is for backward-compatibility */ //jscs:disable requireCamelCaseOrUpperCaseIdentifiers self.get_and_pass_up = self.getAndPassUp; //jscs:enable requireCamelCaseOrUpperCaseIdentifiers /** * Wraps a function in one or more caches. * Has same API as regular caching module. * * If a key doesn't exist in any cache, it gets set in all caches. * If a key exists in a high-priority (e.g., first) cache, it gets returned immediately * without getting set in other lower-priority caches. * If a key doesn't exist in a higher-priority cache but exists in a lower-priority * cache, it gets set in all higher-priority caches. */ self.wrap = function(key, work, options, cb) { if (typeof options === 'function') { cb = options; options = undefined; } if (callbackFiller.queues[key]) { callbackFiller.queues[key].push({cb: cb, domain: process.domain}); return; } callbackFiller.queues[key] = [{cb: cb, domain: process.domain}]; getFromHighestPriorityCache(key, function(err, result, index) { if (err) { return callbackFiller.fill(key, err); } else if (result) { var cachesToUpdate = caches.slice(0, index); var opts = { key: key, value: result, options: options }; if (typeof options !== 'object') { opts.ttl = options; } setInMultipleCaches(cachesToUpdate, opts, function(err) { callbackFiller.fill(key, err, result); }); } else { domain .create() .on('error', function(err) { callbackFiller.fill(key, err); }) .bind(work)(function(err, data) { if (err) { callbackFiller.fill(key, err); return; } var opts = { key: key, value: data, options: options }; if (typeof options !== 'object') { opts.ttl = options; } setInMultipleCaches(caches, opts, function(err) { if (err) { callbackFiller.fill(key, err); } else { callbackFiller.fill(key, null, data); } }); }); } }); }; self.set = function(key, value, options, cb) { var opts = { key: key, value: value, options: options }; if (typeof options !== 'object') { opts.ttl = options; } setInMultipleCaches(caches, opts, cb); }; self.get = function(key, options, cb) { if (typeof options === 'function') { cb = options; options = false; } getFromHighestPriorityCache(key, options, cb); }; self.del = function(key, options, cb) { if (typeof options === 'function') { cb = options; options = false; } async.each(caches, function(cache, next) { if (typeof options === 'object') { cache.store.del(key, options, next); } else { cache.store.del(key, next); } }, cb); }; return self; }; module.exports = multiCaching;