【实战】用 express+MongoDB 搭建一个完整的前端项目

前言：要做一个全沾的工程师，对于后端和数据库来说，即使不认识也要见个面的。本文给的例子很简单，也贴出来源码，只要一步步下来，就可以跑起来啦~~~

思考一个需求：做一个登录页面，自己搭建服务和数据库，将用户输入的登录信息保存到数据库
如何完成呢：首先选择一个应用框架，无论是 express、koa、egg 都可以；然后是数据库选择，MySQL、MongoDB 都可以，Node.js 都支持连接；最后是插件和中间件的选择，将应用于数据库连接起来... 这是大致的思路，那本文以 express+MongoDB 为例建一个简单的程序，完成提出的需求。
数据库准备：MongoDB与可视化工具adminMongo的安装、启动与连接

一、MongoDB 数据库

数据库选择 MongoDB 是因为其结构与 JSON 数据格式很像。基本了解 MongoDB 的概念就好，主要是安装上数据库，并进行简单的增删操作。

SQL 与 MongoDB

更多学习：http://www.runoob.com/mongodb/

安装并运行

更详细的过程参考：MongoDB与可视化工具adminMongo的安装、启动与连接

• 下载：MongoDB网址 https://www.mongodb.com/downl...
• 配置：进入解压后的目录，为MongoDB添加默认的/data/db数据库存储目录 $ mkdir data/db
• 启动：进入bin目录下，启动 mongodb 数据库服务器 $ sudo ./mongod
• 访问：再通过localhost访问本地数据库$ ./mongo
• 一些常用的命令：
  数据库：show dbs ；use mytest ; db.dropDatabase()
  集合：show collections ; db.createCollection("mycollection") ; db.mycollection.drop()
  文档：db.mycollection.find() ; db.mycollection.insert({name:"xxx"}) ; db.mycollection.remove({'name':'xxx'})

二、adminMongo 可视化工具

选择一款可视化工具，能让你的数据库变得清晰，也可以选择其他的工具，这里安装的是adminMongo

• 下载adminMongo

  $  git clone https://github.com/mrvautin/adminMongo

• 安装并启动：

    $  cd adminMongo
    $  npm install
    $  npm start

• 连接本地数据库：mongodb://127.0.0.1:27017

三、mongoose 数据模型

直接用 node.js 也可以连接数据库进行读写，但很多插件除了封装这个基本功能之外，还提供了很多其他的服务。对于 MongoDB，我不会使用原生 node 去操作，而是选了 mongoose 这个插件。mongoose 官网: https://mongoosedoc.top/

• 安装了 node.js 建一个 test 项目文件夹，初始化 package.json

  $  npm init 

• 安装 mongoose

  $ npm install mongoose  --save-dev

• 新建一个js文件，用来写 mongoose 代码

   $  touch mongoose.js

• 连接数据库

  /* 
    mongoose.js ：建立数据库连接
   */
  var mongoose = require('mongoose') // 引入 mongoose
  var url = "mongodb://localhost:27017/mytest"; // 本地数据库地址
  mongoose.connect(url)
  
  // connect() 返回一个状态待定（pending）的连接，可以用来判断连接成功或失败
  var db = mongoose.connection; 
  db.on('error', console.error.bind(console, 'connection error:'));
  db.once('open', function() {
    console.log("Successful connection to "+url)
  });

  运行$ node mongoose.js 后输出：
  Successful connection to mongodb://localhost:27017/mytest

• 此时连接数据库成功，建立 Schema（Mongoose 定义的相当于 collection 集合的概念） ，写数据

  /*
    mongoose.js ：建立数据库连接用 mongoose.Schema 插入数据
   */
  var Schema = mongoose.Schema //schema 都会映射到一个 MongoDB collection
  
  let user = {
    name:String
  }
  
  var userSchema = Schema(user)
  var User = mongoose.model('User', userSchema); //将schema编译为model构造函数
  
  var newUser = new User({name: "yyyyyyyyyyyy"})// Mongoose 会自动找到名称是 model 名字复数形式的 collection
  newUser.save()
  

  运行$ node mongoose.js 后，可以通过 adminmongo 查看数据是否添加成功，也可以通过 terminal 命令查看。

  

• 补充说明：以下是 mongoose 的所有合法 SchemaTypes：
  常见的 String , Number , Date , Buffer , Boolean , Array ,
  Mixed： 一个啥都可以放的 SchemaType，虽然便利，但也会让数据难以维护，
  ObjectId：指定类型为 ObjectId，即“主键”，
  Decimal128：自定义的Type

四、Express 服务框架

mongoose 只是帮我们连接数据并进行读写，还需要启动一个服务框架，这个框架封装了 node 的 http 服务。

• 安装 express

  $ npm install express --save-dev

• 创建 express.js 应用Demo，启动服务接口

  /*
   express.js: 引入 express 模块，设置路由
  */
  var express = require('express')()
  
  express.get('/',function (request, response) { // 路由
    response.send("hello world!") // 传送HTTP响应
  })
  express.listen(3000) //监听3000端口，默认localhost: 127.0.0.1 || 0.0.0.0

  运行$ node express.js 后打开浏览器输入 http://localhost:3000/

五、完成一个表单提交

三四步骤完成后思路会清晰起来，现在只需要建立一个表单，提交数据到 express 提供的接口，express 接收到请求后通过 mongoose 访问数据库。

• express.js 导入 mongoose 模块，

  /*
    mongoose.js: 导出模块
   */
  module.exports = {mongoose,User}
  
  /*
    express.js: 引入 mongoose
   */
  var {mongoose, User} = require("./mongoose")
  

  *支持ES6需要

  $  npm install babel-core --save-dev

• 在express.js中创建一个请求数据的路由/接口

  /*
    express.js: 使用 mongoose 建立接口，添加数据到 MongoDB
   */    
  express.get("/addUser",function (request, response) {
    let data = {
      name: request.query.myinput
    }
    console.log(data)
    var addUser = new User(data)
    addUser.save()
    response.send(JSON.stringify(data))
  })

• 新建一个html，向 http://127.0.0.1:3000/addUser 发送 get 请求，提交数据。

  <!-- index.html -->
  <form action="http://127.0.0.1:3000/addUser" method="GET">
      <h1>随便输入：</h1>
      <input type="text" name="myinput">
      <input type="submit" value="Submit">
  </form>

• 运行$ node express.js 打开 index.html 文件：
  

  成功存储：
  

  在 adminMongo 中查看：
  

六、模板引擎与视图渲染

问题：html请求为什么带url和端口? 如何将html也放在 http://127.0.0.1:3000/ 地址下进行访问？

• 所有的应用框架都需要使用引擎才能将视图渲染输出为HTML！express 官网上默认模板引擎 jade，express 4+ 用 ejs，也可以自定义模板引擎进行视图渲染

• 安装模板引擎 ejs

  $  npm i ejs --save-dev

• 配置模板引擎，使用我们习惯的 html 类型的模板代替 ejs

  /*
   express.js: 配置引擎
  */
  express.set('views', './views'); // 添加视图路径
  express.engine('html', require('ejs').renderFile); // 将EJS模板映射至".html"文件
  express.set('view engine', 'html'); // 设置视图引擎
  

• 配置路由与渲染的模板

  /*
   express.js: 配置引擎
  */
  express.get('/view', function (request, response) {
    response.render('test')
  })

• 新建 views 文件夹与 test.html

  /*
   views/test.html
  */
  <h1>使用了模板引擎，可以直接看到我！</h1>
  <form action="/addUser" method="GET">
      <h1>随便输入：</h1>
      <input type="text" name="myinput">
      <input type="submit" value="Submit">
  </form>

• 打开浏览器访问：http://127.0.0.1:3000/view

  

• 注意此时数据的提交路径是 “/addUser” ，没有地址和端口号，数据也可以提交。

总结

• 整体的目录结构如下：
  
• 整个流程下来，可以直接复制代码跑一下，但要知道每个步骤需要做什么，最重要的是思路，其他的都是工具。

---

加油哦~ 少年！