MongoDB是一種文檔導(dǎo)向數(shù)據(jù)庫管理系統(tǒng),由C++撰寫而成。
本章節(jié)我們將為大家介紹如何使用 Node.js 來連接 MongoDB,并對(duì)數(shù)據(jù)庫進(jìn)行操作。
如果你還沒有 MongoDB 的基本知識(shí),可以參考我們的教程:MongoDB 教程。
本教程使用了淘寶定制的 cnpm 命令進(jìn)行安裝:
$ cnpm install mongodb
接下來我們來實(shí)現(xiàn)增刪改查功能。
要在 MongoDB 中創(chuàng)建一個(gè)數(shù)據(jù)庫,首先我們需要?jiǎng)?chuàng)建一個(gè) MongoClient 對(duì)象,然后配置好指定的 URL 和 端口號(hào)。
如果數(shù)據(jù)庫不存在,MongoDB 將創(chuàng)建數(shù)據(jù)庫并建立連接。
var MongoClient = require('mongodb').MongoClient;
var url = "mongodb://localhost:27017/w3cschool";
MongoClient.connect(url, function(err, db) {
if (err) throw err;
console.log("數(shù)據(jù)庫已創(chuàng)建!");
db.close(); });
我們可以使用 createCollection() 方法來創(chuàng)建集合:
var MongoClient = require('mongodb').MongoClient;
var url = 'mongodb://localhost:27017/w3cschool';
MongoClient.connect(url, function (err, db) {
if (err) throw err;
console.log('數(shù)據(jù)庫已創(chuàng)建');
var dbase = db.db("w3cschool");
dbase.createCollection('site', function (err, res) {
if (err) throw err;
console.log("創(chuàng)建集合!");
db.close(); }); });
與 MySQL 不同的是 MongoDB 會(huì)自動(dòng)創(chuàng)建數(shù)據(jù)庫和集合,所以使用前我們不需要手動(dòng)去創(chuàng)建。
以下實(shí)例我們連接數(shù)據(jù)庫 w3cschool的 site 表,并插入一條數(shù)據(jù)條數(shù)據(jù),使用 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("w3cschool");
var myobj = { name: "編程獅", url: "www.w3cschool" };
dbo.collection("site").insertOne(myobj, function(err, res)
{ if (err) throw err;
console.log("文檔插入成功");
db.close(); }); });
執(zhí)行以下命令輸出就結(jié)果為:
$ node test.js
文檔插入成功
從輸出結(jié)果來看,數(shù)據(jù)已插入成功。
我們也可以打開 MongoDB 的客戶端查看數(shù)據(jù),如:
> show dbs
w3cschool 0.000GB # 自動(dòng)創(chuàng)建了 w3cschool數(shù)據(jù)庫
> show tables
site # 自動(dòng)創(chuàng)建了 site 集合(數(shù)據(jù)表)
> db.site.find()
{ "_id" : ObjectId("5a794e36763eb821b24db854"), "name" : "編程獅", "url" : "www.w3cschool" }
>
如果要插入多條數(shù)據(jù)可以使用 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("w3cschool");
var myobj = [ { name: '編程獅工具', url: 'https://c.w3cschool.com', 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("插入的文檔數(shù)量為: " + res.insertedCount);
db.close();
});
});
res.insertedCount 為插入的條數(shù)。
可以使用 find() 來查找數(shù)據(jù), find() 可以返回匹配條件的所有數(shù)據(jù)。 如果未指定條件,find() 返回集合中的所有數(shù)據(jù)。
var MongoClient = require('mongodb').MongoClient;
var url = "mongodb://localhost:27017/";
MongoClient.connect(url, function(err, db) { if (err) throw err; var dbo = db.db("w3cschool");
dbo.collection("site"). find({}).toArray(function(err, result) {
// 返回集合中所有數(shù)據(jù)
if (err) throw err;
console.log(result);
db.close();
});
});
以下實(shí)例檢索 name 為 "編程獅" 的實(shí)例:
var MongoClient = require('mongodb').MongoClient;
var url = "mongodb://localhost:27017/";
MongoClient.connect(url, function(err, db) {
if (err) throw err; var dbo = db.db("w3cschool");
var whereStr = {"name":'編程獅'};
// 查詢條件
dbo.collection("site").find(whereStr).toArray(function(err, result)
{ if (err) throw err;
console.log(result);
db.close();
});
});
執(zhí)行以下命令輸出就結(jié)果為:
[ { _id: 5a794e36763eb821b24db854,
name: '編程獅',
url: 'www.w3cschool' } ]
我們也可以對(duì)數(shù)據(jù)庫的數(shù)據(jù)進(jìn)行修改,以下實(shí)例將 name 為 "編程獅" 的 url 改為 http://hgci.cn:
var MongoClient = require('mongodb').MongoClient;
var url = "mongodb://localhost:27017/";
MongoClient.connect(url, function(err, db) {
if (err) throw err; var dbo = db.db("w3cschool");
var whereStr = {"name":'編程獅'};
// 查詢條件
var updateStr = {$set: { "url" : "https://www.w3cschool.cn" }};
dbo.collection("site").updateOne(whereStr, updateStr, function(err, res) {
if (err) throw err;
console.log("文檔更新成功");
db.close();
});
});
執(zhí)行成功后,進(jìn)入 mongo 管理工具查看數(shù)據(jù)已修改:
> db.site.find().pretty()
{
"_id" : ObjectId("5a794e36763eb821b24db854"),
"name" : "編程獅",
"url" : "https://www.w3cschool.cn" // 已修改為 https
}
如果要更新所有符合條的文檔數(shù)據(jù)可以使用 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("w3cschool");
var whereStr = {"type":'en'};
// 查詢條件
var updateStr = {$set: { "url" : "https://www.w3cschool.cn" }};
dbo.collection("site").updateMany(whereStr, updateStr, function(err, res) {
if (err) throw err;
console.log(res.result.nModified + " 條文檔被更新");
db.close();
});
});
result.nModified 為更新的條數(shù)。
以下實(shí)例將 name 為 "編程獅" 的數(shù)據(jù)刪除 :
var MongoClient = require('mongodb').MongoClient;
var url = "mongodb://localhost:27017/";
MongoClient.connect(url, function(err, db) { if (err) throw err; var dbo = db.db("w3cschool");
var whereStr = {"name":'編程獅'};
// 查詢條件
dbo.collection("site").deleteOne(whereStr, function(err, obj) {
if (err) throw err;
console.log("文檔刪除成功");
db.close();
});
});
執(zhí)行成功后,進(jìn)入 mongo 管理工具查看數(shù)據(jù)已刪除:
> db.site.find()
>
如果要?jiǎng)h除多條語句可以使用 deleteMany() 方法
以下實(shí)例將 type 為 en 的所有數(shù)據(jù)刪除 :
var MongoClient = require('mongodb').MongoClient;
var url = "mongodb://localhost:27017/";
MongoClient.connect(url, function(err, db) {
if (err) throw err;
var dbo = db.db("w3cschool");
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 刪除的條數(shù)。
排序 使用 sort() 方法,該方法接受一個(gè)參數(shù),規(guī)定是升序(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("w3cschool");
var mysort = { type: 1 };
dbo.collection("site").find().sort(mysort).toArray(function(err, result) {
if (err) throw err;
console.log(result);
db.close();
}); });
如果要設(shè)置指定的返回條數(shù)可以使用 limit() 方法,該方法只接受一個(gè)參數(shù),指定了返回的條數(shù)。
var MongoClient = require('mongodb').MongoClient;
var url = "mongodb://localhost:27017/";
MongoClient.connect(url, function(err, db) {
if (err) throw err;
var dbo = db.db("w3cschool");
dbo.collection("site").find().limit(2).toArray(function(err, result) {
if (err) throw err;
console.log(result);
db.close();
}); });
如果要指定跳過的條數(shù),可以使用 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("w3cschool");
dbo.collection("site").find().skip(2).limit(2).toArray(function(err, result) {
if (err) throw err;
console.log(result);
db.close(); }); });
mongoDB 不是一個(gè)關(guān)系型數(shù)據(jù)庫,但我們可以使用 $lookup 來實(shí)現(xiàn)左連接。
例如我們有兩個(gè)集合數(shù)據(jù)分別為:
集合1:orders
[
{ _id: 1, product_id: 154, status: 1 }
]
集合2:products
[
{ _id: 154, name: '筆記本電腦' },
{ _id: 155, name: '耳機(jī)' },
{ _id: 156, name: '臺(tái)式電腦' }
]
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("w3cschool");
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("w3cschool");
// 刪除 test 集合
dbo.collection("test").drop(function(err, delOK) {
// 執(zhí)行成功 delOK 返回 true,否則返回 false
if (err) throw err; if (delOK) console.log("集合已刪除"); db.close(); }); });
Promise 是一個(gè) ECMAScript 6 提供的類,目的是更加優(yōu)雅地書寫復(fù)雜的異步任務(wù)。
如果你還不了解 Promise,可以參考 JavaScript Promise。
以下實(shí)例使用 Promise 創(chuàng)建集合:
const MongoClient = require("mongodb").MongoClient;
const url = "mongodb://localhost/w3cschool";
MongoClient.connect(url).then((conn) => { console.log("數(shù)據(jù)庫已連接");
var dbase = conn.db("w3cschool");
dbase.createCollection("site").then((res) => { console.log("已創(chuàng)建集合"); }).catch((err) => { console.log("數(shù)據(jù)庫操作錯(cuò)誤"); }).finally(() => { conn.close(); }); }).catch((err) => { console.log("數(shù)據(jù)庫連接失敗"); });
現(xiàn)在我們?cè)谝粋€(gè)程序中實(shí)現(xiàn)四個(gè)連續(xù)操作:增加 、查詢 、更改 、刪除。
const MongoClient = require("mongodb").MongoClient;
const url = "mongodb://localhost/";
MongoClient.connect(url).then((conn) => { console.log("數(shù)據(jù)庫已連接");
const test = conn.db("testdb").collection("test");
// 增加
test.insertOne({ "site": "w3cschool.cn" }).then((res) => {
// 查詢
return test.find().toArray().then((arr) => { console.log(arr); });
}).then(() => {
// 更改
return test.updateMany({ "site": "w3cschool.cn" }, { $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("數(shù)據(jù)操作失敗" + err.message); }).finally(() => { conn.close(); });
}).catch((err) => { console.log("數(shù)據(jù)庫連接失敗");
});
執(zhí)行結(jié)果:
數(shù)據(jù)庫已連接
[ { _id: 5f1664966833e531d83d3ac6, site: 'w3cschool.cn' } ]
[ { _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("數(shù)據(jù)庫已連接");
const test = conn.db("testdb").collection("test");
// 增加
await test.insertOne({ "site": "w3cschool.cn" });
// 查詢
var arr = await test.find().toArray(); console.log(arr);
// 更改
await test.updateMany({ "site": "w3cschool.cn" }, { $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("錯(cuò)誤:" + err.message); } finally { if (conn != null) conn.close();
} } dataOperate();
運(yùn)行結(jié)果:
數(shù)據(jù)庫已連接
[ { _id: 5f169006a2780f0cd4ea640b, site: 'w3cschool.cn' } ]
[ { _id: 5f169006a2780f0cd4ea640b, site: 'example.com' } ]
[]
運(yùn)行結(jié)果完全一樣。
很顯然,異步函數(shù)是一種非常良好的編程風(fēng)格,在多次使用異步操作的時(shí)候非常實(shí)用。
但是請(qǐng)勿在低于 7.6.0 版本的 node.js 上使用異步函數(shù)。
更多建議: