资讯专栏INFORMATION COLUMN

Mongoose简要API

王岩威 / 1077人阅读

摘要:是在环境下对进行便捷操作的对象模型工具因此,要使用,则必须安装环境以及数据库。使操作更简单便捷。找到记录,并且将递增,返回后的为之前的。这个属性很有用,对数字直接进行增减。,要返回的字段与的第二个参数一致。

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

因此,要使用mongoose,则必须安装node.js环境以及mongodb数据库。mongoose使mongodb操作更简单便捷。可以在github中获得其源码,也可以在这里查看api文档,英文的,文档内容较多,因此本文特意总结下mongooseschema数据模型定义以及简单的增删改查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的静态方法很多,如findupdate等,可以通过 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  //查询条件
[fields]  //要查询的字段
[options]  //查询配置参数
[callback]  //回调
条件查询

条件查询中常用属性

$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 方法或者 对数组的操作都没有包含其中,具体以官方文档为主

本文首发在我的博客

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/18946.html

相关文章

  • 【译】测试驱动开发:使用 Node.js 和 MongoDB 构建 Todo API

    摘要:首先安装单元测试环境使用模块来模拟定义的模型。根据删除这是单元测试的最后一小节。需要根据需求和单元测试用例来编写应用逻辑,使我们的程序更加稳定。我们会运行自动测试用例,一直重构,直到所有单元测试都通过。 本文转载自:众成翻译译者:文蔺链接:http://www.zcfy.cc/article/746原文:https://semaphoreci.com/community/tutoria...

    邱勇 评论0 收藏0
  • 【译】测试驱动开发:使用 Node.js 和 MongoDB 构建 Todo API

    摘要:首先安装单元测试环境使用模块来模拟定义的模型。根据删除这是单元测试的最后一小节。需要根据需求和单元测试用例来编写应用逻辑,使我们的程序更加稳定。我们会运行自动测试用例,一直重构,直到所有单元测试都通过。 本文转载自:众成翻译译者:文蔺链接:http://www.zcfy.cc/article/746原文:https://semaphoreci.com/community/tutoria...

    tomener 评论0 收藏0
  • 一篇文章带你入门Mongoose

    摘要:当然,可以使用方法来简写代码删除第个元素类似的,该方法也不能省略回调函数,否则数据不会被删除。 走在前端的大道上 Mongoose是在node.js环境下对mongodb进行便捷操作的对象模型工具 因此,要使用mongoose,则必须安装node.js环境以及mongodb数据库。mongoose使mongodb操作更简单便捷。可以在 github 中获得其源码,也可以在这里查看 ap...

    wayneli 评论0 收藏0
  • Node +MongoDB 搭建后台的全过程

    摘要:搭建后台的全过程近期基于搭建前端项目,搭建后台,遇到了不少问题,总结博客如下,有什么不正确的地方,请大家批评指正是非关系型数据库。是用来启动的,是的命令行客户端。 Node + mongoDB 搭建后台的全过程 近期基于 vue-cil 搭建前端项目, express + mongoose 搭建后台,遇到了不少问题,总结博客如下,有什么不正确的地方,请大家批评指正^ _ ^! mong...

    voidking 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<