koa框架(一) 认识koa

koa

• ​koa是express原班人马打造的轻量、健壮、富有表现力的nodejs框架。目前koa有koa1和koa2两个版本；koa2依赖Node.js 7.6.0或者更高版本；koa不在内核方法中绑定任何中间件，它仅仅是一个轻量级的函数库，几乎所有功能都必须通过第三方插件来实现。

koa 的使用

基本服务

• koa安装
  npm i koa
• 一个简单的koa服务器

  const Koa = require('koa');
  const app = new Koa();
  
  app.use(async ctx => {
    ctx.body = 'Hello World';
  });
  app.listen(3000);
  

• koa 利用中间件 控制“上游”，调用”下游“；

  • koa是包含一组中间件函数的对象；可以将app.use里的函数理解成中间件

    //这里的middleWare函数就是一个中间件
    let middleWare = async (ctx,next)=>{
        console.log("first middleWare");
        ctx.body = "hello world";
    }
    app.use(middleWare);
    

  • 通过next()将控制转交给另一个中间件；

  • 上述过程也可以通过"洋葱模型“来解释中间件执行顺序
    

Application对象

• application是koa的实例，简写app
• app.use 将给定的中间件方法添加到此应用程序,分为同步和异步，异步：通过es7中的async和await来处理
• app.listen设置服务器端口；
• app.on 错误处理；

上下文context对象常用属性及方法

• context 将node中的request和response封装到一个对象中，并提供一些新的api提供给用户进行操作；

• ctx.app:应用程序实例引用,等同于app;

  • ctx.req: Node 的 request 对象.
  • ctx.res: Node的 response` 对象.
  • ctx.request: koa中的Request对象；
  • ctx.response: koa中的response对象；
  • ctx.state：对象命名空间，通过中间件传递信息；
  • ctx.throw: 抛出错误；

• request及response别名

  • koa会把ctx.requset上的属性直接挂载到ctx上如：

    • ctx.header
    • ctx.headers
    • ctx.method
    • ctx.method=
    • ctx.url
    • ctx.url=
      ……

  • 同样也会把ctx.response上的属性直接挂载到ctx上如：

    • ctx.body
    • ctx.body=
    • ctx.status
    • ctx.status=
      ….

    ctx.status 获取响应状态。默认情况下，response.status 设置为 404 而不是像 node 的 res.statusCode 那样默认为 200。

koa常用中间件介绍

koa-router

• 路由是引导匹配之意，是匹配url到相应处理程序的活动。
• koa-router推荐使用RESTful架构API。Restful的全称是Representational State Transfer 即表现层转移。
  • RESTful是一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。基于这个风格设计可以更简洁，更有层次;
  • RESTful设计一般符合如下条件：
    • 程序或者应用的事物都应该被抽象为资源
    • 每个资源对应唯一的URI(uri是统一资源标识符)
    • 使用统一接口对资源进行操作
    • 对资源的各种操作不会改变资源标识
    • 所有操作都是无状态的
• koa-router安装
  npm i koa-router -S
• 基本使用

const KoaRouter = require('koa-router');
const router = new KoaRouter();
router.get('/login', ctx => {
    ctx.body = '登陆';
})
app.use(router.routes());

koa-views

• Koa-views用于加载html模板文件；
• 安装 koa-views
  npm i koa-views -S
  • 使用koa-view

koa-static

• koa-static是用于加载静态资源的中间件，通过它可以加载css、js等静态资源；
• 安装 koa-static
  npm i koa-static
• 使用koa-static

  const static = require("koa-static");
 //加载静态文件的目录
  app.use(static(__dirname+"/static"),{
  		index:false,       // 默认为true  访问的文件为index.html  可以修改为别的文件名或者false
  		hidden:false,      // 是否同意传输隐藏文件
  		defer:true,		   // 如果为true，则在返回next()之后进行服务，从而允许后续中间件先进行响应
 }) 

koa-static-cache

• 作用同koa-static,但是可以配置缓存策略
• 安装 koa-static-cache
  npm i koa-static-cache
• 使用koa-static-cache

const KoaStaticCache = require('koa-static-cache');
app.use(KoaStaticCache('./static', {
    prefix: '/public',  // URL前缀，默认是 '.'
    maxAge: 0,     // 缓存时间，单位毫秒，默认为0
    gzip: true,   // 启用gzip压缩传输，默认为true
    dynamic: true  
}));

koa-body

• 安装 koa-body
  npm i koa-body
• 使用koa-body

const koaBody = require('koa-body');
app.use(koaBody({
    multipart: true,
    // 处理上传的二进制文件
    formidable: {
        // 上传目录
        uploadDir: __dirname + '/public/upload',
        // 是否保留上传文件名后缀
        keepExtensions: true,
        onFileBegin(name, file) {
             // console.log('name, file', name, file);
            return false;
        }
    }
}));

demo

• app.js

const Koa = require('koa');
const KoaRouter = require('koa-router');
const KoaStaticCache = require('koa-static-cache');
// 创建 server 对象
const server = new Koa();
// 创建静态文件代理服务
server.use( KoaStaticCache('./public', {
    prefix: '/public',
    gzip: true,
    dynamic: true
}) );
// 除了上面以 /public 开头的url，其它都会走下面router进行处理
// 创建动态资源（使用router来为动态资源做映射）
// 创建一个router对象
const router = new KoaRouter();
// 用 router 来注册各种需要用到的url资源处理函数
router.get('/', ctx => {
    ctx.body = 'Hello';
});
router.get('/getData', ctx => {
    // 不是合法的json格式
    // ctx.body = "{'name': 'koa'}";
    // 必须是双引号
    // ctx.set('Content-Type', 'application/json;charset=utf-8');
    // ctx.body = '{"name": "koa"}';
    // koa 框架内部帮助我们做了一些处理，如果你给body设置一个对象，那么koa内部会把这个对象转成json以后再发送，同时设置头信息application/json;charset=utf-8
    ctx.body = {name: 'koa'};
    // ctx.type = 'application/json;charset=utf-8';
    // 等同下面的代码
    // ctx.set('Content-Type', 'application/json;charset=utf-8');
});
router.post('/attachment', upload('/static/attachment'), async ctx => {
    console.log(ctx.files);
    ctx.body = '上传成功';
});
// 把router对象的routes中间件注册到Koa中
server.use(router.routes());
// 启动服务，并监听指定的端口
server.listen(8081, () => {
    console.log('服务启动成功，http://localhost:8081');
});

function upload(dir) {
    return koaBody({
        // 开启二进制content-type类型的处理
        multipart: true,
        formidable: {
            uploadDir: __dirname + dir,
            keepExtensions: true,
            onFileBegin(name, file) {
                // console.log('name, file', name, file);
                return false;
            }
        }
    });
}