java - 使用 maven 插件的离线 swagger 文档

Question

我正在尝试生成招摇的文档，为此我需要启动服务器。我想离线生成 swagger 文档（不启动服务器），我刚得到这个链接 swagger-codegen-maven-plugin

但是当我将上面的插件添加到 POM.xml 时（假设在 maven 构建期间生成 HTML 文档，我觉得），它根本没有做任何事情。请帮忙。

Answer 1

看看这个插件： https ://github.com/teamcarma/swagger-jaxrs-doclet

由于 JSON 资源列表是从源代码离线生成的，这意味着您无需向项目添加任何运行时依赖项，并避免因不同 jar 版本和 jaxrs 实现而带来的潜在麻烦。这也避免了增加工件的大小

Answer 2

要生成 HTML 文档，您需要将配置中语言标记的值设置为 HTML。在您链接的示例中，它设置为java. 将其更改为html. 如果您需要同时生成 Java 和 HTML，则有两个execution块，一个用于 Java，一个用于 HTML。