最近因为开发一个自己的博客网站，学习了koa2的搭建，写了一些自己认为比较重要或需要知道的koa2中间件作用和使用场景。
koa-router
路由中间件
下载
npm i koa-router
使用
普通使用方法
需要注意的是引入的koa-router是一个方法，引入后需要执行这个方法。
const Koa = require('koa');
const app = new Koa();
const router = require('koa-router')();
// 配置路由url
// 默认url
router.get('/', async (ctx, next) => {
ctx.body = 'Hello World';
});
// 自定义url
router.get('/hello/:name', async (ctx, next) => {
var name = ctx.params.name;
ctx.response.body = \`<h1>Hello, ${name}!</h1>\`;
});
// 注册路由
app.use(router.routes(), router.allowedMethods());
也可以按需引入并注册路由，可注册多个路由。
不同请求下接收的参数获取
router.get
通过ctx.query获取参数
router.post
通过ctx.request.body获取参数
动态路由 router.get('/:id', func)
通过ctx.params获取参数
遍历注册router
首先引入nodejs中的fs模块，使用fs的readdirSync方法获取到指定目录的所有文件名，遍历引入路由模块并注册。
const fs = require('fs');
// fs.readdirSync 获取指定目录下的所有文件名称，遍历引入路由模块并注册
fs.readdirSync('./routes').forEach(route=> {
let api = require(\`./routes/${route}\`);
app.use(api.routes(), api.allowedMethods());
});
koa-router中的其它api
router.prefix(prefix) 添加url前缀
设置已经初始化的路由器实例的路径前缀
router.prefix('/user');
router.post('/login', function(ctx, next) {
...
});
// 实际路径 /user/login
router.use(url|[url1,url2,...], (ctx, next) => {...}) 路由中间件
使用场景：我们通常需要通过验证用户和用户权限来判定用户是否能使用该接口，如果在每个接口都写一次验证非常麻烦且不好维护。这时我们就需要路由中间件先进行验证，再执行下面操作。
router.use的第一个参数为一个路径或者由多个需要使用中间件的路径组成的数组（需要注意的是，如果路由设置了url前缀，需要在设置前缀后注册中间件，参数中的url不需要设置前缀）。
router.use的第二个参数为函数，函数传递ctx和next两个参数，可通过ctx进行权限验证后，判断是否执行next调用接口。这里特别需要注意的是函数使用next的时候需要添加await，如果不添加，在调用接口前，接口就会返回结果，前台则无法获取到数据。
// this is wrong
app.use(function (ctx, next) {
ctx.set("Access-Control-Allow-Origin", "\*");
next();
});
// this is right
app.use(async function (ctx, next) {
ctx.set("Access-Control-Allow-Origin", "\*");
await next();
});
koa-bodyparser处理post请求
处理post请求时，我们会遇到一个问题，无论是node的request对象还是koa的request对象，都没办法解析request的body，我们就需要下载并引入一个解析body的中间件koa-bodyparser，koa-bodyparser的具体配置详见下面的说明，这里我们直接放入使用方式。
// 引入路由文件
const index = require('./routes/index.js');
const user = require('./routes/user.js');
// 引入解析request.body的中间件
const bodyparser = require('koa-bodyparser');
// 注册bodyparser，需要注意，bodyparser的注册一定要在router路由注册之前
app.use(bodyparser({
enableTypes:\['json', 'form', 'text'\]
}));
...
// 注册routes
app.use(index.routes(), index.allowedMethods());
app.use(user.routes(), user.allowedMethods());
koa-bodyparser
如上所述，koa-bodyparser用于解析request.body，因为node和koa的request无法解析body。
下载
npm i koa-bodyparser
使用
const bodyparser = require('koa-bodyparser');
在注册运行时，bodyparser方法中可传入对象，作相应配置。
- enableTypes：解析器只在配置了enableTypes时解析请求类型，默认是['json'， 'form']。
- encoding：请求编码，默认是utf-8。
- formLimit：urlencoded body的imit如果主体最终大于此限制，则返回一个413错误代码。默认是56 kb。
- jsonLimit：json主体的限制。默认是1 mb。
- textLimit：文本主体的限制。默认是1 mb。
- strict：当设置为true时，JSON解析器将只接受数组和对象。默认是正确的。参见正文中的严格模式。在严格模式下，ctx.request。body总是一个对象(或数组)，这避免了很多类型判断。但文本正文总是返回字符串类型。
- detectJSON：自定义json请求检测函数。默认为null。
app.use(bodyparser({
detectJSON: function (ctx) {
return /\\.json$/i.test(ctx.path);
}
}));
- extendTypes：支持扩展类型
app.use(bodyparser({
extendTypes: {
json: \['application/x-javascript'\] // 解析application/x-javascript 类型 作为JSON字符串
}
}));
- onerror：支持自定义错误句柄，如果koa-bodyparser抛出一个错误，您可以自定义响应如下:
app.use(bodyparser({
onerror: function (err, ctx) {
ctx.throw('body parse error', 422);
}
}));
- disableBodyParser：可以通过设置ctx动态禁用body解析器。disableBodyParser = true。
app.use(async (ctx, next) => {
if (ctx.path === '/disable') ctx.disableBodyParser = true;
await next();
});
app.use(bodyparser());
koa-logger
请求响应监听日志
下载
npm i koa-logger
使用
~~// 引入日志中间件
const logger = require('koa-logger');
// 注册日志中间件
app.use(logger()); ~~
koa-session
用于Koa的简单会话中间件。默认为基于cookie的会话，并支持外部存储。
session
我们知道，http协议是无状态的，当用户进行登录后，并不会保存账户密码，如果我们需要维持用户的登录状态，就需要使用一些方法。目前主流的用户认证方法有基于token和基于session两种方式。
基于token的认证可以使用koa-jwt中间件，基于session的认证则使用标题的koa-session。
下载
npm i koa-session
使用
app.js 入口文件中注册session
const CONFIG = {
key: 'koa:sess', /\*\* (string) cookie key (default is koa:sess) \*/
/\*\* (number || 'session') maxAge in ms (default is 1 days) \*/
// 状态保存最大时间，默认为一天
maxAge: 86400000,
autoCommit: true, /\*\* (boolean) 自动保存头部 (default true) \*/
overwrite: true, /\*\* (boolean) 能否覆盖 (default true) \*/
httpOnly: true, /\*\* (boolean) httpOnly or not (default true) \*/
signed: true, /\*\* (boolean) signed or not (default true) \*/
/\*\* (boolean) 强制在每个响应上设置会话标识符cookie。过期将重置为原始maxAge，重新设置过期倒计时。 (default is false) \*/
rolling: false,
/\*\* (boolean) 当会话快过期时续订会话，这样我们可以始终保持用户登录。(default is false)\*/
renew: false,
};
// 如果你所有都为默认配置，则不需要传递配置参数，app.use(session(app))即可
app.use(session(sessionConfig, app));
session的使用
注册后可以通过上下文ctx找到session属性，下面代码将用户信息存入session属性中，并创建key和value
user.js
// 用户登录
static async login(ctx, next) {
const data = ctx.request.body
const schema = Joi.object().keys({
username: Joi.string().required(),
password: Joi.string().required(),
})
let result = Joi.validate(data, schema)
// 如果有字段类型错误
if(result.error) {
return ctx.response.body = { status: 400, msg: result.error.details};
}
let { username, password } = result.value // 验证过后的数据
// 查找是否有该用户
const userInfo = await usersModel.findByName(username)
// 如果有该用户，继续验证密码是否正确
if (userInfo) {
const userInfo2 = await usersModel.findOne({ username, password })
if (userInfo2) {
ctx.response.body = {state: 200, msg: '登录成功'}
// 设置session
ctx.session.userInfo = userInfo2
} else {
ctx.response.body = {state: 410, msg: '密码错误'}
}
// 如果没有该用户，返回结果
} else {
ctx.response.body = {state: 410, msg: '该用户不存在'}
}
return ctx.response.body
}
koa-router路由中间件中验证session，这里需要注意的是next()方法前一定要使用await，不然程序不会等待next()方法执行。
export const verifyUser = async (ctx, next) => {
if (ctx.session.userInfo) {
await next()
} else {
return ctx.response.body = { state: 401, msg: '无权限访问' }
}
}
koa2-cors
用于解决跨域问题
下载
npm install koa2-cors
使用
app.use(cors())
koa2,中间件
免责声明：本站文章均来自网站采集或用户投稿，网站不提供任何软件下载或自行开发的软件！ 如有用户或公司发现本站内容信息存在侵权行为，请邮件告知！ 858582#qq.com
这一波大模型产业落地浪潮里，不少企业其实处在 “干瞪眼“的状态。
一种情况是，很多大模型产品看得见却摸不着，在台上一个个遥遥领先——今天Sora技精四座，明天英伟达的机器人又赢得满堂彩，可是到了台下一问：啥时候能用上啊？答曰：遥遥无期。
另一种情况是，企业想用上大模型，却又难免瞻前顾后——既要考虑场景融合，又得兼顾安全性，还要考虑打通现有系统，再加上各种部署成本和繁琐的采购流程……最后只能拂袖：罢了，再等等吧。
稳了！魔兽国服回归的3条重磅消息！官宣时间再确认！
昨天有一位朋友在大神群里分享，自己亚服账号被封号之后居然弹出了国服的封号信息对话框。
这里面让他访问的是一个国服的战网网址，com.cn和后面的zh都非常明白地表明这就是国服战网。
而他在复制这个网址并且进行登录之后，确实是网易的网址，也就是我们熟悉的停服之后国服发布的暴雪游戏产品运营到期开放退款的说明。这是一件比较奇怪的事情，因为以前都没有出现这样的情况，现在突然提示跳转到国服战网的网址，是不是说明了简体中文客户端已经开始进行更新了呢？