NodeJS简易博客系统（四）Mongoose入门学习

阳光穿透心脏的1/2处 2022-05-04 04:00 233阅读 0赞

# 一、模式(schemas) #

## 1、定义schema ##

Mongoose的一切都始于一个Schema。每个schema映射到MongoDB的集合  
(collection)和定义该集合(collection)中的文档的形式。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>var mongoose = require('mongoose');<br> var Schema = mongoose.Schema;<br> var blogSchema = new Schema({ <br> title: String,<br> author: String,<br> body: String,<br> comments: [{ body: String, date: Date }],<br> date: { type: Date, default: Date.now },<br> hidden: Boolean,<br> meta: { <br> votes: Number,<br> favs: Number<br> }<br> });</td> 
  </tr> 
 </tbody> 
</table>

如果想后续添加额外的键（keys） ，使用Schema\#add方法。在blogSchema每个key在我们的文件将被转换为相关SchemaType定义一个属性。允许使用的SchemaTypes：

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

用default来设置默认值。

## 2、模型创建 ##

使用刚刚的schema定义，我们需要将我们的blogschema转成我们可以用的模型。  
为此，我们通过 mongoose.model(modelName, schema) ：

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>var Blog = mongoose.model('Blog', blogSchema);</td> 
  </tr> 
 </tbody> 
</table>

## 3、自定义文档实例方法 ##

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>// define a schema<br> var animalSchema = new Schema({ name: String, type: String });<br> // assign a function to the "methods" object of our animalSchema<br> animalSchema.methods.findSimilarTypes = function(cb) { <br> return this.model('Animal').find({ type: this.type }, cb);<br> };</td> 
  </tr> 
 </tbody> 
</table>

调用：

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>var Animal = mongoose.model('Animal', animalSchema);<br> var dog = new Animal({ type: 'dog' });<br> dog.findSimilarTypes(function(err, dogs) { <br> console.log(dogs); // woof<br> });</td> 
  </tr> 
 </tbody> 
</table>

## 4、自定义文档静态实例方法 ##

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>// assign a function to the "statics" object of our animalSchema<br> animalSchema.statics.findByName = function(name, cb) { <br> return this.find({ name: new RegExp(name, 'i') }, cb);<br> };<br> var Animal = mongoose.model('Animal', animalSchema);<br> Animal.findByName('fido', function(err, animals) { <br> console.log(animals);<br> });</td> 
  </tr> 
 </tbody> 
</table>

# 二、模型(models) #

[Models][] 是从 `Schema` 编译来的构造函数。 它们的实例就代表着可以从数据库保存和读取的 [documents][]。 从数据库创建和读取 document 的所有操作都是通过 model 进行的。

## 1、简单实例 ##

schema文件

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td> <pre>var mongoose = require("mongoose");
module.exports = new mongoose.Schema({
    username: String,
    password: String,
    isadmin:{
        type:Boolean,
        default:false
    }
});</pre> </td> 
  </tr> 
 </tbody> 
</table>

model文件

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td> <pre>var mongoose = require("mongoose");
var userschama = require("../schemas/users");
module.exports = mongoose.model("User",userschama);</pre> </td> 
  </tr> 
 </tbody> 
</table>

## 2、CRUD操作 ##

## 1、Create ##

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>model对象.save()</td> 
  </tr> 
 </tbody> 
</table>

## 2、Retrieve ##

用 mongoose 查询文档相当容易啦，它支持 MongoDB 的高级（ rich ）查询语法。 查询文档可以用 model 的 find, findById, findOne, 和 where 这些静态方法。查询对象的size为small并且创建时间为近一年的数据：

<table style="width:610px;"> 
 <tbody> 
  <tr> 
   <td style="width:607px;">model对象.find({ size: 'small' }).where('createdDate').gt(oneYearAgo).exec(callback);。</td> 
  </tr> 
 </tbody> 
</table>

## 3、Update ##

model 的 update 方法可以修改数据库中的文档，不过不会把文档返回给应用层。如果想更新单独一条文档并且返回给应用层，可以使用 findOneAndUpdate 方法。

## 4、Delete ##

`model` 的 `remove` 方法可以删除所有匹配查询条件（ `conditions` ）的文档。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>Tank.remove({ size: 'large' }, function (err) { <br> &nbsp; if (err) return handleError(err);<br> &nbsp; // todo after removing<br> });</td> 
  </tr> 
 </tbody> 
</table>

# 三、文档(documents) #

## 1、更新 ##

Document 更新的方法同样有很多，我们先看看一个传统的实现，使用 findById：

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td> <p>Object.findById(id, function (err,&nbsp;object) { <br> &nbsp; if (err) return handleError(err);</p> <p>&nbsp; object.size = 'large';<br> &nbsp; object.save(function (err, updatedObject) { <br> &nbsp; &nbsp; if (err) return handleError(err);<br> &nbsp; &nbsp; res.send(updatedObject);<br> &nbsp; });<br> });</p> </td> 
  </tr> 
 </tbody> 
</table>

这个方法先检索数据，接着更新（使用了 save）。 如果仅仅需要更新而不需要获取该数据， Model\#update 就很适合：

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>Object.update({ _id: id }, { $set: { size: 'large' }}, callback);</td> 
  </tr> 
 </tbody> 
</table>

如果我们确实需要返回文档，这个方法更适合：

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>Object.findByIdAndUpdate(id, { $set: { size: 'large' }}, { new: true }, function (err,&nbsp;object) { <br> &nbsp; if (err) return handleError(err);<br> &nbsp; res.send(object);<br> });</td> 
  </tr> 
 </tbody> 
</table>

findAndUpdate/Remove 系列静态方法查找并返回最多1个文档。  
注意：findAndUpdate/Remove 不会修改数据库时执行任何钩子或验证。 可以使用 runValidators 选项 获取一个验证的限制子集（待修改）。 但是你需要钩子和全文档验证，还是先 query 后 save 吧。

## 2、覆盖 ##

可以用 .set() 覆盖整个文档。如果你要修改 在中间件中被保存的文档，这样就很方便。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>Object.findById(id, function (err, object) { <br> &nbsp; if (err) return handleError(err);<br> &nbsp; // Now `otherObject` is a copy of `object`<br> &nbsp; otherObject.set(object);<br> });</td> 
  </tr> 
 </tbody> 
</table>

## 3、子文档（Subdocument） ##

子文档是指嵌套在另一个文档中的文档。 在 Mongoose 中，这意味着你可以在里嵌套另一个 schema。 Mongoose 子文档有两种不同的概念：子文档数组和单个嵌套子文档。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td> <p>var childSchema = new Schema({ name: 'string' });</p> <p>var parentSchema = new Schema({ <br> &nbsp; // Array of subdocuments<br> &nbsp; children: [childSchema],<br> &nbsp; // Single nested subdocuments. Caveat: single nested subdocs only work<br> &nbsp; // in mongoose &gt;= 4.2.0<br> &nbsp; child: childSchema<br> });</p> </td> 
  </tr> 
 </tbody> 
</table>

子文档与普通 document 类似。嵌套schema可以有自己的中间件、自定义检验逻辑、 虚拟值以及其他顶层schemas可用的特性。两者主要的不同点是子文档不能单独保存，他们会在他们的顶级文档保存时保存。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td> <p>var Parent = mongoose.model('Parent', parentSchema);<br> var parent = new Parent({ children: [{ name: 'Matt' }, { name: 'Sarah' }] })<br> parent.children[0].name = 'Matthew';</p> <p>// `parent.children[0].save()` 无操作，虽然他触发了中间件<br> // 但是**没有**保存文档。你需要 save 他的父文档<br> parent.save(callback);</p> </td> 
  </tr> 
 </tbody> 
</table>

子文档跟普通 document一样有save和validate中间件。调用父文档的save()会触发其所有子文档的save()中间件，validate()中间件同理。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td> <p>childSchema.pre('save', function (next) { <br> &nbsp; if ('invalid' == this.name) { <br> &nbsp; &nbsp; return next(new Error('#sadpanda'));<br> &nbsp; }<br> &nbsp; next();<br> });</p> <p>var parent = new Parent({ children: [{ name: 'invalid' }] });<br> parent.save(function (err) { <br> &nbsp; console.log(err.message) // #sadpanda<br> });</p> </td> 
  </tr> 
 </tbody> 
</table>

子文档的 pre('save') 和 pre('validate') 中间件执行于 顶层document的pre('save') 之前，顶层 document的pre('validate')之后。 因为save()前的验证就是一个内置中间件。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td> <p>// 一下代码顺序打出 1-4&nbsp;<br> var childSchema = new mongoose.Schema({ name: 'string' });</p> <p>childSchema.pre('validate', function(next) { <br> &nbsp; console.log('2');<br> &nbsp; next();<br> });</p> <p>childSchema.pre('save', function(next) { <br> &nbsp; console.log('3');<br> &nbsp; next();<br> });</p> <p>var parentSchema = new mongoose.Schema({ <br> &nbsp; child: childSchema,<br> &nbsp; &nbsp; });</p> <p>parentSchema.pre('validate', function(next) { <br> &nbsp; console.log('1');<br> &nbsp; next();<br> });</p> <p>parentSchema.pre('save', function(next) { <br> &nbsp; console.log('4');<br> &nbsp; next();<br> });</p> </td> 
  </tr> 
 </tbody> 
</table>

### 查找子文档 ###

每个子文档都有一个默认的\_id 。Mongoose document数组有一个特别的id方法，这个方法只要传入\_id 就能返回文档数组中特定文档。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>var doc = parent.children.id(_id);</td> 
  </tr> 
 </tbody> 
</table>

### 添加子文档到数组 ###

Mongoose 数组方法有 push、 unshift、 addToSet、 及其他：

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td> <p>var Parent = mongoose.model('Parent');<br> var parent = new Parent;</p> <p>// create a comment<br> parent.children.push({ name: 'Liesl' });<br> var subdoc = parent.children[0];<br> console.log(subdoc) // { _id: '501d86090d371bab2c0341c5', name: 'Liesl' }<br> subdoc.isNew; // true</p> <p>parent.save(function (err) { <br> &nbsp; if (err) return handleError(err)<br> &nbsp; console.log('Success!');<br> });</p> </td> 
  </tr> 
 </tbody> 
</table>

create 方法可以新建子文档但不加入数组。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>var newdoc = parent.children.create({ name: 'Aaron' });</td> 
  </tr> 
 </tbody> 
</table>

### 删除子文档 ###

每个子文档都有 remove方法。另外，对于子文档数组，有一个等效方法 .pull()。 对于单个嵌套子文档，remove()与把这个文档的值设为null等效。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>// 等效于 `parent.children.pull(_id)`<br> parent.children.id(_id).remove();<br> // 等效于 `parent.child = null`<br> parent.child.remove();<br> parent.save(function (err) { <br> &nbsp; if (err) return handleError(err);<br> &nbsp; console.log('the subdocs were removed');<br> });</td> 
  </tr> 
 </tbody> 
</table>

掌握了这些就能应付这个小项目了，如果要看详细api请参考官方文档。

[Models]: https://cn.mongoosedoc.top/docs/api.html#model-js
[documents]: https://cn.mongoosedoc.top/docs/documents.html