沪江CCtalk视频地址:https://www.cctalk.com/v/15114923886141
JSON 数据
我颠倒了整个世界,只为摆正你的倒影。
前面的文章中,我们已经完成了项目中常见的问题,比如 路由请求
、结构分层
、视图渲染
、静态资源
等。
那么,JSON
呢?JSON
格式数据的传输,已经深入到了我们的码里行间,脱离了 JSON
的人想必是痛苦的。那么,复合吧!
如何设置 JSON 格式
伟大的武术家——李小龙先生——说过这样一段话:
Empty your mind, Be formless,shapeless like water.
You put water in a cup, it becomes the cup.
You put water in a bottle, it becomes the bottle.
You put water in a teapot , it becomes the teapot.
Water can flow or crash.
翻译成中文意思就是:
清空你的思想,像水一样无形。
你将水倒入水杯,水就是水杯的形状。
你将水倒入瓶子,水就是瓶子的形状。
你将水倒入茶壶,水就是茶壶的形状。
你看,水会流动,也会冲击。
在数据传输过程中,传输的资源都可以称之为『数据』,而『数据』之所以展示出不同的形态,是因为我们已经设置了它的格式。
传输的数据像是『水』一样,没有任何的格式和形状。
我们的设置像是『器』一样,赋予它指定的形态。
所以,我们只需要设置把数据挂载在响应体 body
上,同时告诉客户端『返回的是 JSON
数据』,客户端就会按照 JSON
来解析了。代码如下:
ctx.set("Content-Type", "application/json")
ctx.body = JSON.stringify(json)
提取中间件
我们把上面的代码提取成一个中间件,这样更方便代码的维护性和扩展性
增加文件 /middleware/mi-send/index.js
:
module.exports = () => {
function render(json) {
this.set("Content-Type", "application/json")
this.body = JSON.stringify(json)
}
return async (ctx, next) => {
ctx.send = render.bind(ctx)
await next()
}
}
注意: 目录不存在,需要自己创建。
代码中,我们把 JSON
数据的处理方法挂载在 ctx
对象中,并起名为 send
。当我们需要返回 JSON
数据给客户端时候,只需要调用此方法,并把 JSON
对象作为参数传入到方法中就行了,用法如下:
ctx.send({
status: 'success',
data: 'hello ikcmap'
})
应用中间件
代码的实现过程和调用方法我们已经知道了,现在我们需要把这个中间件应用在项目中。
- 增加文件
middleware/index.js
,用来集中调用所有的中间件:
const miSend = require('./mi-send')
module.exports = (app) => {
app.use(miSend())
}
- 修改
app.js
,增加中间件的引用
const Koa = require('koa')
const path = require('path')
const bodyParser = require('koa-bodyparser')
const nunjucks = require('koa-nunjucks-2')
const staticFiles = require('koa-static')
const app = new Koa()
const router = require('./router')
const middleware = require('./middleware')
middleware(app)
app.use(staticFiles(path.resolve(__dirname, "./public")))
app.use(nunjucks({
ext: 'html',
path: path.join(__dirname, 'views'),
nunjucksConfig: {
trimBlocks: true
}
}));
app.use(bodyParser())
router(app)
app.listen(3000, () => {
console.log('server is running at http://localhost:3000')
})
中间件迁移
随着项目的步步完善,将会产生有更多的中间件。我们把 app.js
中的中间件代码迁移到 middleware/index.js
中,方便后期维护扩展
- 修改
app.js
const Koa = require('koa')
const app = new Koa()
const router = require('./router')
const middleware = require('./middleware')
middleware(app)
router(app)
app.listen(3000, () => {
console.log('server is running at http://localhost:3000')
})
- 修改
middleware/index.js
const path = require('path')
const bodyParser = require('koa-bodyparser')
const nunjucks = require('koa-nunjucks-2')
const staticFiles = require('koa-static')
const miSend = require('./mi-send')
module.exports = (app) => {
app.use(staticFiles(path.resolve(__dirname, "../public")))
app.use(nunjucks({
ext: 'html',
path: path.join(__dirname, '../views'),
nunjucksConfig: {
trimBlocks: true
}
}));
app.use(bodyParser())
app.use(miSend())
}
后面我们还会开发更多的中间件,比如日志记录、错误处理等,都会放在 middleware/
目录下处理。
下一篇:记录日志——开发日志中间件,记录项目中的各种形式信息
上一篇:iKcamp新课程推出啦~~~~~iKcamp|基于Koa2搭建Node.js实战(含视频)☞ 处理静态资源