Node.js 蠶食計劃（六）—— MongoDB + Koa 入門

来源:https://www.cnblogs.com/wisewrong/archive/2020/07/15/13280266.html
-Advertisement-
Play Games

一、安裝 MongoDB 1. 在 Windows 環境下安裝： // Windows 7 / Server 2008 R2 以上的版本 打開官網鏈接 https://www.mongodb.com/try/download/community 在頁面中依次選擇 On-Premises => Mon ...


一、安裝 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入門實戰》


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • Android —— EventBus使用簡介
    參考博客：https://blog.csdn.net/harvic880925/article/details/40660137 EventBus簡介 EventBus有哪些優點 Demo案例分享及問題解決 一、什麼是EventBus 由greenboot組織貢獻(該組織還貢獻了greenDAO), ...
  • Flutter Weekly Issue 64
    教程 必讀 | 深入理解佈局約束 插件 elastic-widgets Set of Flutter widgets built using physics based animations. timeago.dart A library useful for creating fuzzy time ...
  • JS寄快遞地址智能解析
    JS寄快遞地址智能解析——2020年7月15日 去年做了些前端內容，最近在整理一些稍微有點用的內容，比如智能解析地址，用戶只要輸入：張三1351111111江蘇省揚州市廣陵區XX小區X樓xxx室,就能解析出 姓名、電話、省市區、地址信息了。是不是很方便？ 項目地址暫時沒有放，大家可以關註我的個人碼雲 ...
  • 小火箭返回頂部
    網頁中常常會有一個 返回頂部的功能，恰巧我這天寫到了，在網上找了一下思路，下麵就寫了一個案例： 效果預覽：https://li_shang_shan.gitee.io/small_rocket_back_to_top。 代碼就直接粘貼了： <html> <head> <meta charset="u ...
  • 詳解JS中定時器setInterval和setTImeout的this指向問題
    詳解JS中定時器setInterval和setTImeout的this指向問題 ...
  • jQuery加PHP實現圖片上傳並提交
    圖片上傳思路：通過ajax實現圖片上傳，然後把PHP返回的圖片地址，加入到隱藏欄位中，最後通過表單提交給後臺PHP，代碼如下 HTML代碼 zimg.html文件： <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <met ...
  • 循序漸進VUE+Element 前端應用開發(18）--- 功能點管理及許可權控制
    在一個業務管理系統中，如果我們需要實現許可權控制功能，我們需要定義好對應的許可權功能點，然後在界面中對界面元素的功能點進行綁定，這樣就可以在後臺動態分配許可權進行動態控制了，一般來說，許可權功能點是針對角色進行控制的，也就是簡稱RBAC（Role Based Access Control）。在前面隨筆中，我... ...
  • 面試了幾個前端，給爺整哭了！
    長沙這邊面試了幾個三年的前端，給我整哭了， 簡歷簡歷不帶，問點基礎題，一問三不知， 問個水平垂直居中佈局，支支吾吾半天說不出來， 還有個弟弟說你這樣問我不知道怎麼回答，累了。 我只想說，這真的有三年的經驗嘛？ 如果有收穫？希望老鐵們來個三連，點贊、收藏、轉發 創作不易，別忘點個贊，可以讓更多的人看到 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類