写在前面
hello,小伙伴们,我是 pubdreamcc ,本篇文章依旧出至于我的 GitHub仓库 node学习教程 ,如果你觉得我写的还不错,欢迎给个 star
,小伙伴们的star 是我持续更新的动力 !
node学习教程GitHub <https://github.com/pubdreamcc/Node.js>
安装 mongoDB
安装这里,我就不详细介绍,大家可以根据官网选择匹配自己电脑系统的版本安装即可。
mongoDB download地址: download <https://www.mongodb.com/download-center>
下载下来之后,点击打开直接下一步,下一步就 ok 了。
初体验
* 配置环境变量
安装完成后,会在安装目录下面生成一个 mongoDB 的文件夹,打开文件夹,进入 bin 文件夹中,把这里的路径配置成环境变量。
* 创建存储数据库文件 data
在任意盘符根目录下创建一个 data 目录,用来存放数据库文件。 mongoDB 会自动把自己安装位置的盘符根目录下的 data
文件夹作为自己的数据存储目录,这里也可以直接在安装位置所在盘符创建。
* 启动 mongoDB 数据库
如果 data 目录创建在安装位置的盘符根目录下,直接
打开命令行,敲入:
mongod
如果是其他位置,则需要指定数据存放的位置:
mongod --dbpath 文件路径
如果看到输出: waiting for connections on port 27017 说明启动数据库成功。
* 连接数据库
再打开一个命令行,敲入 mongo ,则会默认连接到本地开启的数据库。好了,到这里我们就完成了如何开启一个 mongoDB
数据库了,接下来只需往数据库里存数据,操作数据即可。
MongoDB 概念解析
在mongodb中有三个基本核心的概念:
*
文档
*
集合
*
数据库
它们之间是逐层包含的关系,一个集合可以包含多个文档,一个数据库可以有多个集合,下面听我逐一道来:
文档 : 文档是一个键值(key-value)对(即BSON),本质类似于json对象 的键值对。
{"name":"pubdreamcc", "age": 24}
集合:集合就是 MongoDB 文档组,实质上就是包含多个对象的数组。
比如,我们可以将以下不同数据结构的文档插入到集合中:
{"name":"pubdreamcc"} {"name":"pubdreamcc1","name":"pubdreamcc2"}
{"name":"pubdreamcc3","name":"pubdreamcc4","num":5}
数据库(dataBase)
这里的数据库概念同 关系型数据库中的数据库概念一致,数据库可以包含多个集合。
下面给出一张图用来表示 mongoDB 中的一些概念同 SQL 概念 的 对比,辅助理解。
mongoDB基本操作
在刚才我们连接上本地数据库之后,在这个命令行,我们可以进行很多 mongoDB 提供的增删改查等的基本操作,且听我一一道来。
* 创建数据库 : use 数据库名称。
如果数据库不存在,则创建数据库,否则切换到指定数据库。
MongoDB 中默认的数据库为 test,如果你没有创建新的数据库,集合将存放在 test 数据库中。
*
查看所有数据库: show dbs
*
删除数据库: db.dropDatabase(),你可以使用 db 命令查看当前数据库名。
*
创建集合: db.createCollection(集合名称)
*
查看已有集合: show collections
*
删除集合:db.集合名称.drop()
如果成功删除选定集合,则 drop() 方法返回 true,否则返回 false。
*
插入文档:db.集合名称.insert(document)。往指定集合插入文档,文档的数据结构和 JSON 基本一样。
*
更新文档: update() 方法用于更新已存在的文档,语法格式:
db.collection.update( <query>, <update>, { upsert: <boolean>, multi:
<boolean>, writeConcern: <document> } )
参数说明:
* query : update的查询条件,类似sql update查询内where后面的。
*
update : update的对象和一些更新的操作符(如$,$inc...)等,也可以理解为sql update查询内set后面的。
*
upsert : 可选,这个参数的意思是,如果不存在update的记录,是否插入objNew,true为插入,默认是false,不插入。
*
multi : 可选,mongodb 默认是false,只更新找到的第一条记录,如果这个参数为true,就把按条件查出来多条记录全部更新。
*
writeConcern :可选,抛出异常的级别。
* 删除文档: db.collection.remove( <query>, <justOne> )
参数说明
*
query :(可选)删除的文档的条件。
*
justOne : (可选)如果设为 true 或 1,则只删除一个文档,如果不设置该参数,或使用默认值 false,则删除所有匹配条件的文档。
*
writeConcern :(可选)抛出异常的级别。
*
删除集合所有数据:db.collection.remove({})
*
查询文档:db.collection.find(query, projection)
参数说明
*
query :可选,使用查询操作符指定查询条件。
*
projection :可选,使用投影操作符指定返回的键。查询时返回文档中所有键值, 只需省略该参数即可(默认省略)。
PS:
如果你需要以易读的方式来读取数据,可以使用 pretty() 方法,语法格式如下:
db.col.find().pretty()
pretty() 方法以格式化的方式来显示所有文档。
* 查询一个文档(匹配条件的第一个):db.collection.findOne()
Node操作mongoDB
方法一:
* 使用 mongoDB 官方提供的 node mongodb driver 包 mongoDB ,这种方法是官方提供的,感兴趣的同学可以去 npm
官网查找文档,这里推荐下面一种方法。
mongoDB npm 文档 <https://www.npmjs.com/package/mongodb>
方法二:
* 使用 mongoose
Mongoose 是在 node.js 环境下对 mongodb 进行便捷操作的对象模型工具。
官方 api 文档 <http://www.nodeclass.com/api/mongoose.html>
下面说明下 mongoose 的具体用法。
* 安装 mongoose npm install mongoose
安装完成后,打开mongodb。命令行敲入:mongod,即可打开 mongodb
* 利用mongoose连接mongodb
新建一个js文件,引入mongoose,这里可以参照官网 写的一个 hello world 。
const mongoose = require('mongoose') // 连接数据库
mongoose.connect('mongodb://数据库地址(包括端口号)/数据库名称', (err, ret) => { if (err) {
console.log('连接失败') } else { console.log('连接成功') } })
这样,我们就可以连接上数据库了,注意:如果没有指定数据库名称,则默认连接 test 数据库。
* 创建 Schema ,设计文档结构
Schema
到底是个什么东西呢,我们在往数据库插入数据之前是不是应该得稍微设计下文档的结构,也就是关系数据库中表的结构啥的,因为有一定的设计才使得数据的完整性,不会产生脏数据,Schema就是用来干这个事情的,我们看下官方的介绍
Schema 主要用于定义 MongoDB 中集合 Collection 里文档 document 的结构。mongoose 对表结构的定义,每个
Schema 会映射到mongodb中的一个 collection,Schema 不具备操作数据库的能力。
定义Schema非常简单,指定字段名和类型即可,支持的类型包括以下8种:
String 字符串 Number 数字 Date 日期 Buffer 二进制 Boolean 布尔值 Mixed 混合类型 ObjectId 对象ID
Array 数组
通过mongoose.Schema来调用Schema,然后使用new方法来创建schema
// 引入Schema const Schema = mongoose.Schema // 通过 new 创建一个Schema const
userSchema = new Schema({ // 这里来设计文档的结构,后面插入集合的每一个文档必须是以下指定的结构 name: { type:
String, required: true // 规定 name 是必须有的字段 }, password: { type: String,
required: true }, email: { type: String } })
通过以上的实例,我们就创建了一个 userSchema 的架构,规定了每个文档中必须有 name, password 字段,且类型为 String,email
字段类型为String,有或没有都可以。
* 把 Schema 发布为 model (模型)
简单说就是model是由 Schema 生成的模型,可以对数据库的操作。model的每一个实例(instance)就是一个文档。
把 Schema 发布为模型只需调用mongoose的 mongoose.model() 方法即可,mongoose.model()
接收两个参数,第一个参数表示模型的名称,第二个参数是 Schema,返回值为模型构造函数。这里一定得把第一个参数设置成和mongoose.model()
的返回值相同,否则会出错。最后得到的集合名称就为模型名称的小写形式,如果模型名称最后一个字符是字母,则变成复数形式,如果最后一个是数字,则不变,比如:模型名称:
User,得到的集合名称为: users,模型名称为:User1, 得到的集合名称为;user1。
// 把Schema 发布为模型 const User = mongoose.model('User', userSchema)
* 通过模型构造函数,可以对数据库进行一系列增删改查的操作。
好了,我们经过以上的步骤,最后就可以通过 User 模型构造函数操作数据库了。
mongoose 操作 mongoDB
增加数据
实例化一个模型构造函数就得到一个具体文档。
const user = new User({ // 传入具体的数据信息,必须和之前的Schema 配置的结构一致 name: 'pubdreamcc',
password: '123456', email: '[email protected]' // 可有可无 }) // 通过save()方法持久化存储数据
user.save((err, ret) => { if (err) { console.log('保存失败') } else {
console.log('保存成功') console.log(ret) // ret 就是刚新增加的文档 } })
ok, 通过上面两步我们就已经保存了一条数据到数据库中了,就是怎么简单。
查询数据
查询数据这里有好几个 API , 可以看下 mongoose 的官网:
* find()
* findById()
* findOne()
具体的用法和之前在控制台 操作mongoDB 数据类似,不清楚的同学可以查看本章第一节知识点: mongoDB数据库的使用
<https://github.com/pubdreamcc/Node.js/blob/master/%E7%AC%AC%E4%BA%94%E7%AB%A0/mongoDB%E6%95%B0%E6%8D%AE%E5%BA%93%E7%9A%84%E4%BD%BF%E7%94%A8.md>
这里选取一个findOne代表
User.findOne({name: 'pubdreamcc'}, (err, ret) => { if (err) {
console.log('查询失败') } else { console.log(ret) // ret 即为查询出来的那一条文档 } })
findOne() 会查找匹配的第一个文档出来,通常传入一个查找条件(对象),这里是从数据库查找 name 为 pubdreamcc 的文档出来。
删除数据
删除数据同样也有好几个方法,这里参照官网 api :
* remove()
* findOneAndRemove()
* findByIdAndRemove()
用法其实和更新数据,包括前面说到的查找数据类似,remove() 会删除所有匹配的全部文档,findOneAndRemove() 会删除匹配的第一个文档,
findByIdAndRemove() 通过唯一的id值删除某一个文档。
这里选取findByIdAndRemove() 来说明,其他的小伙伴可以去 mongoose 官网 api
查询,我就不再反复说了,用法很简单,大家看一下都懂的。
mongoose 官网 api: api document <http://mongoosejs.net/docs/api.html#Model>
User.findByIdAndRemove('id值', (err, ret) => { if (err) { console.log('删除失败') }
else { console.log('删除成功') console.log(ret) // ret 即为删除信息反馈对象,包括成功删了几条数据等 } })
更新数据
更新数据也有几个 api 可以供我们使用,我就罗列下,然后也是选取一个加以说明,其他的小伙伴们可以去官网查看 api 即可。
* findByIdAndUpdate()
* update()
* findOneAndUpdate()
这里选取 update() 来演示下:
User.update({name: 'pubdreamcc'}, {email: '[email protected]'}, (err, ret) =>
{ if (err) { console.log('更新失败') } else { console.log('更新成功') } })
update() 方法会把所有满足条件的数据都更新,上面我们已经把 name 为: pubdreamcc 的所有文档的email 都修改为
[email protected] 。
总结
本文也是我查阅相关资料,看了很多mongoDB的资料总结而来,如果有那些地方有差错,欢迎留言评论。
需要演示的源代码可以去GitHub仓库查看。
ok,that's all , thank you !
热门工具 换一换