Mongoose是在node.js环境下对mongodb进行便捷操作的对象模型工具
因此,要使用mongoose,则必须安装node.js环境以及mongodb数据库。mongoose使mongodb操作更简单便捷。可以在github中获得其源码,也可以在这里查看api文档,英文的,文档内容较多,因此本文特意总结下mongoose的schema数据模型定义以及简单的增删改查api。
connectconnect 用于创建数据库连接
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 && modelSchema是一种以文件形式存储的数据库模型骨架,不具备数据库的操作能力。
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`,其他请参考[文档](#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 } ModelModel是由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() findfind用来查询多条文档
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参看该文档
findByIdfindById 用来通过id查询单条文档
Model.findById(id, [fields], [options], [callback]) findOnefindOne 用来通过条件查询单条文档
Model.findOne(conditions, [fields], [options], [callback]) populate