1、拉取代码

该项目上使用了jdk17版本，需要maven环境。如果都有，通过git进行下载代码

#git下载代码命令
git clone https://gitee.com/giteeLinht/db-doc.git

2、初始化项目并运行

1、打开idea，导入项目直接运行com.cn.db.dbdoc.DbDocApplication

2、没有idea，可以直接在db-doc文件夹下，通过mvn clean install进行打包成可运行的jar文件。然后把db-doc/data目录拷贝到target里。然后在target里通过java -jar db-doc-0.0.1-SNAPSHOT.jar

3、验证：在浏览器里输入:http://localhost:8080/swagger-ui/index.html

3、生成数据库设计文档

1、浏览器输入:http://localhost:8080/swagger-ui/index.html

2、通过/db/add接口添加数据库信息返回id

3、根据返回的id，调用/export/word或/export/excel传入id导出数据库文档。如下图所示：

 

 

 

 

 

 

4、疑难杂症

1、要使用jdk17，如果没有jdk17,使用jdk1.8，请在pom文件中降低jdk版本和springboot的版本，同时降低spring-doc的版本

2、通过接口新增数据库信息报错表不存在时，可以在浏览器中登录H2数据库，并在浏览器中执行/data目录下的schema-h2.sql脚本，登录的账号信息请查看application.properties