koa merujuk kepada rangka kerja web berdasarkan Node yang serupa dengan Express, dan komited untuk menjadi asas yang lebih kecil, lebih ekspresif dan lebih mantap dalam bidang aplikasi web dan pembangunan API. Koa tidak menghimpunkan sebarang perisian tengah, tetapi menyediakan satu set kaedah yang elegan untuk membantu pengguna menulis aplikasi sebelah pelayan dengan cepat dan gembira.
Persekitaran pengendalian tutorial ini: sistem windows7, nodejs versi 12.19.0&&koa2.0, komputer Dell G3.
Koa
ialah rangka kerja pembangunan yang serupa dengan Express的Web
, dan pengasasnya adalah orang yang sama. Ciri utamanya ialah penggunaan ES6的Generator函数
dan reka bentuk semula seni bina. Dalam erti kata lain, prinsip dan struktur dalaman Koa sangat serupa dengan Express, tetapi sintaks dan struktur dalaman telah dinaik taraf.
Koa ialah rangka kerja web baharu yang dibina oleh orang yang sama di belakang Express, khusus untuk menjadi asas yang lebih kecil, lebih ekspresif dan lebih mantap untuk aplikasi web dan pembangunan API. Dengan memanfaatkan fungsi async, Koa membantu anda membuang fungsi panggil balik dan meningkatkan pengendalian ralat. Koa tidak menggabungkan sebarang perisian tengah, tetapi menyediakan satu set kaedah yang elegan untuk membantu anda menulis aplikasi sebelah pelayan dengan cepat dan gembira.
Rasmifaq
Ada soalan: "Kenapa koa bukan Express 4.0?", jawapannya begini: ”Koa与Express有很大差异,整个设计都是不同的,所以如果将Express 3.0按照这种写法升级到4.0,就意味着重写整个程序。所以,我们觉得创造一个新的库,是更合适的做法。“
satuKoa应用
ialah 对象
, mengandungi tatasusunan middleware
, yang terdiri daripada kumpulan Generator函数
. Fungsi ini bertanggungjawab untuk pelbagai pemprosesan permintaan HTTP, seperti menjana cache, menentukan proksi, permintaan pengalihan, dsb.
var koa = require('koa'); var app = koa(); app.use(function *(){ this.body = 'Hello World'; }); app.listen(3000);
Hello World
. Kaedah app.use
digunakan untuk menambah middleware
pada tatasusunan Generator函数
. Kaedah listen
menentukan port mendengar dan memulakan aplikasi semasa. var http = require('http'); var koa = require('koa'); var app = koa(); http.createServer(app.callback()).listen(3000);
Koa
sangat serupa dengan Express的中间件
dan juga 对HTTP请求进行处理的函数
, tetapi ia mestilah Generator函数
.
Selain itu, middleware Koa ialah struktur 级联式(Cascading)
, iaitu, ia dipanggil lapisan demi lapisan, 第一个中间件调用第二个中间件
, 第二个调用第三个
, dan sebagainya. 上游的中间件必须等到下游的中间件返回结果
akan terus dilaksanakan, yang hampir sama dengan rekursi.
Middleware didaftarkan melalui kaedah use
aplikasi semasa.
app.use(function* (next){ var start = new Date; // (1) yield next; // (2) var ms = new Date - start; // (3) console.log('%s %s - %s', this.method, this.url, ms); // (4) });
Dalam kod di atas, parameter kaedah app.use
ialah perisian tengah, iaitu Generator函数
Ciri terbesar ialah antara function命令
dan parameter, 必须有一个星号
. Parameter fungsi Penjana next
mewakili perisian tengah seterusnya. Fungsi Generator
menggunakan perintah yield
secara dalaman untuk memindahkan hak pelaksanaan program ke middleware seterusnya, iaitu, yield next
Pelaksanaan akan diteruskan sehingga middleware seterusnya mengembalikan hasilnya.
Generator函数体内部
, baris pertama pernyataan tugasan dilaksanakan terlebih dahulu dan mula pemasaan, yield
menyerahkan hak pelaksanaan ke middleware seterusnya, pelaksanaan middleware semasa akan digantung app.use(function *() { this.body = "header\n"; yield saveResults.call(this); this.body += "footer\n"; }); function *saveResults() { this.body += "Results Saved!\n"; }
Dalam kod di atas, middleware pertama memanggil middleware kedua saveResults, dan kedua-duanya menulis kandungan ke this.body. Akhir sekali, output this.body adalah seperti berikut.
header Results Saved! footer
Selagi satu perisian tengah tiada penyataan yield next
, perisian tengah berikutnya tidak akan dilaksanakan. Perkara ini perlu diambil perhatian.
app.use(function *(next){ console.log('>> one'); yield next; console.log('<< one'); }); app.use(function *(next){ console.log('>> two'); this.body = 'two'; console.log('<< two'); }); app.use(function *(next){ console.log('>> three'); yield next; console.log('<< three'); });
Dalam kod di atas, kerana perisian tengah kedua tiada pernyataan yield next
, perisian tengah ketiga tidak akan dilaksanakan.
Jika anda ingin melangkau perisian tengah, anda boleh terus menulis hasil pulangan seterusnya dalam baris pertama perisian tengah.
app.use(function* (next) { if (skip) return yield next; })
Disebabkan Koa要求中间件唯一的参数就是next
, jika anda ingin meneruskan parameter lain, anda mesti menulis fungsi lain yang mengembalikan Generator函数
.
function logger(format) { return function *(next){ var str = format .replace(':method', this.method) .replace(':url', this.url); console.log(str); yield next; } } app.use(logger(':method :url'));
Dalam kod di atas, middleware sebenar ialah nilai pulangan bagi fungsi logger, dan fungsi logger boleh menerima parameter.
由于中间件的参数统一为next
(意为下一个中间件),因此可以使用.call(this, next)
,将多个中间件进行合并。
function *random(next) { if ('/random' == this.path) { this.body = Math.floor(Math.random()*10); } else { yield next; } }; function *backwards(next) { if ('/backwards' == this.path) { this.body = 'sdrawkcab'; } else { yield next; } } function *pi(next) { if ('/pi' == this.path) { this.body = String(Math.PI); } else { yield next; } } function *all(next) { yield random.call(this, backwards.call(this, pi.call(this, next))); } app.use(all);
上面代码中,中间件all内部,就是依次调用random、backwards、pi,后一个中间件就是前一个中间件的参数。
Koa内部使用koa-compose
模块,进行同样的操作,下面是它的源码。
function compose(middleware){ return function *(next){ if (!next) next = noop(); var i = middleware.length; while (i--) { next = middleware[i].call(this, next); } yield *next; } } function *noop(){}
上面代码中,middleware是中间件数组。前一个中间件的参数是后一个中间件,依次类推。如果最后一个中间件没有next参数,则传入一个空函数。
可以通过this.path属性,判断用户请求的路径,从而起到路由作用。
app.use(function* (next) { if (this.path === '/') { this.body = 'we are at home!'; } }) // 等同于 app.use(function* (next) { if (this.path !== '/') return yield next; this.body = 'we are at home!'; })
下面是多路径的例子。
let koa = require('koa') let app = koa() // normal route app.use(function* (next) { if (this.path !== '/') { return yield next } this.body = 'hello world' }); // /404 route app.use(function* (next) { if (this.path !== '/404') { return yield next; } this.body = 'page not found' }); // /500 route app.use(function* (next) { if (this.path !== '/500') { return yield next; } this.body = 'internal server error' }); app.listen(8080)
上面代码中,每一个中间件负责一个路径,如果路径不符合,就传递给下一个中间件。
复杂的路由需要安装koa-router插件。
var app = require('koa')(); var Router = require('koa-router'); var myRouter = new Router(); myRouter.get('/', function *(next) { this.response.body = 'Hello World!'; }); app.use(myRouter.routes()); app.listen(3000);
上面代码对根路径设置路由。
Koa-router实例提供一系列动词方法,即一种HTTP动词对应一种方法。典型的动词方法有以下五种。
路径模式
,第二个是对应的控制器方法
(中间件),定义用户请求该路径时服务器行为。router.get('/', function *(next) { this.body = 'Hello World!'; });
上面代码中,router.get
方法的第一个参数是根路径,第二个参数是对应的函数方法。注意
,路径匹配的时候,不会把查询字符串考虑在内。比如,/index?param=xyz匹配路径/index。
有些路径模式比较复杂,Koa-router允许为路径模式起别名。
起名时,别名要添加为动词方法的第一个参数,这时动词方法变成接受三个参数。
router.get('user', '/users/:id', function *(next) { // ... });
上面代码中,路径模式\users\:id
的名字就是user
。路径的名称,可以用来引用对应的具体路径,比如url方法可以根据路径名称,结合给定的参数,生成具体的路径。
router.url('user', 3); // => "/users/3" router.url('user', { id: 3 }); // => "/users/3"
上面代码中,user就是路径模式的名称,对应具体路径/users/:id。url方法的第二个参数3,表示给定id的值是3,因此最后生成的路径是/users/3。
Koa-router允许为路径统一添加前缀。
var router = new Router({ prefix: '/users' }); router.get('/', ...); // 等同于"/users" router.get('/:id', ...); // 等同于"/users/:id"
路径的参数通过this.params
属性获取,该属性返回一个对象,所有路径参数都是该对象的成员。
// 访问 /programming/how-to-node router.get('/:category/:title', function *(next) { console.log(this.params); // => { category: 'programming', title: 'how-to-node' } }); param方法可以针对命名参数,设置验证条件。 router .get('/users/:user', function *(next) { this.body = this.user; }) .param('user', function *(id, next) { var users = [ '0号用户', '1号用户', '2号用户']; this.user = users[id]; if (!this.user) return this.status = 404; yield next; })
上面代码中,如果/users/:user
的参数user对应的不是有效用户(比如访问/users/3),param方法注册的中间件会查到,就会返回404错误。
redirect方法会将某个路径的请求,重定向到另一个路径,并返回301状态码。
router.redirect('/login', 'sign-in'); // 等同于 router.all('/login', function *() { this.redirect('/sign-in'); this.status = 301; });
redirect方法的第一个参数是请求来源,第二个参数是目的地,两者都可以用路径模式的别名代替。
this
表示上下文对象context
,代表一次HTTP请求和回应
,即一次访问/回应的所有信息,都可以从上下文对象获得。app.use(function *(){ this; // is the Context this.request; // is a koa Request this.response; // is a koa Response });
context
对象的很多方法,其实是定义在ctx.request对象或ctx.response对象上面
比如,ctx.type
和ctx.length
对应于ctx.response.type
和ctx.response.length
,ctx.path和ctx.method对应于ctx.request.path和ctx.request.method。
context对象的全局属性。
this.state.user = yield User.find(id);
上面代码中,user
属性存放在this.state
对象上面,可以被另一个中间件读取。
context对象的全局方法。
this.throw(403); this.throw('name required', 400); this.throw('something exploded'); this.throw(400, 'name required'); // 等同于 var err = new Error('name required'); err.status = 400; throw err;
Koa提供内置的错误处理机制,任何中间件抛出的错误都会被捕捉到,引发向客户端返回一个500
错误,而不会导致进程停止,因此也就不需要forever这样的模块重启进程。
app.use(function *() { throw new Error(); });
上面代码中,中间件内部抛出一个错误,并不会导致Koa应用挂掉。Koa内置的错误处理机制,会捕捉到这个错误。
当然,也可以额外部署自己的错误处理机制。
app.use(function *() { try { yield saveResults(); } catch (err) { this.throw(400, '数据无效'); } });
上面代码自行部署了try...catch
代码块,一旦产生错误,就用this.throw
方法抛出。该方法可以将指定的状态码和错误信息,返回给客户端。
对于未捕获错误,可以设置error事件的监听函数。
app.on('error', function(err){ log.error('server error', err); });
error
事件的监听函数还可以接受上下文对象,作为第二个参数。
app.on('error', function(err, ctx){ log.error('server error', err, ctx); });
如果一个错误没有被捕获,koa会向客户端返回一个500错误“Internal Server Error”。this.throw
方法用于向客户端抛出一个错误。
this.throw(403); this.throw('name required', 400); this.throw(400, 'name required'); this.throw('something exploded'); this.throw('name required', 400) // 等同于 var err = new Error('name required'); err.status = 400; throw err; this.throw方法的两个参数,一个是错误码,另一个是报错信息。如果省略状态码,默认是500错误。 this.assert方法用于在中间件之中断言,用法类似于Node的assert模块。 this.assert(this.user, 401, 'User not found. Please login!');
上面代码中,如果this.user属性不存在,会抛出一个401错误。
由于中间件是层级式调用,所以可以把try { yield next }
当成第一个中间件。
app.use(function *(next) { try { yield next; } catch (err) { this.status = err.status || 500; this.body = err.message; this.app.emit('error', err, this); } }); app.use(function *(next) { throw new Error('some error'); })
cookie的读取和设置。
this.cookies.get('view'); this.cookies.set('view', n);
get和set
方法都可以接受第三个参数,表示配置参数。其中的signed
参数,用于指定cookie
是否加密。
如果指定加密的话,必须用app.keys指定加密短语。
app.keys = ['secret1', 'secret2']; this.cookies.set('name', '张三', { signed: true });
this.cookie的配置对象的属性如下。
signed
:cookie是否加密。expires
:cookie何时过期path
:cookie的路径,默认是“/”。domain
:cookie的域名。secure
:cookie是否只有https请求下才发送。httpOnly
:是否只有服务器可以取到cookie,默认为true。var session = require('koa-session'); var koa = require('koa'); var app = koa(); app.keys = ['some secret hurr']; app.use(session(app)); app.use(function *(){ var n = this.session.views || 0; this.session.views = ++n; this.body = n + ' views'; }) app.listen(3000); console.log('listening on port 3000');
【推荐学习:《nodejs 教程》】
Atas ialah kandungan terperinci Apakah koa dalam nodejs. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!