SchemaTypes 数据类型
SchemaTypes handle definition of path defaults, validation, getters, setters, field selection defaults for queries and other general characteristics for Strings and Numbers. Check out their respective API documentation for more detail.
数据类型用于定义默认路径, 验证方式, 获取/设置方法,用于数据库查询的默认字段,以及其他针对字符串与数字的特性。关于详细信息请查阅相关API文档。
译注:默认路径即某个域相对于文档而言的路径,如{a: 1}这个文档中,若指定路径为’a’,即可访问到1这个数据。
Following are all valid Schema Types.
接下来是Mongoose中所有可用的数据类型。- String 字符串
- Number 数字
- Date 日期
- Buffer 缓冲区
- Boolean 布尔值
- Mixed 混合
- Objectid 对象ID
- Array 数组
Example
举个栗子!var schema = new Schema({ name: String, binary: Buffer, living: Boolean, updated: { type: Date, default: Date.now }, age: { type: Number, min: 18, max: 65 }, mixed: Schema.Types.Mixed, _someId: Schema.Types.ObjectId, array: [], ofString: [String], ofNumber: [Number], ofDates: [Date], ofBuffer: [Buffer], ofBoolean: [Boolean], ofMixed: [Schema.Types.Mixed], ofObjectId: [Schema.Types.ObjectId], nested: { stuff: { type: String, lowercase: true, trim: true } }})// example usevar Thing = mongoose.model('Thing', schema);var m = new Thing;m.name = 'Statue of Liberty';m.age = 125;m.updated = new Date;m.binary = new Buffer(0);m.living = false;m.mixed = { any: { thing: 'i want' } };m.markModified('mixed');m._someId = new mongoose.Types.ObjectId;m.array.push(1);m.ofString.push("strings!");m.ofNumber.unshift(1,2,3,4);m.ofDates.addToSet(new Date);m.ofBuffer.pop();m.ofMixed = [1, [], 'three', { four: 5 }];m.nested.stuff = 'good';m.save(callback);
Usage notes 用法要点
Dates 日期型
Built-in Date methods are not hooked into the mongoose change tracking logic which in English means that if you use a Date in your document and modify it with a method like setMonth(), mongoose will be unaware of this change and doc.save() will not persist this modification. If you must modify Date types using built-in methods, tell mongoose about the change with doc.markModified(‘pathToYourDate’) before saving.
Mongoose不跟踪JS内建的日期方法对数据造成的改变。这意味着如果你在文档中使用Date
类型并用setMonth
之类的方法去修改它,Mongoose不会意识到它的改变,调用doc.save
方法保存时不会保留这个修改。如果你一定要用JS内建的方法修改Date类型的数据,在保存之前用doc.markModified
方法告诉Mongoose这个改变。
var Assignment = mongoose.model('Assignment', { dueDate: Date });Assignment.findOne(function (err, doc) { doc.dueDate.setMonth(3); doc.save(callback); // THIS DOES NOT SAVE YOUR CHANGE doc.markModified('dueDate'); doc.save(callback); // works})
Mixed 混合型
An “anything goes” SchemaType, its flexibility comes at a trade-off of it being harder to maintain. Mixed is available either through Schema.Types.Mixed or by passing an empty object literal. The following are equivalent:
混合型是一种“存啥都行”的数据类型,它的灵活性来自于对可维护性的妥协。Mixed类型用Schema.Types.Mixed
或者一个字面上的空对象{}
来定义。下面的定义是等价的:
var Any = new Schema({ any: {} });var Any = new Schema({ any: Schema.Types.Mixed });
Since it is a schema-less type, you can change the value to anything else you like, but Mongoose loses the ability to auto detect and save those changes. To “tell” Mongoose that the value of a Mixed type has changed, call the .markModified(path) method of the document passing the path to the Mixed type you just changed.
因为它是一种 无拘无束,无法无天 无固定模式的类型,所以你可以想怎么改就怎么改,但是Mongoose 没有能力去自动检测和保存这些改动。请通过调用doc.markModified
方法来告诉Mongoose某个混合类型的值被改变了。
person.anything = { x: [3, 4, { y: "changed" }] };person.markModified('anything');person.save(); // anything will now get saved
ObjectIds 对象ID型
To specify a type of ObjectId, use Schema.Types.ObjectId in your declaration.
用Schema.Types.ObjectId
来声明一个对象ID类型。 译注:对象ID同MongoDB内置的
_id
的类型。由24位Hash字符串。
var mongoose = require('mongoose');var ObjectId = mongoose.Schema.Types.ObjectId;var Car = new Schema({ driver: ObjectId });// or just Schema.ObjectId for backwards compatibility with v2
Arrays 数组型
Provide creation of arrays of SchemaTypes or Sub-Documents.
提供创造各种数据类型或子文档的数组的方法。var ToySchema = new Schema({ name: String });var ToyBox = new Schema({ toys: [ToySchema], buffers: [Buffer], string: [String], numbers: [Number] // ... etc});
Note: specifying an empty array is equivalent to Mixed. The following all create arrays of Mixed:
注意:用一个空数组来定义等价于创建一个混合型的数组。下面都是创建混合型数组的例子:var Empty1 = new Schema({ any: [] });var Empty2 = new Schema({ any: Array });var Empty3 = new Schema({ any: [Schema.Types.Mixed] });var Empty4 = new Schema({ any: [{}] });
Creating Custom Types 创建自定义类型
Mongoose can also be extended with custom SchemaTypes. Search the plugins site for compatible types like mongoose-long, mongoose-int32 and other types. To create your own custom schema take a look at Creating a Basic Custom Schema Type.
Mongoose也支持使用自定义的数据类型来拓展功能。从Mongoose插件站搜索合适的类型,比如mongoose-long,mongoose-int32或者其他类型。 想要自己创建类型的话请参考创建一个基础的自定义数据类型。