mongoose.js 基础使用——Models

Models

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

编译model

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

第一个参数是跟 model 对应的集合（ collection ）名字的 单数 形式。 Mongoose 会自动找到名称是 model 名字 复数 形式的 collection 。 对于上例，Tank 这个 model 就对应数据库中 tanks 这个 collection。.model() 这个函数是对 schema 做了拷贝（生成了 model）。 你要确保在调用 .model() 之前把所有需要的东西都加进 schema 里了！

Documents 是model 的实例。

新增

创建它们并保存到数据库非常简单：

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

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

查询

用 mongoose 查询文档相当容易啦，它支持 MongoDB 的高级（ rich ）查询语法。 查询文档可以用 model 的 find,findById,findOne, 和 where 这些静态方法。

find

基本语法：MyModel.find(conditions, [projection], [options], [callback])

• conditions 查询条件
• projection 需返回的字段
• options 查询配置选项
• callback 查询回调，回调函数中传入两个形参[err, docs]

执行完成后可以返回 Query 对象，下面是示例：

// name值john且年龄大于等于18
MyModel.find({ name: 'john', age: { $gte: 18 }});

// 查询名字中包含hn字母，并且仅返回 name与 friends 字段
MyModel.find({ name: /hn/i }, 'name friends', function (err, docs) { })

// 跳过10条查询
MyModel.find({ name: /hn/i }, null, { skip: 10 })

其中合法配置项有（不全）：

• sort 值1则表示升序，降序则设置为 -1。{key:1, title:-1}
• limit 接受一个数字，表示指定读取记录条数
• skip 接受一个数组，表示跳过条数再查找
• lean 转换mongoose查询结果类型，从MongooseDocuments转换为JS Object，从而便于我们修改查询结果。(false)

findById

通过_id字段查找单个文档。findById(id)几乎等同于findOne({_id:id})。
基本语法：MyModel.findById(id, [projection], [options], [callback])

• id 依据数据库里_id
• projection 需返回的字段
• options 查询配置选项
• callback 查询回调，回调函数中传入两个形参[err, docs]

MyModel.findById(id, function (err, adventure) {});

findOne

与find 类似，但查询条件是可选的，如果为null或为填写，将返回任意一条文档
基本语法：MyModel.findOne([conditions] [projection], [options], [callback])

• conditions 查询条件
• projection 需返回的字段
• options 查询配置选项
• callback 查询回调，回调函数中传入两个形参[err, docs]

删除

remove

model 的 remove 方法可以删除所有匹配查询条件（ conditions ）的文档。可以考虑是使用single选项，仅删除一条
基本语法：MyModel.remove(conditions, [callback])

• conditions 删除条件
• callback 删除回调，回调函数中传入一个形参[err,]

removeOne

同上，但仅会删除一条文档

deleteMany

同上，但不考虑single选项

更新

update

更新数据库中的一个文档而不返回它，该函数的执行会触发update()中间件。
基本语法:MyModel.update(conditions, doc, [options], [callback])

• conditions 更新条件
• doc 需要更新的字段值
• options 更新配置项
• callback 查询回调，回调函数中传入两个形参[err, docs]

MyModel.update({ name: 'Tobi' }, { ferret: true }, { multi: true }, function (err, raw) {
  if (err) return handleError(err);
  console.log('The raw response from Mongo was ', raw);
  /** {
  acknowledged: true,
  modifiedCount: 2,
  upsertedId: null,
  upsertedCount: 0,
  matchedCount: 2
  }*/
});

其中合法的配置项有：

• safe 安全模式（默认为模式中设置的值（true））
• upsert 如果不匹配，是否创建文档（false）
• multi 是否应更新多个文档（false）
• runValidators
• setDefaultsOnInsert
• strict
• overwrite 禁用 update-only 模式，允许你替换整个文档 (false)
• err
• rawResponse

updateMany

同上，但没有multi 选项

updateOne

同上，但仅更新一个

更多

count

统计数据库集合中匹配文档的数量。
基本语法：MyModel.count(conditions, [callback])

• conditions 查询条件
• callback 查询回调，回调函数中传入两个形参[err, count]
  示例：

MyModel.count({ type: 'jungle' }, function (err, count) {
  if (err) ..
  console.log('there are %d jungle adventures', count);
});

操作符

查询和投影运算符

比较查询运算符

• (>) 大于 - $gt
• (<) 小于 - $lt
• (>=) 大于等于 - $gte
• (<= ) 小于等于 - $lte
• (!=) 不等于 $ne
• (=) 等于 $eq

逻辑查询操作符

• ($and) 多字段查询
• ($or) 多字段查询 {$or : [{key01 : value01}, {key02 : value02}, ...]}
• ($not)
• ($nor)

元素查询操作符

略

赋值查询操作符

略

地理空间操作符

略

数组查询操作符

略

位运算操作符

略

投影操作符

略

混合查询操作符

略

更新操作符

字段更新操作符

• $currentDate
• $inc
• $min
• $max
• $mul
• $rename
• $set
• $setOnInsert
• $unset

数组更新操作符

• $(update)
• $[]
• $[<identifier>]
• $addToSet
• $pop
• $pull
• $push
• $pullAll
• $each
• $position
• $slice
• $sort

位运算更新操作符

略

聚合管道阶段

略

聚合管道操作符

略

模糊查询

查询 title 包含“教”字的文档：

MyModel.find({title:/教/})

查询 title 包含“教”字开头的文档：

MyModel.find({title:/^教/})

查询 title 包含“教”字结尾的文档：

MyModel.find({title:/教$/})