- hapi框架,用官网的简介来说就是:Hapi是构建应用程序和服务的丰富框架,它使开发人员能够专注于编写可重用的应用程序逻辑,而不是花时间构建基础设施。
- 用自己的话简单来说,就是个类似express,koa之类的node服务基础框架。
- 此篇博客是在阅读过掘金小册的《基于 hapi 的 Node.js 小程序后端开发实践指南》并实践操作后,以此记录实践过程和踩过的坑。感兴趣读者可支持阅读掘金小册原版的内容。
Joi数据校验
1.安装joi
更多校验规则参考文档:https://www.npmjs.com/package...
npm i @hapi/joi
2.配合swagger
只需要在路由的config配置校验信息,如./routes/test.js 新增多一条测试接口
{
method: "GET",
path: `/${GROUP_NAME}/get`,
handler: (request, h) => {
return { data: request.query };
},
config: {
tags: ["api", GROUP_NAME],
description: "测试get提交",
notes: "配置Implementation说明文",
validate: {
query: {
num: Joi.number()
.integer()
.required()
.description("数字")
.error(new Error("num参数错误"))
}
}
}
},
3.swagger接口文档
Sequence的使用
1.安装
此案例链接mysql数据库,所以安装mysq2
npm i sequelize-cli -D
npm i sequelize
npm i mysql2
2.使用到的目录和文件
├── config # 项目配置目录
| ├── config.js # 数据库连接的配置(区分开发/生产环境)
| ├── index.js # 暴露部分配置信息给app.js使用
├── models # 数据库 model
| ├── index.js # 数据库连接的样板代码
├── migrations # 数据迁移的目录
├── seeders # 数据填充的目录
├── .env # 配置
3.env配置数据库信息
注意需要在本地mysql中创建对应的数据库, 如:hapi_db
# 域名配置信息
HOST = 127.0.0.1
PORT = 3303
# MySQL 数据库连接配置信息
MYSQL_HOST = 127.0.0.1
MYSQL_PORT = 3306
MYSQL_DB_NAME = hapi_db
MYSQL_USERNAME = root
MYSQL_PASSWORD = 123456
4. 暴露给入口文件使用的数据信息
新建./config/index.js
const { env } = process;
module.exports = {
host: env.HOST,
port: env.PORT
};
5. 模式model使用
新建./config/config.js给后台将要创建的数据库模型model使用的数据信息
// 根据环境动态加载数据库配置信息
// 本页面内容主要给数据库连接使用(../models/index.js)
if (process.env.NODE_ENV == "production") {
require("env2")("./.env.prod");
} else {
require("env2")("./.env");
}
const { env } = process;
module.exports = {
development: {
username: env.MYSQL_USERNAME,
password: env.MYSQL_PASSWORD,
database: env.MYSQL_DB_NAME,
host: env.MYSQL_HOST,
port: env.MYSQL_PORT,
dialect: "mysql",
operatorsAliases: false
},
production: {
username: env.MYSQL_USERNAME,
password: env.MYSQL_PASSWORD,
database: env.MYSQL_DB_NAME,
host: env.MYSQL_HOST,
port: env.MYSQL_PORT,
dialect: "mysql",
operatorsAliases: false
}
};
使用sequelize创建表
1.数据库的创建
sequelize提供创建数据库的命令,但最后还需要自己动手修改数据库格式为utf-8,所以还是手动直接创建方便
2.migration创建表
创建一个商品表 shops
根据以下命令,将会自动创建./migration/2019XXXXXXXXX-create-shops-table.js
其实是可以直接在mysql创建表并填写数据,但这里使用migration来创建主要为了留下对表的创建修改等记录,未来有查询依据。就类比记录创建日志。
./node_modules/.bin/sequelize migration:create --name create-shops-table
xxxx-crate.shops.table.js
"use strict";
module.exports = {
up: (queryInterface, Sequelize) => {
return queryInterface.createTable("shops", {
id: {
type: Sequelize.INTEGER,
autoIncrement: true,
primaryKey: true
},
name: {
type: Sequelize.STRING,
allowNull: false
},
thumb_url: Sequelize.STRING,
created_at: Sequelize.DATE,
updated_at: Sequelize.DATE
});
},
down: (queryInterface, Sequelize) => {face.dropTable("shops");
}
};
3. 向mysql数据库中创建表
在项目根目录下执行命令
./node_modules/.bin/sequelize db:migrate
成功创建示例
可能报错情况1:
解决:查看config/config.js配置是否正确,并注释掉operatorsAliases: false
可能报错情况2:
解决:mysql数据库没有设置密码,注释掉配置文件(config/config.js)password: env.MYSQL_PASSWORD,
数据库表成功插件
使用Sequelize填充表数据
1.在项目根目录下执行命令:
将自动创建 /seeders/2019XXXX-init-shops.js
./node_modules/.bin/sequelize seed:create --name init-shops
2. 编写要填充的数据 xxxx-init-shops.js
"use strict";
/**
* 初始化 店铺 数据
* 若 数据库表中存在created_at和updated_at此两个字段,将默认由Sequelize维护
*/
const timestamps = {
created_at: new Date().toLocaleString(),// 解决时差问题,使用toLocaleString()
updated_at: new Date().toLocaleString()
};
module.exports = {
up: (queryInterface, Sequelize) => {
return queryInterface.bulkInsert(
"shops",
[
{ id: 1, name: "店铺1", thumb_url: "1.png", ...timestamps },
{ id: 2, name: "店铺2", thumb_url: "2.png", ...timestamps },
{ id: 3, name: "店铺3", thumb_url: "3.png", ...timestamps },
{ id: 4, name: "店铺4", thumb_url: "4.png", ...timestamps }
],
{}
);
},
down: (queryInterface, Sequelize) => {
// 删除shop表id为1,2,3,4的数据
const { Op } = Sequelize;
return queryInterface.bulkDelete(
"shops",
{ id: { [Op.in]: [1, 2, 3, 4] } },
{}
);
}
};
3.执行填充
./node_modules/.bin/sequelize db:seed:all
执行效果和数据结果
目录结构
截止目前为止,目录结构和文件如下:
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。