Fastify Swagger，为Fastify路线添加标签和描述

mftmpeh8 于 8个月前发布在其他

关注(0)|答案(1)|浏览(93)

我使用fastify 3.28.0（加上fastify-swagger插件）和typescript 4.6.2，我想在每个路由中添加标签，描述和摘要。
从文档：fastify Swagger 这将是可能的添加描述，标签和总结，每一个路线。
但我不能这样做，因为模式的定义没有提供它们：

export interface FastifySchema {
  body?: unknown;
  querystring?: unknown;
  params?: unknown;
  headers?: unknown;
  response?: unknown;
}

所以在这种情况下，我不知道如何在fastify路由中定义它们：

const userRoutes: FastifyPluginCallback = (fastify, _opts, done) => {
  const findRoute: RouteOptions = {
    method: 'GET',
    url: '/:username',
    schema: {
      params: schemaParams,
      response: {
        200: schema
      }
    },
    handler: (request: FastifyRequest<{
      Params: UserRequestFindParams,
    }>, reply) => {
      const user = find(request.params.username)
      reply.send(user)
    }
  }

    fastify.route(findRoute)

    done()
}

更新

我刚刚发现fastify-swagger的新版本已经发布（fastify-swagger已经被**@fastify/swagger**取代）。在新版本中，上面提到的所有属性都可用。

swagger

来源：https://stackoverflow.com/questions/71991072/fastify-swagger-add-tag-and-description-to-fastify-route

1条答案

按热度按时间

rggaifut1#

fastify版本等于“4.21.x”
1.运行命令fastify generate project;cd project; npm i
1.创建文件plugins/swagger.js

const fp = require('fastify-plugin')

module.exports = fp(async function (fastify, opts) {
  await fastify.register(require('@fastify/swagger'), {
    swagger: {
      info: {
        title: 'Admin Api',
        description: 'admin api',
        version: '0.1.0',
      },
      basePath: '',
      schemes: ['http', 'https'],
      consumes: ['application/json'],
      produces: ['application/json'],
      securityDefinitions: {
        Authorization: {
          description: 'Authorization header token, sample: "Bearer #TOKEN#"',
          type: 'apiKey',
          name: 'Authorization',
          in: 'header'
        }

      }
    },
  })
  await fastify.register(require('@fastify/swagger-ui'), {
    routePrefix: '/docs',
    uiConfig: {
      docExpansion: 'none', // expand/not all the documentations none|list|full
      deepLinking: true
    },
    uiHooks: {
      onRequest: function (request, reply, next) {
        next()
      },
      preHandler: function (request, reply, next) {
        next()
      }
    },
    staticCSP: false,
    transformStaticCSP: (header) => header,
    exposeRoute: true,

  })

  fastify.addHook('onRoute', (routeOptions) => {
    if (routeOptions.schema && routeOptions.url == '/graphql') {
      routeOptions.schema.hide = true
    }
  });
});

1.创建新文件routes/test.js

'use strict'

const fastify = require('fastify')();

const schemaPostList = {
  description: 'Admin Post List',
  tags: ['Admin'],
  summary: 'Admin Post List',
  security: [{ "Authorization": []}],
  querystring: {
    page: { type: 'number' },
    user: { type: 'string' }
  },
};
const schemaPostDetail = {
  description: 'Admin Post Detail',
  tags: ['Admin'],
  summary: 'Admin Post Detail',
  security: [{ "Authorization": []}]
};

module.exports = async function (fastify, opts) {
  fastify.get('/list', {schema:schemaPostList},async function (request, reply) {
    return 'this is an example'
  });
}

1.运行命令npm run dev
它看起来像：

赞(0）回复(0）举报 8个月前

我来回答

Fastify Swagger，为Fastify路线添加标签和描述

1条答案

相关问题

热门标签

最新问答