@

• 一、数据库概述及环境搭建
  • 1.概述
    • 为什么要使用数据库
    • 什么是数据库
  • 2. MongoDB环境搭建
    • MongoDB可视化软件
    • 数据库相关概念
    • 启动与停止MongoDB
    • Mongoose第三方包
    • 数据库连接
    • 创建数据库
• 二、基于mongoose对MongoDB增删改查操作
  • 1. 创建集合
    • mongoose.Schema() / mongoose.model()
  • 2. 创建文档
    • 方式一:save()
    • 方式二: collection.create()
  • 3. mongoDB数据库导入数据
  • 4. 查询文档
    • collection.find()
    • collection.findone()
    • 指定特殊条件查询文档
    • collection.countDocuments()
  • 5. 删除文档
    • collection.findOneAndDelete()
    • collection.deleteMany()
  • 6. 更新文档
    • collection.updateOne()
    • collection.updateMany()
  • 7. mongoose验证
    • 一般验证项
    • 自定义验证器
    • 获取错误信息
  • 8. 集合关联
• 三、mongoDB数据库添加账号

一、数据库概述及环境搭建

1.概述

为什么要使用数据库

• 动态网站中的数据都是存储在数据库中的
• 数据库可以用来持久存储客户端通过表单收集的用户信息
• 数据库软件本身可以对数据进行高效的管理
  
  

什么是数据库

数据库即存储数据的仓库，可以将数据进行有序的分门别类的存储。它是独立于语言之外的软件，可以通过API去操作它。
常见的数据库软件有：mysql、mongoDB、oracle。

2. MongoDB环境搭建

MongoDB官方中文文档
下载地址

MongoDB可视化软件

MongoDB可视化操作软件，是使用图形界面操作数据库的一种方式。

数据库相关概念

在一个数据库软件中可以包含多个数据仓库，在每个数据仓库中可以包含多个数据集合，每个数据集合中可以包含多条文档（具体的数据）。

启动与停止MongoDB

以管理员身份在命令行工具中运行
net start mongoDB即可启动MongoDB，否则MongoDB将无法连接。
net stop mongoDB即可停止MongoDB服务。

Mongoose第三方包

使用Node.js操作MongoDB数据库需要依赖Node.js第三方包mongoose
使用npm install mongoose命令下载之后用require('mongoose')引入
Mongoose-npm
Mongoose 5.0 中文文档

数据库连接

使用mongoose提供的connect方法即可连接数据库

const mongoose = require('mongoose');
//链接playground数据库的之前自动创建该数据库
mongoose.connect('mongodb://localhost/playground', {useNewUrlParser: true})
//connect方法方法返回Promise对象, 内部输出结果可用then()或catch()接收
.then(() => console.log('数据库连接成功'))
.catch(err => console.log('数据库连接失败', err));

创建数据库

在MongoDB中不需要显式创建数据库，如果正在使用的数据库不存在，MongoDB会自动创建。

二、基于mongoose对MongoDB增删改查操作

1. 创建集合

mongoose.Schema() / mongoose.model()

创建集合分为两步:

1. 对对集合设定规则，创建mongoose.Schema构造函数的实例即可创建集合规则

   let SchemaName = new mongoose.Schema({
   //字段规则...
   })
   

2. 创建集合，通过mongoose.model()方法创建集合并应用指定的集合规则

   /*注意：集合名称需首字母大写,比如: Course; mongodb数据库创建的集合名为: courses
   方法返回一个集合构造函数
   */
   let collection = mongoose.model(集合名称,集合规则);
   

2. 创建文档

方式一:save()

分为两步：
① 通过所创建的集合构造函数创建文档并插入该集合中。
② 调用实例对象下的save()将数据保存到数据库中。

方式二: collection.create()

/*
err: 文档插入失败,返回错误信息对象，否者返回null
doc: 文档插入成功, 文档本身
*/
create({被插入文档数据对象},callback(err, doc) =>{
})

// 引入mongoose第三方模块 用来操作数据库
//const mongoose = require('mongoose');
// 数据库连接
//mongoose.connect(//...);

// 创建集合规则
const courseSchema = new mongoose.Schema({
	name: String,
	author: String,
	isPublished: Boolean
});

// 使用规则创建集合
const Course = mongoose.model('Course', courseSchema) // 数据库实际生成集合名: courses

// 方式一:
// 创建文档
const course = new Course({
	name: 'node.js基础',
	author: 'teacher',
	isPublished: true,
	//通过给字段设置 unique: true 来使在插入字段时数据库会检测该字段的值是否重复了之前插入的字段值，如果重复，报错
	unique: true
});
// 将文档插入到数据库中
course.save();

//方式二:
Course.create({name: 'JavaScript', author: 'MrLi', isPublish: true}, (err, doc) => {
// 错误对象
console.log(err)
// 当前插入的文档
console.log(doc)
});

//注意：mongodb大部分API都是异步，create()是异步API，可返回Promise对象
Course.create({name:'JavaScript',author: 'MrLi', isPublish: true})
	.then(doc => {console.log(doc)})
	.catch(err => {console.log(err)})

3. mongoDB数据库导入数据

通过命令mongoimport -d 数据库名称 -c 集合名称 --file 要导入的数据文件 导入数据
找到mongodb数据库的安装目录，将安装目录下的bin目录放置在环境变量path中。

PS D:\...\test\item> mongoimport -d playground -c users --file ./user.json
2021-08-30T17:18:19.562+0800    connected to: localhost
2021-08-30T17:18:19.644+0800    imported 6 documents
PS D:\...test\item>

4. 查询文档

collection.find()

// 根据条件查找文档（条件为空则查找所有文档）
Course.find({//查询条件
})
//find()返回Promise对象
.then(result => console.log(result))

/*
find()返回文档集合(数组) , 
若擦找不到返回空数组
比如:
*/
[{
	_id: 5c0917ed37ec9b03c07cf95f,
	name: 'node.js基础',
	author: 'teacher‘
},{
	_id: 5c09dea28acfb814980ff827,
	name: 'Javascript',
	author: 'MrLi'
}]

collection.findone()

// 根据条件查找文档(条件为空则查找集合的首个文档)
Course.findOne({name: 'node.js基础'}).then(result => console.log(result))

// 返回文档(对象)
{
	_id: 5c0917ed37ec9b03c07cf95f,
	name: 'node.js基础',
	author: 'teacher'
}

指定特殊条件查询文档

// 匹配指定字段值大于($gt) 小于($lt)
User.find({age: {$gt: 20, $lt: 50}}).then(result => console.log(result))

// 匹配指定字段值包含($in)
User.find({hobbies: {$in: ['敲代码']}}).then(result => console.log(result))

// 选择要查询的字段, -字段名：表示不查询此字段
User.find().select('name email').then(result => console.log(result))

// 将数据按照年龄进行排序(默认升序), -字段名表示降序
User.find().sort('age').then(result => console.log(result))

// skip 跳过多少条数据 limit 限制查询数量
User.find().skip(2).limit(2).then(result => console.log(result))

collection.countDocuments()

返回集合里的所用文档一共的数量，方法返回promise对象

user.countDocuments(查询条件)

Model.countDocuments()

5. 删除文档

collection.findOneAndDelete()

/*
删除单个文档, 可通过指定参数对象来删除指定文档
如何查询条件匹配了多个文档, 那么将会删除第一个匹配的文档
返回删除的文档
*/
Course.findOneAndDelete({}).then(result => console.log(result))

collection.deleteMany()

/*
删除多个文档
当不指定参数，将会删除集合里的所有文档
返回一个对象{ deletedCount }, 被删除文档的数量
*/
User.deleteMany({}).then(result => console.log(result))

6. 更新文档

collection.updateOne()

// // 更新单个
User.updateOne({查询条件}, {要修改的值}).then(result => console.log(result))

collection.updateMany()

//// 更新多个
User.updateMany({查询条件}, {要更改的值}).then(result => console.log(result))

< BR > < BR >

7. mongoose验证

在创建集合规则时，可以设置当前字段的验证规则，验证失败就则输入插入失败。

一般验证项

可自定义错误信息，比如验证项: [值，'自定义错误信息']

自定义验证器

特殊验证项 : validate

new mongoose.Schema({
	title: {
		// 指定字段类型
		type: String,
		// 必选字段
		required: [true, '请传入文章标题'],
		// 字符串的最小长度
		minlength: [2, '文章长度不能小于2'],
		// 字符串的最大长度
		maxlength: [5, '文章长度最大不能超过5'],
		// 去除字符串两边的空格
		trim: true
	},
	age: {
		type: Number,
		// 数字的最小范围
		min: 18,
		// 数字的最大范围
		max: 100
	},
	publishDate: {
		type: Date,
		// 默认值
		default: Date.now
	},
	category: {
		type: String,
		// 枚举 列举出当前字段可以拥有的值
		enum: {
			values: ['html', 'css', 'javascript', 'node.js'],
			message: '分类名称要在一定的范围内才可以'
		}
	},
	author: {
		type: String,
		validate: {
			//自定义验证规则
			validator: v => {
				// 返回布尔值
				// true 验证成功
				// false 验证失败
				// v 要验证的值
				return v && v.length > 4
			},
			// 自定义错误信息
			message: '传入的值不符合验证规则'
		}
	}
});


Post.create({title:'aa', age: 60, category: 'java', author: 'bd'})
	.then(result => console.log(result))
	.catch(error => {
		// 获取错误信息对象
		const err = error.errors;
		// 循环错误信息对象
		for (var attr in err) {
			// 将错误信息打印到控制台中
			console.log(err[attr]['message']);
		}
	})

获取错误信息

error.errors['字段名称'].message

8. 集合关联

通常不同集合的数据之间是有关系的，例如文章信息和用户信息存储在不同集合中，但文章是某个用户发表的，要查询文章的所有信息包括发表用户，就需要用到集合关联。

比如：
使用id对集合进行关联
使用populate方法进行关联集合查询

// 引入mongoose第三方模块 用来操作数据库
//const mongoose = require('mongoose');
// 数据库连接
//mongoose.connect(//...)
// 用户集合
const User = mongoose.model('User', new mongoose.Schema({
	name: {
		type: String,
		required: true
	}
}););
// 文章集合
const Post = mongoose.model('Post', new mongoose.Schema({
	title: {
		type: String
	},
	author: {
		//通过以下方式：autor字段关联到 users集合 中的文档
		type: mongoose.Schema.Types.ObjectId,
		ref: 'User'
	}
}););
User.create({name: 'gh'}).then(result => console.log(result));
Post.create({titile: '123', author: '5c0caae2c4e4081c28439791'}).then(result => console.log(result));
//通过populate()查询 posts集合中文档中的 关联字段author
Post.find().populate('author').then(result => console.log(result))

三、mongoDB数据库添加账号

1. 以系统管理员的方式运行powershell

2. 连接数据库 mongo

3. 查看数据库 show dbs

4. 切换到默认数据库admin, use admin

5. 创建超级管理员账户

   /*
   创建账号 
   user: 用户名 
   pwd: 密码
   roles:角色,可指定多个角色,
   	root：超级管理员
   	readWirte: 读写权限
   */
   db.createUser({user:'root', pwd:'root',roles:['root']})
   

6. 登录超级管理员账户 db.auth('超级管理员用户名', '超级管理员用户名密码')

7. 切换到自定义数据库(自建)

   比如，登录超级管理员账户后，使用一个名为blog的数据库，mongoDB会自动判断当前数据库是否存在，
   如果不存在会自动创建		
   use blog
   

8. 创建普通账号 db.createUser()

   db.createUser({user:'blog', pwd:'blog',roles:['readWrite']})
   

9. 卸载mongodb服务

   • 停止服务 net stop mongodb
   • mongod --remove

10. 创建mongodb服务

    /*
    --logpath: 指定输出日志目录
    --dbpath: 指定数据库的存储目录
    --install: 安装mongoDB服务
    -auth: 设置数据库必须登录才能操作
    */
    mongod --logpath="C:\Program Files\MongoDB\Server\4.1\log\mongod.log" --dbpath="C:\ProgramFiles\MongoDB\Server\4.1\data" --install –-auth
    

11. 在项目中使用账号连接数据库

    /*
    user: 用户名
    pass: 密码
    默认端口: 27017
    */
    mongoose.connect('mongodb://user:pass@localhost:27017/database')
    

    如果不连接就访问数据库则会报错 MongoError：

    (node:4088) UnhandledPromiseRejectionWarning: MongoError: command find requires authentication