一、koa的錯(cuò)誤處理
-
koa-onerror
koa有error事件殖氏，當(dāng)發(fā)生錯(cuò)誤雅采，可以通過(guò)error事件慨亲，對(duì)錯(cuò)誤統(tǒng)一處理。
var Koa = require('koa');
var app = Koa();
app.on('error', function(err,ctx){
console.log(err);
});
app.listen(3000);
上面這段代碼在如果捕獲到錯(cuò)誤巴刻，頁(yè)面會(huì)打印出 “Internal Server Error” （這是Koa對(duì)錯(cuò)誤的默認(rèn)處理）铐望。這個(gè)錯(cuò)誤我們?cè)诰C合監(jiān)控系統(tǒng)中也經(jīng)常見(jiàn)到，那么我們顯然無(wú)法根據(jù)這條日志得到什么信息。
TypeError: Cannot read property 'split' of undefined
at Object.Home.index (d:\test\route\home.js:143:31)
at GeneratorFunctionPrototype.next (native)
at Object.dispatch (d:\test\node_modules\koa-router\lib\router.js:97:44)
at GeneratorFunctionPrototype.next (native)
這些錯(cuò)誤信息是怎么報(bào)出來(lái)的的呢乒验，其實(shí)是Koa-onerror 中間件蒂阱，它優(yōu)化錯(cuò)誤信息狂塘，根據(jù)這些錯(cuò)誤信息就能更好的捕獲到錯(cuò)誤荞胡。
var onerror = require('Koa-onerror');
onerror(app);
二了嚎、koa日志
- koa-logger
app.use(require('koa-logger'));
-
log4js
log4js提供了多個(gè)日志等級(jí)分類歪泳，同時(shí)也能替代console.log輸出。另外它可以按照文件大小或者日期來(lái)生成本地日志文件敌卓，還可以使用郵件等形式發(fā)送日志伶氢。
用法：http://www.reibang.com/p/6b816c609669（version<2.0）
三癣防、請(qǐng)求數(shù)據(jù)解析
1、koa-bodyparser
用來(lái)解析body惧蛹，比如通過(guò)post來(lái)傳遞表單刑枝、json或上傳文件，數(shù)據(jù)不容易獲取靠娱，通過(guò)koa-bodyparser解析之后掠兄，在koa中this.body就能獲取到數(shù)據(jù)蚂夕。
支持json,form,text類型
用法：
const bodyparser = require('koa-bodyparser');
app.use(bodyparser({
enableTypes:['json', 'form', 'text']
}))
參數(shù)：
- disableBodyParser，可以動(dòng)態(tài)設(shè)置不轉(zhuǎn)換
app.use(async (ctx, next) => {
if (ctx.path === '/disable') ctx.disableBodyParser = true;
await next();
});
app.use(bodyparser());
- onerror侈贷，用戶化設(shè)置轉(zhuǎn)換出錯(cuò)時(shí)的處理
app.use(bodyparser({
onerror: function (err, ctx) {
ctx.throw('body parse error', 422);
}
}));
2俏蛮、koa-multer
解析multipart/form-data類型
const multer = require('koa-multer');
app.user(multer());
四、路由處理
1争涌、koa-router
① 基本用法：
var router = require('koa-router')();
router.get('/', function(ctx, next){
...
});
app
.use(router.routes())
.use(router.allowedMethods());
② router.get/post/put/del/all
router
.get('/', function (ctx, next) {
ctx.body = 'Hello World!';
})
.post('/users', function (ctx, next) {
})
.put('/users/:id', function (ctx, next) {
})
.del('/users/:id', function (ctx, next) {
})
.all('/users/:id', function (ctx, next) {
});
③ 多個(gè)中間件
router.get(
'/users/:id',
function (ctx, next) {
return User.findOne(ctx.params.id).then(function(user) {
ctx.user = user;
return next();
});
},
function (ctx) {
console.log(ctx.user);
// => { id: 17, name: "Alex" }
}
);
五亮垫、其他
1、koa-json
美觀的輸出JSON response的Koa中間件
有兩種使用方式：
一種是總是返回美化了的json數(shù)據(jù)：
const json = require('koa-json');
app.use(json());
另一種是默認(rèn)不進(jìn)行美化抑党，但是當(dāng)?shù)刂窓趥魅雙retty參數(shù)的時(shí)候包警，則返回的結(jié)果是進(jìn)行了美化的。
app.use(json({ pretty: false, param: 'pretty' }));
2底靠、koa-static
用于koa的靜態(tài)文件指定映射路徑害晦。
const staticServe = require('koa-static');
app.use(staticServe(root, opts));
參數(shù)：
① root：靜態(tài)文件的根目錄
② opts：
- maxage
瀏覽器緩存的最大時(shí)間（max-age），單位是milliseconds（毫秒）暑中。默認(rèn)為0 - hidden
允許傳送隱藏文件壹瘟，默認(rèn)為false - index
Default file name, defaults to ‘index.html’ - defer
If true, serves after yield next, allowing any downstream middleware to respond first. - gzip
當(dāng)client支持 gzip 而且被請(qǐng)求的文件也有一個(gè)以 .gz 為擴(kuò)展名的文件的時(shí)候，自動(dòng)以所請(qǐng)求文件對(duì)應(yīng)的 .gz 文件進(jìn)行返回鳄逾。默認(rèn)為true - extensions
Try to match extensions from passed array to search for file when no extension 是合格的 in URL. First found is served. (defaults to false)
3稻轨、koa-views
用于指定視圖的渲染模板類型
app.use(views(__dirname + '/views', {
extension: 'jade',
map: {
html: 'underscore'
},
engineSource: {
foo: () => Promise.resolve('bar')
},
options: {
helpers: {
uppercase: (str) => str.toUpperCase()
},
partials: {
subTitle: './my-partial' // requires ./my-partial.hbs
}
}
}));
參數(shù)：
① root雕凹，指明view文件的絕對(duì)路徑（注意這里不能用相對(duì)路徑）殴俱；
② opt，這里面又包含著四個(gè)配置項(xiàng)：
- extension枚抵，用于指明view文件的默認(rèn)后綴名线欲。
- map，指明后綴名為某種類型的文件采用何種引擎進(jìn)行處理汽摹。如上例中即指明后綴為.html的文件使用underscore引擎進(jìn)行處理李丰。
- engineSource，指明后綴名為某類型的文件采用某engine source來(lái)進(jìn)行處理逼泣，替換掉默認(rèn)的engine source —— consolidate趴泌。上例中表示所有以.foo為后綴的文件會(huì)被返回’bar’。
- options拉庶，這是傳入helpers和partials的地方嗜憔，這些options會(huì)被傳入到view engine中。
開(kāi)啟koa-views的debug模式：
在啟動(dòng)koa服務(wù)的時(shí)候添加一個(gè) DEBUG=koa-views 環(huán)境變量氏仗。
