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

最新推荐文章于 2024-04-04 10:07:43 发布

weixin_34071713

最新推荐文章于 2024-04-04 10:07:43 发布

阅读量588

点赞数 1

文章标签：数据库前端 json ViewUI

原文链接：https://segmentfault.com/a/1190000015866331

版权

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

思考一个需求：做一个登录页面，自己搭建服务和数据库，将用户输入的登录信息保存到数据库
如何完成呢：首先选择一个应用框架，无论是 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>