使用maven插件的离线招摇文档

Question

我正在尝试生成swagger文档，因为我需要启动服务器。我想离线生成swagger文档（无需启动服务器），我刚刚获得此链接swagger-codegen-maven-plugin

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

Answer 1

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

  

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

Answer 2

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