lerry903/swagger-showdoc

一个将swagger的Json文件转换为ShowDoc的小工具

swagger-showdoc

项目介绍

很多在使用swagger的公司都有一个问题，文档真的可读性不高，在有些情况下，甚至只是开发人员自己能玩，完全不能作为开放文档使用。本项目旨在帮助使用swagger项目的团队，利用现有的swagger.json格式文件来实现文档的自动生成，文档的展示使用了showDoc

软件架构

Spring Boot 2.0.3

JDK 1.8

swagger2markup 1.3.3

okhttp 3.11.0

使用说明

1. 克隆项目
2. 直接运行SwaggerShowDocApplication
3. 访问http://localhost:8080/index.html
4. 输入各种参数，点击"开始文档同步"按钮

源码地址

• GitHub：https://github.com/lerry903/swagger-showdoc
• 码云：https://gitee.com/lerry903/swagger-showdoc

参与贡献

1. Fork 本项目
2. 新建分支
3. 提交代码
4. 新建 Pull Request

License

用户在遵循本项目协议的同时，如果用户下载、安装、使用本项目中所提供的软件，软件作者对任何原因在使用本项目中提供的软件时可能对用户自己或他人造成的任何形式的损失和伤害不承担任何责任。作者有权根据有关法律、法规的变化修改本项目协议。修改后的协议会随附于本项目的新版本中。当发生有关争议时，以最新的协议文本为准。如果用户不同意改动的内容，用户可以自行删除本项目。如果用户继续使用本项目，则视为您接受本协议的变动。

感谢大家 Star & Fork 的支持。

swagger-showdoc's Issues

modelDocAddJdd递归处理模型属性 过程 定义的backModel 变量存在bug

如果模型中嵌套模型，有三层结构时候，第三层的模型会被定义多次，举例
ResponseResult 中 含有 ResponseEntity ，ResponseEntity 含有 Blue类 ，那么Blue类会根据ResponseResult 中定义的属性个数出现多次，假如ResponseResult 有三个属性，其他两个是基本类型， 如果遍历ResponseResult 中 ResponseEntity 最后被处理，那么blue出现一次，如果最先被处理，那么blue会出现三次，因为定义这个backModel在处理modelDocAddJdd方法中会被后面的属性使用，从而重复生成模型数据。

请问具体怎么用

开始同步不成功啊, 填了参数不行的