6.8 KiB
zyplayer-doc
项目介绍
定位为所有文档的管理项目，swagger文档、dubbo文档、数据库文档....等，提供一整套的解决方案，为开发者服务，欢迎有想法的一起来写，给个Star鼓励下呗！（您的一个Star是快速迭代的动力源泉！） 欢迎加群讨论，QQ群号：466363173
体验地址：http://doc.zyplayer.com 需登录 账号：zyplayer 密码：123456 （未运行dubbo服务，不能体验dubbo文档调试）
开放文档地址：http://doc.zyplayer.com/zyplayer-doc-manage/open-wiki.html?pageId=1&space=23f3f59a60824d21af9f7c3bbc9bc3cb （无需登录）
软件架构
一、zyplayer-doc-core 一些核心、公用的类
二、zyplayer-doc-db 数据库文档
原zyplayer-doc-db，具有数据库文档的查看、管理、导出等功能
三、zyplayer-doc-manage 可以单独部署的文档管理后台
后端使用spring-boot、mybatis-plus、springfox-swagger等框架，前端使用zui、Vue、element-ui等框架
已集成三套优秀swagger文档前端：zyplayer-doc-swagger、swagger-bootstrap-ui、springfox-swagger-ui
已集成zyplayer-doc-db数据库文档
四、zyplayer-doc-swagger 原swagger-mg-ui，swagger的UI及整套解决方案
具有 后端存储、代理请求、模拟返回、所有文档管理 等一系列原创功能，不止UI
五、zyplayer-doc-dubbo 将dubbo的文档在线化管理
支持zookeeper、nacos的注册中心文档获取，支持在线调试接口
六、zyplayer-doc-wiki wiki文档工具
暂时处于开发阶段，暂不能使用 目标是支持文档创建、展示，文件上传、下载，空间隔离，页面权限控制等
运行方式
-
创建数据库：zyplayer_doc_manage，执行脚本：zyplayer_doc_manage.sql
-
修改zyplayer-doc-manage项目的application.yml配置文件里面的数据库账号密码
-
启动zyplayer-doc-manage项目，访问地址： http://127.0.0.1:8082/zyplayer-doc-manage/static/manage/home.html 未登录会进入登录页面，登陆后自动跳回，默认账号：zyplayer 密码:123456
项目页面全是静态的html，如果使用idea启动，有可能访问不了静态页面，需要在这里配置下工作目录，然后重新启动即可
功能介绍
一、zyplayer-doc-swagger
-
在
zyplayer-doc-swagger->文档管理->文档地址管理页可以管理任意地址的文档，在集成的三套UI中都可以直接查看和调试这里配置的文档，不用对UI做任何调整，只要标准的UI集成进来也可以直接用 -
文档展示配置，
自动填充请求参数：可配置填充级别，强制重写域名：文档在本地想调试线上接口的好帮手，自动保存请求参数：不用每次输入 -
可配置
全局参数，放在header或param里的 -
可对
调试数据进行管理 -
模拟返回：前端自行调试接口的好帮手 -
私人强迫症级定制化文档展示，清晰明了，参数支持批量编辑，每一条线的间距都考量了半天，支持
文件上传的调试，需要指定dataType =File或MultipartFile，例：
@ApiImplicitParam(name = "file", value = "文件", dataType = "File", allowMultiple = true)
- 后端代理请求，后端存储，不会存在任何跨域问题
二、zyplayer-doc-db
-
支持Mysql、SQLserver的数据库表、字段文档查看修改，导出，展示关系图等功能
-
支持多数据源，在
zyplayer-doc-manage->application.yml->zyplayer.doc.db.dbConfigList处配置多个数据库连接即可
三、zyplayer-doc-dubbo
-
zyplayer-doc-manage->application.yml->zyplayer.dubbo.zookeeper.url配置zookeeper地址 -
zyplayer-doc-manage->application.yml->zyplayer.dubbo.nacos.url配置nacos服务地址 -
默认找zookeeper，未配置再找nacos的配置，访问地址：http://127.0.0.1:8082/zyplayer-doc-manage/doc-dubbo.html
-
支持文档查找、文档编辑、在线调试接口
-
自动获取参数列表需要指定的类存在，所以请在 pom.xml -> dependencies 最后加上服务所在的包，后端才能通过Class.forName("xx");来找到参数列表，减少录入成本
-
数组或List参数，调试参数录入格式例：[1,2] ，后端通过JSON工具转成指定类型，有不支持的类型时欢迎反馈
四、zyplayer-doc-manage
-
整合了上面两个功能到此项目，较少熟悉成本，
git clone下来即可运行 -
具有简单的
权限管理、人员管理功能（还没想好具体怎么控制，没需求） -
使用最新的一些技术框架，很简单，初学者拿来学习也是很不错的
如果觉得此项目对您有帮助，就捐赠一个吧！无关金额，主要是对作者的认可。
界面展示
权限和用户管理：
数据库文档：
dubbo文档：
dubbo接口调试：
增加文档处：
使用springfox-swagger-ui访问增加的文档：
文档展示：
在线调试：
模拟返回：
文档配置：
全局参数管理：
