一、安裝 MongoDB
1. 在 Windows 環境下安裝：
// Windows 7 / Server 2008 R2 以上的版本
打開官網鏈接 https://www.mongodb.com/try/download/community
在頁面中依次選擇 On-Premises => MongoDB Communtiy Server，然后選擇 Platform 為 Windows，最后下載并執行安裝包
1. 在 MacOS 安裝：
也可以按照上面的方法下載安裝包，或者選擇 Download 按鈕旁的 Copy Link，通過 curl 命令安裝
不過還有另一種不需要打開 MongoDB 官網的辦法：直接使用 brew 安裝（參考鏈接）
首先 tab 倉庫
brew tap mongodb/brew
然后安裝社區版本
brew install mongodb-community
安裝的時候會自動創建組態檔：
- 組態檔: /usr/local/etc/mongod.conf
- 日志目錄: /usr/local/var/log/mongodb
- 資料目錄: /usr/local/var/mongodb
可以用 mongod --version 命令來檢查是否安裝成功
如果能正常顯示當前版本，就說明安裝成功，可以直接進入下一節
如果提示 "command not found: mongod" ，就得手動配置環境變數
需要先找到 mongod 的安裝位置，由于安裝的版本不同，路徑不會完全一致，可以一步一步的來找：
先進入 Cellar 目錄：
cd /usr/local/Cellar
然后通過 ls 命令查看當前目錄下的檔案，然后進入帶有 mongodb 的檔案夾，然后逐步深入，直到進入 bin 檔案夾，使用 pwd 命令查看完整路徑
記下這個路徑備用，打開環境變陣列態檔
vim ~/.bash_profile
添加一行變數（把路徑改成自己的路徑）
export PATH=/usr/local/Cellar/mongodb-community/4.2.8/bin:${PATH}}
保存檔案，執行以下命令
source ~/.bash_profile
然后就可以使用 mongod 命令了
二、啟動 MongoDB
如果直接啟動
mongod
會直接報錯 Data directory /data/db not found
這是因為使用不帶引數的 mongod 命令會使用默認的資料目錄 /data/db
如果使用之前創建的組態檔啟動就不會有問題：
mongod --config /usr/local/etc/mongod.conf
如果覺得這樣的啟動命令很累贅，就創建一個 /data/db 目錄
sudo mkdir -p /data/db
然后就能使用 mongod 命令啟動了，
// 如果遇到 Address already in use 這個錯誤，是因為埠號占用，清理對應埠的 pid 即可
可以在瀏覽器訪問 localhost:27017 確認是否成功啟動
如果需要關閉服務器，可以使用 Crtl + C 組合鍵
這個啟動 mongod 的終端可以放在一邊了，新起一個終端，打開 MongoDB shell
mongo
注意這個命令不是 mongod
在啟動的 shell 里面輸入 help，查看可用的命令
如果不想使用命令列來操作 MongoDB，可以使用可視化工具，比如 Robomongo、Nosqlclient、Navicat
三、MongoDB 創建資料
接下來在 MongoDB 中插入資料，首先創建一個資料庫
use Movie
這里創建了一個名為 Movie 的資料庫，但這時的 Movie 資料庫還沒有資料，所以 show dbs 不會列出剛才創建的資料庫
在當前資料庫中創建一個集合，并插入一條資料
db.createCollection("movies")
db.movies.insert({"name":"讓子彈飛","years":"2010","director": ["姜文"]})
注意: 和創建資料庫類似，在 MongoDB 中，創建集合后要再插入一個檔案，集合才會真正創建
當插入了具體的資料之后，資料庫才算創建完成，接下來了解一下基本的增刪改查
1. 新增資料
在 MongoDB 中可以使用 insert 向集合插入資料，每條新建的資料都會自動生成一個主鍵 _id
使用 insert 插入資料時，如果沒有攜帶主鍵 _id，則新增資料；
如果攜帶了 _id 且 _id 沒有重復，則新增一條自帶 _id 的資料（不會自動生成 _id）；
如果攜帶了 _id 且 _id 沖突，則拋出“主鍵重復”的錯誤，保存失敗，
2. 查詢資料
在 MongoDB 中查詢資料一般使用 find 方法
db.movies.find().pretty()
這里的 pretty() 用來格式化查詢結果
在查詢條件中，還可以加入條件判斷
3. 更新資料
在 MongoDB 中使用 update 和 replaceOne 來更新集合中的檔案
其中 update() 可以接收三個引數
第一個引數為查詢條件，和上面的 find 類似；
第二個引數為運算子，比如 $set 用來設定新屬性；
第三個引數為配置項，暫時不提，
這里我先新增了一條資料，然后通過 update 修改了這條資料的 name
可以看到，只有 name 被修改了，years 并沒有發生變化，也就是說 update() 的 $set 只會合并相應的欄位
如果需要替換整條資料，可以用 replaceOne()
4. 洗掉資料
可以使用 remove 來洗掉集合中的資料
該方法和 find 類似，都是接受一個查詢條件，然后從集合中洗掉查詢到的檔案
remove 的 query 引數是必填的，如果往 remove 方法中傳入的查詢條件為空物件 {}，會洗掉整個集合的資料
另外， 可以使用 drop 來洗掉集合，dropDatabase 來洗掉資料庫
db.collection.drop()
db.dropDatabase()
關于 MongoDB 的介紹就到這里，深入了解可以參考 MongoDB 中文網
四、在 Koa 中連接 MongoDB
先創建一個 Koa 專案，可以參考之前的文章《Node.js 蠶食計劃（五）—— Koa 基礎專案搭建》
在專案的根目錄創建一個 mongodb 目錄，然后在該目錄下新建 config.js，用來保存一些資料庫常量配置
// /mongodb/config.js
const dbUrl = 'mongodb://127.0.0.1:27017'; // 資料庫地址
const dbName = 'Movie'; //資料庫名稱
module.exports = {
dbUrl,
dbName
}
然后安裝 mongodb 中間件
yarn add mongodb
在 mongodb 目錄下創建一個 index.js，使用中間件連接 MongoDB 資料庫
// /mongodb/index.js
const { MongoClient, ObjectID} = require('mongodb');
const { dbUrl, dbName } = require('./config');
// 連接資料庫
MongoClient.connect(dbUrl, (err, client) => {
console.log("Connected successfully to server");
const db = client.db(dbName);
// db.close(); // 關閉連接
});
我的專案結構是這樣的，其中 app.js 是入口檔案
可以在 app.js 中 require('./mongodb') 直接引入剛才的 index.js，檢查一下是否能夠正常連接資料庫
啟動專案，如果在 MongoDB 的終端看到連接的提示，則表示成功連接資料庫
五、封裝 MongoDB 類
實際場景中肯定不會每次查詢都呼叫一次資料庫，所以需要封裝一個類，通過類的實體來操作資料庫
// /mongodb/index.js
const { MongoClient, ObjectID } = require("mongodb");
const Config = require("./config");
class Db {
static getInstance() {
// 單例模式 解決多次實體化 實體不共享的問題
if (!Db.instance) {
Db.instance = new Db();
}
return Db.instance;
}
constructor() {
this.dbClient = ""; //db物件
this.connect(); // 實體化的時候就連接資料庫
}
connect() {
// 連接資料庫
return new Promise((resolve, reject) => {
if (!this.dbClient) {
//解決資料庫多次連接的問題
MongoClient.connect(Config.dbUrl, { useUnifiedTopology: true }, (err, client) => {
if (err) {
reject(err);
return;
}
this.dbClient = client.db(Config.dbName);
resolve(this.dbClient);
});
} else {
resolve(this.dbClient);
}
});
}
//查找操作 collection：表名 json：查找條件
find(collection, json) {
return new Promise((resolve, reject) => {
this.connect().then((db) => {
let result = db.collection(collection).find(json);
result.toArray((err, docs) => {
if (!err) {
resolve(docs);
} else {
reject(err);
}
});
});
});
}
//新增操作
insert(collection, json) {
return new Promise((resolve, reject) => {
this.connect().then((db) => {
db.collection(collection).insertOne(json, (err, result) => {
if (!err) {
resolve(result);
} else {
reject(err);
}
});
});
});
}
//修改操作
update(collection, json1, json2) {
return new Promise((resolve, reject) => {
this.connect().then((db) => {
db.collection(collection).updateOne(
json1,
{
$set: json2,
},
(err, result) => {
if (!err) {
resolve(result);
} else {
reject(err);
}
}
);
});
});
}
//洗掉操作
delete(collection, json) {
return new Promise((resolve, reject) => {
this.connect().then((db) => {
db.collection(collection).removeOne(json, (err, result) => {
if (!err) {
resolve(result);
} else {
reject(err);
}
});
});
});
}
//在進行查詢或者洗掉操作的時候，我們一般都會通過id去進行操作，但是我們直接使用傳遞過來的id是不起作用的，需要使用mongodb提供的ObjectID方法，生成一個新的id去查詢，
getObjectID(id) {
return new ObjectID(id);
}
}
module.exports = Db.getInstance();
// 代碼摘自 https://juejin.im/post/5e4765626fb9a07cad3b93dc#heading-24
封裝好了，在 app.js 試試
//...
const bodyParser = require('koa-bodyparser');
const DB = require('./mongodb');
//...
app.use(bodyParser());
router.post('/save', async(ctx, next) => {
const form = ctx.request.body;
console.log('form------>', form);
const result = await DB.insert('movies', form); // 新增
ctx.body = result;
});
router.get('/list', async(ctx, next) => {
const result = await DB.find('movies', {}); // 查詢
ctx.body = result;
});
//...
上面引入了 koa-bodyparser 來處理 POST 請求的引數
然后寫了一個新增資料的 post 介面 /save，和查詢資料的 get 介面 /list
接下來先用 PostMan 測驗一下 /save 介面
這里傳的引數是 JSON 格式，需要在 Headers 中設定 Content-Type 為 application/json
如果設定為 application/x-www-form-urlencoded，就需要用 querystring 轉碼
保存成功之后，再試試 /list 介面
到這里一個簡單的后端服務就搭好了
但這里我們直接使用了 mongodb 中間件來連接資料庫，對資料庫的操作比較原始
一個工程化的后端專案，通常會設計 Controller 來管理 API，還會通過 Schema 來規范集合
這些都可以通過 使用 mongoose 來實作，在后面的文章中會介紹
參考資料：
《MongoDB 中文手冊》
《koa2 + jwt + mongodb入門實戰》
轉載請註明出處，本文鏈接：https://www.uj5u.com/qiye/36858.html
標籤：JavaScript