Mongoose -- Schemas Models Documents

系统管理员 2022-06-09 11:57 166阅读 0赞

# Schemas #

Mongoose中，所有的东西都由Schemas开始。schema相当于是MongoDB的collection，并且定义了文档的结构。

上面的例子中，属性名后面是属性的类型，Schema允许的类型包括：

String
    Number
    Date
    Buffer
    Boolean
    Mixed
    ObjectId
    Array

*schema不仅可以用来定义文档的结构和属性，而且还可以用来定义实例方法，静态方法，索引，生命周期钩子方法，这些将在下文详细说明。*

接下来，我们需要使用Schema来生成一个Model。

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

**实例方法**  
关键字：Schema.methods

实例方法可以使用Schema来定义。

// define a schema
    var animalSchema = new Schema({ name: String, type: String });
    
    // assign a function to the "methods" object of our animalSchema
    animalSchema.methods.findSimilarTypes = function(cb) { 
      return this.model('Animal').find({ type: this.type }, cb);
    };

如此，所有的Animal实例都将拥有findSimilarTypes方法。

var Animal = mongoose.model('Animal', animalSchema);
    var dog = new Animal({ type: 'dog' });
    
    dog.findSimilarTypes(function(err, dogs) { 
      console.log(dogs); // woof
    });

**Model静态方法**  
关键字：Schema.statics

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);
    });

**索引**

不太懂…附上原文吧。  
![这里写图片描述][SouthEast]

**虚拟属性**

虚拟属性允许我们创建一个在MongoDB中不存在的属性。

personSchema.virtual('fullName').get(function () { 
      return this.name.first + ' ' + this.name.last;
    });

这样，我们就可以访问实例的fullName属性了，但其实这个属性在数据库中并不存在。

同时，给fullName我们还可以设置set：

personSchema.virtual('fullName').
      get(function() {  return this.name.first + ' ' + this.name.last; }).
      set(function(v) { 
        this.name.first = v.substr(0, v.indexOf(' '));
        this.name.last = v.substr(v.indexOf(' ') + 1);
      });
    
    axl.fullName = 'William Rose'; // Now `axl.name.first` is "William"

这样，当我们设置fullName时，first name和last name也将会被设置。

**Options**

当我们新建一个Schema的时候，第一个参数可以规定Schema的数据结构（key: type），第二个参数可以定义可选options；如果定义的时候省略第二个参数，则可以使用set方法。

代码如下：

new Schema({..}, options);
    
    // or
    
    var schema = new Schema({..});
    schema.set(option, value);

可以选择的options包括：

autoIndex
    capped
    collection
    emitIndexErrors
    id
    _id
    minimize
    read
    safe
    shardKey
    strict
    toJSON
    toObject
    typeKey
    validateBeforeSave
    versionKey
    skipVersioning
    timestamps
    retainKeyOrder

详情可见：  
[http://mongoosejs.com/docs/guide.html\#autoIndex][http_mongoosejs.com_docs_guide.html_autoIndex]

# Models #

var schema = new mongoose.Schema({ name: 'string', size: 'string' });
    var Tank = mongoose.model('Tank', schema);

## 新建文档 ##

文档就是Model的实例，有两种方式可以将数据保存到数据库。

注意：如果不建立mongoose的连接，数据是无法保存的。每个Model都有一个绑定的连接。当开发者调用方法mongoose.model()的时候，这个Model将会使用默认的mongoose连接。

mongoose.connect('localhost', 'gettingstarted');

如果你建立了一个常用的连接，可以用这个连接来创建model：

var connection = mongoose.createConnection('mongodb://localhost:27017/test');
    var Tank = connection.model('Tank', yourSchema);

## 查询 ##

查询方法包括： find, findById, findOne, where。

Tank.find({ size: 'small' }).where('createdDate').gt(oneYearAgo).exec(callback);

具体将在后文介绍。

## 删除 ##

Tank.remove({ size: 'large' }, function (err) { 
      if (err) return handleError(err);
      // removed!
    });

## 更新 ##

更新方法：findOneAndUpdate

# Documents #

## 更新方法 ##

Tank.findById(id, function (err, tank) {
      if (err) return handleError(err);
    
      tank.size = 'large'; // or tank.set({ size: 'large' });
      tank.save(function (err, updatedTank) {
        if (err) return handleError(err);
        res.send(updatedTank);
      });
    });

上面这个方法，会返回这个查找到的tank实例，如果我们不需要查找功能，只需要更新，则可以使用下面这个方法：

Tank.update({ _id: id }, { $set: { size: 'large' }}, callback);

如果我们需要返回实例，下面这个方法也是一个很好的选择：

Tank.findByIdAndUpdate(id, { $set: { size: 'large' }}, { new: true }, function (err, tank) { 
      if (err) return handleError(err);
      res.send(tank);
    });

[SouthEast]: /images/20220609/a0e2be130e134b2caa49c945b6bd4cdb.png
[http_mongoosejs.com_docs_guide.html_autoIndex]: http://mongoosejs.com/docs/guide.html#autoIndex