Skip to content

Latest commit

 

History

History
214 lines (145 loc) · 5.54 KB

study-koa.md

File metadata and controls

214 lines (145 loc) · 5.54 KB

以express的方式学习koa

假定你是一个熟悉express的nodejs工程师

  • 熟悉nodejs
  • 熟悉expressjs
  • 想快速学习koa

什么是koa?

koa 是由 Express 原班人马打造的,致力于成为一个更小、更富有表现力、更健壮的 Web 框架。使用 koa 编写 web 应用,通过组合不同的 generator,可以免除重复繁琐的回调函数嵌套,并极大地提升错误处理的效率。koa 不在内核方法中绑定任何中间件,它仅仅提供了一个轻量优雅的函数库,使得编写 Web 应用变得得心应手。

http://koajs.com/

更多中间件,上下文,异常处理等,详见Koa or Express

express和koa比较

https://github.com/koajs/koa/blob/master/docs/koa-vs-express.md

Feature Koa Express Connect
Middleware Kernel
Routing
Templating
Sending Files
JSONP

这是一份很久以前的文档,目前来看也是对的,但是koa的生态已经很好了

Feature Koa Express Connect
Middleware Kernel
Routing ✓ koa-router
Templating ✓ koa-views
Sending Files ✓ koa-send
JSONP ✓ koa-safe-jsonp

该有的基本都有了,于是我仿着express-generator写了koa-generator

技术栈如下

生成器

generator是生成器的意思,用于生成项目骨架,express-generator就是一个比较好的例子,虽然比较精简,但结构清晰,足矣满足一帮性需求

鉴于很多人非常熟悉expressjs,我就假定大家也熟悉express-generator

express-generator提供的功能

  • 生成项目骨架
  • 约定目录结构(经典,精简,结构清晰)
  • 支持css预处理器

express-generator提供的功能

  • 生成项目骨架
  • 约定目录结构(和express-generator的结构一模一样)
  • 支持css预处理器(暂未实行)

2个生成器共同的项目骨架结构

  • app.js为入口
  • bin/www为启动入口
  • 支持static server,即public目录
  • 支持routes路由目录
  • 支持views视图目录
  • 模式jade模板引擎

用法

npm install -g koa-generator

然后使用koa命令创建项目

当前目录创建,如果非空需要加force选项

koa

创建项目目录

koa helloworld

实例

➜  koatest  koa helloworld

   create : helloworld
   create : helloworld/package.json
   create : helloworld/app.js
   create : helloworld/public
   create : helloworld/public/javascripts
   create : helloworld/public/images
   create : helloworld/public/stylesheets
   create : helloworld/public/stylesheets/style.css
   create : helloworld/routes
   create : helloworld/routes/index.js
   create : helloworld/routes/users.js
   create : helloworld/views
   create : helloworld/views/index.jade
   create : helloworld/views/layout.jade
   create : helloworld/views/error.jade
   create : helloworld/bin
   create : helloworld/bin/www

   install dependencies:
     $ cd helloworld && npm install

   run the app:
     $ DEBUG=helloworld:* npm start

➜  koatest  cd helloworld 
➜  helloworld  npm install
➜  helloworld  npm start

此时访问

路由写法说明

只要是koa-router写的路由都可以加载的,加载方式和express里一样

var router = require('koa-router')();

router.get('/', function *(next) {
  this.body = 'this /1!';
});


router.get('2', function *(next) {
  this.body = 'this /2!';
});

module.exports = router;

一定要区分

url = /2
router.get('2', function *(next) {
  this.body = 'this /2!';
});
url = //2
router.get('/2', function *(next) {
  this.body = 'this /2!';
});

这个是koa-router的一个问题,和express里的路由稍有不一样,注意一些即可

koa-generator

项目地址 https://github.com/base-n/koa-generator/

分支

  • master是生成器,里面的templates目录放模板
  • tpl是项目模板

欢迎fork、star或issue,O(∩_∩)O谢谢

总结

打通了express-generator和koa-generator玄关后,剩下的就是习惯koa的语法,整个世界就更简单了

另外项目骨架的好处是约定技术栈,你可以在上面基础上做更多更有意思的事儿

提前报个料moajs很快会放出一个基于koa的版本来

全文完

欢迎关注我的公众号【node全栈】

node全栈.png