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

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

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

一、MongoDB 数据库

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

SQL 与 MongoDB

clipboard.png

更多学习: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 命令查看。

    clipboard.png

  • 补充说明:以下是 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/

clipboard.png

五、完成一个表单提交

三四步骤完成后思路会清晰起来,现在只需要建立一个表单,提交数据到 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 文件:
    clipboard.png

    成功存储:
    clipboard.png

    在 adminMongo 中查看:
    clipboard.png

六、模板引擎与视图渲染

问题: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

    clipboard.png

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

总结

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

加油哦~ 少年!

阅读 3.8k更新于 2018-12-22
推荐阅读
前端工程化之路
用户专栏

只要投入时间,一切都很简单。

33 人关注
17 篇文章
专栏主页
目录