1806 lines
49 KiB
JavaScript
1806 lines
49 KiB
JavaScript
'use strict';
|
|
|
|
/*!
|
|
* Module dependencies.
|
|
*/
|
|
|
|
const EventEmitter = require('events').EventEmitter;
|
|
const Kareem = require('kareem');
|
|
const SchemaType = require('./schematype');
|
|
const VirtualType = require('./virtualtype');
|
|
const applyTimestampsToChildren = require('./helpers/update/applyTimestampsToChildren');
|
|
const applyTimestampsToUpdate = require('./helpers/update/applyTimestampsToUpdate');
|
|
const get = require('./helpers/get');
|
|
const getIndexes = require('./helpers/schema/getIndexes');
|
|
const handleTimestampOption = require('./helpers/schema/handleTimestampOption');
|
|
const merge = require('./helpers/schema/merge');
|
|
const mpath = require('mpath');
|
|
const readPref = require('./driver').get().ReadPreference;
|
|
const symbols = require('./schema/symbols');
|
|
const util = require('util');
|
|
const utils = require('./utils');
|
|
const validateRef = require('./helpers/populate/validateRef');
|
|
|
|
let MongooseTypes;
|
|
|
|
const allMiddleware = require('./helpers/query/applyQueryMiddleware').
|
|
middlewareFunctions.
|
|
concat(require('./helpers/model/applyHooks').middlewareFunctions);
|
|
|
|
let id = 0;
|
|
|
|
/**
|
|
* Schema constructor.
|
|
*
|
|
* ####Example:
|
|
*
|
|
* var child = new Schema({ name: String });
|
|
* var schema = new Schema({ name: String, age: Number, children: [child] });
|
|
* var Tree = mongoose.model('Tree', schema);
|
|
*
|
|
* // setting schema options
|
|
* new Schema({ name: String }, { _id: false, autoIndex: false })
|
|
*
|
|
* ####Options:
|
|
*
|
|
* - [autoIndex](/docs/guide.html#autoIndex): bool - defaults to null (which means use the connection's autoIndex option)
|
|
* - [autoCreate](/docs/guide.html#autoCreate): bool - defaults to null (which means use the connection's autoCreate option)
|
|
* - [bufferCommands](/docs/guide.html#bufferCommands): bool - defaults to true
|
|
* - [capped](/docs/guide.html#capped): bool - defaults to false
|
|
* - [collection](/docs/guide.html#collection): string - no default
|
|
* - [id](/docs/guide.html#id): bool - defaults to true
|
|
* - [_id](/docs/guide.html#_id): bool - defaults to true
|
|
* - `minimize`: bool - controls [document#toObject](#document_Document-toObject) behavior when called manually - defaults to true
|
|
* - [read](/docs/guide.html#read): string
|
|
* - [writeConcern](/docs/guide.html#writeConcern): object - defaults to null, use to override [the MongoDB server's default write concern settings](https://docs.mongodb.com/manual/reference/write-concern/)
|
|
* - [shardKey](/docs/guide.html#shardKey): bool - defaults to `null`
|
|
* - [strict](/docs/guide.html#strict): bool - defaults to true
|
|
* - [toJSON](/docs/guide.html#toJSON) - object - no default
|
|
* - [toObject](/docs/guide.html#toObject) - object - no default
|
|
* - [typeKey](/docs/guide.html#typeKey) - string - defaults to 'type'
|
|
* - [useNestedStrict](/docs/guide.html#useNestedStrict) - boolean - defaults to false
|
|
* - [validateBeforeSave](/docs/guide.html#validateBeforeSave) - bool - defaults to `true`
|
|
* - [versionKey](/docs/guide.html#versionKey): string - defaults to "__v"
|
|
* - [collation](/docs/guide.html#collation): object - defaults to null (which means use no collation)
|
|
* - [selectPopulatedPaths](/docs/guide.html#selectPopulatedPaths): boolean - defaults to `true`
|
|
*
|
|
* ####Note:
|
|
*
|
|
* _When nesting schemas, (`children` in the example above), always declare the child schema first before passing it into its parent._
|
|
*
|
|
* @param {Object|Schema|Array} [definition] Can be one of: object describing schema paths, or schema to copy, or array of objects and schemas
|
|
* @param {Object} [options]
|
|
* @inherits NodeJS EventEmitter http://nodejs.org/api/events.html#events_class_events_eventemitter
|
|
* @event `init`: Emitted after the schema is compiled into a `Model`.
|
|
* @api public
|
|
*/
|
|
|
|
function Schema(obj, options) {
|
|
if (!(this instanceof Schema)) {
|
|
return new Schema(obj, options);
|
|
}
|
|
|
|
this.obj = obj;
|
|
this.paths = {};
|
|
this.aliases = {};
|
|
this.subpaths = {};
|
|
this.virtuals = {};
|
|
this.singleNestedPaths = {};
|
|
this.nested = {};
|
|
this.inherits = {};
|
|
this.callQueue = [];
|
|
this._indexes = [];
|
|
this.methods = {};
|
|
this.methodOptions = {};
|
|
this.statics = {};
|
|
this.tree = {};
|
|
this.query = {};
|
|
this.childSchemas = [];
|
|
this.plugins = [];
|
|
// For internal debugging. Do not use this to try to save a schema in MDB.
|
|
this.$id = ++id;
|
|
|
|
this.s = {
|
|
hooks: new Kareem()
|
|
};
|
|
|
|
this.options = this.defaultOptions(options);
|
|
|
|
// build paths
|
|
if (Array.isArray(obj)) {
|
|
for (const definition of obj) {
|
|
this.add(definition);
|
|
}
|
|
} else if (obj) {
|
|
this.add(obj);
|
|
}
|
|
|
|
// check if _id's value is a subdocument (gh-2276)
|
|
const _idSubDoc = obj && obj._id && utils.isObject(obj._id);
|
|
|
|
// ensure the documents get an auto _id unless disabled
|
|
const auto_id = !this.paths['_id'] &&
|
|
(!this.options.noId && this.options._id) && !_idSubDoc;
|
|
|
|
if (auto_id) {
|
|
const _obj = {_id: {auto: true}};
|
|
_obj._id[this.options.typeKey] = Schema.ObjectId;
|
|
this.add(_obj);
|
|
}
|
|
|
|
this.setupTimestamp(this.options.timestamps);
|
|
}
|
|
|
|
/*!
|
|
* Create virtual properties with alias field
|
|
*/
|
|
function aliasFields(schema, paths) {
|
|
paths = paths || Object.keys(schema.paths);
|
|
for (const path of paths) {
|
|
const options = get(schema.paths[path], 'options');
|
|
if (options == null) {
|
|
continue;
|
|
}
|
|
|
|
const prop = schema.paths[path].path;
|
|
const alias = options.alias;
|
|
|
|
if (!alias) {
|
|
continue;
|
|
}
|
|
|
|
if (typeof alias !== 'string') {
|
|
throw new Error('Invalid value for alias option on ' + prop + ', got ' + alias);
|
|
}
|
|
|
|
schema.aliases[alias] = prop;
|
|
|
|
schema.
|
|
virtual(alias).
|
|
get((function(p) {
|
|
return function() {
|
|
if (typeof this.get === 'function') {
|
|
return this.get(p);
|
|
}
|
|
return this[p];
|
|
};
|
|
})(prop)).
|
|
set((function(p) {
|
|
return function(v) {
|
|
return this.set(p, v);
|
|
};
|
|
})(prop));
|
|
}
|
|
}
|
|
|
|
/*!
|
|
* Inherit from EventEmitter.
|
|
*/
|
|
Schema.prototype = Object.create(EventEmitter.prototype);
|
|
Schema.prototype.constructor = Schema;
|
|
Schema.prototype.instanceOfSchema = true;
|
|
|
|
/*!
|
|
* ignore
|
|
*/
|
|
|
|
Object.defineProperty(Schema.prototype, '$schemaType', {
|
|
configurable: false,
|
|
enumerable: false,
|
|
writable: true
|
|
});
|
|
|
|
/**
|
|
* Array of child schemas (from document arrays and single nested subdocs)
|
|
* and their corresponding compiled models. Each element of the array is
|
|
* an object with 2 properties: `schema` and `model`.
|
|
*
|
|
* This property is typically only useful for plugin authors and advanced users.
|
|
* You do not need to interact with this property at all to use mongoose.
|
|
*
|
|
* @api public
|
|
* @property childSchemas
|
|
* @memberOf Schema
|
|
* @instance
|
|
*/
|
|
|
|
Object.defineProperty(Schema.prototype, 'childSchemas', {
|
|
configurable: false,
|
|
enumerable: true,
|
|
writable: true
|
|
});
|
|
|
|
/**
|
|
* The original object passed to the schema constructor
|
|
*
|
|
* ####Example:
|
|
*
|
|
* var schema = new Schema({ a: String }).add({ b: String });
|
|
* schema.obj; // { a: String }
|
|
*
|
|
* @api public
|
|
* @property obj
|
|
* @memberOf Schema
|
|
* @instance
|
|
*/
|
|
|
|
Schema.prototype.obj;
|
|
|
|
/**
|
|
* Schema as flat paths
|
|
*
|
|
* ####Example:
|
|
* {
|
|
* '_id' : SchemaType,
|
|
* , 'nested.key' : SchemaType,
|
|
* }
|
|
*
|
|
* @api private
|
|
* @property paths
|
|
* @memberOf Schema
|
|
* @instance
|
|
*/
|
|
|
|
Schema.prototype.paths;
|
|
|
|
/**
|
|
* Schema as a tree
|
|
*
|
|
* ####Example:
|
|
* {
|
|
* '_id' : ObjectId
|
|
* , 'nested' : {
|
|
* 'key' : String
|
|
* }
|
|
* }
|
|
*
|
|
* @api private
|
|
* @property tree
|
|
* @memberOf Schema
|
|
* @instance
|
|
*/
|
|
|
|
Schema.prototype.tree;
|
|
|
|
/**
|
|
* Returns a deep copy of the schema
|
|
*
|
|
* @return {Schema} the cloned schema
|
|
* @api public
|
|
* @memberOf Schema
|
|
* @instance
|
|
*/
|
|
|
|
Schema.prototype.clone = function() {
|
|
const s = new Schema({}, this._userProvidedOptions);
|
|
s.base = this.base;
|
|
s.obj = this.obj;
|
|
s.options = utils.clone(this.options);
|
|
s.callQueue = this.callQueue.map(function(f) { return f; });
|
|
s.methods = utils.clone(this.methods);
|
|
s.methodOptions = utils.clone(this.methodOptions);
|
|
s.statics = utils.clone(this.statics);
|
|
s.query = utils.clone(this.query);
|
|
s.plugins = Array.prototype.slice.call(this.plugins);
|
|
s._indexes = utils.clone(this._indexes);
|
|
s.s.hooks = this.s.hooks.clone();
|
|
s._originalSchema = this._originalSchema == null ?
|
|
this._originalSchema :
|
|
this._originalSchema.clone();
|
|
|
|
s.tree = utils.clone(this.tree);
|
|
s.paths = utils.clone(this.paths);
|
|
s.nested = utils.clone(this.nested);
|
|
s.subpaths = utils.clone(this.subpaths);
|
|
s.childSchemas = this.childSchemas.slice();
|
|
s.singleNestedPaths = utils.clone(this.singleNestedPaths);
|
|
|
|
s.virtuals = utils.clone(this.virtuals);
|
|
s.$globalPluginsApplied = this.$globalPluginsApplied;
|
|
s.$isRootDiscriminator = this.$isRootDiscriminator;
|
|
|
|
if (this.discriminatorMapping != null) {
|
|
s.discriminatorMapping = Object.assign({}, this.discriminatorMapping);
|
|
}
|
|
if (s.discriminators != null) {
|
|
s.discriminators = Object.assign({}, this.discriminators);
|
|
}
|
|
|
|
s.aliases = Object.assign({}, this.aliases);
|
|
|
|
// Bubble up `init` for backwards compat
|
|
s.on('init', v => this.emit('init', v));
|
|
|
|
return s;
|
|
};
|
|
|
|
/**
|
|
* Returns default options for this schema, merged with `options`.
|
|
*
|
|
* @param {Object} options
|
|
* @return {Object}
|
|
* @api private
|
|
*/
|
|
|
|
Schema.prototype.defaultOptions = function(options) {
|
|
if (options && options.safe === false) {
|
|
options.safe = {w: 0};
|
|
}
|
|
|
|
if (options && options.safe && options.safe.w === 0) {
|
|
// if you turn off safe writes, then versioning goes off as well
|
|
options.versionKey = false;
|
|
}
|
|
|
|
this._userProvidedOptions = options == null ? {} : utils.clone(options);
|
|
|
|
const baseOptions = get(this, 'base.options', {});
|
|
options = utils.options({
|
|
strict: 'strict' in baseOptions ? baseOptions.strict : true,
|
|
bufferCommands: true,
|
|
capped: false, // { size, max, autoIndexId }
|
|
versionKey: '__v',
|
|
discriminatorKey: '__t',
|
|
minimize: true,
|
|
autoIndex: null,
|
|
shardKey: null,
|
|
read: null,
|
|
validateBeforeSave: true,
|
|
// the following are only applied at construction time
|
|
noId: false, // deprecated, use { _id: false }
|
|
_id: true,
|
|
noVirtualId: false, // deprecated, use { id: false }
|
|
id: true,
|
|
typeKey: 'type'
|
|
}, utils.clone(options));
|
|
|
|
if (options.read) {
|
|
options.read = readPref(options.read);
|
|
}
|
|
|
|
return options;
|
|
};
|
|
|
|
/**
|
|
* Adds key path / schema type pairs to this schema.
|
|
*
|
|
* ####Example:
|
|
*
|
|
* const ToySchema = new Schema();
|
|
* ToySchema.add({ name: 'string', color: 'string', price: 'number' });
|
|
*
|
|
* const TurboManSchema = new Schema();
|
|
* // You can also `add()` another schema and copy over all paths, virtuals,
|
|
* // getters, setters, indexes, methods, and statics.
|
|
* TurboManSchema.add(ToySchema).add({ year: Number });
|
|
*
|
|
* @param {Object|Schema} obj plain object with paths to add, or another schema
|
|
* @param {String} [prefix] path to prefix the newly added paths with
|
|
* @return {Schema} the Schema instance
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.add = function add(obj, prefix) {
|
|
if (obj instanceof Schema) {
|
|
merge(this, obj);
|
|
return;
|
|
}
|
|
|
|
prefix = prefix || '';
|
|
const keys = Object.keys(obj);
|
|
|
|
for (let i = 0; i < keys.length; ++i) {
|
|
const key = keys[i];
|
|
|
|
if (obj[key] == null) {
|
|
throw new TypeError('Invalid value for schema path `' + prefix + key + '`');
|
|
}
|
|
|
|
if (Array.isArray(obj[key]) && obj[key].length === 1 && obj[key][0] == null) {
|
|
throw new TypeError('Invalid value for schema Array path `' + prefix + key + '`');
|
|
}
|
|
|
|
if (utils.isObject(obj[key]) &&
|
|
(!obj[key].constructor || utils.getFunctionName(obj[key].constructor) === 'Object') &&
|
|
(!obj[key][this.options.typeKey] || (this.options.typeKey === 'type' && obj[key].type.type))) {
|
|
if (Object.keys(obj[key]).length) {
|
|
// nested object { last: { name: String }}
|
|
this.nested[prefix + key] = true;
|
|
this.add(obj[key], prefix + key + '.');
|
|
} else {
|
|
if (prefix) {
|
|
this.nested[prefix.substr(0, prefix.length - 1)] = true;
|
|
}
|
|
this.path(prefix + key, obj[key]); // mixed type
|
|
}
|
|
} else {
|
|
if (prefix) {
|
|
this.nested[prefix.substr(0, prefix.length - 1)] = true;
|
|
}
|
|
this.path(prefix + key, obj[key]);
|
|
}
|
|
}
|
|
|
|
const addedKeys = Object.keys(obj).
|
|
map(key => prefix ? prefix + key : key);
|
|
aliasFields(this, addedKeys);
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Reserved document keys.
|
|
*
|
|
* Keys in this object are names that are rejected in schema declarations b/c they conflict with mongoose functionality. Using these key name will throw an error.
|
|
*
|
|
* on, emit, _events, db, get, set, init, isNew, errors, schema, options, modelName, collection, _pres, _posts, toObject
|
|
*
|
|
* _NOTE:_ Use of these terms as method names is permitted, but play at your own risk, as they may be existing mongoose document methods you are stomping on.
|
|
*
|
|
* var schema = new Schema(..);
|
|
* schema.methods.init = function () {} // potentially breaking
|
|
*/
|
|
|
|
Schema.reserved = Object.create(null);
|
|
Schema.prototype.reserved = Schema.reserved;
|
|
const reserved = Schema.reserved;
|
|
// Core object
|
|
reserved['prototype'] =
|
|
// EventEmitter
|
|
reserved.emit =
|
|
reserved.on =
|
|
reserved.once =
|
|
reserved.listeners =
|
|
reserved.removeListener =
|
|
// document properties and functions
|
|
reserved.collection =
|
|
reserved.db =
|
|
reserved.errors =
|
|
reserved.init =
|
|
reserved.isModified =
|
|
reserved.isNew =
|
|
reserved.get =
|
|
reserved.modelName =
|
|
reserved.save =
|
|
reserved.schema =
|
|
reserved.toObject =
|
|
reserved.validate =
|
|
reserved.remove =
|
|
reserved.populated =
|
|
// hooks.js
|
|
reserved._pres = reserved._posts = 1;
|
|
|
|
/*!
|
|
* Document keys to print warnings for
|
|
*/
|
|
|
|
const warnings = {};
|
|
warnings.increment = '`increment` should not be used as a schema path name ' +
|
|
'unless you have disabled versioning.';
|
|
|
|
/**
|
|
* Gets/sets schema paths.
|
|
*
|
|
* Sets a path (if arity 2)
|
|
* Gets a path (if arity 1)
|
|
*
|
|
* ####Example
|
|
*
|
|
* schema.path('name') // returns a SchemaType
|
|
* schema.path('name', Number) // changes the schemaType of `name` to Number
|
|
*
|
|
* @param {String} path
|
|
* @param {Object} constructor
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.path = function(path, obj) {
|
|
if (obj === undefined) {
|
|
if (this.paths.hasOwnProperty(path)) {
|
|
return this.paths[path];
|
|
}
|
|
if (this.subpaths.hasOwnProperty(path)) {
|
|
return this.subpaths[path];
|
|
}
|
|
if (this.singleNestedPaths.hasOwnProperty(path)) {
|
|
return this.singleNestedPaths[path];
|
|
}
|
|
|
|
// Look for maps
|
|
for (const _path of Object.keys(this.paths)) {
|
|
if (!_path.includes('.$*')) {
|
|
continue;
|
|
}
|
|
const re = new RegExp('^' + _path.replace(/\.\$\*/g, '.[^.]+') + '$');
|
|
if (re.test(path)) {
|
|
return this.paths[_path];
|
|
}
|
|
}
|
|
|
|
// subpaths?
|
|
return /\.\d+\.?.*$/.test(path)
|
|
? getPositionalPath(this, path)
|
|
: undefined;
|
|
}
|
|
|
|
// some path names conflict with document methods
|
|
if (reserved[path]) {
|
|
throw new Error('`' + path + '` may not be used as a schema pathname');
|
|
}
|
|
|
|
if (warnings[path]) {
|
|
console.log('WARN: ' + warnings[path]);
|
|
}
|
|
|
|
if (typeof obj === 'object' && 'ref' in obj) {
|
|
validateRef(obj.ref, path);
|
|
}
|
|
|
|
// update the tree
|
|
const subpaths = path.split(/\./);
|
|
const last = subpaths.pop();
|
|
let branch = this.tree;
|
|
|
|
subpaths.forEach(function(sub, i) {
|
|
if (!branch[sub]) {
|
|
branch[sub] = {};
|
|
}
|
|
if (typeof branch[sub] !== 'object') {
|
|
const msg = 'Cannot set nested path `' + path + '`. '
|
|
+ 'Parent path `'
|
|
+ subpaths.slice(0, i).concat([sub]).join('.')
|
|
+ '` already set to type ' + branch[sub].name
|
|
+ '.';
|
|
throw new Error(msg);
|
|
}
|
|
branch = branch[sub];
|
|
});
|
|
|
|
branch[last] = utils.clone(obj);
|
|
|
|
this.paths[path] = this.interpretAsType(path, obj, this.options);
|
|
const schemaType = this.paths[path];
|
|
|
|
if (schemaType.$isSchemaMap) {
|
|
// Maps can have arbitrary keys, so `$*` is internal shorthand for "any key"
|
|
// The '$' is to imply this path should never be stored in MongoDB so we
|
|
// can easily build a regexp out of this path, and '*' to imply "any key."
|
|
const mapPath = path + '.$*';
|
|
this.paths[path + '.$*'] = this.interpretAsType(mapPath,
|
|
obj.of || { type: {} }, this.options);
|
|
schemaType.$__schemaType = this.paths[path + '.$*'];
|
|
}
|
|
|
|
if (schemaType.$isSingleNested) {
|
|
for (const key in schemaType.schema.paths) {
|
|
this.singleNestedPaths[path + '.' + key] = schemaType.schema.paths[key];
|
|
}
|
|
for (const key in schemaType.schema.singleNestedPaths) {
|
|
this.singleNestedPaths[path + '.' + key] =
|
|
schemaType.schema.singleNestedPaths[key];
|
|
}
|
|
|
|
Object.defineProperty(schemaType.schema, 'base', {
|
|
configurable: true,
|
|
enumerable: false,
|
|
writable: false,
|
|
value: this.base
|
|
});
|
|
|
|
schemaType.caster.base = this.base;
|
|
this.childSchemas.push({
|
|
schema: schemaType.schema,
|
|
model: schemaType.caster
|
|
});
|
|
} else if (schemaType.$isMongooseDocumentArray) {
|
|
Object.defineProperty(schemaType.schema, 'base', {
|
|
configurable: true,
|
|
enumerable: false,
|
|
writable: false,
|
|
value: this.base
|
|
});
|
|
|
|
schemaType.casterConstructor.base = this.base;
|
|
this.childSchemas.push({
|
|
schema: schemaType.schema,
|
|
model: schemaType.casterConstructor
|
|
});
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* The Mongoose instance this schema is associated with
|
|
*
|
|
* @property base
|
|
* @api private
|
|
*/
|
|
|
|
Object.defineProperty(Schema.prototype, 'base', {
|
|
configurable: true,
|
|
enumerable: false,
|
|
writable: true,
|
|
value: null
|
|
});
|
|
|
|
/**
|
|
* Converts type arguments into Mongoose Types.
|
|
*
|
|
* @param {String} path
|
|
* @param {Object} obj constructor
|
|
* @api private
|
|
*/
|
|
|
|
Schema.prototype.interpretAsType = function(path, obj, options) {
|
|
if (obj instanceof SchemaType) {
|
|
return obj;
|
|
}
|
|
|
|
// If this schema has an associated Mongoose object, use the Mongoose object's
|
|
// copy of SchemaTypes re: gh-7158 gh-6933
|
|
const MongooseTypes = this.base != null ? this.base.Schema.Types : Schema.Types;
|
|
|
|
if (obj.constructor) {
|
|
const constructorName = utils.getFunctionName(obj.constructor);
|
|
if (constructorName !== 'Object') {
|
|
const oldObj = obj;
|
|
obj = {};
|
|
obj[options.typeKey] = oldObj;
|
|
}
|
|
}
|
|
|
|
// Get the type making sure to allow keys named "type"
|
|
// and default to mixed if not specified.
|
|
// { type: { type: String, default: 'freshcut' } }
|
|
let type = obj[options.typeKey] && (options.typeKey !== 'type' || !obj.type.type)
|
|
? obj[options.typeKey]
|
|
: {};
|
|
let name;
|
|
|
|
if (utils.getFunctionName(type.constructor) === 'Object' || type === 'mixed') {
|
|
return new MongooseTypes.Mixed(path, obj);
|
|
}
|
|
|
|
if (Array.isArray(type) || Array === type || type === 'array') {
|
|
// if it was specified through { type } look for `cast`
|
|
let cast = (Array === type || type === 'array')
|
|
? obj.cast
|
|
: type[0];
|
|
|
|
if (cast && cast.instanceOfSchema) {
|
|
return new MongooseTypes.DocumentArray(path, cast, obj);
|
|
}
|
|
if (cast &&
|
|
cast[options.typeKey] &&
|
|
cast[options.typeKey].instanceOfSchema) {
|
|
return new MongooseTypes.DocumentArray(path, cast[options.typeKey], obj, cast);
|
|
}
|
|
|
|
if (Array.isArray(cast)) {
|
|
return new MongooseTypes.Array(path, this.interpretAsType(path, cast, options), obj);
|
|
}
|
|
|
|
if (typeof cast === 'string') {
|
|
cast = MongooseTypes[cast.charAt(0).toUpperCase() + cast.substring(1)];
|
|
} else if (cast && (!cast[options.typeKey] || (options.typeKey === 'type' && cast.type.type))
|
|
&& utils.getFunctionName(cast.constructor) === 'Object') {
|
|
if (Object.keys(cast).length) {
|
|
// The `minimize` and `typeKey` options propagate to child schemas
|
|
// declared inline, like `{ arr: [{ val: { $type: String } }] }`.
|
|
// See gh-3560
|
|
const childSchemaOptions = {minimize: options.minimize};
|
|
if (options.typeKey) {
|
|
childSchemaOptions.typeKey = options.typeKey;
|
|
}
|
|
//propagate 'strict' option to child schema
|
|
if (options.hasOwnProperty('strict')) {
|
|
childSchemaOptions.strict = options.strict;
|
|
}
|
|
const childSchema = new Schema(cast, childSchemaOptions);
|
|
childSchema.$implicitlyCreated = true;
|
|
return new MongooseTypes.DocumentArray(path, childSchema, obj);
|
|
} else {
|
|
// Special case: empty object becomes mixed
|
|
return new MongooseTypes.Array(path, MongooseTypes.Mixed, obj);
|
|
}
|
|
}
|
|
|
|
if (cast) {
|
|
type = cast[options.typeKey] && (options.typeKey !== 'type' || !cast.type.type)
|
|
? cast[options.typeKey]
|
|
: cast;
|
|
|
|
name = typeof type === 'string'
|
|
? type
|
|
: type.schemaName || utils.getFunctionName(type);
|
|
|
|
if (!(name in MongooseTypes)) {
|
|
throw new TypeError('Invalid schema configuration: ' +
|
|
`\`${name}\` is not a valid type within the array \`${path}\`.` +
|
|
'See http://bit.ly/mongoose-schematypes for a list of valid schema types.');
|
|
}
|
|
}
|
|
|
|
return new MongooseTypes.Array(path, cast || MongooseTypes.Mixed, obj, options);
|
|
}
|
|
|
|
if (type && type.instanceOfSchema) {
|
|
return new MongooseTypes.Embedded(type, path, obj);
|
|
}
|
|
|
|
if (Buffer.isBuffer(type)) {
|
|
name = 'Buffer';
|
|
} else if (typeof type === 'function' || typeof type === 'object') {
|
|
name = type.schemaName || utils.getFunctionName(type);
|
|
} else {
|
|
name = type == null ? '' + type : type.toString();
|
|
}
|
|
|
|
if (name) {
|
|
name = name.charAt(0).toUpperCase() + name.substring(1);
|
|
}
|
|
// Special case re: gh-7049 because the bson `ObjectID` class' capitalization
|
|
// doesn't line up with Mongoose's.
|
|
if (name === 'ObjectID') {
|
|
name = 'ObjectId';
|
|
}
|
|
|
|
if (MongooseTypes[name] == null) {
|
|
throw new TypeError(`Invalid schema configuration: \`${name}\` is not ` +
|
|
`a valid type at path \`${path}\`. See ` +
|
|
'http://bit.ly/mongoose-schematypes for a list of valid schema types.');
|
|
}
|
|
|
|
return new MongooseTypes[name](path, obj);
|
|
};
|
|
|
|
/**
|
|
* Iterates the schemas paths similar to Array#forEach.
|
|
*
|
|
* The callback is passed the pathname and schemaType as arguments on each iteration.
|
|
*
|
|
* @param {Function} fn callback function
|
|
* @return {Schema} this
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.eachPath = function(fn) {
|
|
const keys = Object.keys(this.paths);
|
|
const len = keys.length;
|
|
|
|
for (let i = 0; i < len; ++i) {
|
|
fn(keys[i], this.paths[keys[i]]);
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Returns an Array of path strings that are required by this schema.
|
|
*
|
|
* @api public
|
|
* @param {Boolean} invalidate refresh the cache
|
|
* @return {Array}
|
|
*/
|
|
|
|
Schema.prototype.requiredPaths = function requiredPaths(invalidate) {
|
|
if (this._requiredpaths && !invalidate) {
|
|
return this._requiredpaths;
|
|
}
|
|
|
|
const paths = Object.keys(this.paths);
|
|
let i = paths.length;
|
|
const ret = [];
|
|
|
|
while (i--) {
|
|
const path = paths[i];
|
|
if (this.paths[path].isRequired) {
|
|
ret.push(path);
|
|
}
|
|
}
|
|
this._requiredpaths = ret;
|
|
return this._requiredpaths;
|
|
};
|
|
|
|
/**
|
|
* Returns indexes from fields and schema-level indexes (cached).
|
|
*
|
|
* @api private
|
|
* @return {Array}
|
|
*/
|
|
|
|
Schema.prototype.indexedPaths = function indexedPaths() {
|
|
if (this._indexedpaths) {
|
|
return this._indexedpaths;
|
|
}
|
|
this._indexedpaths = this.indexes();
|
|
return this._indexedpaths;
|
|
};
|
|
|
|
/**
|
|
* Returns the pathType of `path` for this schema.
|
|
*
|
|
* Given a path, returns whether it is a real, virtual, nested, or ad-hoc/undefined path.
|
|
*
|
|
* @param {String} path
|
|
* @return {String}
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.pathType = function(path) {
|
|
if (path in this.paths) {
|
|
return 'real';
|
|
}
|
|
if (path in this.virtuals) {
|
|
return 'virtual';
|
|
}
|
|
if (path in this.nested) {
|
|
return 'nested';
|
|
}
|
|
if (path in this.subpaths) {
|
|
return 'real';
|
|
}
|
|
if (path in this.singleNestedPaths) {
|
|
return 'real';
|
|
}
|
|
|
|
// Look for maps
|
|
for (const _path of Object.keys(this.paths)) {
|
|
if (!_path.includes('.$*')) {
|
|
continue;
|
|
}
|
|
const re = new RegExp('^' + _path.replace(/\.\$\*/g, '.[^.]+') + '$');
|
|
if (re.test(path)) {
|
|
return this.paths[_path];
|
|
}
|
|
}
|
|
|
|
if (/\.\d+\.|\.\d+$/.test(path)) {
|
|
return getPositionalPathType(this, path);
|
|
}
|
|
return 'adhocOrUndefined';
|
|
};
|
|
|
|
/**
|
|
* Returns true iff this path is a child of a mixed schema.
|
|
*
|
|
* @param {String} path
|
|
* @return {Boolean}
|
|
* @api private
|
|
*/
|
|
|
|
Schema.prototype.hasMixedParent = function(path) {
|
|
const subpaths = path.split(/\./g);
|
|
path = '';
|
|
for (let i = 0; i < subpaths.length; ++i) {
|
|
path = i > 0 ? path + '.' + subpaths[i] : subpaths[i];
|
|
if (path in this.paths &&
|
|
this.paths[path] instanceof MongooseTypes.Mixed) {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
};
|
|
|
|
/**
|
|
* Setup updatedAt and createdAt timestamps to documents if enabled
|
|
*
|
|
* @param {Boolean|Object} timestamps timestamps options
|
|
* @api private
|
|
*/
|
|
Schema.prototype.setupTimestamp = function(timestamps) {
|
|
const childHasTimestamp = this.childSchemas.find(withTimestamp);
|
|
|
|
function withTimestamp(s) {
|
|
const ts = s.schema.options.timestamps;
|
|
return !!ts;
|
|
}
|
|
|
|
if (!timestamps && !childHasTimestamp) {
|
|
return;
|
|
}
|
|
|
|
const createdAt = handleTimestampOption(timestamps, 'createdAt');
|
|
const updatedAt = handleTimestampOption(timestamps, 'updatedAt');
|
|
const schemaAdditions = {};
|
|
|
|
this.$timestamps = { createdAt: createdAt, updatedAt: updatedAt };
|
|
|
|
if (updatedAt && !this.paths[updatedAt]) {
|
|
schemaAdditions[updatedAt] = Date;
|
|
}
|
|
|
|
if (createdAt && !this.paths[createdAt]) {
|
|
schemaAdditions[createdAt] = Date;
|
|
}
|
|
|
|
this.add(schemaAdditions);
|
|
|
|
this.pre('save', function(next) {
|
|
const defaultTimestamp = (this.ownerDocument ? this.ownerDocument() : this).
|
|
constructor.base.now();
|
|
const auto_id = this._id && this._id.auto;
|
|
|
|
if (createdAt && !this.get(createdAt) && this.isSelected(createdAt)) {
|
|
this.set(createdAt, auto_id ? this._id.getTimestamp() : defaultTimestamp);
|
|
}
|
|
|
|
if (updatedAt && (this.isNew || this.isModified())) {
|
|
let ts = defaultTimestamp;
|
|
if (this.isNew) {
|
|
if (createdAt != null) {
|
|
ts = this.get(createdAt);
|
|
} else if (auto_id) {
|
|
ts = this._id.getTimestamp();
|
|
}
|
|
}
|
|
this.set(updatedAt, ts);
|
|
}
|
|
|
|
next();
|
|
});
|
|
|
|
this.methods.initializeTimestamps = function() {
|
|
if (createdAt && !this.get(createdAt)) {
|
|
this.set(createdAt, new Date());
|
|
}
|
|
if (updatedAt && !this.get(updatedAt)) {
|
|
this.set(updatedAt, new Date());
|
|
}
|
|
return this;
|
|
};
|
|
|
|
_setTimestampsOnUpdate[symbols.builtInMiddleware] = true;
|
|
|
|
this.pre('findOneAndUpdate', _setTimestampsOnUpdate);
|
|
this.pre('replaceOne', _setTimestampsOnUpdate);
|
|
this.pre('update', _setTimestampsOnUpdate);
|
|
this.pre('updateOne', _setTimestampsOnUpdate);
|
|
this.pre('updateMany', _setTimestampsOnUpdate);
|
|
|
|
function _setTimestampsOnUpdate(next) {
|
|
const now = this.model.base.now();
|
|
applyTimestampsToUpdate(now, createdAt, updatedAt, this.getUpdate(),
|
|
this.options, this.schema);
|
|
applyTimestampsToChildren(now, this.getUpdate(), this.model.schema);
|
|
next();
|
|
}
|
|
};
|
|
|
|
/*!
|
|
* ignore
|
|
*/
|
|
|
|
function getPositionalPathType(self, path) {
|
|
const subpaths = path.split(/\.(\d+)\.|\.(\d+)$/).filter(Boolean);
|
|
if (subpaths.length < 2) {
|
|
return self.paths.hasOwnProperty(subpaths[0]) ? self.paths[subpath[0]] : null;
|
|
}
|
|
|
|
let val = self.path(subpaths[0]);
|
|
let isNested = false;
|
|
if (!val) {
|
|
return val;
|
|
}
|
|
|
|
const last = subpaths.length - 1;
|
|
let subpath;
|
|
let i = 1;
|
|
|
|
for (; i < subpaths.length; ++i) {
|
|
isNested = false;
|
|
subpath = subpaths[i];
|
|
|
|
if (i === last && val && !/\D/.test(subpath)) {
|
|
if (val.$isMongooseDocumentArray) {
|
|
const oldVal = val;
|
|
val = new SchemaType(subpath, {
|
|
required: get(val, 'schemaOptions.required', false)
|
|
});
|
|
val.cast = function(value, doc, init) {
|
|
return oldVal.cast(value, doc, init)[0];
|
|
};
|
|
val.$isMongooseDocumentArrayElement = true;
|
|
val.caster = oldVal.caster;
|
|
val.schema = oldVal.schema;
|
|
} else if (val instanceof MongooseTypes.Array) {
|
|
// StringSchema, NumberSchema, etc
|
|
val = val.caster;
|
|
} else {
|
|
val = undefined;
|
|
}
|
|
break;
|
|
}
|
|
|
|
// ignore if its just a position segment: path.0.subpath
|
|
if (!/\D/.test(subpath)) {
|
|
continue;
|
|
}
|
|
|
|
if (!(val && val.schema)) {
|
|
val = undefined;
|
|
break;
|
|
}
|
|
|
|
const type = val.schema.pathType(subpath);
|
|
isNested = (type === 'nested');
|
|
val = val.schema.path(subpath);
|
|
}
|
|
|
|
self.subpaths[path] = val;
|
|
if (val) {
|
|
return 'real';
|
|
}
|
|
if (isNested) {
|
|
return 'nested';
|
|
}
|
|
return 'adhocOrUndefined';
|
|
}
|
|
|
|
|
|
/*!
|
|
* ignore
|
|
*/
|
|
|
|
function getPositionalPath(self, path) {
|
|
getPositionalPathType(self, path);
|
|
return self.subpaths[path];
|
|
}
|
|
|
|
/**
|
|
* Adds a method call to the queue.
|
|
*
|
|
* @param {String} name name of the document method to call later
|
|
* @param {Array} args arguments to pass to the method
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.queue = function(name, args) {
|
|
this.callQueue.push([name, args]);
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Defines a pre hook for the document.
|
|
*
|
|
* ####Example
|
|
*
|
|
* var toySchema = new Schema({ name: String, created: Date });
|
|
*
|
|
* toySchema.pre('save', function(next) {
|
|
* if (!this.created) this.created = new Date;
|
|
* next();
|
|
* });
|
|
*
|
|
* toySchema.pre('validate', function(next) {
|
|
* if (this.name !== 'Woody') this.name = 'Woody';
|
|
* next();
|
|
* });
|
|
*
|
|
* // Equivalent to calling `pre()` on `find`, `findOne`, `findOneAndUpdate`.
|
|
* toySchema.pre(/^find/, function(next) {
|
|
* console.log(this.getQuery());
|
|
* });
|
|
*
|
|
* @param {String|RegExp} method or regular expression to match method name
|
|
* @param {Object} [options]
|
|
* @param {Boolean} [options.document] If `name` is a hook for both document and query middleware, set to `true` to run on document middleware.
|
|
* @param {Boolean} [options.query] If `name` is a hook for both document and query middleware, set to `true` to run on query middleware.
|
|
* @param {Function} callback
|
|
* @see hooks.js https://github.com/bnoguchi/hooks-js/tree/31ec571cef0332e21121ee7157e0cf9728572cc3
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.pre = function(name) {
|
|
if (name instanceof RegExp) {
|
|
const remainingArgs = Array.prototype.slice.call(arguments, 1);
|
|
for (const fn of allMiddleware) {
|
|
if (name.test(fn)) {
|
|
this.pre.apply(this, [fn].concat(remainingArgs));
|
|
}
|
|
}
|
|
return this;
|
|
}
|
|
this.s.hooks.pre.apply(this.s.hooks, arguments);
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Defines a post hook for the document
|
|
*
|
|
* var schema = new Schema(..);
|
|
* schema.post('save', function (doc) {
|
|
* console.log('this fired after a document was saved');
|
|
* });
|
|
*
|
|
* schema.post('find', function(docs) {
|
|
* console.log('this fired after you ran a find query');
|
|
* });
|
|
*
|
|
* schema.post(/Many$/, function(res) {
|
|
* console.log('this fired after you ran `updateMany()` or `deleteMany()`);
|
|
* });
|
|
*
|
|
* var Model = mongoose.model('Model', schema);
|
|
*
|
|
* var m = new Model(..);
|
|
* m.save(function(err) {
|
|
* console.log('this fires after the `post` hook');
|
|
* });
|
|
*
|
|
* m.find(function(err, docs) {
|
|
* console.log('this fires after the post find hook');
|
|
* });
|
|
*
|
|
* @param {String|RegExp} method or regular expression to match method name
|
|
* @param {Object} [options]
|
|
* @param {Boolean} [options.document] If `name` is a hook for both document and query middleware, set to `true` to run on document middleware.
|
|
* @param {Boolean} [options.query] If `name` is a hook for both document and query middleware, set to `true` to run on query middleware.
|
|
* @param {Function} fn callback
|
|
* @see middleware http://mongoosejs.com/docs/middleware.html
|
|
* @see kareem http://npmjs.org/package/kareem
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.post = function(name) {
|
|
if (name instanceof RegExp) {
|
|
const remainingArgs = Array.prototype.slice.call(arguments, 1);
|
|
for (const fn of allMiddleware) {
|
|
if (name.test(fn)) {
|
|
this.post.apply(this, [fn].concat(remainingArgs));
|
|
}
|
|
}
|
|
return this;
|
|
}
|
|
this.s.hooks.post.apply(this.s.hooks, arguments);
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Registers a plugin for this schema.
|
|
*
|
|
* @param {Function} plugin callback
|
|
* @param {Object} [opts]
|
|
* @see plugins
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.plugin = function(fn, opts) {
|
|
if (typeof fn !== 'function') {
|
|
throw new Error('First param to `schema.plugin()` must be a function, ' +
|
|
'got "' + (typeof fn) + '"');
|
|
}
|
|
|
|
if (opts &&
|
|
opts.deduplicate) {
|
|
for (let i = 0; i < this.plugins.length; ++i) {
|
|
if (this.plugins[i].fn === fn) {
|
|
return this;
|
|
}
|
|
}
|
|
}
|
|
this.plugins.push({ fn: fn, opts: opts });
|
|
|
|
fn(this, opts);
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Adds an instance method to documents constructed from Models compiled from this schema.
|
|
*
|
|
* ####Example
|
|
*
|
|
* var schema = kittySchema = new Schema(..);
|
|
*
|
|
* schema.method('meow', function () {
|
|
* console.log('meeeeeoooooooooooow');
|
|
* })
|
|
*
|
|
* var Kitty = mongoose.model('Kitty', schema);
|
|
*
|
|
* var fizz = new Kitty;
|
|
* fizz.meow(); // meeeeeooooooooooooow
|
|
*
|
|
* If a hash of name/fn pairs is passed as the only argument, each name/fn pair will be added as methods.
|
|
*
|
|
* schema.method({
|
|
* purr: function () {}
|
|
* , scratch: function () {}
|
|
* });
|
|
*
|
|
* // later
|
|
* fizz.purr();
|
|
* fizz.scratch();
|
|
*
|
|
* NOTE: `Schema.method()` adds instance methods to the `Schema.methods` object. You can also add instance methods directly to the `Schema.methods` object as seen in the [guide](./guide.html#methods)
|
|
*
|
|
* @param {String|Object} method name
|
|
* @param {Function} [fn]
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.method = function(name, fn, options) {
|
|
if (typeof name !== 'string') {
|
|
for (const i in name) {
|
|
this.methods[i] = name[i];
|
|
this.methodOptions[i] = utils.clone(options);
|
|
}
|
|
} else {
|
|
this.methods[name] = fn;
|
|
this.methodOptions[name] = utils.clone(options);
|
|
}
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Adds static "class" methods to Models compiled from this schema.
|
|
*
|
|
* ####Example
|
|
*
|
|
* var schema = new Schema(..);
|
|
* schema.static('findByName', function (name, callback) {
|
|
* return this.find({ name: name }, callback);
|
|
* });
|
|
*
|
|
* var Drink = mongoose.model('Drink', schema);
|
|
* Drink.findByName('sanpellegrino', function (err, drinks) {
|
|
* //
|
|
* });
|
|
*
|
|
* If a hash of name/fn pairs is passed as the only argument, each name/fn pair will be added as statics.
|
|
*
|
|
* @param {String|Object} name
|
|
* @param {Function} [fn]
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.static = function(name, fn) {
|
|
if (typeof name !== 'string') {
|
|
for (const i in name) {
|
|
this.statics[i] = name[i];
|
|
}
|
|
} else {
|
|
this.statics[name] = fn;
|
|
}
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Defines an index (most likely compound) for this schema.
|
|
*
|
|
* ####Example
|
|
*
|
|
* schema.index({ first: 1, last: -1 })
|
|
*
|
|
* @param {Object} fields
|
|
* @param {Object} [options] Options to pass to [MongoDB driver's `createIndex()` function](http://mongodb.github.io/node-mongodb-native/2.0/api/Collection.html#createIndex)
|
|
* @param {String} [options.expires=null] Mongoose-specific syntactic sugar, uses [ms](https://www.npmjs.com/package/ms) to convert `expires` option into seconds for the `expireAfterSeconds` in the above link.
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.index = function(fields, options) {
|
|
fields || (fields = {});
|
|
options || (options = {});
|
|
|
|
if (options.expires) {
|
|
utils.expires(options);
|
|
}
|
|
|
|
this._indexes.push([fields, options]);
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Sets/gets a schema option.
|
|
*
|
|
* ####Example
|
|
*
|
|
* schema.set('strict'); // 'true' by default
|
|
* schema.set('strict', false); // Sets 'strict' to false
|
|
* schema.set('strict'); // 'false'
|
|
*
|
|
* @param {String} key option name
|
|
* @param {Object} [value] if not passed, the current option value is returned
|
|
* @see Schema ./
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.set = function(key, value, _tags) {
|
|
if (arguments.length === 1) {
|
|
return this.options[key];
|
|
}
|
|
|
|
switch (key) {
|
|
case 'read':
|
|
this.options[key] = readPref(value, _tags);
|
|
this._userProvidedOptions[key] = this.options[key];
|
|
break;
|
|
case 'safe':
|
|
setSafe(this.options, value);
|
|
this._userProvidedOptions[key] = this.options[key];
|
|
break;
|
|
case 'timestamps':
|
|
this.setupTimestamp(value);
|
|
this.options[key] = value;
|
|
this._userProvidedOptions[key] = this.options[key];
|
|
break;
|
|
default:
|
|
this.options[key] = value;
|
|
this._userProvidedOptions[key] = this.options[key];
|
|
break;
|
|
}
|
|
|
|
return this;
|
|
};
|
|
|
|
/*!
|
|
* ignore
|
|
*/
|
|
|
|
const safeDeprecationWarning = 'Mongoose: The `safe` option for schemas is ' +
|
|
'deprecated. Use the `writeConcern` option instead: ' +
|
|
'http://bit.ly/mongoose-write-concern';
|
|
|
|
const setSafe = util.deprecate(function setSafe(options, value) {
|
|
options.safe = value === false ?
|
|
{w: 0} :
|
|
value;
|
|
}, safeDeprecationWarning);
|
|
|
|
/**
|
|
* Gets a schema option.
|
|
*
|
|
* @param {String} key option name
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.get = function(key) {
|
|
return this.options[key];
|
|
};
|
|
|
|
/**
|
|
* The allowed index types
|
|
*
|
|
* @receiver Schema
|
|
* @static indexTypes
|
|
* @api public
|
|
*/
|
|
|
|
const indexTypes = '2d 2dsphere hashed text'.split(' ');
|
|
|
|
Object.defineProperty(Schema, 'indexTypes', {
|
|
get: function() {
|
|
return indexTypes;
|
|
},
|
|
set: function() {
|
|
throw new Error('Cannot overwrite Schema.indexTypes');
|
|
}
|
|
});
|
|
|
|
/**
|
|
* Returns a list of indexes that this schema declares, via `schema.index()`
|
|
* or by `index: true` in a path's options.
|
|
*
|
|
* @api public
|
|
*/
|
|
|
|
Schema.prototype.indexes = function() {
|
|
return getIndexes(this);
|
|
};
|
|
|
|
/**
|
|
* Creates a virtual type with the given name.
|
|
*
|
|
* @param {String} name
|
|
* @param {Object} [options]
|
|
* @param {String|Model} [options.ref] model name or model instance. Marks this as a [populate virtual](populate.html#populate-virtuals).
|
|
* @param {String|Function} [options.localField] Required for populate virtuals. See [populate virtual docs](populate.html#populate-virtuals) for more information.
|
|
* @param {String|Function} [options.foreignField] Required for populate virtuals. See [populate virtual docs](populate.html#populate-virtuals) for more information.
|
|
* @param {Boolean|Function} [options.justOne=false] Only works with populate virtuals. If truthy, will be a single doc or `null`. Otherwise, the populate virtual will be an array.
|
|
* @param {Boolean} [options.count=false] Only works with populate virtuals. If truthy, this populate virtual will contain the number of documents rather than the documents themselves when you `populate()`.
|
|
* @return {VirtualType}
|
|
*/
|
|
|
|
Schema.prototype.virtual = function(name, options) {
|
|
if (options && options.ref) {
|
|
if (!options.localField) {
|
|
throw new Error('Reference virtuals require `localField` option');
|
|
}
|
|
|
|
if (!options.foreignField) {
|
|
throw new Error('Reference virtuals require `foreignField` option');
|
|
}
|
|
|
|
this.pre('init', function(obj) {
|
|
if (mpath.has(name, obj)) {
|
|
const _v = mpath.get(name, obj);
|
|
if (!this.$$populatedVirtuals) {
|
|
this.$$populatedVirtuals = {};
|
|
}
|
|
|
|
if (options.justOne || options.count) {
|
|
this.$$populatedVirtuals[name] = Array.isArray(_v) ?
|
|
_v[0] :
|
|
_v;
|
|
} else {
|
|
this.$$populatedVirtuals[name] = Array.isArray(_v) ?
|
|
_v :
|
|
_v == null ? [] : [_v];
|
|
}
|
|
|
|
mpath.unset(name, obj);
|
|
}
|
|
});
|
|
|
|
const virtual = this.virtual(name);
|
|
virtual.options = options;
|
|
return virtual.
|
|
get(function() {
|
|
if (!this.$$populatedVirtuals) {
|
|
this.$$populatedVirtuals = {};
|
|
}
|
|
if (name in this.$$populatedVirtuals) {
|
|
return this.$$populatedVirtuals[name];
|
|
}
|
|
return null;
|
|
}).
|
|
set(function(_v) {
|
|
if (!this.$$populatedVirtuals) {
|
|
this.$$populatedVirtuals = {};
|
|
}
|
|
|
|
if (options.justOne || options.count) {
|
|
this.$$populatedVirtuals[name] = Array.isArray(_v) ?
|
|
_v[0] :
|
|
_v;
|
|
|
|
if (typeof this.$$populatedVirtuals[name] !== 'object') {
|
|
this.$$populatedVirtuals[name] = options.count ? _v : null;
|
|
}
|
|
} else {
|
|
this.$$populatedVirtuals[name] = Array.isArray(_v) ?
|
|
_v :
|
|
_v == null ? [] : [_v];
|
|
|
|
this.$$populatedVirtuals[name] = this.$$populatedVirtuals[name].filter(function(doc) {
|
|
return doc && typeof doc === 'object';
|
|
});
|
|
}
|
|
});
|
|
}
|
|
|
|
const virtuals = this.virtuals;
|
|
const parts = name.split('.');
|
|
|
|
if (this.pathType(name) === 'real') {
|
|
throw new Error('Virtual path "' + name + '"' +
|
|
' conflicts with a real path in the schema');
|
|
}
|
|
|
|
virtuals[name] = parts.reduce(function(mem, part, i) {
|
|
mem[part] || (mem[part] = (i === parts.length - 1)
|
|
? new VirtualType(options, name)
|
|
: {});
|
|
return mem[part];
|
|
}, this.tree);
|
|
|
|
return virtuals[name];
|
|
};
|
|
|
|
/**
|
|
* Returns the virtual type with the given `name`.
|
|
*
|
|
* @param {String} name
|
|
* @return {VirtualType}
|
|
*/
|
|
|
|
Schema.prototype.virtualpath = function(name) {
|
|
return this.virtuals.hasOwnProperty(name) ? this.virtuals[name] : null;
|
|
};
|
|
|
|
/**
|
|
* Removes the given `path` (or [`paths`]).
|
|
*
|
|
* @param {String|Array} path
|
|
* @return {Schema} the Schema instance
|
|
* @api public
|
|
*/
|
|
Schema.prototype.remove = function(path) {
|
|
if (typeof path === 'string') {
|
|
path = [path];
|
|
}
|
|
if (Array.isArray(path)) {
|
|
path.forEach(function(name) {
|
|
if (this.path(name)) {
|
|
delete this.paths[name];
|
|
|
|
const pieces = name.split('.');
|
|
const last = pieces.pop();
|
|
let branch = this.tree;
|
|
for (let i = 0; i < pieces.length; ++i) {
|
|
branch = branch[pieces[i]];
|
|
}
|
|
delete branch[last];
|
|
}
|
|
}, this);
|
|
}
|
|
return this;
|
|
};
|
|
|
|
/**
|
|
* Loads an ES6 class into a schema. Maps [setters](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/set) + [getters](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/get), [static methods](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes/static),
|
|
* and [instance methods](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes#Class_body_and_method_definitions)
|
|
* to schema [virtuals](http://mongoosejs.com/docs/guide.html#virtuals),
|
|
* [statics](http://mongoosejs.com/docs/guide.html#statics), and
|
|
* [methods](http://mongoosejs.com/docs/guide.html#methods).
|
|
*
|
|
* ####Example:
|
|
*
|
|
* ```javascript
|
|
* const md5 = require('md5');
|
|
* const userSchema = new Schema({ email: String });
|
|
* class UserClass {
|
|
* // `gravatarImage` becomes a virtual
|
|
* get gravatarImage() {
|
|
* const hash = md5(this.email.toLowerCase());
|
|
* return `https://www.gravatar.com/avatar/${hash}`;
|
|
* }
|
|
*
|
|
* // `getProfileUrl()` becomes a document method
|
|
* getProfileUrl() {
|
|
* return `https://mysite.com/${this.email}`;
|
|
* }
|
|
*
|
|
* // `findByEmail()` becomes a static
|
|
* static findByEmail(email) {
|
|
* return this.findOne({ email });
|
|
* }
|
|
* }
|
|
*
|
|
* // `schema` will now have a `gravatarImage` virtual, a `getProfileUrl()` method,
|
|
* // and a `findByEmail()` static
|
|
* userSchema.loadClass(UserClass);
|
|
* ```
|
|
*
|
|
* @param {Function} model
|
|
* @param {Boolean} [virtualsOnly] if truthy, only pulls virtuals from the class, not methods or statics
|
|
*/
|
|
Schema.prototype.loadClass = function(model, virtualsOnly) {
|
|
if (model === Object.prototype ||
|
|
model === Function.prototype ||
|
|
model.prototype.hasOwnProperty('$isMongooseModelPrototype')) {
|
|
return this;
|
|
}
|
|
|
|
this.loadClass(Object.getPrototypeOf(model));
|
|
|
|
// Add static methods
|
|
if (!virtualsOnly) {
|
|
Object.getOwnPropertyNames(model).forEach(function(name) {
|
|
if (name.match(/^(length|name|prototype)$/)) {
|
|
return;
|
|
}
|
|
const method = Object.getOwnPropertyDescriptor(model, name);
|
|
if (typeof method.value === 'function') {
|
|
this.static(name, method.value);
|
|
}
|
|
}, this);
|
|
}
|
|
|
|
// Add methods and virtuals
|
|
Object.getOwnPropertyNames(model.prototype).forEach(function(name) {
|
|
if (name.match(/^(constructor)$/)) {
|
|
return;
|
|
}
|
|
const method = Object.getOwnPropertyDescriptor(model.prototype, name);
|
|
if (!virtualsOnly) {
|
|
if (typeof method.value === 'function') {
|
|
this.method(name, method.value);
|
|
}
|
|
}
|
|
if (typeof method.get === 'function') {
|
|
this.virtual(name).get(method.get);
|
|
}
|
|
if (typeof method.set === 'function') {
|
|
this.virtual(name).set(method.set);
|
|
}
|
|
}, this);
|
|
|
|
return this;
|
|
};
|
|
|
|
/*!
|
|
* ignore
|
|
*/
|
|
|
|
Schema.prototype._getSchema = function(path) {
|
|
const _this = this;
|
|
const pathschema = _this.path(path);
|
|
const resultPath = [];
|
|
|
|
if (pathschema) {
|
|
pathschema.$fullPath = path;
|
|
return pathschema;
|
|
}
|
|
|
|
function search(parts, schema) {
|
|
let p = parts.length + 1;
|
|
let foundschema;
|
|
let trypath;
|
|
|
|
while (p--) {
|
|
trypath = parts.slice(0, p).join('.');
|
|
foundschema = schema.path(trypath);
|
|
if (foundschema) {
|
|
resultPath.push(trypath);
|
|
|
|
if (foundschema.caster) {
|
|
// array of Mixed?
|
|
if (foundschema.caster instanceof MongooseTypes.Mixed) {
|
|
foundschema.caster.$fullPath = resultPath.join('.');
|
|
return foundschema.caster;
|
|
}
|
|
|
|
// Now that we found the array, we need to check if there
|
|
// are remaining document paths to look up for casting.
|
|
// Also we need to handle array.$.path since schema.path
|
|
// doesn't work for that.
|
|
// If there is no foundschema.schema we are dealing with
|
|
// a path like array.$
|
|
if (p !== parts.length && foundschema.schema) {
|
|
let ret;
|
|
if (parts[p] === '$' || isArrayFilter(parts[p])) {
|
|
if (p + 1 === parts.length) {
|
|
// comments.$
|
|
return foundschema;
|
|
}
|
|
// comments.$.comments.$.title
|
|
ret = search(parts.slice(p + 1), foundschema.schema);
|
|
if (ret) {
|
|
ret.$isUnderneathDocArray = ret.$isUnderneathDocArray ||
|
|
!foundschema.schema.$isSingleNested;
|
|
}
|
|
return ret;
|
|
}
|
|
// this is the last path of the selector
|
|
ret = search(parts.slice(p), foundschema.schema);
|
|
if (ret) {
|
|
ret.$isUnderneathDocArray = ret.$isUnderneathDocArray ||
|
|
!foundschema.schema.$isSingleNested;
|
|
}
|
|
return ret;
|
|
}
|
|
}
|
|
|
|
foundschema.$fullPath = resultPath.join('.');
|
|
|
|
return foundschema;
|
|
}
|
|
}
|
|
}
|
|
|
|
// look for arrays
|
|
const parts = path.split('.');
|
|
for (let i = 0; i < parts.length; ++i) {
|
|
if (parts[i] === '$' || isArrayFilter(parts[i])) {
|
|
// Re: gh-5628, because `schema.path()` doesn't take $ into account.
|
|
parts[i] = '0';
|
|
}
|
|
}
|
|
return search(parts, _this);
|
|
};
|
|
|
|
/*!
|
|
* ignore
|
|
*/
|
|
|
|
Schema.prototype._getPathType = function(path) {
|
|
const _this = this;
|
|
const pathschema = _this.path(path);
|
|
|
|
if (pathschema) {
|
|
return 'real';
|
|
}
|
|
|
|
function search(parts, schema) {
|
|
let p = parts.length + 1,
|
|
foundschema,
|
|
trypath;
|
|
|
|
while (p--) {
|
|
trypath = parts.slice(0, p).join('.');
|
|
foundschema = schema.path(trypath);
|
|
if (foundschema) {
|
|
if (foundschema.caster) {
|
|
// array of Mixed?
|
|
if (foundschema.caster instanceof MongooseTypes.Mixed) {
|
|
return { schema: foundschema, pathType: 'mixed' };
|
|
}
|
|
|
|
// Now that we found the array, we need to check if there
|
|
// are remaining document paths to look up for casting.
|
|
// Also we need to handle array.$.path since schema.path
|
|
// doesn't work for that.
|
|
// If there is no foundschema.schema we are dealing with
|
|
// a path like array.$
|
|
if (p !== parts.length && foundschema.schema) {
|
|
if (parts[p] === '$' || isArrayFilter(parts[p])) {
|
|
if (p === parts.length - 1) {
|
|
return { schema: foundschema, pathType: 'nested' };
|
|
}
|
|
// comments.$.comments.$.title
|
|
return search(parts.slice(p + 1), foundschema.schema);
|
|
}
|
|
// this is the last path of the selector
|
|
return search(parts.slice(p), foundschema.schema);
|
|
}
|
|
return {
|
|
schema: foundschema,
|
|
pathType: foundschema.$isSingleNested ? 'nested' : 'array'
|
|
};
|
|
}
|
|
return { schema: foundschema, pathType: 'real' };
|
|
} else if (p === parts.length && schema.nested[trypath]) {
|
|
return { schema: schema, pathType: 'nested' };
|
|
}
|
|
}
|
|
return { schema: foundschema || schema, pathType: 'undefined' };
|
|
}
|
|
|
|
// look for arrays
|
|
return search(path.split('.'), _this);
|
|
};
|
|
|
|
/*!
|
|
* ignore
|
|
*/
|
|
|
|
function isArrayFilter(piece) {
|
|
return piece.indexOf('$[') === 0 &&
|
|
piece.lastIndexOf(']') === piece.length - 1;
|
|
}
|
|
|
|
/*!
|
|
* Module exports.
|
|
*/
|
|
|
|
module.exports = exports = Schema;
|
|
|
|
// require down here because of reference issues
|
|
|
|
/**
|
|
* The various built-in Mongoose Schema Types.
|
|
*
|
|
* ####Example:
|
|
*
|
|
* var mongoose = require('mongoose');
|
|
* var ObjectId = mongoose.Schema.Types.ObjectId;
|
|
*
|
|
* ####Types:
|
|
*
|
|
* - [String](#schema-string-js)
|
|
* - [Number](#schema-number-js)
|
|
* - [Boolean](#schema-boolean-js) | Bool
|
|
* - [Array](#schema-array-js)
|
|
* - [Buffer](#schema-buffer-js)
|
|
* - [Date](#schema-date-js)
|
|
* - [ObjectId](#schema-objectid-js) | Oid
|
|
* - [Mixed](#schema-mixed-js)
|
|
*
|
|
* Using this exposed access to the `Mixed` SchemaType, we can use them in our schema.
|
|
*
|
|
* var Mixed = mongoose.Schema.Types.Mixed;
|
|
* new mongoose.Schema({ _user: Mixed })
|
|
*
|
|
* @api public
|
|
*/
|
|
|
|
Schema.Types = MongooseTypes = require('./schema/index');
|
|
|
|
/*!
|
|
* ignore
|
|
*/
|
|
|
|
exports.ObjectId = MongooseTypes.ObjectId;
|