如何使用Node.js开发RESTful|如何使用Node.js开发RESTful API接口(Node.js+Express+Sequelize+MySQL)
本教程手把手教你搭建一套使用 Node.js + Express + Sequelize + MySQL 构建的后端服务,详细描述通过 Node.js 与数据库通讯。整个服务搭建起来后,我们使用 Postman 对整个后端服务进行测试。本教程每段代码我都亲手测过,保证百分百没有错误,请打开你的 terminal 跟随本教程一起操作,从这里开始,成为一名后端工程师。
全栈实战教程:
- Vue + Node.js+Expres+MySQL 开发「待办清单」APP
- Vue + Axios + Node.js + Express 搭建带预览的「上传图片」管理后台
- Vue + Axios + Node.js + Express 搭建「文件上传」管理后台
- React + Nodejs 搭建带预览的「上传图片/预览」管理后台
- React + Axios + Node.js + Express 搭建「文件上传」管理后台
- 使用 Node.js + MySQL 开发 RESTful API 接口(Node.js + Express + Sequelize + MySQL)
- 使用 Node.js + MongoDB 开发 RESTful API 接口(Node.js + Express + MongoDB)
文章图片
后端部分:node.js + Express + Sequelize + MySQL
- node.js 是整个后端的框架
- 使用 Express 生成
- Sequelize ORM
- MySQL
后端 node.js 项目结构
文章图片
db.config.js
包含远程连接 MySQL 数据库的登录参数server.js
包含 Express Web 服务器初始化配置models/index.js
包含 MySQL 数据库的配置信息models/todo.model.js
: 包含 Sequelize 数据模型controllers/todo.controller.js
:包含所有增删改查操作的路由
安装 node.js node.js 是一种 JavaScript 的运行环境,它可以让 JS 脱离浏览器在后端服务器上运行。本教程的后端环境使用 node.js 搭建。请先确认你的计算机中是否已安装 node.js 。如果尚未安装请前往 node 官网下载安装。
安装或准备可远程连接的 MySQL 数据库 本教程搭建的 app 数据存放在 MySQL 中,你可以在本机安装 MySQL ,也可以准备一台可远程连接的 MySQL 数据库。
如果你还没有安装 MySQL 数据库,可根据《如何安装 MySQL》教程安装 MySQL 数据库,或在腾讯云之类的云服务商购买现成的 MySQL 数据库。
- 如何远程连接 MySQL 数据库,阿里云腾讯云允许远程连接教程
- 如何在 ubuntu 上安装 MySQL
- MySQL 官方下载地址
创建 node.js App 在根目录创建 node.js 的项目文件夹
mkdir nodejs-express-sequelize-mysql-kalacloud
cd nodejs-express-sequelize-mysql-kalacloud
接下来配置后端的所有操作都在
nodejs-express-sequelize-mysql-kalacloud
这个文件夹中完成。我们先来初始化 node.js,使用
npm init
配置 package.json
文件。package.json
定义了当前项目所需要的各种模块以及项目配置信息(包含当前项目所需的开发和运行环境等信息)。文章图片
npm init
name: (nodejs-express-sequelize-mysql)
version: (1.0.0)
description: Node.js Rest Apis with Express, Sequelize , MySQL.
entry point: (index.js) server.js
test command:
git repository:
keywords: nodejs, express, sequelize, mysql, rest, api
author: kalacloud
license: (ISC)
Is this ok? (yes) yes
跟随 node.js 初始化程序填写相应的 app 初始化信息。
{
"name": "nodejs-mysql-kalacloud-com",
"version": "1.0.0",
"description": "Node.js Rest Apis with Express, Sequelize , MySQL.",
"main": "server.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"keywords": [
"nodejs",
"express",
"sequelize",
"mysql",
"rest",
"api"
],
"author": "kalacloud",
"license": "ISC"
}
初始化程序填写完成之后,npm 会自动帮你在根目录下生成
package.json
配置文件。接着我们来安装项目中需要用到的模块:
express
,sequelize
,mysql2
和body-parser
。在项目根目录
nodejs-express-sequelize-mysql-kalacloud
执行 npm
命令:npm install express sequelize mysql2 body-parser cors --save
配置 Express Web 服务器 在根目录中,创建一个新的
server.js
文件文件位置:
nodejs-express-sequelize-mysql-kalacloud/server.js
const express = require("express");
const bodyParser = require("body-parser");
const cors = require("cors");
const app = express();
var corsOptions = {
origin: "*"
};
app.use(cors(corsOptions));
// content-type:application/json
app.use(bodyParser.json());
// content-type:application/x-www-form-urlencoded
app.use(bodyParser.urlencoded({ extended: true }));
// 简单路由
app.get("/", (req, res) => {
res.json({ message: "欢迎访问卡拉云后端服务器" });
});
// 设置监听端口
const PORT = process.env.PORT || 8080;
app.listen(PORT, () => {
console.log(`服务器运行端口: ${PORT}.`);
});
- 我们导入了
express
,body-parser
和cors
模块 express
用于构建 Rest API 帮助前后端实现通讯。body-parser
用于解析请求并创建 req.body 对象cors
提供 Express 中间件corsOptions
这里设置了可访问后端的前端来源为*
,这意味着任何前端都可以接入此后端。这样设置并不安全,为了避免「跨域问题」,先这么设置。之后请在这里限制可访问的前端服务器。- 后端服务在 8080 端口上侦听指令
文章图片
好,现在我们在根目录运行指令:
node server.js
启动后端服务器。文章图片
在浏览器中输入 http://localhost:8080 ,你可以看到后端服务器欢迎信息,这表明我们的后端服务器已经启动。
使用 Sequelize 连接数据库 Sequelize 是一个基于 Promise 的 Node.js ORM,目前支持 Postgres、MySQL、SQLite 和 Microsoft SQL Server。 它是一个很成熟的框架,有很好的性能和速度。
我们先来配置 Sequelize ,在根目录新建
app
文件夹,然后再其中建一个 config
文件夹,我们把 Sequelize 的配置文件放在这里,新建 db.config.js
文件,在这个文件中写入你数据库连接的配置信息。文件位置:
nodejs-express-sequelize-mysql-kalacloud/app/config/db.config.js
module.exports = {
HOST: "192.168.1.5",
USER: "kalacloud",
PASSWORD: "YOUR_PASSWORD",
DB: "demo",
port:3306,
dialect: "mysql",
pool: {
max: 5,
min: 0,
acquire: 30000,
idle: 10000
}
};
HOST
这里是你的 MySQL 服务器地址,如果数据库跑在本地就是loaclhost
,如果在腾讯云等云服务上,就填写云服务给你的数据库地址,比如cdb-5nvdsixo.bj.tencentcdb.com
这是腾讯云的数据库地址样式。USER
数据库登录用户名PASSWORD
用户名对应的登录密码DB
数据库名称port
数据库远程访问端口max
最大连接数min
最小连接数acquire
超时时间idle
空闲时间
初始化 Sequelize 我们将在 app / models 文件夹中初始化 Sequelize。
在
app/models
新建 index.js
文件并写入以下代码。文件位置:
nodejs-express-sequelize-mysql-kalacloud/app/models/index.js
const dbConfig = require("../config/db.config.js");
const Sequelize = require("sequelize");
const sequelize = new Sequelize(dbConfig.DB, dbConfig.USER, dbConfig.PASSWORD, {
host: dbConfig.HOST,
dialect: dbConfig.dialect,
operatorsAliases: false,pool: {
max: dbConfig.pool.max,
min: dbConfig.pool.min,
acquire: dbConfig.pool.acquire,
idle: dbConfig.pool.idle
}
});
const db = {};
db.Sequelize = Sequelize;
db.sequelize = sequelize;
db.todos = require("./todo.model.js")(sequelize, Sequelize);
module.exports = db;
这里的
todo.model.js
是一个用来操作数据库的 sequelize 模型,用于前端发出指令,后端接受指令后操作数据库,后文会具体讲解。本文的前端配套教程《全栈实战:手把手教你用 Vue+Nodejs 开发「待办清单」app》然后在根目录下的 server.js 文件里添加
sync()
调用的方法:文件位置:
nodejs-express-sequelize-mysql-kalacloud/server.js
const express = require("express");
const bodyParser = require("body-parser");
const cors = require("cors");
const app = express();
var corsOptions = {
origin: "http://localhost:8081"
};
app.use(cors(corsOptions));
// content-type:application/json
app.use(bodyParser.json());
// content-type:application/x-www-form-urlencoded
app.use(bodyParser.urlencoded({ extended: true }));
// 简单路由
app.get("/", (req, res) => {
res.json({ message: "欢迎访问卡拉云后端服务器" });
});
// 设置监听端口
const PORT = process.env.PORT || 8080;
app.listen(PORT, () => {
console.log(`服务器运行端口: ${PORT}.`);
});
const db = require("./app/models");
db.sequelize.sync();
在结尾处添加这两行即可,你可以直接把 server.js 里的代码全删掉,然后复制上面的代码进去,保证你的项目代码与本教程完全一致。
定义 Sequelize Model 在
models
文件夹中,像这样创建 todo.model.js
文件【如何使用Node.js开发RESTful|如何使用Node.js开发RESTful API接口(Node.js+Express+Sequelize+MySQL)】文件位置:
nodejs-express-sequelize-mysql-kalacloud/app/models/todo.model.js
module.exports = (sequelize, Sequelize) => {
const Todo = sequelize.define("todo", {
title: {
type: Sequelize.STRING
},
description: {
type: Sequelize.STRING
},
status: {
type: Sequelize.BOOLEAN
}
});
return Todo;
};
Sequelize Model 是向 MySQL 中指定数据库的写入列,这里会自动生成 ID,title,description,status,createdAt,updatedAt 这六个列。
初始化 Sequelize 之后,我们不需要在写任何增删改查函数,直接调就可以了。
- 创建一个新清单:
[create](https://sequelize.org/master/class/lib/model.js~Model.html#static-method-create)(object)
- 通过 id 查找清单:
[findByPk](https://sequelize.org/master/class/lib/model.js~Model.html#static-method-findByPk)(id)
- 获取所有待办清单:
[findAll](https://sequelize.org/master/class/lib/model.js~Model.html#static-method-findAll)()
- 根据 ID 更新清单:
[update](https://sequelize.org/master/class/lib/model.js~Model.html#static-method-update)(data, where: { id: id })
- 根据 ID 删除清单:
[destroy](https://sequelize.org/master/class/lib/model.js~Model.html#static-method-destroy)(where: { id: id })
- 删除所有清单:
destroy(where: {})
- 在所有清单中按标题查找:
findAll({ where: { title: ... } })
创建控制器(controllers) 在
app/controllers
文件夹中,我们来创建一个控制器 todo.controller.js
,把上面 Sequelize 写入控制器来操作数据。文件位置:
nodejs-express-sequelize-mysql-kalacloud/app/controllers/todo.controller.js
const db = require("../models");
const Todo = db.todos;
const Op = db.Sequelize.Op;
// 创建并保存一条清单
exports.create = (req, res) => {
// Validate request
if (!req.body.title) {
res.status(400).send({
message: "内容不能为空"
});
return;
}// 创建一条清单
const todo = {
title: req.body.title,
description: req.body.description,
stauts: req.body.stauts ? req.body.stauts : false
};
// 将清单保存到数据库
Todo.create(todo)
.then(data => {
res.send(data);
})
.catch(err => {
res.status(500).send({
message:
err.message || "创建清单是发生错误。"
});
});
};
// 从数据库中搜索.
exports.findAll = (req, res) => {
const title = req.query.title;
var condition = title ? { title: { [Op.like]: `%${title}%` } } : null;
Todo.findAll({ where: condition })
.then(data => {
res.send(data);
})
.catch(err => {
res.status(500).send({
message:
err.message || "搜索时,发生错误。"
});
});
};
// 按照条目 ID 搜索
exports.findOne = (req, res) => {
const id = req.params.id;
Todo.findByPk(id)
.then(data => {
if (data) {
res.send(data);
} else {
res.status(404).send({
message: `没有找到 ${id} 的清单`
});
}
})
.catch(err => {
res.status(500).send({
message:`查询第 ${id} 条清单时出错`
});
});
};
// 更新指定 ID 清单
exports.update = (req, res) => {
const id = req.params.id;
Todo.update(req.body, {
where: { id: id }
})
.then(num => {
if (num == 1) {
res.send({
message: "更新成功"
});
} else {
res.send({
message: `第 ${id} 条更新失败。`
});
}
})
.catch(err => {
res.status(500).send({
message: `更新第 ${id} 条清单时出错`
});
});
};
// Delete a Todo with the specified id in the request
exports.delete = (req, res) => {
const id = req.params.id;
Todo.destroy({
where: { id: id }
})
.then(num => {
if (num == 1) {
res.send({
message: "删除成功"
});
} else {
res.send({
message: `删除第${id}条清单失败。`
});
}
})
.catch(err => {
res.status(500).send({
message: "不能删除清单:" + id
});
});
};
// 删除数据库中所有清单
exports.deleteAll = (req, res) => {
Todo.destroy({
where: {},
truncate: false
})
.then(nums => {
res.send({ message: `删除${nums}条清单 ` });
})
.catch(err => {
res.status(500).send({
message:
err.message || "删除所有清单时出错"
});
});
};
// 检查所有清单状态
exports.findAllstauts = (req, res) => {
Todo.findAll({ where: { stauts: true } })
.then(data => {
res.send(data);
})
.catch(err => {
res.status(500).send({
message:
err.message || "搜索清单时出错"
});
});
};
至此,整个后端部分就搭建完成了,我们把后端运行起来看看效果。
运行 Node.js Express 服务器 在 node.js 服务器根目录,运行
node server.js
文章图片
控制台显示对数据库的读写,每当前端调用后端时,这里就会给出对应后端操作了写什么的 log
使用 Postman 调用 node.js 后端测试 API
文章图片
后端搭建起来后,我们可以使用 postman 来对它进行测试。
扩展阅读:
Vue + Node.js 前后端分离搭建实战,手把手教你用 Vue+Nodejs 开发「待办清单」app
Node.js 后端搭建总结 Node.js 接收前端指令,根据前端指令操作数据库 CRUD,相当方便。学会前后端是成为全栈工程师的基础技能。但如果你只想专注在解决实际问题,不想写代码,推荐使用卡拉云,卡拉云内置多种常用组件,无需懂前后端,仅需拖拽即可快速生成你需要的后台管理工具。
下面是用卡拉云搭建的数据库 CURD 后台管理系统,只需拖拽组件,即可在10分钟内完成搭建。
可直接分享给同事一起使用:https://my.kalacloud.com/apps/8z9z3yf9fy/published
卡拉云可帮你快速搭建企业内部工具,下图为使用卡拉云搭建的内部广告投放监测系统,无需懂前端,仅需拖拽组件,10 分钟搞定。你也可以快速搭建一套属于你的后台管理工具。
文章图片
卡拉云是新一代低代码开发平台,与前端框架 Vue、React等相比,卡拉云的优势在于不用首先搭建开发环境,直接注册即可开始使用。开发者完全不用处理任何前端问题,只需简单拖拽,即可快速生成所需组件,可一键接入常见数据库及 API,根据引导简单几步打通前后端,数周的开发时间,缩短至 1 小时。立即免费试用卡拉云。
推荐阅读
- Vue|Vue 里,多级菜单要如何设计才显得专业()
- 【SpringBoot的自动配置--下篇】架构师如何自定义自己的条件注解与自动配置
- 你是如何对待步入中年的父母的———读《人生没有白走的路,每一步都算数》有感
- 如何创建一个常见问题解答(FAQ)页面()
- Python|Python Opencv使用ann神经网络识别手写数字功能
- 0716|0716 晨读感悟(如何知道了道理也能过好这一生!)
- CloudBees CI使用Velero进行灾备(DR)概念验证
- 如何给自己的库插上cocoapods的翅膀_公开库的使用
- 【读书清单】如何高效读懂一本书(04)
- 社群营销:3个案例再来聊聊如何降低参与门槛