Java 通过Maven使用Swagger 2.x生成HTML文档

Java 通过Maven使用Swagger 2.x生成HTML文档,java,maven,swagger,swagger-ui,Java,Maven,Swagger,Swagger Ui,我正在考虑在我的几个不同的项目中生成一些API文档,希望使用Swagger。我从未使用过招摇过市,我正在试图找到一个通过Maven生成HTML文档的非常简单的解决方案 这些项目中使用的底层REST框架是Jersey。我从中找到了文档,但似乎没有简单生成HTML文件的示例。他们的大多数示例似乎将API文档嵌入到实际服务本身中 因此,我的问题是: 如何通过Maven使用Swagger生成HTML文档 随服务附上文档是否与REST应用程序正常相关 您需要使用swagger codegen生成HTML

我正在考虑在我的几个不同的项目中生成一些API文档,希望使用Swagger。我从未使用过招摇过市,我正在试图找到一个通过Maven生成HTML文档的非常简单的解决方案

这些项目中使用的底层REST框架是Jersey。我从中找到了文档,但似乎没有简单生成HTML文件的示例。他们的大多数示例似乎将API文档嵌入到实际服务本身中

因此,我的问题是:

  • 如何通过Maven使用Swagger生成HTML文档
  • 随服务附上文档是否与REST应用程序正常相关

您需要使用swagger codegen生成HTML

要使用swagger codegen生成HTML文档,首先需要生成OpenAPI文档。因为您已经在使用Jersey作为REST框架,所以将swagger作为依赖项引入项目并注释所有API servlet可能是最简单的方法。这样做,将告诉swagger阅读所有代码并生成OpenAPI规范。您可以按照中的步骤开始


祝你好运

我会调查一下的!我很快就回来。非常感谢。