Fastify 系列教程四（求对象、响应对象和插件）

Fastify 系列教程：

响应对象

路由的第二个参数即是响应对象 reply ，它有如下几个方法：

.code(statusCode) - 设置状态码。
.header(name, value) - 设置响应头。
.type(value) - 设置 Content-Type 字段。
.redirect([code,] url) - 重定向到特定的地址，code 参数是可选的 (默认为 302)。
.serializer(function) - 为有效荷载设置自定义的序列化器。
.send(payload) - 向客户端发送荷载，可以是文本、JSON、流或者一个错误对象。
.sent - 一个布尔值，用来判断 send 函数是否已经被调用。

示例：

fastify.get('/', options, function (request, reply) {
  // Your code
  reply
    .code(200)
    .header('Content-Type', 'application/json')
    .send({ hello: 'world' })
})

Code

如果没有设置 reply.code，默认 statusCode 是 200。

设置自定义的响应头。
如果没有设置 'Content-Type' 字段，Fastify 猜测你会使用 'application/json'，除非你要发送一个流，在这种情况下，Fastify会识别并设置 'Content-Type' 为 'application/octet-stream'。

注意，如果使用的序列化器不是序列化到 JSON，则必须设置自定义的 Content-Type 头。

Redirect

重定向一个请求到特定的地址，状态码是可选的，默认为 302。

reply.redirect('/home')

Type

设置响应头的 Content-Type字段。
这是 reply.header('Content-Type', 'the/type') 的简写。

reply.type('text/html')

Serializer

Fastify 作为一个完整的JSON兼容服务器而诞生，所以可以直接序列化 send() 函数中的有效荷载。如果你设置了输出 schema，那么会使用 fast-json-stringify 作为格式化JSON的工具包，否则使用 fast-safe-stringify。

如果想使用自定义的序列化器，比如 msgpack5 或者 protobuf，你可以使用 .serializer() ，注意：如果使用自定义的序列化器却不是序列化成JSON，那么必须得设置自定义的 'Content-Type' 头。

reply
  .header('Content-Type', 'application/x-protobuf')
  .serializer(protoBuf.serialize)

Promises

发送原生的 promises 和支持开箱即用的 async-await。

fastify.get('/promises', options, function (request, reply) {
  const promise = new Promise(function(){
    setTimeout(function(resolve, reject){
      resolve({hello: 'promise'})
    }, 1000)
  })
  reply
    .code(200)
    .send(promise)
})

// 上述代码将会在服务端延迟 1s 后成功响应 {hello: 'promise'}

fastify.get('/async-await', options, async function (request, reply) {
  var res = await new Promise(function (resolve) {
    setTimeout(resolve, 200, { hello: 'world' })
  })
  return res
})

Streams

也可以发送流，内部使用 pump 来避免文件描述符的泄露。如果你要发送流，并且尚未设置 “Content-Type” 头，则 send 将会以“application/octet-stream” 进行设置。

fastify.get('/streams', function (request, reply) {
  const fs = require('fs')
  const stream = fs.createReadStream('some-file', 'utf8')
  reply.send(stream)
})

Errors

如果你向 send 函数传入一个 Error 对象的实例，Fastify 将自动创建一个结构如下的错误

{
  error: String // the http error message
  message: String // the user error message
  statusCode: Number // the http status code
}

fastify.get('/error', function(request. reply){
  reply.send(new Error('error request'))
})

如果你想要扩展错误对象，可以使用 extendServerError

如果你传入错误对象并且设置小于 400 的状态码，Fastify 将会自动的设置成 500。

请求对象

路由的第一个参数即是请求对象 request，它有如下几个属性：

query - 解析后的查询字符串
body - 请求体
params - 匹配url的参数，例如: 用 /page/5 匹配 /page/:id =>
headers - 请求头对象
req - 原生Node的请求对象
log - 日志记录器的实例

fastify.post('/page/:id', options, function (request, reply) {
  console.log(request.body)
  console.log(request.query)
  console.log(request.params)
  console.log(request.headers)
  console.log(request.req)
  request.log.info('some info')
})

插件

Fastify 允许用户使用插件扩展其功能。

一个插件可以是一组路由，一个装饰器等，可以使用 register 函数注册插件。

默认情况下，register 创建了一个新的作用域，这意味着如果对 Fastify 实例（通过 decorate）进行一些更改，则此更改不会反映到当前上下文的祖先中，而只会反映到其子节点。这个特性允许我们实现插件封装和继承，这样就创建了一个直接非循环图（DAG），就不会有交叉依赖关系引起的问题。

创建一个插件

创建插件非常简单，你只要创建一个包含三个参数的方法。第一个是 fastify 实例，第二个是一个配置对象，最后一个是 next 回调。

// plugin.js
module.exports = function (fastify, opts, next) {
  fastify.decorate('utility', () => {})

  fastify.get('/', handler)

  next()
}

使用插件：

var plugin = require('./plugin')
var fastify = require('fastify')()

fastify.register(plugin)

注意，插件是有作用域的：

fastify.register((instance, opts, next) => {
  instance.decorate('util', (a, b) => a + b)
  console.log(instance.util('that is ', ' awesome'))

  next()
})

fastify.register((instance, opts, next) => {
  console.log(instance.util('that is ', ' awesome')) // 抛出异常

  next()
})

在第二个 register 函数中 instance.util 会抛出异常，因为 util 只存在于第一个 register 函数的上下文中。

注意：封装只适用于祖先和兄弟作用域，不适用于子作用域。

fastify.register((instance, opts, next) => {
  instance.decorate('util', (a, b) => a + b)
  console.log(instance.util('that is ', ' awesome'))

  fastify.register((instance, opts, next) => {
    console.log(instance.util('that is ', ' awesome')) // 不会抛出异常
    next()
  })

  next()
})

fastify.register((instance, opts, next) => {
  console.log(instance.util('that is ', ' awesome')) // 会抛出异常

  next()
})

如果希望定义的方法在应用的任何地方都可以用，没有作用域的影响，则可以在根作用域中定义。或者使用 fastify-plugin 来包装插件。

使用 fastify-plugin 模块，可以传递一个表示 Fastify 的版本范围的参数作为插件将支持的 Fastify 版本。

const fp = require('fastify-plugin')

const plugin = fp(function (fastify, opts, next) {
  fastify.decorate('utility', (a, b) => {
    return a + b
  })
  next()
}, ">=0.30.2")

fastify.register(plugin)

fastify.register(function(fastify, opts, next){
  console.log(fastify.utility(1, 3))  // 4
  next()
})

在插件中使用路由钩子

只在某些特定的路由中执行路由钩子，可以这样做：

fastify.register((instance, opts, next) => {
  instance.decorate('util', (req, key, value) => { req.key = value })

  instance.addHook('preHandler', (req, reply, done) => {
    instance.util(req, 'timestamp', new Date())
    done()
  })

  instance.get('/plugin1', (req, reply) => {
    reply.send(req)
  })

  next()
})

fastify.get('/plugin2', (req, reply) => {
  reply.send(req)
})

/plugin2 将不会应用 preHandler 钩子。

常用插件

point-of-view 模板引擎

安装

npm install point-of-view --save

使用方法

fastify.register(require('point-of-view'), {
  engine: {
    ejs: require('ejs')
  },
  templates: './views' // 模板存放的目录
})

fastify.get('/', (req, reply) => {
  reply.view('index.ejs', { text: 'text' })
})

安装

npm install fastify-cookie --save

使用方法

const fastify = require('fastify')()

fastify.register(require('fastify-cookie'), (err) => {
  if (err) throw err
})

fastify.get('/', (req, reply) => {
  const cookieFoo = req.cookies.foo  // 得到发送过来的cookie中的foo字段


  reply
    .setCookie('foo', 'foo', { // 设置cookie
      domain: 'example.com',
      path: '/'
    })
    .send({hello: 'world'})
})

fastify-formbody 支持 application/x-www-form-urlencoded 内容类型

安装

npm install fastify-formbody --save

使用方式

const fastify = require('fastify')()

fastify.register(require('fastify-formbody'), {}, (err) => {
  if (err) throw err
})

fastify.post('/', (req, reply) => {
  reply.send(req.body)
})

fastify.listen(8000, (err) => {
  if (err) throw err
})

更多插件可以访问https://www.fastify.io/ecosystem/

Fastify 系列教程到此结束。

Tips：访问 https://lavyun.gitbooks.io/fastify/content/ 查看我翻译的 Fastify 中文文档。

posted @ 2017-10-30 11:24 lavyun 阅读(2941) 评论(0) 编辑收藏举报

刷新页面返回顶部

lavyun

世界上没有什么是一段js解决不了的事

Fastify 系列教程四（求对象、响应对象和插件）

响应对象

Code

Header设置响应头

Redirect

Type

Serializer

Promises

Streams

Errors

请求对象

插件

创建一个插件

在插件中使用路由钩子

常用插件

point-of-view 模板引擎

fastify-formbody 支持 application/x-www-form-urlencoded 内容类型

公告

lavyun

世界上没有什么是一段js解决不了的事

Fastify 系列教程四 （求对象、响应对象和插件）

响应对象

Code

Header设置响应头

Redirect

Type

Serializer

Promises

Streams

Errors

请求对象

插件

创建一个插件

在插件中使用路由钩子

常用插件

point-of-view 模板引擎

fastify-cookie Cookie

fastify-formbody 支持 application/x-www-form-urlencoded 内容类型

公告

Fastify 系列教程四（求对象、响应对象和插件）

fastify-formbody 支持 application/x-www-form-urlencoded 内容类型