egg-mongoose专题

导读

juejin.cn/post/684490… egg-从入门到上线 (上)

juejin.cn/post/684490… egg-从入门到上线 (下)

1 安装与配置

1.0 介绍

MongoDB 是由C++语言编写的，是一个基于分布式文件存储的开源数据库系统。
在高负载的情况下，添加更多的节点，可以保证服务器性能。
MongoDB 旨在为WEB应用提供可扩展的高性能数据存储解决方案。
MongoDB 将数据存储为一个文档，数据结构由键值(key=>value)对组成。MongoDB 文档类似于 JSON 对象。字段值可以包含其他文档，数组及文档数组

1.1 mac电脑安装教程

1.1.1 安装homebrew

homebrew的安装查看官网，安装完成后，在终端中输入以下命令更新homebrew的package数据库

brew update

提示：brew update升级brew的版本库，brew outdated 查看outdated的库和应用，brew upgrade 升级outdated的库和应用，brew cleanup 清理调过期的库和应用

1.1.2 安装mongodb

使用homebrew安装mongodb，在MAC的终端中输入

cd / 

brew install mongodb

若要查看安装信息

brew info mongodb

查看mongodb的版本

mongo --version

 which mongod

/usr/local/bin/mongod

如果这样了就安装成功了

启动服务

sudo mongod

1.2 手动部署服务器

1.2.1 下载安装包

wget http://fastdl.mongodb.org/linux/mongodb-linux-i686-1.8.2.tgz

下载完成后解压缩压缩包

tar zxf mongodb-linux-i686-1.8.2.tgz

1.2.2. 安装准备

将mongodb移动到/usr/local/server/mongdb文件夹

mv mongodb-linux-i686-1.8.2 /usr/local/mongodb

创建数据库文件夹与日志文件

mkdir /usr/local/mongodb/data
touch /usr/local/mongodb/logs

1.2.3. 设置开机自启动

将mongodb启动项目追加入rc.local保证mongodb在服务器开机时启动

echo "/usr/local/mongodb/bin/mongod --dbpath=/usr/local/mongodb/data –logpath=/usr/local/mongodb/logs –logappend  --auth -–port=27017" >> /etc/rc.local

1.2.4. 启动mongodb

cd到mongodb目录下的bin文件夹启动mongodb

下面这个是需要权限的登录方式, 用户连接需要用户名和密码

/usr/local/mongodb/bin/mongod --dbpath=/usr/local/mongodb/data --logpath=/usr/local/mongodb/logs --logappend  --auth  --port=27017 --fork

这个是不需要密码的(不建议)

/usr/local/mongodb/bin/mongod --dbpath=/usr/local/mongodb/data --logpath=/usr/local/mongodb/logs --logappend  --port=27017 --fork

1.3 宝塔一键完成

1.4 设置密码

1.4.1 进入安装路径的bin目录

cd /www/server/mongodb/bin

1.4.2 输入命令行mongo，进入mongodb环境

mongo

1.4.3 切换到 admin 数据库

use admin

1.4.4 给admin设置用户密码

• user: 用户名
• pwd: 用户密码
• roles: 用来设置用户的权限，比如读，读写 等等

db.createUser({user: 'root', pwd: 'admin_mima', roles: ['root']})

1.4.5 验证是否添加成功，db.auth(用户名，用户密码)

db.auth('root', 'admin_mima') 

如果返回 '1’表示验证成功， 如果是 ‘0’ 表示验证失败。

1.4.6 创建一个新的数据库，例如asGiant

use asGiant

1.4.7  接下来为asGiant库添加一个用户，并且赋予权限，

db.createUser({ user: 'aaaa', pwd: 'graphql_mima', roles: [{ role: 'readWrite', db: 'asGiant' }] })

这行代码意思是 创建一个cccc用户 给予读写权限 db表示该用户操作的数据库名。

• Read：允许用户读取指定数据库
• readWrite：允许用户读写指定数据库
• dbAdmin：允许用户在指定数据库中执行管理函数，如索引创建、删除，查看统计或访问system.profile
• userAdmin：允许用户向system.users集合写入，可以找指定数据库里创建、删除和管理用户
• clusterAdmin：只在admin数据库中可用，赋予用户所有分片和复制集相关函数的管理权限。
• readAnyDatabase：只在admin数据库中可用，赋予用户所有数据库的读权限
• readWriteAnyDatabase：只在admin数据库中可用，赋予用户所有数据库的读写权限
• userAdminAnyDatabase：只在admin数据库中可用，赋予用户所有数据库的userAdmin权限
• dbAdminAnyDatabase：只在admin数据库中可用，赋予用户所有数据库的dbAdmin权限。
• root：只在admin数据库中可用。超级账号，超级权限

1.4.8 开启安全登录

一切搞定，重新开机mongodb，通过增加 --auth 开启安全登录

mongod --dbpath /www/server/mongodb/data --auth

如果你是手动安装，那么需要以下操作

mongodb，MongoDB默认是没有开启访问控制，我们通过--auth参数重启mongod服务。

mongod --dbpath 存放数据库文件夹路径 --auth

mongod --dbpath usr/local/mongodb/bin --auth

一旦开启了，用户连接mongod必须指定用户名和密码。

如果你采用的是宝塔一键完成的

可以通过修改mongodb的配置文件来实现

修改为

net:
  port: 27017
  bindIp: 0.0.0.0
 
#operationProfiling:
#replication:
#    replSetName: bt_main   
security:
  authorization: enabled
  javascriptEnabled: false

• bindIp修改为 0.0.0.0 允许外网访问
• authorization 修改为 enabled 开启认证
  重启一下mongodb

1.5 放行端口

2 工具连接

2.1 下载robo 3t

创建一个连接

点击test

安装完成

2.2 连接加密数据库

xxx.db('mongodb://your name: your pwd@ip:27017/asgiant');
your name：为用户名
your pwd:为密码

3 数据备份还原

当mongodb 数据库打开了 auth认证 以后 就不能直接使用 dump 而需要提供对应的账号密码 如下

mongodump -h 127.0.0.1:27017 -d asGiant -u 'myz' -p '123456' -o /usr/local/mongodb/dump

-h 地址
-d 数据库名称
-u 用户名
-p 密码
-o 输出地址
--authenticationDatabase admin 验证账户的数据库

mongorestore命令脚本语法如下：

mongorestore -h <hostname><:port> -d dbname <path>

• **--host <:port>, -h <:port>：**MongoDB所在服务器地址，默认为： localhost:27017
  
• **--db , -d ：**需要恢复的数据库实例，例如：test，当然这个名称也可以和备份时候的不一样，比如test2
  
• **--drop：**恢复的时候，先删除当前数据，然后恢复备份的数据。就是说，恢复后，备份后添加修改的数据都会被删除，慎用哦！
  
• **：**mongorestore 最后的一个参数，设置备份数据所在位置，例如：/usr/local/mongodb/dump。
  你不能同时指定 和 --dir 选项，--dir也可以设置备份目录。
  
• **--dir：**指定备份的目录
  你不能同时指定 和 --dir 选项。

mongorestore -h localhost:27017 -d asGiant -c user --dir /usr/local/mongodb/dump -u myz -p 12346

mongodump -u root -p 123456

mongorestore  -u root -p 123456

4 egg-mongoose 配置

4.1 安装

$ npm install egg-mongoose --save

4.2 配置

改变Egg项目中的配置文件{workplace}/config/plugin.js中来启用 egg-mongoose 插件:

exports.mongoose = {
  enable: true,
  package: 'egg-mongoose',
};

4.3 Egg连接mongoose

在Egg项目中的配置文件{workplace}/config/default.js配置项config添加属性

config.mongoose = {
    url: process.env.EGG_MONGODB_URL || 'mongodb://127.0.0.1/website',
    options: {
      server: {
        poolSize: 40,
      },
    },
  };

连接方法

 config.mongoose = {
    client: {
      url: 'mongodb://账号:密码@服务器:端口/库名',
      options: {},
    },
  };

5 设计数据库模型

5.1 定义模型，也就是数据表

在{workplace}/app/model/article.js定义数据表

'use strict';
module.exports = app => {
  const mongoose = app.mongoose;
  const Schema = mongoose.Schema;
  const RoleSchema = new Schema({
    role: {
      type: String,
      index: {
        unique: true,
      }, // 该字段为唯一字段
      require: true, // 必填项
    },
    roleName: {
      type: String,
      require: true,
    },
    // 备注
    note: {
      type: String,
      require: true,
    },
  });
  return mongoose.model('Role', RoleSchema, 'role');
};

5.2 数据类型

数据类型
Number	数字
String	字符串
Boolean	布尔值
ObjectId	对象ID
Array	数组
Date	日期
Buffer	二进制
Mixed	混合类型

6 增加数据

this.ctx.model.Article.create(post,callback);

备注：其中post为json数据结构，callback为操作后的回调函数

7 查询数据

7.1 获取所有数据，返回是一个数组

this.ctx.model.Article.find()

7.2 获取一个数据，返回是一个对象

this.ctx.model.Article.findOne()

7.3 条件查询

this.ctx.model.Article.find(conditions,callback);

condition有以下几种类型

7.3.1 根据具体数据进行查询

this.ctx.model.Article.find({_id：5c4a819fb87ba4002a47bc4f,title:"123"},callback);

• 返回_id为5c4a819fb87ba4002a47bc4f，title为123的结果

7.3.2 条件查询

"$lt"	小于
"$lte"	小于等于
"$gt"	大于
"$gte"	大于等于
"$ne"	不等于

this.ctx.model.Article.find({“sort”:{ $get:18 , $lte:30 });

• 返回Article表中sort 大于等于18并小于等于30的结果

7.3.3 或查询 OR

"$in"	一个键对应多个值
"$nin"	同上取反, 一个键不对应指定值
"$or"	多个条件匹配, 可以嵌套 $in 使用
"$not"	同上取反, 查询与特定模式不匹配的文档

this.ctx.model.Article.find({"title":{ $in:[20,21,22."haha"]} );

• 返回Article表中title等于20或21或21或"haha"的结果

this.ctx.model.Article.find({"$or" :  [ {"age":18} , {"name":"wxw"} ] });

• 返回Article表中age等于18或 name等于"wxw"的结果

7.3.4 类型查询（"$exists"条件判定）

this.ctx.model.Article.find({name: {$exists: true}},function(error,docs){
  //返回Article表中所有存在name属性的结果
});

this.ctx.model.Article.find({telephone: {$exists: false}},function(error,docs){
  //返回Article表中所有不存在telephone属性的结果
});

7.3.5 匹配正则表达式查询

MongoDb 是使用 Prel兼容的正则表达式库来匹配正则表达式

this.ctx.model.Article.find( {"name" : /joe/i } );

• 返回Article表中name为 joe 的结果, 并忽略大小写

7.3.6 查询数组

this.ctx.model.Article.find({"array":10} );

• 返回Article表中array(数组类型)键中有10的文档, array : [1,2,3,4,5,10] 会匹配到

this.ctx.model.Article.find({"array[5]":10}  );

• 返回Article表中array(数组类型)键中下标5对应的值是10, array : [1,2,3,4,5,10] 会匹配到

this.ctx.model.Article.find({"array":[5,10]});

• 返回Article表中查询匹配array数组中既有5又有10的结果

this.ctx.model.Article.find({"array":{$size : 3} });

• 返回Article表中查询匹配array数组长度为3 的的结果

this.ctx.model.Article.find({"array":{$slice : 10} });

• 返回Article表中查询匹配array数组的前10个元素

this.ctx.model.Article.find({"array":{$slice :  [5,10]} });

• 返回Article表中查询匹配array数组的第5个到第10个元素

7.3.7 where

用它可以执行任意javacript语句作为查询的一部分,如果回调函数返回 true 文档就作为结果的一部分返回

this.ctx.model.Article.find( {"$where" :  "this.x + this.y === 10" } );
this.ctx.model.Article.find( {"$where" : " function(){ return this.x + this.y ===10; } " } )

• 其中this为数据表中的数据，上述返回Article表中属性x+属性y=10的所有数据

8 删除数据

this.ctx.model.Article.remove(conditions,callback);

备注：conditions为查询条件，与查询数据介绍的一样，eg：{ _id：5c4a819fb87ba4002a47bc4f }，找到_id为5c4a819fb87ba4002a47bc4f的数据，callback为操作成功后的回调函数

9 更新数据

9.1 更新数据

this.ctx.model.Article.update(conditions, update, callback)

• 参数1:查询条件, 参数2:更新对象,可以使用MondoDB的更新修改器

备注：conditions与查询数据中介绍的一样

9.2 update为更新对象

let post = {
    wid: '5c492c57acbe363fd4824446',
    column: [ '新闻' ],
    titleHead: '',
    img: '',
    isAbstract: 'false',
}
this.ctx.model.Article.update({ _id: '5c4a819fb87ba4002a47bc4f ' }, post)

• 查询Article表中特定_id，并对post中所包含的属性进行更新。

update使用MondoDB的更新修改器，有以下几种使用场景

9.2.1 "$inc"增减修改器,只对数字有效

this.ctx.model.Article.update({"age":22}, {$inc:{"age":1} }  );

• 找到age=22的文档,修改文档的age值自增1

9.2.2 '$set' 指定一个键的值,这个键不存在就创建它.可以是任何MondoDB支持的类型.

this.ctx.model.Article.update({ _id：5c4a819fb87ba4002a47bc4f }, { $set: { isDelete: true } });

• 对5c4a819fb87ba4002a47bc4f 表进行软删除，找到特定_id数据，增加或者修改isDelete属性

9.2.3 "$unset"同上取反,删除一个键

this.ctx.model.Article.update({age:22}, {$unset:{age:18} } );

• 执行后age键不存在

9.2.4 '$push'给一个键push一个数组成员,键不存在会创建,对数组有效

this.ctx.model.Article.update({name:'wxw'}, {$push:{array:10} } );

• 返回Article表中name为wxw的数据，增加一个array键,类型为数组,有一个成员 10

9.2.5 '$addToSet'向数组中添加一个元素,如果存在就不添加

this.ctx.model.Article.update({name:'wxw'},{$addToSet:{array:10} } );

• 返回Article表中name为wxw的数据，array中有10所以不会添加

9.2.6 'push 修改器配合可以插入多个值

this.ctx.model.Article.update({name:'wxw'}, {$push:{array:{$each: [1,2,3,4,5]}} } );

• 返回Article表中name为wxw的数据，执行后array : [10,1,2,3,4,5]

9.2.7 '$pop' 向数组中尾部删除一个元素

this.ctx.model.Article.update({name:'wxw'}, {$pop:{array:1} } );

• 返回Article表中name为wxw的数据，其中array : [10,1,2,3,4,5]，执行后 array : [10,1,2,3,4]
• tip:将1改成-1可以删除数组首部元素

9.2.8 '$pull' 向数组中删除指定元素

this.ctx.model.Article.update({name:'wxw'}, {$pull:{array:10} });

• 返回Article表中name为wxw的数据，匹配到array中的10后将其删除。

10 排序（sort）

this.ctx.model.Article.sort({ isSetTop: -1, sort: 1, editTime: -1 });

• 对Article表中的数据进行排序，先按“isSetTop”降序，再按“sort”升序，最后按“editTime”降序

备注：键对应数据中的键名，值代表排序方向，1 升序, -1降序。

11 限制返回结果的数量（limit）

this.ctx.model.Article.limit(3);

• 对Article表中的数据进行返回，返回为前面3条数据

12 跳过前3个文档,返回其余的（skip）

this.ctx.model.Article.skip(3);

• 对Article表中的数据进行返回，跳过前面3条数据，返回其余数据

附：综合使用最后三个方法进行分页查询

this.ctx.model.Article.find({ _id：5c4a819fb87ba4002a47bc4f }).skip(pageSize * (pageNum - 1)).limit(parseInt(pageSize)).sort({ isSetTop: -1, sort: 1, editTime: -1 });

• 其中pageSize和pageNum为动态传递数据，返回Article表中特定_id在每页数据为pageSize条件下的第pageNum页中的数据，并按照“isSetTop”降序，再按“sort”升序，最后按“editTime”降序进行排序。