Mongoose之 SchemaTypes 数据类型

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 use

var 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或者其他类型。 想要自己创建类型的话请参考创建一个基础的自定义数据类型。

---