教程 > Express.js 中文教程 > Express 基础阅读：229

Express.js 数据库

我们正在接收请求，但没有将它们存储在任何地方。我们需要一个数据库来存储数据。我们将使用一个名为 MongoDB 的著名 NoSQL 数据库。

为了在 Koa 中使用 Mongo，我们需要一个用于 Node 的客户端 API。我们有多种选择，但是对于本教程，我们将坚持使用 mongoose。 Mongoose 用于 Node for MongoDB 中的文档建模。文档建模意味着，我们将创建一个模型（很像面向文档的编程中的一个类），然后我们将使用这个模型生成文档（就像我们在 OOP 中创建一个类的文档）。我们所有的处理都将在这些“文档”上完成，最后，我们会将这些文档写入我们的数据库中。

设置 Mongoose

现在我们已经安装了 Mongo，让我们安装 mongoose，就像我们安装其他节点包一样。

$ npm install --save mongoose

在我们开始使用 mongoose 之前，我们必须使用 Mongo shell 创建一个数据库。要创建新数据库，请打开终端并输入“mongo”。 Mongo shell 将启动，输入以下内容。

use my_db

这将为我们创建一个新的数据库。每当打开 Mongo shell 时，它将默认为“test”db，则必须使用与上述相同的命令更改为我们的数据库。

要使用 mongoose，我们需要在 app.js 文件中使用它，然后连接到运行在 mongodb://localhost 上的 mongod 服务

var mongoose = require('mongoose');
mongoose.connect('mongodb://localhost/my_db');

现在我们的应用程序已连接到我们的数据库，让我们创建一个新模型。这个模型将作为我们数据库中的一个集合。要创建新模型，请在定义任何路由之前使用以下代码

var personSchema = mongoose.Schema({
   name: String,
   age: Number,
   nationality: String
});
var Person = mongoose.model("Person", personSchema);

上面的代码定义了一个 Person 的模式，并用于创建一个 mongoose 模型 Person。

保存文档

现在我们将创建一个新的 html 表单，它将获取一个人的详细信息并将其保存到我们的数据库中。要创建表单，请在 views 目录中创建一个名为 person.pug 的新视图文件，其中包含以下内容。

html
   head
      title Person
   body
      form(action = "/person", method = "POST")
         div
            label(for = "name") Name: 
            input(name = "name")
         br
         div
            label(for = "age") Age: 
            input(name = "age")
         br
         div
            label(for = "nationality") Nationality: 
            input(name = "nationality")
         br
         button(type = "submit") Create new person

还要在 index.js 中添加一个新的 get 路由来呈现这个文档。

app.get('/person', function(req, res){
   res.render('person');
});

我们现在将在 '/person' 处定义一个 post 路由处理程序来处理这个请求。

app.post('/person', function(req, res){
   var personInfo = req.body; //Get the parsed information
   
   if(!personInfo.name || !personInfo.age || !personInfo.nationality){
      res.render('show_message', {
         message: "Sorry, you provided worng info", type: "error"});
   } else {
      var newPerson = new Person({
         name: personInfo.name,
         age: personInfo.age,
         nationality: personInfo.nationality
      });
        
      newPerson.save(function(err, Person){
         if(err)
            res.render('show_message', {message: "Database error", type: "error"});
         else
            res.render('show_message', {
               message: "New person added", type: "success", person: personInfo});
      });
   }
});

在上面的代码中，如果我们收到任何空字段或没有收到任何字段，我们将发送错误响应。但是，如果我们收到一个格式正确的文档，那么我们会从 Person 模型创建一个 newPerson 文档，并使用 newPerson.save() 函数将它保存到我们的数据库中。这是在 mongoose 中定义的，并接受回调作为参数。这个回调有两个参数，错误和响应。这将呈现 show_message 视图，因此我们也需要创建它。

要显示来自该路由的响应，我们还需要创建一个 show_message.pug 视图。使用以下代码创建一个新视图。

html
   head
      title Person
   body
      if(type = "error")
         h3(style = "color:red") #{message}
      else
         h3 New person, name: 
            #{person.name}, age: 
            #{person.age} and nationality: 
            #{person.nationality} added!

检索文档

Mongoose 提供了很多用于检索文档的功能，我们将重点介绍其中的三个。所有这些函数也都将回调作为最后一个参数，就像保存函数一样，它们的参数是错误和响应。

这三个功能是

Model.find(conditions, callback)

此函数查找与条件对象中的字段匹配的所有文档。 Mongo 中使用的相同运算符也适用于 mongoose。例如，这将从 person 的集合中获取所有文档。

Person.find(function(err, response){
   console.log(response);
});

这将获取字段名称为“Ayush”且年龄为 20 的所有文档。

Person.find({name: "Ayush", age: 20}, 
   function(err, response){
      console.log(response);
   });

我们还可以提供我们需要的投影，即我们需要的字段。例如，如果你只检索国籍为“印度”的人的姓名，需要使用

Person.find({nationality: "Indian"}, 
   "name", function(err, response) {
      console.log(response);
   });

Model.findOne(conditions, callback)

此函数始终获取单个、最相关的文档。它与 Model.find() 具有相同的参数。

Model.findById(id, callback)

该函数将 _id（由 mongo 定义）作为第一个参数，一个可选的 projection 字符串和一个回调来处理响应。例如，

Person.findById("507f1f77bcf86cd799439011", 
   function(err, response){
      console.log(response);
   });

让我们创建一条路由来查看所有人员记录。

var express = require('express');
var app = express();

var mongoose = require('mongoose');
mongoose.connect('mongodb://localhost/my_db');

var personSchema = mongoose.Schema({
   name: String,
   age: Number,
   nationality: String
});

var Person = mongoose.model("Person", personSchema);

app.get('/people', function(req, res){
   Person.find(function(err, response){
      res.json(response);
   });
});

app.listen(3000);

更新文档

Mongoose 提供了三种更新文档的功能。

Model.update(condition, updates, callback)

此函数将条件和更新对象作为输入，并将更改应用于与集合中的条件匹配的所有文档。例如，以下代码将更新所有 Person 文档，使其具有“中国”国籍。

Person.update({age: 25},
   {nationality: "China"}, 
   function(err, response){
      console.log(response);
   });

Model.findOneAndUpdate(condition, updates, callback)

它完全按照所说的去做。根据查询查找一个文档并根据第二个参数更新该文档。它还将回调作为最后一个参数。例如，

Person.findOneAndUpdate({name: "Ayush"}, 
   {age: 40}, 
   function(err, response){
      console.log(response);
   });

Model.findByIdAndUpdate(id, updates, callback)

此函数更新由其 id 标识的单个文档。例如，

Person.findByIdAndUpdate("507f1f77bcf86cd799439011", 
   {name: "James"}, 
   function(err, response){
      console.log(response);
   });

让我们创建一条更新 person 的路由。这将是一个 PUT 路由，其中 id 作为参数和有效负载中的详细信息。

var express = require('express');
var app = express();

var mongoose = require('mongoose');
mongoose.connect('mongodb://localhost/my_db');

var personSchema = mongoose.Schema({
   name: String,
   age: Number,
   nationality: String
});

var Person = mongoose.model("Person", personSchema);

app.put('/people/:id', function(req, res){
   Person.findByIdAndUpdate(req.params.id, req.body, function(err, response){
      if(err) res.json({message: "Error in updating person with id " + req.params.id});
      res.json(response);
   });
});

app.listen(3000);

要测试这条路由，请在终端中输入以下内容（将 id 替换为你创建的人员的 id）。

$ curl -X PUT --data "name = James&age = 20&nationality = China" https://localhost:3000/people/507f1f77bcf86cd799439011

这将使用上述详细信息更新与路由中提供的 id 关联的文档。

删除文档

我们已经介绍了创建、读取和更新，现在我们将了解如何使用 mongoose 来删除文档。这里一共有三个函数，跟update一模一样。

Model.remove(condition, [callback])

此函数将条件对象作为输入，并删除所有符合条件的文档。例如，如果我们需要移除所有 20 岁的人，

Person.remove({age:20});

Model.findOneAndRemove(condition, [callback])

此函数根据条件对象删除单个、最相关的文档。例如，

Person.findOneAndRemove({name: "Ayush"});

Model.findByIdAndRemove(id, [callback])

此函数删除由其 id 标识的单个文档。例如，

Person.findByIdAndRemove("507f1f77bcf86cd799439011");

现在让我们创建一条从数据库中删除 person 的路由。

var express = require('express');
var app = express();

var mongoose = require('mongoose');
mongoose.connect('mongodb://localhost/my_db');

var personSchema = mongoose.Schema({
   name: String,
   age: Number,
   nationality: String
});

var Person = mongoose.model("Person", personSchema);

app.delete('/people/:id', function(req, res){
   Person.findByIdAndRemove(req.params.id, function(err, response){
      if(err) res.json({message: "Error in deleting record id " + req.params.id});
      else res.json({message: "Person with id " + req.params.id + " removed."});
   });
});

app.listen(3000);

要对此进行测试，请使用以下 curl 命令

$ curl -X DELETE https://localhost:3000/people/507f1f77bcf86cd799439011

这将删除具有给定 id 的人，并产生以下消息。

{message: "Person with id 507f1f77bcf86cd799439011 removed."}

这总结了我们如何使用 MongoDB、mongoose 和 Koa 创建简单的 CRUD 应用程序。要学习更多关于 mongoose的知识，请阅读 API 文档。

 Express.js 表单处理

Express.js Cookies 

迹忆客计算机编程教程

Express.js 数据库

设置 Mongoose

保存文档

检索文档

Model.find(conditions, callback)

Model.findOne(conditions, callback)

Model.findById(id, callback)

更新文档

Model.update(condition, updates, callback)

Model.findOneAndUpdate(condition, updates, callback)

Model.findByIdAndUpdate(id, updates, callback)

删除文档

Model.remove(condition, [callback])

Model.findOneAndRemove(condition, [callback])

Model.findByIdAndRemove(id, [callback])

查看笔记

Express.js 数据库

设置 Mongoose

保存文档

检索文档

Model.find(conditions, callback)

Model.findOne(conditions, callback)

Model.findById(id, callback)

更新文档

Model.update(condition, updates, callback)

Model.findOneAndUpdate(condition, updates, callback)

Model.findByIdAndUpdate(id, updates, callback)

删除文档

Model.remove(condition, [callback])

Model.findOneAndRemove(condition, [callback])

Model.findByIdAndRemove(id, [callback])

 查看笔记

查看笔记