用Node.js开发Web服务器端，有几个显著的优势：
速度快，非常快！这得益于Node.js天生是异步的。
好消息是这个教程已经帮你选好了，你只需要跟着教程一条道走到黑就可以了。
koa是Express的下一代基于Node.js的web框架，目前有1.x和2.0两个版本。建议用2.0
Express是第一代最流行的web框架，它对Node.js的http进行了封装
var
express =
require
(
'express'
);
var
app = express(); app.get(
'/'
,
function
(req, res) { res.send(
'Hello World!'
); }); app.listen(
3000
,
function
() { console.log(
'Example app listening on port 3000!'
); });
koa2的代码看上去像这样：
app.
use
(async (ctx, next) => { await next();
var
data = await doReadFile(); ctx.response.type =
'text/plain'
; ctx.response.body = data; });
koa入门
如何安装koa2
可以用npm命令直接安装koa。先打开命令提示符，务必把当前目录切换到
文件所在的那个
目录，然后执行命令：
npm install koa
@2
.
0
.
0
任何时候都可以直接删除整个
node_modules
目录，因为用
npm install
命令可以完整地重新下载所有依赖。并且，这个目录不应该被放入版本控制中。
或者通过下面方式安装：
创建一个
package.json
，这个文件描述了我们的
hello-koa
工程会用到哪些包
{ "
name
":
"hello-koa2"
, "
version
":
"1.0.0"
, "
description
":
"Hello Koa 2 example with async"
, "
main
":
"app.js"
, "
scripts
": { "
start
":
"node app.js"
}, "
keywords
": [
"koa"
,
"async"
], "
author
":
"Michael Liao"
, "
license
":
"Apache-2.0"
, "
repository
": { "
type
":
"git"
, "
url
":
"https://github.com/michaelliao/learn-javascript.git"
}, "
dependencies
": { "
koa
":
"2.0.0"
} }
其中，
dependencies
描述了我们的工程依赖的包以及版本号。其他字段均用来描述项目信息，
可任意填写。
然后，我们在
hello-koa
目录下执行
npm install
就可以把所需包以及依赖包一次性全部装好：
npm start
命令会让npm执行定义在
package.json
文件中的start对应命令
// 导入koa，和koa 1.x不同，在koa2中，我们导入的是一个class，因此用大写的Koa表示:
const
Koa =
require
(
'koa'
);
// 创建一个Koa对象表示web app本身:
const
app =
new
Koa();
// 对于任何请求，app将调用该
异步函数
处理请求：
app.
use
(async (ctx, next) => { await next(); ctx.response.type =
'text/html'
; ctx.response.body =
'<h1>Hello, koa2!</h1>'
; });
// 在端口3000监听:
app.listen(
3000
); console.log(
'app started at port 3000...'
);
其中，参数
ctx
是由koa传入的
封装了request和response的变量
，我们可以通过它访问request和response，
next
是koa传入的将要处理的下一个异步函数。
async
标记的函数称为异步函数，在异步函数中，可以用
await
调用另一个异步函数，这两个关键字将在ES7中引入。
每收到一个http请求，koa就会调用通过
app.use()
注册的async函数，并传入
ctx
和
next
参数。
为什么要调用
await next()
？
原因是koa把很多async函数组成一个处理链，每个async函数都可以做一些自己的事情，然后用
await next()
来调用下一个async函数。我们把每个async函数称为middleware，这些middleware可以组合起来，完成很多有用的功能。
console.log(`${ctx.request.method} ${ctx.request.url}`);
// 打印URL
const
ms =
new
Date().getTime() - start;
// 耗费时间
console.log(`Time: ${ms}ms`);
// 打印耗费时间
如果一个middleware没有调用
await next()
，会怎么办？答案是后续的middleware将不再执行了。
例如，一个检测用户权限的middleware可以决定是否继续处理请求，还是直接返回403错误：
app.use(async (ctx,
next
) => {
if
(await checkUserPermission(ctx)) { await
next
(); }
else
{ ctx.response.status =
403
; } });
处理url路由
"koa-router": "7.0.0"
const
Koa = require(
'koa'
);
// 注意require('koa-router')返回的是函数:
const
router = require(
'koa-router'
)();
const
app =
new
Koa();
// log request URL:
app.use(async (ctx, next) => { console.log(`Process ${ctx.request.method} ${ctx.request.url}...`); await next(); });
// add url-route:
router.get(
'/hello/:name'
, async (ctx, next) => {
var
name =
ctx.params.name;
ctx.response.body = `<h1>Hello, ${name}!
</h1>
`; });
router.get
('/', async (ctx, next) => { ctx.response.body = '
<h1>
Index
</h1>
'; }); // add router middleware: app.use(router.routes()); app.listen(3000); console.log('app started at port 3000...');
注意导入
koa-router
的语句最后的
()
是函数调用：
处理post请求
可以用
router.post('/path', async ...
注意：
需要引入另一个middleware来解析原始request请求，然后，把解析后的参数，绑定到
ctx.request.body
中。
"koa-bodyparser": "3.2.0"
const
bodyParser =
require
(
'koa-bodyparser'
);
在合适的位置加上：
app.
use
(bodyParser());
由于middleware的顺序很重要，这个
koa-bodyparser
必须在
router
之前被注册到
app
对象上。
name = ctx.request.body.name || '', //
默认值
把URL处理函数集中到某几个js文件中
比如 在
controllers
目录下编写
index.js
：
var fn_index = async (ctx, next) => { ctx.response.body = `
<h1>
Index
</h1>
<form
action
=
"/signin"
method
=
"post"
>
<p>
Name:
<input
name
=
"name"
value
=
"koa"
></p>
<p>
Password:
<input
name
=
"password"
type
=
"password"
></p>
<p><input
type
=
"submit"
value
=
"Submit"
></p>
</form>
`; };
...
module.exports = { 'GET /': fn_index, 'POST /signin': fn_signin };
另一个
var
fn_hello = async (ctx, next) => {
var
name = ctx.params.name; ctx.response.body = `<h1>Hello, ${name}!
</h1>
`; }; module.exports = { 'GET /hello/:name': fn_hello };
修改
app.js
，让它自动扫描
controllers
目录，找到所有
js
文件，导入，然后注册每个URL：
let
命令，用来声明变量。它的用法类似于
var
，但是所声明的变量，只在
let
命令所在的代码块内有效。
for
循环的计数器，就很合适使用
let
命令。
const
fs =
require
(
'fs'
);
function
addMapping
(router, mapping) {
for
(
var
url
in
mapping) {
if
(url.startsWith(
'GET '
)) {
var
path = url.substring(
4
); router.get(path, mapping[url]); console.log(`register URL mapping: GET ${path}`); }
else
if
(url.startsWith(
'POST '
)) {
var
path = url.substring(
5
); router.post(path, mapping[url]); console.log(`register URL mapping: POST ${path}`); }
else
{ console.log(`invalid URL: ${url}`); } } }
function
addControllers
(router) {
var
files = fs.readdirSync(__dirname +
'/controllers'
);
var
js_files = files.filter((f) => {
return
f.endsWith(
'.js'
); });
for
(
var
f of js_files) { console.log(`process controller: ${f}...`);
let
mapping = require(__dirname +
'/controllers/'
+ f); addMapping(router, mapping); } } //addControllers(router);
module.exports =
function
(dir) { let controllers_dir = dir ||
'controllers'
,
// 如果不传参数，扫描目录默认为'controllers'
router =
require
(
'koa-router'
)(); addControllers(router,
controllers_dir
);
return
router.routes(); };
主文件中
// 导入controller middleware:
const
controller =
require
(
'./controller'
); ...
// 使用middleware:
app.
use
(controller());
其它：
Nunjucks
模板引擎
2219
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
