如何使用Express Swagger Generator在同一路线上定义多个操作
我使用npm软件包express-swagger-generator ,当我定义2路由像这样:
/** * @group Users - operations about user * @route GET /users * @route POST /users */
它只显示POST路线,而不是像这样的GET路线
如果我切换它们,它只显示GET路线,同样使用@group标记两次在分开的地方定义它们。
如何使我的api文档中显示的POST和GETpath都在/ users上?
查看源代码 ,特别是swagger.js
,第85行:
parameters[route.uri] = {}
这一行将基本上消除以前parsing的方法/参数/等给定的路线。 图书馆似乎没有被devise或尚未开发得足够远,以允许单个function的多个路由注册(甚至在多个function上 – 这对我个人来说似乎是一个交易断路器)。
如果这是你喜欢的东西,我会build议提出一个问题,反对这个存储库,甚至更好。 提出问题,并提出一个合并请求。
就个人而言,我相信这个实现可以包含这个特性,因为今天的基于REST的API通常使用多个动词来展示相同的path。
build议的更改可能如下所示:
parameters[route.uri] = parameters[route.uri] || {} parameters[route.uri][route.method] = parameters[route.uri][route.method] || {}