java一键生成《数据库设计文档》
一、前言:
以前我们还需要手写数据库设计文档、现在可以通过引入screw核心包 来实现Java 数据库文档一键生成。
企业级开发过程中,一颗永不生锈的螺丝钉!
1、支持的数据库列表:
MySQL (本篇博客内容)
MariaDB
TIDB
Oracle
SqlServer
PostgreSQL
Cache DB(2016)
这些主流的数据库都支持的。
2、文档生成支持
html
word
markdown
3、screw 开源地址:
🚀 screw (螺丝钉) 英:[skruː] ~ 简洁好用的数据库表结构文档生成工具
螺丝钉(screw)的开源地址:螺丝钉(screw)的开源地址
二、实现步骤:
题目:将mysql数据库中db1数据库里面的表自动生成数据库设计文档
(1)引入 pom.xml核心配置screw包
<!--mysql连接--> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.16</version> </dependency> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.11</version> <scope>test</scope> </dependency> <!--screw [skruː]:螺丝钉--> <dependency> <groupId>cn.smallbun.screw</groupId> <artifactId>screw-core</artifactId> <version>1.0.5</version> </dependency> <dependency> <groupId>org.freemarker</groupId> <artifactId>freemarker</artifactId> <version>2.3.30</version> </dependency> <!-- HikariCP:数据库连接池组件 --> <dependency> <groupId>com.zaxxer</groupId> <artifactId>HikariCP</artifactId> <version>3.4.5</version> </dependency> </dependencies>
HikariCP简介
HikariCP是由日本程序员开源的一个数据库连接池组件,代码非常轻量,并且速度非常的快。 根据官方提供的数据,在i7,开启32个线程32个连接的情况下,进行随机数据库读写操作, HikariCP的速度是现在常用的C3P0数据库连接池的数百倍。 Springboot2.0默认连接池,官方也是推荐使用HikariCP。
(2)mysql中db1数据库里面的表
(3) 用screw自动生成数据库文档:
/** * @author 王恒杰 * @version 1.0 * @date 2021/11/14 15:32 * @email 1078993387@qq.com * @Address 天津 * @Description: */ public class Test { /** * 路径 */ private static final String MYSQL_URL = "jdbc:mysql://localhost:3306"; /** * 数据库名 */ private static final String MYSQL_NAME = "db1?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai"; /** * mysql用户名 */ private static final String MYSQL_USERNAME = "root"; /** * mysql密码 */ private static final String MYSQL_PASSWORD = "root"; /** * 文件输出目录 */ private static final String FILE_OUTPUT_DIR = "E:\\"; /** * 可以设置 Word 或者 Markdown 格式 */ private static final EngineFileType FILE_OUTPUT_TYPE = EngineFileType.WORD; private static final String DOC_FILE_NAME = "java实现数据库表设计文档"; private static final String DOC_VERSION = "V1.0.0"; private static final String DOC_DESCRIPTION = "数据库表设计描述"; public static void main(String[] args) { // 创建 screw 的配置 Configuration config = Configuration.builder() // 版本 .version(DOC_VERSION) // 描述 .description(DOC_DESCRIPTION) // 数据源 .dataSource( buildDataSource()) // 引擎配置 .engineConfig(buildEngineConfig()) // 处理配置 .produceConfig(buildProcessConfig()) .build(); // 执行 screw,生成数据库文档 new DocumentationExecute(config).execute(); } /** * 创建数据源 */ private static HikariDataSource buildDataSource() { // 创建 HikariConfig 配置类 HikariConfig hikariConfig = new HikariConfig(); hikariConfig.setDriverClassName("com.mysql.cj.jdbc.Driver"); hikariConfig.setJdbcUrl(MYSQL_URL + "/" + MYSQL_NAME); hikariConfig.setUsername(MYSQL_USERNAME); hikariConfig.setPassword(MYSQL_PASSWORD); // 设置可以获取 tables remarks 信息 hikariConfig.addDataSourceProperty("useInformationSchema", "true"); hikariConfig.setMinimumIdle(2); hikariConfig.setMaximumPoolSize(5); // 创建数据源 HikariDataSource hikariDataSource = new HikariDataSource(hikariConfig); return hikariDataSource; } /** * 创建 screw 的引擎配置 */ private static EngineConfig buildEngineConfig() { return EngineConfig.builder() // 生成文件路径 .fileOutputDir(FILE_OUTPUT_DIR) // 打开目录 .openOutputDir(false) // 文件类型 .fileType(FILE_OUTPUT_TYPE) // 文件类型 .produceType(EngineTemplateType.freemarker) // 自定义文件名称 .fileName(DOC_FILE_NAME) .build(); } /** * 创建 screw 的处理配置,一般可忽略 * 指定生成逻辑、当存在指定表、指定表前缀、指定表后缀时,将生成指定表,其余表不生成、并跳过忽略表配置 */ private static ProcessConfig buildProcessConfig() { return ProcessConfig.builder() // 根据名称指定表生成 .designatedTableName(Collections.<String>emptyList()) // 根据表前缀生成 .designatedTablePrefix(Collections.<String>emptyList()) // 根据表后缀生成 .designatedTableSuffix(Collections.<String>emptyList()) // 忽略数据库中address这个表名 .ignoreTableName(Arrays.asList("address")) // 忽略表前缀,就是db1数据库中表名是t_开头的都不生产数据库文档(t_student,t_user这两张表) .ignoreTablePrefix(Collections.singletonList("t_")) // 忽略表后缀(就是db1数据库中表名是_teacher结尾的都不生产数据库文档:stu_teacher) .ignoreTableSuffix(Collections.singletonList("_teacher")) .build(); }
控制台打印部分信息
三:java自动生成的《数据库文档》
数据库设计文档
数据库名: db1
文档版本: V1.0.0
文档描述: 数据库表设计描述
表名: admin
说明:
数据列:
表名: card
说明:
数据列:
表名: dep
说明:
数据列:
表名: emp
说明:
数据列:
表名: person
说明:
数据列:
表名: student
说明:
数据列:
表名: teacher
说明:
数据列:
表名: user
说明:
数据列: