MongoDB是一种文档导向数据库管理系统,由C++撰写而成。
本章节我们将为大家介绍如何使用 Node.js 来连接 MongoDB,并对数据库进行操作。
如果你还没有 MongoDB 的基本知识,可以参考我们的教程:MongoDB 教程。
本教程使用了淘宝定制的 cnpm 命令进行安装:
- $ cnpm install mongodb
接下来我们来实现增删改查功能。
要在 MongoDB 中创建一个数据库,首先我们需要创建一个 MongoClient 对象,然后配置好指定的 URL 和 端口号。
如果数据库不存在,MongoDB 将创建数据库并建立连接。
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/cdsy";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- console.log("数据库已创建!");
- db.close();
- });
我们可以使用 createCollection() 方法来创建集合:
- var MongoClient = require('mongodb').MongoClient;
- var url = 'mongodb://localhost:27017/cdsy';
- MongoClient.connect(url, function (err, db) {
- if (err) throw err;
- console.log('数据库已创建');
- var dbase = db.db("cdsy");
- dbase.createCollection('site', function (err, res) {
- if (err) throw err;
- console.log("创建集合!");
- db.close();
- });
- });
与 MySQL 不同的是 MongoDB 会自动创建数据库和集合,所以使用前我们不需要手动去创建。
以下实例我们连接数据库 cdsy 的 site 表,并插入一条数据条数据,使用insertOne():
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- var myobj = { name: "城东书院", url: "www.cdsy.xyz" };
- dbo.collection("site").insertOne(myobj, function(err, res) {
- if (err) throw err;
- console.log("文档插入成功");
- db.close();
- });
- });
执行以下命令输出就结果为:
- $ node test.js
- 文档插入成功
从输出结果来看,数据已插入成功。
我们也可以打开 MongoDB 的客户端查看数据,如:
- > show dbs
- cdsy 0.000GB # 自动创建了 cdsy 数据库
- > show tables
- site # 自动创建了 site 集合(数据表)
- > db.site.find()
- { "_id" : ObjectId("5a794e36763eb821b24db854"), "name" : "城东书院", "url" : "www.cdsy.xyz" }
- >
如果要插入多条数据可以使用insertMany():
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- var myobj = [
- { name: '城东书院', url: 'https://www.cdsy.xyz', type: 'cn'},
- { name: 'Google', url: 'https://www.google.com', type: 'en'},
- { name: 'Facebook', url: 'https://www.google.com', type: 'en'}
- ];
- dbo.collection("site").insertMany(myobj, function(err, res) {
- if (err) throw err;
- console.log("插入的文档数量为: " + res.insertedCount);
- db.close();
- });
- });
res.insertedCount 为插入的条数。
可以使用 find() 来查找数据, find() 可以返回匹配条件的所有数据。 如果未指定条件,find() 返回集合中的所有数据。
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- dbo.collection("site"). find({}).toArray(function(err, result) { // 返回集合中所有数据
- if (err) throw err;
- console.log(result);
- db.close();
- });
- });
以下实例检索 name 为 "城东书院" 的实例:
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- var whereStr = {"name":'城东书院'}; // 查询条件
- dbo.collection("site").find(whereStr).toArray(function(err, result) {
- if (err) throw err;
- console.log(result);
- db.close();
- });
- });
执行以下命令输出就结果为:
- [ { _id: 5a794e36763eb821b24db854,
- name: '城东书院',
- url: 'www.cdsy.xyz' } ]
我们也可以对数据库的数据进行修改,以下实例将 name 为 "城东书院" 的 url 改为 https://www.cdsy.xyz:
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- var whereStr = {"name":'城东书院'}; // 查询条件
- var updateStr = {$set: { "url" : "https://www.cdsy.xyz" }};
- dbo.collection("site").updateOne(whereStr, updateStr, function(err, res) {
- if (err) throw err;
- console.log("文档更新成功");
- db.close();
- });
- });
执行成功后,进入 mongo 管理工具查看数据已修改:
- > db.site.find().pretty()
- {
- "_id" : ObjectId("5a794e36763eb821b24db854"),
- "name" : "城东书院",
- "url" : "https://www.cdsy.xyz" // 已修改为 https
- }
如果要更新所有符合条的文档数据可以使用updateMany():
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- var whereStr = {"type":'en'}; // 查询条件
- var updateStr = {$set: { "url" : "https://www.cdsy.xyz" }};
- dbo.collection("site").updateMany(whereStr, updateStr, function(err, res) {
- if (err) throw err;
- console.log(res.result.nModified + " 条文档被更新");
- db.close();
- });
- });
result.nModified 为更新的条数。
以下实例将 name 为 "城东书院" 的数据删除 :
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- var whereStr = {"name":'城东书院'}; // 查询条件
- dbo.collection("site").deleteOne(whereStr, function(err, obj) {
- if (err) throw err;
- console.log("文档删除成功");
- db.close();
- });
- });
执行成功后,进入 mongo 管理工具查看数据已删除:
- > db.site.find()
- >
如果要删除多条语句可以使用deleteMany()方法
以下实例将 type 为 en 的所有数据删除 :
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- var whereStr = { type: "en" }; // 查询条件
- dbo.collection("site").deleteMany(whereStr, function(err, obj) {
- if (err) throw err;
- console.log(obj.result.n + " 条文档被删除");
- db.close();
- });
- });
obj.result.n 删除的条数。
排序 使用 sort() 方法,该方法接受一个参数,规定是升序(1)还是降序(-1)。
例如:
- { type: 1 } // 按 type 字段升序
- { type: -1 } // 按 type 字段降序
按 type 升序排列:
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- var mysort = { type: 1 };
- dbo.collection("site").find().sort(mysort).toArray(function(err, result) {
- if (err) throw err;
- console.log(result);
- db.close();
- });
- });
如果要设置指定的返回条数可以使用limit()方法,该方法只接受一个参数,指定了返回的条数。
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- dbo.collection("site").find().limit(2).toArray(function(err, result) {
- if (err) throw err;
- console.log(result);
- db.close();
- });
- });
如果要指定跳过的条数,可以使用skip()方法。
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- dbo.collection("site").find().skip(2).limit(2).toArray(function(err, result) {
- if (err) throw err;
- console.log(result);
- db.close();
- });
- });
mongoDB 不是一个关系型数据库,但我们可以使用$lookup来实现左连接。
例如我们有两个集合数据分别为:
集合1:orders
- [
- { _id: 1, product_id: 154, status: 1 }
- ]
集合2:products
- [
- { _id: 154, name: '笔记本电脑' },
- { _id: 155, name: '耳机' },
- { _id: 156, name: '台式电脑' }
- ]
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://127.0.0.1:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- dbo.collection('orders').aggregate([
- { $lookup:
- {
- from: 'products', // 右集合
- localField: 'product_id', // 左集合 join 字段
- foreignField: '_id', // 右集合 join 字段
- as: 'orderdetails' // 新生成字段(类型array)
- }
- }
- ]).toArray(function(err, res) {
- if (err) throw err;
- console.log(JSON.stringify(res));
- db.close();
- });
- });
我们可以使用drop()方法来删除集合:
- var MongoClient = require('mongodb').MongoClient;
- var url = "mongodb://localhost:27017/";
-
- MongoClient.connect(url, function(err, db) {
- if (err) throw err;
- var dbo = db.db("cdsy");
- // 删除 test 集合
- dbo.collection("test").drop(function(err, delOK) { // 执行成功 delOK 返回 true,否则返回 false
- if (err) throw err;
- if (delOK) console.log("集合已删除");
- db.close();
- });
- });
Promise 是一个 ECMAScript 6 提供的类,目的是更加优雅地书写复杂的异步任务。
以下实例使用 Promise 创建集合:
- const MongoClient = require("mongodb").MongoClient;
- const url = "mongodb://localhost/cdsy";
- MongoClient.connect(url).then((conn) => {
- console.log("数据库已连接");
- var dbase = conn.db("cdsy");
- dbase.createCollection("site").then((res) => {
- console.log("已创建集合");
- }).catch((err) => {
- console.log("数据库操作错误");
- }).finally(() => {
- conn.close();
- });
- }).catch((err) => {
- console.log("数据库连接失败");
- });
现在我们在一个程序中实现四个连续操作:增加 、查询 、更改 、删除。
- const MongoClient = require("mongodb").MongoClient;
- const url = "mongodb://localhost/";
- MongoClient.connect(url).then((conn) => {
- console.log("数据库已连接");
- const test = conn.db("testdb").collection("test");
- // 增加
- test.insertOne({ "site": "cdsy.xyz" }).then((res) => {
- // 查询
- return test.find().toArray().then((arr) => {
- console.log(arr);
- });
- }).then(() => {
- // 更改
- return test.updateMany({ "site": "cdsy.xyz" },
- { $set: { "site": "example.com" } });
- }).then((res) => {
- // 查询
- return test.find().toArray().then((arr) => {
- console.log(arr);
- });
- }).then(() => {
- // 删除
- return test.deleteMany({ "site": "example.com" });
- }).then((res) => {
- // 查询
- return test.find().toArray().then((arr) => {
- console.log(arr);
- });
- }).catch((err) => {
- console.log("数据操作失败" + err.message);
- }).finally(() => {
- conn.close();
- });
- }).catch((err) => {
- console.log("数据库连接失败");
- });
执行结果:
- 数据库已连接
- [ { _id: 5f1664966833e531d83d3ac6, site: 'cdsy.xyz' } ]
- [ { _id: 5f1664966833e531d83d3ac6, site: 'example.com' } ]
- []
- const MongoClient = require("mongodb").MongoClient;
- const url = "mongodb://localhost/";
-
- async function dataOperate() {
- var conn = null;
- try {
- conn = await MongoClient.connect(url);
- console.log("数据库已连接");
- const test = conn.db("testdb").collection("test");
- // 增加
- await test.insertOne({ "site": "cdsy.xyz" });
- // 查询
- var arr = await test.find().toArray();
- console.log(arr);
- // 更改
- await test.updateMany({ "site": "cdsy.xyz" },
- { $set: { "site": "example.com" } });
- // 查询
- arr = await test.find().toArray();
- console.log(arr);
- // 删除
- await test.deleteMany({ "site": "example.com" });
- // 查询
- arr = await test.find().toArray();
- console.log(arr);
- } catch (err) {
- console.log("错误:" + err.message);
- } finally {
- if (conn != null) conn.close();
- }
- }
-
- dataOperate();
运行结果:
- 数据库已连接
- [ { _id: 5f169006a2780f0cd4ea640b, site: 'cdsy.xyz' } ]
- [ { _id: 5f169006a2780f0cd4ea640b, site: 'example.com' } ]
- []
运行结果完全一样。
很显然,异步函数是一种非常良好的编程风格,在多次使用异步操作的时候非常实用。
但是请勿在低于 7.6.0 版本的 node.js 上使用异步函数。