将 Swagger 2.0 可重用参数与 springfox 一起使用答案

【问题标题】：Using Swagger 2.0 reusable parameters with springfox将 Swagger 2.0 可重用参数与 springfox 一起使用
【发布时间】：2018-04-26 07:58:37
【问题描述】：

Swagger 2.0 支持可重用参数，as described here。

我将如何使用Springfox 来利用此功能

Springfox 支持这个功能吗？

【问题讨论】：

通常可重用参数在设计规范优先时很有用。由于 springfox 是代码优先的方法，所以这不是真的。
我认为可重用参数在代码优先方法中也很有用。如果您希望您的 API 正确记录，此功能将为您节省许多重复的 @ApiParam 注释行（如果您有许多操作和许多重用参数）
但根据您的评论，我猜答案是否定的，不支持 :)
由于您处于春季生态系统中，因此在您的情况下重用的更好技术是annotation aggregation/meta annotation

【解决方案1】：

根据Dilip Krishnan 的评论，Springfox 目前不支持此功能。

【讨论】：

这是一个 100% 真实的陈述。但是我将重申一个事实，即使用 springfox，您不需要在任何参数上定义 ApiParam 注释，除非您试图影响默认行为。它是该项目的the goals 之一。