JAVA-文档工具screw-gui

前言

为什么萌生了写文档工具得想法，因为在项目开发得过程中，经常需要补充一些文档，比如数据库文档、详细设计文档等等，文档与项目相绑定，在项目需求新增或变更时，文档也需要反反复复得修改。

1. 数据库文档工具

Screw 是个不错sdk, 可以方便得生成数据库文档 。

• 支持maven插件方式构建文档
• 支持main方法方式生成文档

不管什么方式，还是跟项目相绑定，有时候想写文档得时候，不太关注程序。不想单独启动IDE只是为了运行生成文档。 不想使用Navicat 特意查看数据库信息，所以构建了该小工具。

1.1 功能简介

目前只支持 mysql和sqlite3
常用信息默认已经初始化，只需要修改保存目录和文件名称即可
连接测试：验证数据库信息是否正确
预览库： 查看数据表信息和表结构
备份： 保存数据库连接信息
历史备份：加载历史数据库连接信息，内置删除和编辑功能

ps: 第二次生成时 ，文件目录和名称未修改，若文件已在word或wps打开，因为文件被占用所以生成失败

1.2 使用示例

1.3 补充说明

• QA: screw 支持多个数据库, 为什么工具不支持

1. 因为平时工作只用mysql, 而且版本为5.7,所以maven依赖中只添加了mysql依赖

      <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.29</version>
        </dependency>

2. 增加screw支持的数据库, screw-swing -->pom.xml 添加依赖, 打包即可

2. swagger文档工具

在开发时经常使用swagger 文档，比较好用得算 Knife4j。swagger2 后来又升级迭代为openApi3，常用注解变更挺大，所以需要写2种方式parser转换器，该工具得初衷也只是本地不启动服务得同时，直接访问测试环境得API接口就可以生成文档。

2.1 功能简介

1. 选择API类型
2. 修改保存目录和文件名称
3. 填写swagger地址，http开头则使用get方法请求json信息 或直接填写json信息。
4. 生成即可

   ps: 第二次生成时 ，文件目录和名称未修改，若文件已在word或wps打开，因为文件被占用所以生成失败

2.2 使用示例

1.3 补充说明

• QA: 文档格式不喜欢,怎么自定义
  模板基于beetl 设置, 找到screw-swing–>resources–>templates–>word.btl .

3.如何下载

3.1 项目地址

项目已上传至码云：码云screw-gui

• build 目录可以下载可执行jar和exe （免安装）
  

3.2 模块依赖关系

依赖

依赖

依赖

screw-gui

note-swing-db

note-service-toolkit

note-swing-core

3.3 补充说明

QA: 为什么简单的工具, 但是项目这么臃肿
note-开头的工程 ,都是个人项目基础依赖, 因为有时候在写其他的工具的时候用到. 但是如果不提供这些工程,你无法在IDE中顺利编译. 当然可以使用lib形式引用, 使项目看起来更简洁。

4. 其他说明

• QA: 本地安装java环境但是无法运行
  该程序基于jdk1.8+和swing开发，java版本可能过低。 exe4j打包时寻找环境变量顺序如图，找不到环境变量则无法运行。
  

• QA: 是否可以本地不安装java环境并运行工具
  下载jar包，使用exe4j 打包exe时内嵌jre ，可以在未安装java环境的系统中运行，但是因为jre的大小，文件大小会从6MB -->160MB左右

• QA: 非windows系统如何使用
  java -jar screw-gui.jar 或者使用工具打包为相应系统可执行程序