如何使用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] || {} 
Interesting Posts