深入浅出mongodb之实战

2020-09-21 15:48:51 浏览数 (1)

人的一生就像一篇文章,只有经过多次精心修改,才能不断完善。

前言

再好的东西不使用它,他终究不属于你,只有我们真正的把它运用到实际,真正的理解它,才能发挥它的最大作用正所谓实践出真理深入浅出mongodb(一)深入浅出mongodb(二)两篇文章讲述了一些安装和使用的基础知识,这篇文章小编将带你走进实战世界,真正体会项目中是怎么使用mongodb开发,让我们一起揭开它神秘的面纱。

准备工作

项目中我们用到的是基于nodeexpress[1] 框架

代码语言:javascript复制
npm i express-generator -g

express-generator是一个express的应用生成器,可以快速的创建一个express应用。

安装完成上述指令之后,我们可以检查一下安装的express是否能用

代码语言:javascript复制
express --version

接着我们就可以创建项目了,在创建项目的时候可以先express -h来查看一下,express命令的参数

代码语言:javascript复制
$ express -h

  Usage: express [options] [dir]

  Options:

        --version        output the version number
    -e, --ejs            add ejs engine support
        --pug            add pug engine support
        --hbs            add handlebars engine support
    -H, --hogan          add hogan.js engine support
    -v, --view <engine>  add view <engine> support (dust|ejs|hbs|hjs|jade|pug|twig|vash) (defaults to jade)
        --no-view        use static html instead of view engine
    -c, --css <engine>   add stylesheet <engine> support (less|stylus|compass|sass) (defaults to plain css)
        --git            add .gitignore
    -f, --force          force on non-empty directory
    -h, --help           output usage information

在默认的情况下,我们创建的项目模板引擎使用的是jade,个人感觉ejs[2]模板引擎比较好用,所以我们可以通过修改模板引擎的方式创建项目

代码语言:javascript复制
express backend -e

创建好项目之后,我们express骨架已经搭建好了,我们可以启动项目看一下效果

代码语言:javascript复制
cd backend
npm i
npm start

如果出现下面的结果说明我们的启动成功了

代码语言:javascript复制
$ npm start

> backend@0.0.0 start C:UsersDELLDesktopbackend
> node ./bin/www

这个时候我们打开项目先熟悉一下项目目录

  • bin是启动目录,里面有一个www启动文件,默认的端口是3000,如果不合适我们可以手动修改
  • node_modules这个目录下面是我们安装的所有依赖
  • pubilc这个文件夹下是我们前端存放静态资源的
  • routes这个文件是存放路由的,主要编写前端发送请求和响应数据给前端
  • views这个文件夹中ejs文件结尾的文件是后端的模板文件
  • app.js是入口文件,模板配置和总路由文件
  • package.json 这个是包的描述文件,我们主要关注的是scriptsdependencies

我们在执行node文件的时候,如果修改了node文件,每次执行都需要重新启动项目才行,为了方便我们可以使用nodemon来监听项目的改动,不再需要重复启动项目,这么方便的东西用起来能不香吗??

代码语言:javascript复制
npm i nodemon -g
代码语言:javascript复制
//package.json
"scripts": {
    "start": "nodemon ./bin/www"
 },

完成上述的操作之后,我们启动项目npm start

数据库

安装

代码语言:javascript复制
npm i mongoose -S

完成安装之后我们需要在app.js里引入并且配置数据库

代码语言:javascript复制
//app.js
//引入数据库
const mongoose = require('mongoose');
//连接数据库
mongoose.connect(`mongodb://localhost:27017/test`,{
        useNewUrlParser: true,
        useUnifiedTopology: true 
});

设置跨域

在开发中,我们采用的都是前后端分离的状态,在本地的开发环境中我们无法避免的会遇到跨域[3]的情况,我们这里设置允许所有的源访问

代码语言:javascript复制
app.use("/*", function (req, res, next) {
  //设置headers
  res.header("Access-Control-Allow-Origin", "*");
  res.header("Access-Control-Allow-Methods", "GET,PUT,POST,DELETE,OPTION");
  //自定义请求头
  res.header(
    "Access-Control-Allow-Headers",
    "Content-type,Accept,X-Access-Token,X-Key"
  );
  if (req.method == "OPTIONS") {
    res.status(200).end();
  } else {
    next();
  }
});

OPTIONS这个是预检请求,如果遇到了不同源请求时,会先询问来自哪个源对源进行检查之后,做出响应。

实际上在真正的开发环境中,如果我们这么设置允许所有的的源都可以访问会有很多问题,我们可以使用cors[4]来代替它

当然如果在生产中我们采用nginx部署之后,就不存在跨域了?

接下来就是我们平时常说的mvc模式下的mc部分了,为了结构清晰,便于维护我们分成四部分scheme,model,controller,api

scheme

在项目的根目录下创建scheme文件夹,因为这里项目简单我们就创建一个index.js文件,当然如果项目模块和功能比较多的话,我们可以按照功能来创建文件,因人而异。

代码语言:javascript复制
const mongoose = require("mongoose");
const Scheme = mongoose.Schema;

const ObjectId = mongoose.Types.ObjectId;

//物品表
const gooseScheme = Scheme({
  id: ObjectId,
  name: String,
  age: Number,
  image: String,
  price: Number,
  description: String,
  user: {
    type: ObjectId,
    ref: "User",
  },
});

//用户表
const  userScheme= Scheme({
  id: ObjectId,
  name: String,
});

module.exports = { gooseScheme, userScheme };

model

在项目的根目录下创建model的文件夹,创建index.js文件:

代码语言:javascript复制
const mongoose = require("mongoose");
const model = mongoose.model.bind(mongoose);
const scheme = require("../scheme");

const { gooseScheme, userScheme } = scheme;

const GooseModel = model("Goose", gooseScheme);
const UserModel = model("User", userScheme);

module.exports = { GooseModel, UserModel };

controller

在项目的根目录下创建controller的文件夹,根据功能我们创建userController.jsgooseController.js

代码语言:javascript复制
//userController.js
const Model = require("../model");
const { UserModel } = Model;

const userController = {
  all(req, res) {
    UserModel.find({}).then(docs => res.json(docs));
  },
  create(req, res) {
    const requestBody = req.body;
    const newUserModel = new UserModel(requestBody);

    newUserModel.save((err, save) => {
      UserModel.findOne({ _id: save._id }).then((docs) => res.json(docs));
    });
  },
  byId(req, res) {
    const idParams = req.params.id;

    UserModel.findOne({ _id: idParams }).then((docs) => res.json(docs));
  },
  update(req, res) {
    const idParams = req.params.id;
    let requestBody = req.body;

    UserModel.updateOne({ _id: idParams }, { ...requestBody }, (err, docs) => {
      res.json(docs);
    });
  },
  remove(req, res) {
    const idParams = req.params.id;

    UserModel.findOne({ _id: idParams }).remove((err, docs) =>
      res.json(idParams)
    );
  },
};

module.exports = userController;

代码语言:javascript复制
//gooseController.js
const Model = require("../model");
const { GooseModel } = Model;

const gooseController = {
  all(req, res) {
    GooseModel
      .find({})
      .populate("user")
      .then(docs=> res.json(docs));
  },
  byId(req, res) {
    const idParams = req.params.id;

    GooseModel
      .findOne({ _id: idParams })
      .populate("user")
      .then((docs) => res.json(docs));
  },
  create(req, res) {
    const requestBody = req.body;
    const newGooseModel = new GooseModel(requestBody);

    newGooseModel.save((err, saved) => {
        console.log(saved);
        GooseModel
        .findOne({ _id: newGooseModel._id })
        .populate("user")
        .then((docs) => res.json(docs));
    });
  },
  update(req, res) {
    const idParams = req.params.id;
    const requestBody = req.body;

    GooseModel.updateOne({ _id: idParams }, { ...requestBody }, (err, docs) => {
      res.json(docs);
    });
  },
  remove(req, res) {
    const idParams = req.params.id;

    gooseModel
      .findOne({ _id: idParams })
      .remove((err, docs) => res.json(idParams));
  },
};

module.exports = gooseController;

api

在express中有这么一句话一切皆为中间件,我们在设置路由的时候,需要在app.js中注册之后才能使用

代码语言:javascript复制
//app.js
var api = require("./routes/api");
app.use("/api",api)

配置routes文件夹下的api.js文件

代码语言:javascript复制
const express = require("express");
const router = express.Router();

const gooseController = require("../controller/gooseController");
const userContoller = require("../controller/userController");

router.get('/user',userContoller.all);
router.get('/user/:id',userContoller.byId);
router.post('/user', userContoller.create);
router.put('/user/:id', userContoller.update);
router.delete('/user/:id', userContoller.remove);


router.get('/goose', gooseController.all);
router.get('/goose/:id', gooseController.byId);
router.post('/goose', gooseController.create);
router.put('/goose/:id', gooseController.update);
router.delete('/goose/:id', gooseController.remove);

module.exports = router

成果

我们完成上面的步骤之后,我们需要自测试一下接口和逻辑是否正确

查询人员

localhost:3000/api/user get

新增人员

localhost:3000/api/user post

删除人员

localhost:3000/api/user/:id delete

新增物品

localhost:3000/api/goose post

查询物品及所属人员

localhost:3000/api/goose get

最后

本文结束,有什么问题和有错误的地方,欢迎大家的留言和评论,还有后续更新,下期更加精彩 ???

参考资料

[1]

express: https://www.expressjs.com.cn/

[2]

ejs: https://ejs.bootcss.com/

[3]

跨域: http://www.ruanyifeng.com/blog/2016/04/cors.html

[4]

cors: https://www.npmjs.com/package/cors

0 人点赞