Node.js 入门：Express + Mongoose 基础使用 | 林鑫的博客-前端博客-web前端技术

Node.js 入门：Express + Mongoose 基础使用

发表于 | 分类于 | 阅读数 | 喜欢数

Express 是基于 Node.js 平台的 web 应用开发框架，在学习了 Node.js 的基础知识后，可以使用 Express 框架来搭建一个 web 应用，实现对数据库的增删查改。

数据库选择 MongoDB，它是一个基于分布式文件存储的开源数据库系统，Mongoose 是 MongoDB 的对象模型工具，可以在异步环境里工作。

接下来就使用 Express + Mongoose 来实现简单的增删查改，在实现的过程中来学习 Express 和 Mongoose 的基础知识。

准备

既然是基于 Node.js 的框架，那么肯定需要装 node.js，还有 MongoDB，网上有很多安装教程。然后使用 express-generator 来快速生成一个 Express 项目。那么先安装一下 express-generator

1
npm install -g express-generator

然后初始化一个名为 express-demo 的项目

1
express express-demo

目前 Express 已经发布到了 4.x 版本，接下来也是基于这个版本来实现的。

1
2
3
cd express-demo
npm install
npm start

浏览器打开 http://localhost:3000 ，就可以看到已经可以访问了。

目录

1
2
3
4
5
6
├─bin/      // 启动文件
├─public/   // 资源文件
├─routes/   // 路由
├─views/    // 视图
├─app.js
└─package.json

初始化的项目目录简单明了，接下来我们来看看 app.js 里是写了什么。

1
2
3
// view engine setup
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'jade');

这是设置模板引擎，使用了 jade 模板引擎，views/ 目录下都是 .jade 格式文件，这种写法我并不熟悉，那么来改一下，改成 ejs 引擎，.html 格式的视图文件。（需要 npm 安装 ejs 模块）

1
2
3
4
5
var ejs = require('ejs');
// view engine setup
app.set('views', path.join(__dirname, 'views'));
app.engine('html', ejs.__express);
app.set('view engine', 'html');

实现

以上准备都好了之后，我们就来看看如何实现用户信息的增删查改。这里我们先把视图和路由搭建起来，能访问页面之后再来实现数据库操作的功能。

用户列表

在 view/ 视图目录下创建以下文件： UserList.html

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
<!DOCTYPE html>
<html>
<head>
    <title>用户列表页面</title>
</head>
<body>
    <table>
        <tr>
            <th>用户名</th>
            <th>邮箱</th>
            <th>操作</th>
        </tr>
        <% for(var i in user){ %>
            <tr>
                <td><%= user[i].username %></td>
                <td><%= user[i].email %></td>
                <td>
                    <div>
                        <a href="/users/detail/<%= user[i]._id %>"> 查看 </a>
                        <a href="/users/edit/<%= user[i]._id %>"> 编辑 </a>
                        <a href="#" class="del" data-id="<%= user[i]._id %>"> 删除 </a>
                    </div>
                </td>
            </tr>
        <% } %>
    </table>
</body>
</html>

<% %> 就是 ejs 模板引擎的语法，user 是在路由渲染页面的时候传过来的，它是如何传的，待会再看。
接下来实现上面视图对应的路由，项目中默认已经给我们生成了两个路由。在 routes/ 路由目录下已经有了两个路由文件：index.js 和 users.js。

app.js 中，已经帮我们设置好了这两个路由：

1
2
3
4
var index = require('./routes/index');
var users = require('./routes/users');
app.use('/', index);
app.use('/users', users);

只要浏览器访问 http://localhost:3000/users ，就能访问到 users 对应的页面了。我们来看看路由里 users.js 是如何写的。

1
2
3
4
5
6
7
8
var express = require('express');
var router = express.Router();
router.get('/', function(req, res, next) {
  res.send('respond with a resource');
});
module.exports = router;

express.Router 类创建模块化、可挂载的路由句柄。我们修改上面代码来创建用户列表的路由 users/list

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
var express = require('express');
var router = express.Router();
router.get('/', function(req, res, next) {
  res.send('respond with a resource');
});
router.get('/list', function(req, res, next) {
  var list = [{_id: 1, username: 'linxin', email: '123123@qq.com'}];
  res.render('UserList',{
      user: list
  })
});
module.exports = router;

还记得在 UserList.html 视图中的 user 变量吗，这里用到了 res.render() 响应方法，功能就是渲染视图模板，第一个参数为视图文件名，第二个参数为对象，用于向模板中传递数据，user 就是在这里传过去的。更改完路由之后重启服务器，访问 http://localhost:3000/users/list 就可以看到用户列表页面了。

但是这用户信息是写死的，要怎么从数据库中读取呢？

连接数据库

我们这里用到了 Mongoose，需要先安装 npm install mongoose -S 。安装之后在项目中引入并连接到数据库 userdb

1
2
3
var mongoose = require('mongoose');
mongoose.Promise = global.Promise;
mongoose.connect('mongodb://localhost:27017/userdb', {useMongoClient: true});

连接成功之后，定义一个 Schema，它一种以文件形式存储的数据库模型骨架，不具备数据库的操作能力。

1
2
3
4
var userSchema = new mongoose.Schema({
    username: String,
    email: String
})

这里的 userSchema 还不能对数据库进行操作，只是定义了数据模型属性 username, email 为字符串类型。需要将该 Schema 发布为 Model，Model 是由 Schema 发布生成的模型，具有抽象属性和行为的数据库操作对。

1
var model = mongoose.model('user', userSchema);

最后 model 就可以对数据库进行操作了，把上面的代码封装成 userModel.js 到根目录下新建一个 models/ 目录下面，用 module.exports = model; 将 model 暴露出来供其他文件使用。

在 user.js 路由文件里，我们来引入 userModel.js 进行数据库操作。

1
2
3
4
5
6
7
8
9
10
var userModel = require('../models/userModel.js');
router.get('/list', function(req, res, next) {
  userModel.find(function(err, data){
    if(err){ return console.log(err) }
    res.render('UserList',{
      user: data
    })
  })
});

这里使用 userModel.find() 查询到所有用户。但是现在数据库里还是空的，我们来新增一个添加用户页面向数据库里插入数据。

添加用户

在 views/ 目录下新建 UserAdd.html 添加用户视图

1
2
3
4
5
6
7
8
9
10
11
12
13
<!DOCTYPE html>
<html>
<head>
    <title>用户编辑页面</title>
</head>
<body>
    <form action="/users/add" method="post">
        <input type="text" name="username" value="">
        <input type="email" name="email" value="">
        <button type="submit">submit</button>
    </form>
</body>
</html>

在 user.js 路由文件里来添加对应视图的路由

1
2
3
router.get('/add', function(req, res, next) {
  res.render('UserAdd');
});

这是渲染视图页面的路由，我们需要添加一个 post 方法的路由，在点击提交按钮的时候，把数据存进数据库里。

1
2
3
4
5
6
7
8
9
10
router.post('/add', function(req, res, next) {
  var newUser = new userModel({
    username: req.body.username,
    email: req.body.email
  })
  newUser.save(function(err, data){
    if(err){ return console.log(err) }
    res.redirect('/users/list');
  })
});

这里使用 new userModel() 创建了一个 Entity，它是由 Model 创建的实体，它的操作也会影响数据库。newUser 调用 save() 方法将数据保存到数据库中。然后 res.redirect() 将页面重定向到用户列表页面，这时就可以看到我们新增的用户显示在列表中了。接下来我们看看如何来编辑用户信息。

编辑用户

依然是创建相应的用户编辑视图：UserEdit.html

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<!DOCTYPE html>
<html>
<head>
    <title>用户编辑页面</title>
</head>
<body>
    <form action="/users/update" method="post">
        <input type="hidden" name="id" value="<%= user._id %>">
        <input type="text" name="username" value="<%= user.username %>">
        <input type="email" name="email" value="<%= user.email %>">
        <button type="submit">update</button>
    </form>
</body>
</html>

添加对应的路由：/users/edit/:id 来渲染视图，/users/update 来修改数据库数据

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
router.get('/edit/:id', function (req, res, next) {
  var id = req.params.id;
  userModel.findOne({_id: id}, function (err, data) {
    res.render('UserEdit', {
      user: data
    })
  })
});
router.post('/update', function (req, res, next) {
  var id = req.body.id;
  userModel.findById(id, function (err, data) {
    if(err){ return console.log(err); }
    data.username = req.body.username;
    data.email = req.body.email;
    data.save(function(err){
      res.redirect('/users/list');
    })
  })
});

userModel.findOne() 会根据查询条件 {_id: id} 查询到对应的一条数据，那么同理，查看用户详情的实现也是如此，只是渲染你到另外一个模板而已，这里就不重复写了；userModel.findById() 查询到 data 对象，该对象也属于 Entity，有 save() 操作。req.body.username 就可以获取到我们修改后的 username，修改 data 对象之后调用 save() 方法保存到数据库中。接下来看看如何删除用户吧。

删除用户

在用户列表中，点击删除按钮，就把该用户从数据库中给删除了，不需要视图，那直接写路由吧。

1
2
3
4
5
6
7
router.delete('/del', function (req, res) {
  var id = req.query.id;
  userModel.remove({_id: id}, function (err, data) {
    if(err){ return console.log(err); }
    res.json({code: 200, msg: '删除成功'});
  })
})

点击按钮，发送删除的请求，那我们可以使用 ajax 来实现。在用户列表页面引入 jquery，方便我们操作。然后添加 ajax 请求

1
2
3
4
5
6
7
8
$('.del').on('click',function(){
    var id = $(this).data('id');
    $.ajax({
        url: '/users/del?id='+id,
        type: 'delete',
        success: function (res) { console.log(res); }
    })
})

重启服务器，进入 users/list，点击删除按钮，如果看到控制台中已经打印了 {code: 200, msg: ‘删除成功’} ，表示已经成功删除了，这时我们刷新页面，看看列表中确实已经不存在该用户了。

代码地址: express-demo

总结

通过对用户的增删查改，学习如何写路由已经如何操作数据库。我们来总结一下：

  1. 定义 Schema，由 Schema 发布 Model 来操作数据库。
  2. Model 创建的实体 Entity，可以调用 save() 方法将数据保存到数据库中。
  3. Model.find() 方法查询到该 Schema 下的所有数据，findOne() 根据条件查询数据，findById() 根据 id 查询数据。
  4. Model.remove() 删除数据。