Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/junixapp/qingblogbackend
Qing博客系统后台,基于Koa2和NodeJs编写。
https://github.com/junixapp/qingblogbackend
koa mongoose nodejs
Last synced: about 1 month ago
JSON representation
Qing博客系统后台,基于Koa2和NodeJs编写。
- Host: GitHub
- URL: https://github.com/junixapp/qingblogbackend
- Owner: junixapp
- Created: 2018-03-09T10:37:09.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-07-12T08:22:49.000Z (over 6 years ago)
- Last Synced: 2024-02-27T03:37:27.119Z (10 months ago)
- Topics: koa, mongoose, nodejs
- Language: JavaScript
- Size: 680 KB
- Stars: 4
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## QingBlog后端
Koa2套件 + mongoose**前端项目为**:[QingBlog前端](https://github.com/li-xiaojun/QingBlogFrontend)
## 结构说明
- `app.js`负责加载router、middlewares,连接db
- router层只负责映射路由,调用controller层,然后响应success数据,不应该抛出异常,不应该响应错误的数据
- controller层为router层服务,负责执行业务逻辑,参数检查,读取db,返回数据,抛出异常
- 中间件负责处理所有的错误返回
- model为数据结构层## 中间件说明
- `rest_handler.js`负责给ctx安装success方法和error方法,分别是返回成功的数据和失败的数据
- `err_handler.js`是全局的错误处理中间件,负责处理所有错误的返回,包括api级别,数据库级别,其他未知错误
- `auth_handler.js`是负责验证token
- `permission_handler.js`是负责权限检查## RestfulAPI设计
> code采用字符串,目的是不用查表。
- 成功只有一种,msg只是辅助客户端,所以http响应码为200,内容是:
```javascript
{ code: "success", msg: "成功", data: xx }
```- 失败响应码采用500:错误码按照模块分类:
```javascript
{ code: "errCode", msg: "errMsg" }
```
比如errCode设计如下:
```
TokenNotExist - token不存在
TokenInvalidToken - token失效
AuthUsernamePswNotMatched - 用户名或密码错误
AuthUserNotExist - 用户不存在
BlogNameExist - 名字已存在
BlogNotFound - 博客不存在
```
## 全局错误处理
所有的中间件都将错误抛出,由最外层的`error_handler`中间件来处理,包括数据库异常,最后将错误信息封装为json返回。
注意,有时候布局代码(比如中间件代码或者controller)可能要try/catch局部异常,**此时千万不要把`await next()`写到try块里面;或者你写进去了,
那么catch块,一定要有个throw操作,否则后续中间件的异常将被此处捕获,全局错误处理器将失效。**## 启动和部署
使用pm2。