Swagger + spring全局配置

时间:2017-05-12 16:36:53

标签: spring swagger

有没有办法用全局弹簧配置swagger,以便swagger可以通过扫描类/方法签名自动推断和生成文档,而无需使用swagger注释注释每个单独的方法?

1 个答案:

答案 0 :(得分:0)

您应该尝试springfox。您可以生成服务规范,而无需添加任何特殊注释。

来自描述goals of the library的文档:

  

从哲学上讲,我们希望不鼓励使用(swagger-core)注释,这些注释在运行时对服务描述不重要。对于例如杰克逊注释应该总是胜过或者比@ApiModelProperty具有更大的权重,例如@NotNull或指定@RequestParam#required应始终获胜。在无法推断服务/架构特征的情况下,注释仅用于补充文档或覆盖/调整生成的规范