生成数据库设计文档

依赖

<dependency>
        <groupId>cn.smallbun.screw</groupId>
        <artifactId>screw-core</artifactId>
        <version>1.0.5</version>
</dependency>

代码

import cn.smallbun.screw.core.Configuration;
import cn.smallbun.screw.core.engine.EngineConfig;
import cn.smallbun.screw.core.engine.EngineFileType;
import cn.smallbun.screw.core.engine.EngineTemplateType;
import cn.smallbun.screw.core.execute.DocumentationExecute;
import cn.smallbun.screw.core.process.ProcessConfig;
import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;

import javax.sql.DataSource;
import java.util.Collections;

public class databaseToPDF {

    static String DB_URL ;
    static String DB_NAME ;
    static String DB_USERNAME ;
    static String DB_PASSWORD;
    static String FILE_OUTPUT_DIR = "E:/";
    static EngineFileType FILE_OUTPUT_TYPE = EngineFileType.WORD; // 可以设置 Word 或者 Markdown 格式
    static String DOC_FILE_NAME = "数据库文档";
    static String DOC_VERSION = "1.0.0";
    static String DOC_DESCRIPTION = "文档描述";
    static String DRIVER_CLASS_NAME;
    static String SPLIT_SIGN;

    static {
//        setMysql();
        setSqlserver();
    }
    static void setMysql() {
        DB_URL = "jdbc:mysql://10.250.198.51:3306";
        DB_NAME = "initial_ces_cloud_saas_app";
        DB_USERNAME = "root";
        DB_PASSWORD = "pwd_ces_cloud_data";
        DRIVER_CLASS_NAME = "com.mysql.cj.jdbc.Driver";
        SPLIT_SIGN = "/";
    }

    static void setSqlserver() {
        DB_URL = "jdbc:sqlserver://10.250.220.67:1433";
        DB_NAME = "initial_ces_cloud_saas_app";
        DB_USERNAME = "sa";
        DB_PASSWORD = "cesGroup123";
        DRIVER_CLASS_NAME = "com.microsoft.sqlserver.jdbc.SQLServerDriver";
        SPLIT_SIGN = ";DatabaseName=";
    }


    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 DataSource buildDataSource() {
        // 创建 HikariConfig 配置类
        HikariConfig hikariConfig = new HikariConfig();
        hikariConfig.setDriverClassName(DRIVER_CLASS_NAME);
        hikariConfig.setJdbcUrl(DB_URL + SPLIT_SIGN + DB_NAME);
        hikariConfig.setUsername(DB_USERNAME);
        hikariConfig.setPassword(DB_PASSWORD);
        hikariConfig.addDataSourceProperty("useInformationSchema", "true"); // 设置可以获取 tables remarks 信息
        // 创建数据源
        return new HikariDataSource(hikariConfig);
    }

    /**
     * 创建 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()) // 根据表后缀生成
//                .ignoreTableName(Arrays.asList("test_user", "test_group")) // 忽略表名
//                .ignoreTablePrefix(Collections.singletonList("test_")) // 忽略表前缀
//                .ignoreTableSuffix(Collections.singletonList("_test")) // 忽略表后缀
                .build();
    }
}

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
### 回答1: MySQL 是一种常用的关系型数据库管理系统,用于存储和管理数据。虽然 MySQL 并不提供直接生成数据库设计文档的功能,但我们可以通过以下方式生成数据库设计文档。 第一种方法是使用数据库建模工具。有许多数据库建模工具可以与 MySQL 配合使用,例如 MySQL Workbench、Navicat 等等。这些工具提供了数据建模和设计功能,可以帮助我们创建数据库模型,并生成相应的设计文档。我们可以根据实际的数据库结构进行建模,包括表、字段、关联关系等信息,然后使用工具提供的导出功能,将数据库设计导出为文档格式,如 PDF、HTML、Word 等。 第二种方法是通过 SQL 注释生成文档。在创建数据库表和字段时,我们可以使用 SQL 注释的方式来添加表和字段的描述信息。例如,我们可以在创建表时,在表名后面添加注释来描述表的用途和结构,在每个字段前面添加注释来描述字段的含义和数据类型等。然后,我们可以使用数据库管理工具或脚本等方式,将这些注释提取出来,并将其整理成特定格式的文档。这种方法相对简单,但需要开发人员自行整理和提取注释。 总之,MySQL 并没有直接提供生成数据库设计文档的功能,但通过使用数据库建模工具或通过整理 SQL 注释,我们可以生成适合我们需求的数据库设计文档。这些文档可以帮助团队了解数据库结构和设计思路,方便数据库开发和维护工作的进行。 ### 回答2: MySQL是一个开源的关系型数据库管理系统,用于存储和管理结构化数据。在进行数据库设计时,可以利用MySQL的相关功能来生成数据库设计文档。 首先,可以使用MySQL的信息模式表(information schema),通过查询这些表来获取数据库的结构信息。例如,可以查询information_schema.tables表来获取所有表的信息,包括表名、列数、记录数等。还可以查询information_schema.columns表来获取表的列信息,包括列名、数据类型、是否为主键等。 其次,可以使用MySQL的SHOW语句来获取数据库的详细信息。例如,可以使用SHOW DATABASES语句来获取所有数据库的列表,使用SHOW TABLES语句来获取指定数据库中所有表的列表,使用SHOW CREATE TABLE语句来获取指定表的创建语句。 此外,MySQL还提供了一些工具和命令行选项来生成数据库设计文档。例如,可以使用mysqldump命令来导出数据库的结构和数据,并保存为SQL文件或者其他格式的文档。可以使用MySQL Workbench来设计和建模数据库,并生成相应的数据库设计文档。 还可以利用第三方工具来生成数据库设计文档。有一些开源或商业化的工具可以通过连接到MySQL数据库,自动生成数据库设计文档。这些工具通常提供直观的界面,可以根据用户的需求来生成不同格式的文档,如HTML、PDF等。 总之,MySQL提供了丰富的功能和工具来生成数据库设计文档。根据具体需求,可以选择适合的方式来生成文档,方便数据库设计、维护和分析。 ### 回答3: MySQL可以通过使用MySQL Workbench工具生成数据库设计文档。MySQL Workbench是MySQL官方提供的一个集成开发环境(IDE),它支持数据库建模、SQL开发、数据库管理等功能。 生成数据库设计文档的步骤如下: 1. 打开MySQL Workbench并连接到目标数据库。 2. 选择“Model”菜单中的“Create Diagram from Catalog Objects”选项。 3. 弹出的对话框中,选择要生成文档数据库对象,包括表、视图、存储过程等。可以选择全部对象或者指定对象。 4. 点击“Next”继续。 5. 在下一个对话框中,选择文档的输出格式,可以选择PDF、HTML、SVG等格式。 6. 点击“Next”继续。 7. 在下一个对话框中,可以选择是否包含详细信息,比如表的列、索引、外键等信息。 8. 点击“Finish”完成生成文档的设置。 9. 最后,选择生成文档的输出位置和文件名,并点击“Save”。 生成文档完成后,可以在指定的输出位置找到生成数据库设计文档。这个文档包含了数据库对象的结构信息,比如表的字段、索引、外键关系等,可以帮助开发人员和DBA了解数据库的结构,提供参考和分析。同时,这个文档也可以作为开发文档的一部分,用于项目文档的编写和分享。 总之,通过使用MySQL Workbench工具,我们可以方便地生成MySQL数据库设计文档,帮助我们更好地理解和管理数据库
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值