Nodejs mongoose 詳解

前言

Mongoose 是在nodejs環境下，對mongodb進行便捷操做的對象模型工具。本文介紹解（翻）密（譯）Mongoose插件。

Schema

開始咱們就要講到Schema，一個Schema對應的是mongodb的collection(至關於SQL table)，而且定義其結構。

var mongoose = require('mongoose');
var Schema = mongoose.Schema;
//定義一個博客結構
var blogSchema = new Schema({
    title:  String,
    author: String,
    body:   String,
    comments: [{ body: String, date: Date }],
    date: { type: Date, default: Date.now },
    hidden: Boolean,
    meta: {
      votes: Number,
      favs:  Number
    }
  });

Schema可用Type：

.String (ex: 'ABCD')

.Number (ex: 123)

.Date (ex: new Date)

.Buffer (ex: new Buffer(0))

.Boolean (ex: false)

.Schema.Types.Mixed (ex: {any:{thing:'ok'}})

.Schema.Types.ObjectId (ex:new mongoose.Types.ObjectID)

.Array (ex:[1,2,3])

.Schema.Types.Decimal128

.Map (ex: new Map([['key','value']]))

咱們能夠經過一段代碼，將Schema轉化成Model： mongoose.model(modelName,Schema)

var Blog = mongoose.model('Blog', blogSchema);

賦予Schema方法，當方法轉成Model的時候，會將方法給予Model

//建立一個變量，Schema
var animalSchema = new Schema({ name: String, type: String });

//將方法賦予這個Schema
animalSchema.methods.findSimilarTypes = function(cb) {
    return this.model('Animal').find({ type: this.type }, cb);
};

var Animal = mongoose.model('Animal', animalSchema);
var dog = new Animal({ type: 'dog' });

dog.findSimilarTypes(function(err, dogs) {
    console.log(dogs); // woof
});

在Schema方法裏，不要使用箭頭函數，它會從新綁定this。

賦予Schema static （靜態）方法，咱們繼續使用上面的例子：

//賦予靜態方法，能夠再Model不實例化的狀況下調用
animalSchema.statics.findByName = function(name, cb) {
    return this.find({ name: new RegExp(name, 'i') }, cb);
};

var Animal = mongoose.model('Animal', animalSchema);
Animal.findByName('fido', function(err, animals) {
    console.log(animals);
});

Schema索引 index

MongoDB支持二級索引，在mongoose，咱們能夠將索引定在Schema層。

var animalSchema = new Schema({
    name: String,
    type: String,
    tags: { type: [String], index: true } // 聲明在字段層
});

animalSchema.index({ name: 1, type: -1 }); // 聲明在schema層

使用index（二級索引）的時候記得要disable Mongodb 的 autoIndex。

mongoose.connect('mongodb://user:pass@localhost:port/database', { autoIndex: false });
  // 或者
mongoose.createConnection('mongodb://user:pass@localhost:port/database', { autoIndex: false });
  // 或者
animalSchema.set('autoIndex', false);
  // 或者
new Schema({..}, { autoIndex: false });

虛擬化

// 聲明一個Schema
var personSchema = new Schema({
    name: {
      first: String,
      last: String
    }
});

// 轉成Model
var Person = mongoose.model('Person', personSchema);

// 實例化Model
var axl = new Person({
    name: { first: 'Axl', last: 'Rose' }
});

//1.若是咱們想要打印Person的姓名
console.log(axl.name.first + ' ' + axl.name.last); // Axl Rose

//2.使用虛擬化，咱們聲明一個虛擬字段，而後經過get給其賦值
personSchema.virtual('fullName').get(function () {
  return this.name.first + ' ' + this.name.last;
});
console.log(axl.fullName); // Axl Rose

別名

var personSchema = new Schema({
  n: {
    type: String,
    // 給予 n 別名 name，n與name指向同一個值
    alias: 'name'
  }
});

// 修改name一樣修改n，方向同樣
var person = new Person({ name: 'Val' });
console.log(person); // { n: 'Val' }
console.log(person.toObject({ virtuals: true })); // { n: 'Val', name: 'Val' }
console.log(person.name); // "Val"

person.name = 'Not Val';
console.log(person); // { n: 'Not Val' }

Model & Documents

增

var Tank = mongoose.model('Tank', yourSchema);

var small = new Tank({ size: 'small' });
//使用save的方法
small.save(function (err) {
  if (err) return handleError(err);
  // saved!
});

// 或者 使用create

Tank.create({ size: 'small' }, function (err, small) {
  if (err) return handleError(err);
  // saved!
});

// 或者 使用insertMany/insertOne
Tank.insertMany([{ size: 'small' }], function(err) {

});

刪

//deleteOne 或者 deleteMany
Tank.deleteOne({ size: 'large' }, function (err) {
  if (err) return handleError(err);
  // 只刪掉符合項的第一條
});

改

Tank.updateOne({ size: 'large' }, { name: 'T-90' }, function(err, res) {

});

// findOneAndUpdate 查找出相應的數據，修改，並返還給程序

查

// 查提供了多種方式，find，findById,findOne,和where
Tank.find({ size: 'small' }).where('createdDate').gt(oneYearAgo).exec(callback);