【问题标题】:How can I generate a swagger API specification from a JAX-RS (Jersey 2) application at build time?如何在构建时从 JAX-RS (Jersey 2) 应用程序生成 swagger API 规范?
【发布时间】:2015-04-07 03:49:50
【问题描述】:

swagger-core documentation 描述了如何将 swagger 合并到应用程序中。注释在运行时被扫描。

相反,我想在构建时静态生成 swagger API 规范。这可以使用 swagger-core 吗?

编辑:我们正在使用 ant 构建。

【问题讨论】:

    标签: jax-rs swagger


    【解决方案1】:

    swagger-core 单独是一个运行时库,不能用于在构建时生成 Swagger 定义。

    您可以使用依赖 swagger-core 的 swagger-maven-plugin 来生成此类定义。但是,我建议浏览分支并使用生成 Swagger 2.0 定义的版本来跟上最新的改进。

    【讨论】:

    • 我们使用ant 构建。你知道是否有这样的选择吗?
    • Enunciate (enunciate.webcohesion.com) 可能有一个 ant 任务,但我不知道它提供的 Swagger 定义的质量。
    • 谢谢@Ron。我查看了发音,但它不支持 Java 8。
    • 这是我所知道的两个可用选项。