[转] Mongoose简要API

Mongoose是在node.js环境下对mongodb进行便捷操做的对象模型工具

所以，要使用mongoose，则必须安装node.js环境以及mongodb数据库。mongoose使mongodb操做更简单便捷。能够在github中得到其源码，也能够在这里查看api文档，英文的，文档内容较多，所以本文特地总结下mongoose的schema数据模型定义以及简单的增删改查api。

connect

connect 用于建立数据库链接

mongoose.connect(uri(s), [options], [callback])
//url(s):数据库地址,能够是多个,以`,`隔开 //options:可选,配置参数 //callback:可选,回调 mongoose.connect('mongodb://数据库地址(包括端口号)/数据库名称')

指定用户链接

mongoose.connect('mongodb://用户名:密码@127.0.0.1:27017/数据库名称')

链接多个数据库

若是你的app中要链接多个数据库，只须要设置多个url以,隔开，同时设置mongos为true

mongoose.connect('urlA,urlB,...', { mongos : true })

schema && model

Schema是一种以文件形式存储的数据库模型骨架，不具有数据库的操做能力。

schema能够理解为mongoose对表结构的定义(不单单能够定义文档的结构和属性，还能够定义文档的实例方法、静态模型方法、复合索引等)，每一个schema会映射到mongodb中的一个collection，schema不具有操做数据库的能力

定义Schema

//语法 new mongoose.Schema({字段...}, [options]) //实例 const mongoose = require('mongoose') const Schema = mongoose.Schema const ObjectId = Schema.Types.ObjectId const ArticleSchema = new Schema({ title: { type: String, required: true }, contents: String, author: String, category: { type: ObjectId, ref: 'Category' //关联Category表的_id }, createTime: { type: Date, default: Date.now } }, { connection: 'Article', //模型名称, })

字段类型

schema中支持如下字段类型

• String

• Number

• Date

• Buffer

• Boolean

• Mixed

• ObjectId

• Array

schema中不单单能够设置字段类型，同时还能够设置默认值（default），关联文档（ref），required等。_一旦设置了字段类型，若是出现错误，好比某字段类型为Boolean，而输入了一个其余类型，mongoose将会抛出类型错误的提示_

options

//经常使用到的`collection`,其余请参考[文档](http://www.nodeclass.com/api/mongoose.html#index_Mongoose-Schema) { _id : true, //Boolean, 惟一索引, 若是不须要,能够设置为false关闭 collection : '文档名称', //在MongDB中默认使用Model的名字做为集合的名字，如过须要自定义集合的名字，能够经过设置这个选项 versionKey : '__v', //包含文档的内部修订,默认的是__v autoIndex, capped : Number, //上限设置,此属性对批量操做有效，用来限制一次对数据库操做的量 id, //mongoose分配给每个schema一个虚拟属性id，它是一个getter。返回的是_id转换为字符串后的值 read, safe, shardKey, strict, toJSON, toObject }

Model

Model是由Schema编译而成的假想（fancy）构造器，具备抽象属性和行为。Model的每个实例（instance）就是一个document。document能够保存到数据库和对数据库进行操做。

//语法 mongoose.model(`文档名称`, Schema) //实例 module.exports = mongoose.model(`Article`, ArticleSchema )

Methods 实例方法

Model的实例是document。内置实例方法如 save，能够经过methods属性给实例自定义扩展方法

ArticleSchema.methods.methodFunc = function() { // body... }

Statics 静态方法

model的静态方法不少，如find，update等，能够经过 statics属性给 Model 添加自定义扩展方法

ArticleSchema.statics.staticFunc = function() { // body... }

Methods 和 Statics 的区别

statics是给model添加方法，methods是给实例（instance）添加方法。methods和statics的区别

//接上面代码, //module.exports = mongoose.model(`Article`, ArticleSchema ) //将article的model保存为文件 article.js const Article = require('../models/article') // statics Article.staticFunc () //methods const article = new Article(arguments) article.methodFunc()

find

find用来查询多条文档

Model.find(conditions, [fields], [options], [callback])
conditions <Object> //查询条件 [fields] <Object> //要查询的字段 [options] <Object> //查询配置参数 [callback] <Function> //回调

条件查询

条件查询中经常使用属性

• $or　　　　或关系

• $nor　　　　或关系取反

• $gt　　　　大于

• $gte　　　　大于等于

• $lt　　　　小于

• $lte　　　　小于等于

• $ne　　　　不等于

• $in　　　　在多个值范围内

• $nin　　　　不在多个值范围内

• $all　　　　匹配数组中多个值

• $regex　　　　正则，用于模糊查询

• $size　　　　匹配数组大小

• $maxDistance　　　　范围查询，距离（基于LBS）

• $mod　　　　取模运算

• $near　　　　邻域查询，查询附近的位置（基于LBS）

• $exists　　　　字段是否存在

• $elemMatch　　　　匹配内数组内的元素

• $within　　　　范围查询（基于LBS）

• $box　　　　范围查询，矩形范围（基于LBS）

• $center　　　　范围醒询，圆形范围（基于LBS）

• $centerSphere　　　　范围查询，球形范围（基于LBS）

• $slice　　　　查询字段集合中的元素（好比从第几个以后，第N到第M个元素

如要查询阅读量大于500小于600的文章

Article.find({views : {$gte : 500 , $lte : 600}})

options

参看该文档

findById

findById 用来经过id查询单条文档

Model.findById(id, [fields], [options], [callback])

findOne

findOne 用来经过条件查询单条文档

Model.findOne(conditions, [fields], [options], [callback])

populate

populate用于查看关联文档内容, 也就是查询 设置了 ref 的字段关联的 文档的相关字段

Model.populate(docs, options, [cb(err,doc)])

//示例 yield Article.findOne({_id : id}, {title : 1, author : 1}) .populate('category', {select : {name : 1, _id : 1}}) //查找_id 为 id 的文章的category字段对应的category表中的分类名称和id //多个关联表须要使用数组 yield Article.findOne({ _id: id }, { title: 1, author: 1 }) .populate([{ path: 'comments', //文章的comments字段 select: { _id: 1, user: 1, text: 1, }, }, { path: 'category' //文章的category字段, select: { fields... } }]) 

分页和排序

yield Article.findOne({ _id: id }, { title: 1, author: 1 }, { sort: { createTime: -1, //倒序 desc _id: -1 }, skip: (page - 1) * pageSize, //page : 当前页码, pageSize 每页显示条数 limit: pageSize }) // sort : -1 => desc , a => asc

模糊查询

请参看博文《MONGOOSE 多条件模糊查询的实现》

count

count方法用来统计符合条件的文档集合的总数

Model.count(conditions, [callback])

update

Model.update(conditions, update, [options], [callback])
//查找并更新 Model.findByIdAndUpdate(id, [update], [options], [callback]) Model.findOneAndUpdate([conditions], [update], [options], [callback])

更新修改器

`$inc` 增减修改器，只对数字有效。 Article.update({_id : id}, {$inc : {views : 1}}) //找到id=_id记录，而且将 views递增，返回后的views为以前的views+1。ps：这个属性颇有用，对数字直接进行增减。用于更新一些数字（如阅读数）颇有用 `$set` 指定字段的值，这个字段不存在就建立它。能够是任何MondoDB支持的类型。 Article.update({_id : id}, {$set : {views : 51, title : '修改后的标题' ...}}) //更新后views为51,标题为'修改后的标题' `$unset` 同上取反，删除一个字段 Article.update({views : 50}, {$unset : {views : 'remove'}}) //执行后: views字段不存在

可选参数, 第三个参数

{
    new: true, //为true：返回update后的文档，false：返回update前的，默认是false sort: null, //排序条件，与sort函数的参数一致。 fields: null， //要返回的字段, 与find*的第二个参数一致。 upsert: null, // 若是是true，表示若是没有符合查询选择器的文档，mongo将会综合第一第二个参数向集合插入一个新的文档 multi: false, //true:更新匹配到的全部文档，false：更新匹配到的第一个文档 }

save

save是一个实例方法，使用时须要先 new Model() 来获取实例

const article = new Article({ //字段 => value //... }) yield article.save()

remove

Model.remove(conditions, [callback])
//查找并删除 Model.findByIdAndRemove(id, [options], [callback]) Model.findOneAndRemove(conditions, [options], [callback])

小结

以上仅仅是对mongoose文档最简单的使用总结，诸如 where 方法或者 对数组的操做都没有包含其中，具体以官方文档为主