express和koa文档：
express: http://www.expressjs.com.cn
koa: https://www.koajs.com.cn/#
koa-router:
https://www.jianshu.com/p/7e0798fe46bb
https://www.npmjs.com/package/koa-router
koa中使用cookie,session
koa中使用cookie：
- Koa 中设置、获取 Cookie 的值
ctx.cookies.set(name,value,[options])// 设置
ctx.cookies.get(name)// 获取
通过options 设置cookie name 的value:
Koa 中设置中文Cookie，没有办法直接设置，需要将设置的中文转换为base64字符串。比如:
new Buffer('张三').toString('base64'));// 转换成base64字符 串：aGVsbG8sIHdvcmxkIQ==
new Buffer('aGVsbG8sIHdvcmxkIQ==', 'base64').toString() // 还原base 64字符串：张三
koa中使用session
当浏览器访问服务器并发送第一次请求时，服务器端会创建一个session对象，生成一个类似于key,value的键值对， 然后将key(cookie)返回到浏览器(客户)端，浏览器下次再访问时，携带key(cookie)，找到对应的session(value)。 客户的信息都保存在session中
- 安装 express-session
npm install koa-session --save
- 引入express-session
const session = require('koa-session');
- 设置官方文档提供的中间件
app.keys = ['some secret hurr'];
const CONFIG = {
key: 'koa:sess', //cookie key (default is koa:sess)
maxAge: 86400000, // cookie 的过期时间 maxAge in ms (default is 1 days)
overwrite: true, //是否可以 overwrite (默认 default true)
httpOnly: true, //cookie 是否只有服务器端可以访问 httpOnly or not (default true)
signed: true, //签名默认 true
rolling: false, //在每次请求时强行设置 cookie，这将重置 cookie 过期时间（默认：false）
renew: false, //(boolean) renew session when session is nearly expired,
};
app.use(session(CONFIG, app));
当启动应用，并设置了例如：ctx.session.user='123'，则会新建一个名为name为'koa:sess'的cookie
- 使用
设置值 ctx.session.username = "张三";
获取值 ctx.session.username
koa中间件:
什么是koa中间件
通俗的讲：中间件就是匹配路由之前或者匹配路由完成做的一系列的操作，我们就可以 把它叫做中间件。
在express中间件（Middleware）是一个函数，它可以访问请求对象（requestobject(req)） , 响应对象（responseobject(res)）, 和 web 应用中处理请求-响应循环流程中的中间件，一 般被命名为 next 的变量。在 Koa 中中间件和 express 有点类似。
中间件的功能包括：
执行任何代码。 修改请求和响应对象。 终结请求-响应循环。 调用堆栈中的下一个中间件。如果我的 get、post 回调函数中，没有 next 参数，那么就匹配上第一个路由，就不会往下匹 配了。如果想往下匹配的话，那么需要写 next()
例如：
router.get('/',(ctx,next) => {
console.log('1111');
next();
})
router.get('/',(ctx,next) => {
console.log('222');
ctx.body = 'hello koa';
}:
如果不加next，路由就匹配第一个路由（当前路径），不会继续向下匹配，也就不会输出222。
koa中几种中间件的类别
- 应用级中间件
const koa = require('koa');
const router = require('koa-router')();
const app = new koa();
router.use(async (ctx,next) => {
console.log(111);
await next();
})
// get请求
router.get('/',(ctx,next)=> {
ctx.body = 'hello koa'
})
router.get('/news',(ctx,next)=> {
ctx.body='这是新闻页面'; // 响应的内容
})
app.use(router.routes()); // 作用： 启动路由
app.use(router.allowedMethods());
app.listen(8080,() =>{
console.log('starting at port 8080')
});
在上面的代码中不论是访问哪一个路由都会输入111。
- 路由级中间件
路由级中间件顾名思义就对匹配到特定的路由之前或者之后进行一些处理。
router.get('/',(ctx,next) => {
console.log('1111');
next();
})
// get请求
router.get('/',(ctx,next)=> {
ctx.body = 'hello koa'
})
先对匹配到的路由进行处理，然后next的继续向下匹配。
- 错误处理中间件
app.use(async (ctx,next) => {
next();
if(ctx.status === 404){
ctx.status = 404;
ctx.body = '这是一个错误处理中间件'
}
})
错误中间件的用法就是在路由路由之后进行状态判断或者其他的判断。
- 常见第三方中间件
- koa-static: 用于加载静态资源比如加载css,图片，js等。
const static = require('koa-static');
const staicPath = './static';
app.use(static({
path.join(_dirname,staicPath);
}))
app.use(static(_dirname+'./public'))
// koa中静态资源中间件可以配置多个
// www.xxx.com/css/index.css
// 它会去./static/css/index.css文件夹下去找对应的文件，如果没有找到就去public下面去找,然后返回对应的结果。类似于静态资源的托管。
- koa-bodyparser: 这是一个解析 POST 数据的模块，解决了 Koa 原生 ctx 访问 POST 数据不太便利的问题。
app.use(async ctx => {
// the parsed body will store in ctx.request.body
// if nothing was parsed, body will be an empty object {}
ctx.body = ctx.request.body;
});
- koa-views: 这是一个让koa配合使用模板工具（ejs,pug）的中间件。
const views=require('koa-views');
app.use(views('views',{
map:{html:'ejs'}，
// extension: 'ejs'
}));
// 第一个参数是模板文件存放的地址，
// extension: 'ejs' 表示要使用ejs模板引擎
// map:{html:'ejs'}，和上面extension一样表示要是使用ejs模板。只是可以在引入文件的时候省略文件后缀。
router.get('/add',async(ctx) =>{
let title='hello koa2'
await ctx.render('index',{
title
})
})
// 如果我们需要给多个模板传入一样的数据，我们可以通过设置一个公共的数据。
// 设置一些公共的数据，可以供模板引擎使用，必须要写入中间件中,这样在所用的render的模板中都可以使用这些数据。比如： 可以直接在index.ejs中使用name,不需要在渲染的时候传入。
app.use(async (ctx) => {
ctx.state = {
name: 'zhangsan',
};
})
这里render里面第一个参数是文件的地址（相对于你前面设置的文件夹，上面是view文件夹下），第二个参数为传入的数据。
- koa-art-template：是一种是一个简约、超快的模板引擎，采用作用域预声明的技术来优化模板渲染速度。
const Koa=require('koa');
const render=require('koa-art-template');
const app=newKoa();
render(app,{
root:path.join(__dirname,'view'), extname:'.art', debug:process.env.NODE_ENV!=='production' });
app.use( async function(ctx){
await ctx.render('user');
});
app.listen(8080)
参考语法：http://aui.github.io/art-template/zh-cn/docs/syntax.html
koa中中间件的执行流程
koa中的中间件的执行流程和express的执行流程都是洋葱模型。
//www.域名.com/news
app.use(async (ctx,next)=>{
console.log('1、这是第一个中间件01');
await next();
console.log('5、匹配路由完成以后又会返回来执行中间件');
})
app.use(async (ctx,next)=>{
console.log('2、这是第二个中间件02');
await next();
console.log('4、匹配路由完成以后又会返回来执行中间件');
})
router.get('/',async (ctx)=>{
ctx.body="首页";
})
router.get('/news',async (ctx)=>{
console.log('3、匹配到了news这个路由');
ctx.body='这是一个新闻';
})
app.use(router.routes()); /*启动路由*/
app.use(router.allowedMethods());
app.listen(3002);
中间件的执行结果为：1、2、3、4、5
