使用nodejs-koa2-mysql-sequelize-jwt 实现项目api接口

nodejs-koa2-mysql-sequelize-jwt

• 技术栈：nodejs, koa2, mysql, sequelize, jwt
• 项目数据层和操作层分明
• 使用koa2框架中间件，参数处理
• jwt做权限接口验证
• sequelize管理mysql数据库
• 异步处理async/await
• 已实现登录注册接口，文章增删改查接口
• 喜欢或对你有帮助的话请点star✨✨，或有您有更好的建议和意见，请提出来告知我，可以留言issues，可以加我QQ: 841053515, Thanks.

项目地址 点击跳转https://github.com/liangfengbo/nodejs-koa2-mysql-sequelize-jwt.git

一、学习使用

git clone

git clone https://github.com/liangfengbo/nodejs-koa2-mysql-sequelize-jwt.git

1.1.安装

npm install

1.2.需要在config文件下db.js配置本地数据库

const sequelize = new Sequelize('数据库', '数据库用户名', '数据库密码', {})
别忘了创建数据库，黑窗口登录msyql：create database '数据库用户名'

1.3.开启服务

npm start

二、路由说明

// └──routes/index.js文件
const router = new Router({
    prefix: '/api/v1'
})
/**
 * 用户接口
 */
// 用户注册
router.post('/user', UserController.create);
// 用户登录
router.post('/user/login', UserController.login);
// 获取用户信息
router.get('/user', UserController.getUserInfo);
// 获取用户列表
router.get('/user/list', UserController.getUserList);
// 删除用户
router.delete('/user/:id', UserController.delete);
/**
 * 文章接口
 */
// 创建文章
router.post('/article', ArticleController.create);
// 获取文章列表
router.get('/article', ArticleController.getArticleList);
// 获取文章详情
router.get('/article/:id', ArticleController.detail);
// 删除文章
router.delete('/article/:id', ArticleController.delete);
// 更改文章
router.put('/article/:id', ArticleController.update);

三、接口说明（用户接口）

创建用户接口

/user

3.1.请求方式

post

3.2.请求参数

参数	说明	需求
username	用户名	必填
password	密码	必填

3.3.返回数据

{
    "code": 200,
    "msg": "创建用户成功",
    "data": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6IkJvYiIsImlkIjozLCJpYXQiOjE1Mjg3NzUzOTMsImV4cCI6MTUyODc3ODk5M30.cnWcgJQF1z7adgKp49AgP4UvpqIXUNjGfjWLMq-rMeA"
}

登录接口

/user/login

3.4.请求方式

post

3.5.请求参数

参数	说明	需求
username	用户名	必填
password	密码	必填

3.6.返回数据

{
    "code": 200,
    "msg": "登录成功",
    "data": {
        "id": 3,
        "username": "Bob",
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6IkJvYiIsImlkIjozLCJpYXQiOjE1Mjg3NzU0NTIsImV4cCI6MTUyODc3OTA1Mn0.v_B_EXvzYTk7Wz-jl4D8F5n5kn2iah8oht0s6S72Zsc"
    }
}

获取用户信息

/user

3.7.请求方式

get

3.8.说明

token 一定要传

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6IuaigeWHpOazomJvIiwiaWQiOjUsImlhdCI6MTUyNzczNjc2NSwiZXhwIjoxNTI3NzQwMzY1fQ.y5w4lEFRf8bpR4fFPNDms1m9WSX9mfQ3fo5dejG7y3A

3.9.返回数据

{
    "code": 200,
    "msg": "查询成功",
    "data": {
        "id": 3,
        "username": "Bob"
    }
}

删除用户接口

/user/:id

3.10.请求方式

delete

3.11.请求参数

参数	说明	需求
id	用户ID	必填

3.12.返回数据

{
    "code": 200,
    "msg": "删除用户成功"
}

四、项目主要文件

4.1.1schema文件

创建数据库表

4.2.1modules文件

model层 - 主要处理参数

4.3.1controllers文件

控制器 - 处理数据库增删改查

4.4.1router 文件

路由

4.5.1app.js

入口文件

项目身份验证使用了jwt，就是说登录注册和获取用户信息不用jwt验证，其他接口都需要token验证

比如注册用户接口：在postman软件操作接口，例注册接口：

post 请求
http://localhost:3000/api/v1/createUser?username=梁凤波bo&password=bobo12345

创建成功后返回信息：

{
    "code": 200,
    "message": "创建成功",
    "bean": {
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6IuaigeWHpOazomJvIiwiaWQiOjUsImlhdCI6MTUyNzczNjUzMSwiZXhwIjoxNTI3NzQwMTMxfQ.GAQg-hZm3rDYq70-16sgfNHvD64gmrWSFzQCZQs7bl4"
    }
}

注册

post 请求
http://localhost:3000/api/v1/user/login?username=梁凤波bo&password=bobo12345

成功返回信息：

{
    "message": "登录成功！",
    "data": {
        "id": 5,
        "username": "梁凤波bo",
        "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6IuaigeWHpOazomJvIiwiaWQiOjUsImlhdCI6MTUyNzczNjc2NSwiZXhwIjoxNTI3NzQwMzY1fQ.y5w4lEFRf8bpR4fFPNDms1m9WSX9mfQ3fo5dejG7y3A"
    },
    "code": 200
}

处理jwt验证时候，我添加了方法

app.use(jwt({secret: secret.sign}).unless({path: [/^\/api\/v1\/login/, /^\/api\/v1\/createUser/]}))

登录注册都会返回token信息，除了这两个接口必须要发送header头

在header中加入token

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6IuaigeWHpOazomJvIiwiaWQiOjUsImlhdCI6MTUyNzczNjc2NSwiZXhwIjoxNTI3NzQwMzY1fQ.y5w4lEFRf8bpR4fFPNDms1m9WSX9mfQ3fo5dejG7y3A

才能获取到接口信息，而且token有效期是1个小时就失效。

具体可以看项目主要几个文件代码，一起学习进步，如果你有什么好的建议或意见，或如有错误恳请指导，请留言，谢谢

学习推荐链接：

koa2 实现jwt认证 作者日暮途远_ https://www.jianshu.com/p/176198fbdb35

基于 Egg.js 框架的 Node.js 服务构建之用户管理设计

如果对你学习nodejs有帮助，请给个星星star✨✨谢谢