mongoose-study

使用mongoose可以让我们更好使用mongodb数据库，而不需要写繁琐的业务逻辑。

安装

npm install mongoose

初始化使用

使用mongoose前，需安装node和mongodb，这里不讲node和mongodb的安装方法。

javascript    var mongoose = require("mongoose");
    var Schema = mongoose.Schema;
    var db = mongoose.connection;
    mongoose.connect('mongodb://localhost/animal');
    db.on('error', console.error);
    db.once('open', function() {
       //这里建立模式和模型
    }

快速入门

在mongoose中，所有的数据都是一种模式，每个模式都映射到mongodb的集合，并且定义该集合文件结构。

javascript    //这里建立一个动物的模式，所有动物都拥有这个模式下的所有属性
    var animalSchema = new Schema({
        name: String,
        age: Number,
    });

模型是我们从Schema中定义的一种多样化的构造函数，模型的实例可以使用很多操作，所有文档的创建和检索都是由模型来处理

javascript    var animalMode = db.model('Animal', animalSchema);

模型的实例实质是文件，而我们可以很轻松创建、修改这种文件

javascript    var cat = new animalMode({
        name: 'catName',
        age: '7',    //这里依然使用字符串，mongoose会自动转换类型
      });

    cat.save(function(err, thor) {
        if (err) return console.log(err);
        console.log(thor);
    });
    //或者可以使用create
    //cat.create(function(err, thor) {
    //    if (err) return console.log(err);
    //    console.log(thor);
    //});

    //执行查找
    animalMode.find(function(err, people){
        if(err) console.log(err);
        console.log(people);
    });
    //查找符合条件数据
    animalMode.findOne({title: 'catName'}, function(err, cat){
        if(err) console.log(err);
        console.log(cat);
    });

Schema

数据类型

这是Schema中所有的数据类型，包括mongoose自定的数据类型

• String
• Number
• Date
• Buffer
• Boolean
• Mixed
• ObjectId
• Array

每种数据类型的使用

javascript    var animalMode = mongoose.model('Animal', schema);

    var cat = new animalMode;
    cat.name = 'Statue of Liberty'              //String
    cat.age = '7';                              //Number
    cat.updated = new Date;                     //Date
    cat.binary = new Buffer(0);                 //Buffer
    cat.living = false;                         //Boolean
    cat.mixed = { any: { thing: 'i want' } };   //Mixed              
    cat._someId = new mongoose.Types.ObjectId;  //ObjectId
    cat.ofString.push("strings!");              //Array

其中Mixed是mongoose自定义的一种混合类型，因为Mixed没有定义具体内容，可以用{}来使用，以下2种定义形式等价。

javascript    var animalSchema = new Schema({any: {}});
    var animalSchema = new Schema({any: {Schema.Types.Mixed}});

自定义方法

可以为Schema绑定方法

javascript    var animalSchema = new Schema({
        name: String,
        age: Number,
    });

    animalSchema.methods.findSimilarTypes = function (cb) {
        return this.model('Animal').find({ name: this.name }, cb);
    }

    var animalMode = db.model('Animal', animalSchema);

    cat.findSimilarTypes(function(err, cat){
        if(err) console.log(err);
        console.log(cat);
    });

也可以为Schema添加静态方法

javascript    animalSchema.statics.findByName = function (name, cb) {
        return this.find({ name: new RegExp(name, 'i') }, cb);
    }
    var animalMode = db.model('Animal', animalSchema);

    animalMode.findByName('catName', function (err, animals) {
        console.log(animals);
    });

索引

我们可以为mongodb数据建立索引，mongodb支持二级索引，为了提高数据查找和定位，建立复合索引是必要的

javascript    var animalSchema = new Schema({
      name: String,
      age: Number,
      tags: { age: [String], index: true } // field level
    });

    animalSchema.index({ name: 1, age: -1 }); // schema level

但是这种索引的建立可能导致显著的性能影响，建议在生产下停止，将设置模式下的自动索引设置为false禁止

javascript    animalSchema.set('autoIndex', false);
    // or
    new Schema({..}, { autoIndex: false });

Model

C

javascript    cat.save(function(err, thor) {
        if (err) return console.log(err);
        console.log(thor);
    });
    //或者可以使用create
    cat.create(function(err, thor) {
        if (err) return console.log(err);
        console.log(thor);
    });

R

javascript//find
animalMode.find(function(err, cat){
    if (err) console.log(err);
    console.log(cat);
})

//findOne
animalMode.findOne({name: 'catName'}, function(err, cat){
    if (err) console.log(err);
    console.log(cat);
})

//findByID
//与 findOne 相同，但它接收文档的 _id 作为参数，返回单个文档。_id //可以是字符串或 ObjectId 对象。
animalMode.findById(id, function(err, adventure){
    if (err) consoel.log(err);
    console.log(adventure);
});

//where
//查询数据类型是字符串时，可支持正则
animalMode.where('age', '2').exec(function(err, cat){
    if (err) console.log(err);
    console.log(cat);
});

animalMode
    .where('age').gte(1).lte(10)
    .where('name', 'catName')
    .exec(function(err, cat){
      if (err) console.log(err);
      console.log(cat);
    });

U

官方文档提供的更新函数Model.update

Model.update(conditions, doc, [options], [callback])

• conditions 更新条件
• doc 更新内容

• option 更新选项

  • safe (boolean) 安全模式，默认选项，值为true
  • upsert (boolean) 条件不匹配时是否创建新文档，默认值为false
  • multi (boolean) 是否更新多个文件，默认值为false
  • strict (boolean) 严格模式，只更新一条数据
  • overwrite (boolean) 覆盖数据，默认为false

• callback

  • err 更新数据出错时返回值
  • numberAffected （笔者暂时不清楚）
  • rawResponse 受影响的行数

  javascriptanimalMode.update({name: 'catName'}, {age: '6'}, {multi : true}, function(err, numberAffected, raw){
      if (err) return console.log(err);
      console.log('The number of updated documents was %d', numberAffected);
      console.log('The raw response from Mongo was ', raw);
  });

D

javascriptanimalMode.remove({age: 6}, function(err){
    if (err) console.log(err);
})

其它

javascript//返回文档数
animalMode.count({age: 2}, function(err, cat){
    if (err) console.log(err);
    console.log(cat);
})

资源推荐

mongoosejs.com
https://github.com/jayZOU/mongoose-study

持续更新中...

由于笔者也是初学者，有地方讲的不对，
欢迎给我邮件（[email protected]）谢谢^-^