一、说明
1、准备舍弃swagger了,拥抱smart-doc
2、win10
3、jdk8
4、idea
二、搭建torna
1)下载zip
2)也可以下载最新版
https://gitee.com/durcframework/torna/releases
3)创建数据库并导入初始化脚本
数据库: MySQL 5.6以上 库名: tonar
4)mysql脚本
https://gitee.com/durcframework/torna/edit/master/mysql.sql
5)启动即可
端口: 7700
账号: admin
密码: 123456
6)后台管理-创建用户
7)创造空间
8)创建项目
9)查看smart-doc的token
到此,配置完成
~~
三、项目配置smart-doc
1)使用maven插件即可
2)配置示例
3)配置smart-doc.json
{
"outPath": "src/main/resources/static/doc",
"serverUrl": "http://127.0.0.1",
"isStrict": false,
"packageFilters": "",
"projectName": "eladmin-java",
"appToken": "0fe821154b134ec5b52ce56315c7afe7",
"appKey": "",
"secret": "",
"openUrl": "http://localhost:7700/api",
"debugEnvName":"测试环境",
"replace": true,
"debugEnvUrl":"http://127.0.0.1"
}
4)通过插件生成doc
5)推送成功示例
6)到torna刷新查看
真香~~~
7)smart-doc扩展了注解,了解一下
~~