Koa 是一个新的 web 框架,由 Express 幕后的原班人马打造, 致力于成为 web 应用和 API 开发领域中的一个更小、更富有表现力、更健壮的基石。 通过利用 async 函数,Koa 帮你丢弃回调函数,并有力地增强错误处理。 Koa 并没有捆绑任何中间件, 而是提供了一套优雅的方法,帮助您快速而愉快地编写服务端应用程序。

  1. npm install koa

每收到一个http请求,koa就会调用通过app.use()注册的async函数,并传入ctx和next参数
middleware的顺序很重要,也就是调用app.use()的顺序决定了middleware的顺序

对于await next(),如果一个middleware没有调用,则后续的middleware将不再执行了,使用场景
如,一个检测用户权限的middleware可以决定是否继续处理请求,还是直接返回403错误

  1. app.use(async (ctx, next) => {
  2. if (await checkUserPermission(ctx)) {
  3. await next();
  4. } else {
  5. ctx.response.status = 403;
  6. }
  7. });

ctx简写

  1. ctx.url相当于ctx.request.urlctx.type相当于ctx.response.type

安装koa-router

  1. npm install koa-router
  1. // 注意require('koa-router')返回的是函数:
  2. const router = require('koa-router')();
  3. 这里导入koa-router的语句最后的()是函数调用
  4. const router = require('koa-router')();
  5. 相当于
  6. const fn_router = require('koa-router');
  7. const router = fn_router();
  8. // add url-route:
  9. router.get('/hello/:name', async (ctx, next) => {
  10. var name = ctx.params.name;
  11. ctx.response.body = `<h1>Hello, ${name}!</h1>`;
  12. });
  13. router.get('/', async (ctx, next) => {
  14. ctx.response.body = '<h1>Index</h1>';
  15. });
  16. // add router middleware:
  17. app.use(router.routes());

这样我们在访问http://localhost:3000/hello/kerry时会打印hello,kerry

post请求通常会发送一个表单,或者JSON,它作为request的body发送,但无论是Node.js提供的原始request对象,还是koa提供的request对象,都不提供解析request的body的功能,所以我们需要用到koa-bodyparser中间件来解析request的body

安装koa-bodyparser

  1. npm install koa-bodyparser
  1. const bodyParser = require('koa-bodyparser');
  2. // 解决body 需在router之前注册到app对象上
  3. app.use(bodyParser());
  4. 这样我们就可以处理post请求了
  5. router.get('/', async (ctx, next) => {
  6. ctx.response.body = `<h1>Index</h1>
  7. <form action="/signin" method="post">
  8. <p>Name: <input name="name" value="koa"></p>
  9. <p>Password: <input name="password" type="password"></p>
  10. <p><input type="submit" value="Submit"></p>
  11. </form>`;
  12. });
  13. router.post('/signin', async (ctx, next) => {
  14. var
  15. name = ctx.request.body.name || '',
  16. password = ctx.request.body.password || '';
  17. console.log(`signin with name: ${name}, password: ${password}`);
  18. if (name === 'koa' && password === '12345') {
  19. ctx.response.body = `<h1>Welcome, ${name}!</h1>`;
  20. } else {
  21. ctx.response.body = `<h1>Login failed!</h1>
  22. <p><a href="/">Try again</a></p>`;
  23. }
  24. });

所有的代码都放在了app.js中
我们可以单独将所有路由放到一个js文件中,如果是复杂系统,还可以按模块建立多个路由文件,如
user.js(处理用户管理相关url)、login.js(处理用户登录相关url)

安装koa-static

  1. npm install koa-static
  1. const static = require('koa-static')
  2. const path = require('path')
  3. // 静态资源目录
  4. app.use(static(
  5. path.join( __dirname,'./static')
  6. ));

我们在根目录下建立static文件夹,新建一个json文件,输入如下地址访问

  1. http://localhost:3000/china.geojson
  1. npm install --save art-template
  2. npm install --save koa-art-template
  3. // 模板引擎
  4. const render = require('koa-art-template');
  5. render(app, {
  6. root: path.join(__dirname, './static'),
  7. extname: '.html',
  8. // debug: process.env.NODE_ENV !== 'production'
  9. });
  10. // 使用ctx.render渲染页面 可传递数据
  11. router.get('/user', async (ctx, next) => {
  12. ctx.render('user',{
  13. data:'hello msg'
  14. });
  15. });

html中渲染数据 {{data}}

更多用法查看
https://aui.github.io/art-template/zh-cn/docs/index.html

  1. https://github.com/zadzbw/koa2-cors
  2. npm install --save koa2-cors
  3. var cors = require('koa2-cors');
  4. app.use(cors());

1、 项目搭建好后,通过node运行

  1. node app.js

也可以在package.json中添加scripts

  1. "scripts": {
  2. "start": "node app.js"
  3. }

这样就可以运行

  1. npm run start

然后访问http://localhost:3000

2、 通过nodemon来运行项目

  1. npm install -g nodemon

之后用 nodemon 来代替 node 来启动应用

  1. nodemon app.js

3、 如果是在线上 我们则使用pm2来管理应用程序,
pm2 是一个带有负载均衡功能的Node应用的进程管理器.当你要把你的独立代码利用全部的服务器上的所有CPU,并保证进程永远都活着,0秒的重载, PM2是完美的
https://www.cnblogs.com/lxg0/p/7771229.html

通过以上简单介绍对koa2使用,我搭建了一个koa2本地静态node服务器,已上传至github,欢迎大家star或clone
koa2-server

版权声明:本文为fozero原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.cnblogs.com/fozero/p/10171322.html