-
3 votesanswersviews
将工件从Gitlab CI移动到项目Wiki页面
我正在设置Gitlab CI以从Swagger YAML规范创建asciidoc页面 . 为此，我设置了Gitlab来执行swagger maven插件并将结果保存到public artifacts文件夹，如下所示： enter codedeploy:jdk8: stage: test script: - 'mvn $MAVEN_CLI_OPTS swagger2markup:convertSwa... -
15 votesanswersviews
使用Javadocs生成Swagger文档
我想为现有的一组RESTful API构建Swagger文档 . 我有以下要求： 离线生成Swagger文档（我使用http://kongchen.github.io/swagger-maven-plugin/） . 这个插件帮助我在编译期间生成Swagger文档 . 读取现有的Javadoc，以便可以在Swagger文档中使用它们 . 到目前为止使用上面的插件我能够实现第1点 . 所... -
2 votesanswersviews
使用swagger for Java自动生成休息 endpoints
我被赋予了为使用jaxrs开发的大型API找到最佳方法的任务，以便为第三方记录 . 目前，javadoc已经充分记录了该代码 . 我的问题是帮助确定目前为止基于我的研究的最佳方法，并验证我们正在走正确的道路，所以我正在寻找输入，评论或其他框架来查看 . 我确信这是一个常见的用例，其他人会遇到类似的问题，并且非常感谢其他有兴趣和文档经验的人的意见 . 我们有以下要求： 我们没有大量的注释使代码混... -
0 votesanswersviews
apiKey作为Swagger UI 2.0中的查询参数
Context ：将Swagger从1.2规范中的当前REST文档转换为2.0 Environment ：Java 8，swagger-maven-plugin 3.0.1，swagger annotations（com.wordnik） Where I am stuck ：我能够成功生成REST API文档 . 但是，REST API需要ApiKey作为Query参数 . 在1.2规范中，这是使... -
1 votesanswersviews
使用CXF中的swagger生成脱机文档
我正在尝试使用带有cxf和camel的swagger生成REST文档 . 我已经成功获得了昂首阔步的文档 . 而且我的心烦意乱！ 所以现在我正在尝试导出所有内容并构建离线文档 . 为了做到这一点，我使用：1）swagger-maven-plugin：REST - > json 2）swagger2markup-maven-plugin：json - > asciidoc 我设法得到...