4.4 KiB
zyplayer-doc
项目介绍
定位为所有文档的管理项目,swagger文档、数据库文档....等,提供一整套的解决方案,欢迎有想法的一起来写
软件架构
一、zyplayer-doc-core 一些核心、公用的类
二、zyplayer-doc-db 数据库文档
原zyplayer-doc-db,具有数据库文档的查看、管理、导出等功能
三、zyplayer-doc-manage 可以单独部署的文档管理后台
后端使用spring-boot、mybatis-plus、springfox-swagger等框架,前端使用zui、Vue等框架
已集成三套优秀swagger文档前端:zyplayer-doc-swagger、swagger-bootstrap-ui、springfox-swagger-ui
已集成zyplayer-doc-db数据库文档
四、zyplayer-doc-swagger 原swagger-mg-ui,swagger的UI及整套解决方案
具有 后端存储、代理请求、模拟返回、所有文档管理 等一系列原创功能,不止UI
运行方式
-
创建数据库:zyplayer_doc_manage,执行脚本:zyplayer_doc_manage.sql
-
修改zyplayer-doc-manage项目的application.yml配置文件里面的数据库账号密码
-
启动zyplayer-doc-manage项目,访问地址: http://127.0.0.1:8082/zyplayer-doc-manage/statics/manage/home.html
功能介绍
一、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-manage
-
整合了上面两个功能到此项目,较少熟悉成本,
git clone
下来即可运行 -
具有简单的
权限管理
、人员管理
功能(还没想好具体怎么控制,没需求) -
使用最新的一些技术框架,很简单,初学者拿来学习也是很不错的
界面展示
权限和用户管理: 数据库文档: 增加文档处: 使用springfox-swagger-ui访问增加的文档: 文档展示: 在线调试: 模拟返回: 文档配置: 全局参数管理: