/** * Manage access to data, be it to find, update or remove it */ var model = require('./model'); /** * Create a new cursor for this collection * @param {Datastore} db - The datastore this cursor is bound to * @param {Query} query - The query this cursor will operate on * @param {Function} execDn - Handler to be executed after cursor has found the results and before the callback passed to find/findOne/update/remove */ function Cursor (db, query, execFn) { this.db = db; this.query = query || {}; if (execFn) { this.execFn = execFn; } } /** * Set a limit to the number of results */ Cursor.prototype.limit = function(limit) { this._limit = limit; return this; }; /** * Skip a the number of results */ Cursor.prototype.skip = function(skip) { this._skip = skip; return this; }; /** * Sort results of the query * @Param {SortQuery} sortQuery - SortQuery is { field: order }, field can use the dot-notation, order is 1 for ascending and -1 for descending */ Cursor.prototype.sort = function(sortQuery) { this._sort = sortQuery; return this; }; /** * Get all matching elements * Will return pointers to matched elements (shallow copies), returning full copies is the role of find or findOne * This is an internal function, use exec which uses the executor * * @param {Function} callback - Signature: err, results */ Cursor.prototype._exec = function(callback) { var candidates = this.db.getCandidates(this.query) , res = [], added = 0, skipped = 0, self = this , i, keys, key ; try { for (i = 0; i < candidates.length; i += 1) { if (model.match(candidates[i], this.query)) { // If a sort is defined, wait for the results to be sorted before applying limit and skip if (!this._sort) { if (this._skip && this._skip > skipped) { skipped += 1; } else { res.push(candidates[i]); added += 1; if (this._limit && this._limit <= added) { break; } } } else { res.push(candidates[i]); } } } } catch (err) { return callback(err); } // Apply all sorts if (this._sort) { keys = Object.keys(this._sort); // Going backwards so that the first sort is the last that gets applied for (i = keys.length - 1; i >= 0; i -= 1) { key = keys[i]; res.sort(function(a, b) { return self._sort[key] * model.compareThings(model.getDotValue(a, key), model.getDotValue(b, key)); }); } // Applying limit and skip var limit = this._limit || res.length , skip = this._skip || 0; res = res.slice(skip, skip + limit); } if (this.execFn) { return this.execFn(null, res, callback); } else { return callback(null, res); } }; Cursor.prototype.exec = function () { this.db.executor.push({ this: this, fn: this._exec, arguments: arguments }); }; // Interface module.exports = Cursor;