国产精品久久中文字幕,色窝窝免费播放视频在线,国产目拍亚洲精品二区

生成數據庫的表結構文檔

背景說明

項目完成前后，需要提供各種各樣的文檔，我所在的公司，每次項目結束要整理的文檔高達29個，其中有些文檔很單一但是數據量很大，這個時候就必須偷懶一下了。

使用依賴

<groupId>cn.smallbun.screw</groupId>
<artifactId>screw-core</artifactId> <!-- 實現數據庫文檔 -->
<version>1.0.5</version>

依賴說明

在企業級開發中、我們經常會有編寫數據庫表結構文檔的時間付出，從業以來，待過幾家企業，關于數據庫表結構文檔狀態：要么沒有、要么有、但都是手寫、后期運維開發，需要手動進行維護到文檔中，很是繁瑣、如果忘記一次維護、就會給以后工作造成很多困擾、無形中制造了很多坑留給自己和后人，于是萌生了要自己寫一個插件工具的想法，但由于自己前期在程序設計上沒有很多造詣，且能力偏低，有想法并不能很好實現，隨著工作閱歷的增加，和知識的不斷儲備，終于在2020年的3月中旬開始進行編寫，4月上旬完成初版，想完善差不多在開源，但由于工作太忙，業余時間不足，沒有在進行完善，到了6月份由于工作原因、頻繁設計和更改數據庫、經常使用自己寫的此插件、節省了很多時間，解決了很多問題，在僅有且不多的業余時間中、進行開源準備，于2020年6月22日，開源，歡迎大家使用、建議、并貢獻。
??關于名字，想一個太難了，好在我這個聰明的小腦瓜靈感一現，怎么突出它的小，但重要呢？從小就學過雷鋒的螺絲釘精神，摘自雷鋒日記：雖然是細小的螺絲釘，是個細微的小齒輪，然而如果缺了它，那整個的機器就無法運轉了，慢說是缺了它，即使是一枚小螺絲釘沒擰緊，一個小齒輪略有破損，也要使機器的運轉發生故障的...，感覺自己寫的這個工具，很有這意味，雖然很小、但是開發中缺了它還不行，于是便起名為screw（螺絲釘）。

maven依賴配置

　　　　<dependency>
            <groupId>cn.smallbun.screw</groupId>
            <artifactId>screw-core</artifactId> <!-- 實現數據庫文檔 -->
            <version>1.0.5</version>
            <exclusions>
                <exclusion>
                    <groupId>org.freemarker</groupId>
                    <artifactId>freemarker</artifactId> <!-- 移除 Freemarker 依賴，采用 Velocity 作為模板引擎 -->
                </exclusion>
                <exclusion>
                    <groupId>com.alibaba</groupId>
                    <artifactId>fastjson</artifactId> <!-- 最新版screw-core1.0.5依賴fastjson1.2.73存在漏洞，移除。 -->
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>org.apache.velocity</groupId>
            <artifactId>velocity-engine-core</artifactId>
            <version>2.3</version>
        </dependency>

主代碼部分

package com.heit.road.web.config;

import cn.hutool.core.io.FileUtil;
import cn.hutool.core.util.IdUtil;
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.heit.road.service.util.ServletUtils;
import com.zaxxer.hikari.HikariConfig;
import com.zaxxer.hikari.HikariDataSource;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.Resource;
import javax.servlet.http.HttpServletResponse;
import javax.sql.DataSource;
import java.io.File;
import java.io.IOException;
import java.util.Arrays;

@Tag(name = "管理后臺 - 數據庫文檔")
@RestController
@RequestMapping("/infra/db-doc")
public class DatabaseDocController {

    @Resource
    private DataSource db; //獲取項目數據源


    private static final String FILE_OUTPUT_DIR = System.getProperty("java.io.tmpdir") + File.separator
            + "db-doc";
    private static final String DOC_FILE_NAME = "數據庫文檔";
    private static final String DOC_VERSION = "1.0.0";
    private static final String DOC_DESCRIPTION = "文檔描述";

    @GetMapping("/export-html")
    @Operation(summary = "導出 html 格式的數據文檔")
    @Parameter(name = "deleteFile", description = "是否刪除在服務器本地生成的數據庫文檔", example = "true")
    public void exportHtml(@RequestParam(defaultValue = "true") Boolean deleteFile,
                           HttpServletResponse response) throws IOException {
        doExportFile(EngineFileType.HTML, deleteFile, response);
    }

    @GetMapping("/export-word")
    @Operation(summary = "導出 word 格式的數據文檔")
    @Parameter(name = "deleteFile", description = "是否刪除在服務器本地生成的數據庫文檔", example = "true")
    public void exportWord(@RequestParam(defaultValue = "true") Boolean deleteFile,
                           HttpServletResponse response) throws IOException {
        doExportFile(EngineFileType.WORD, deleteFile, response);
    }

    @GetMapping("/export-markdown")
    @Operation(summary = "導出 markdown 格式的數據文檔")
    @Parameter(name = "deleteFile", description = "是否刪除在服務器本地生成的數據庫文檔", example = "true")
    public void exportMarkdown(@RequestParam(defaultValue = "true") Boolean deleteFile,
                               HttpServletResponse response) throws IOException {
        doExportFile(EngineFileType.MD, deleteFile, response);
    }

    private void doExportFile(EngineFileType fileOutputType, Boolean deleteFile,
                              HttpServletResponse response) throws IOException {
        String docFileName = DOC_FILE_NAME + "_" + IdUtil.fastSimpleUUID();
        String filePath = doExportFile(fileOutputType, docFileName);
        String downloadFileName = DOC_FILE_NAME + fileOutputType.getFileSuffix(); //下載后的文件名
        try {
            // 讀取，返回
            ServletUtils.writeAttachment(response, downloadFileName, FileUtil.readBytes(filePath));
        } finally {
            handleDeleteFile(deleteFile, filePath);
        }
    }

    /**
     * 輸出文件，返回文件路徑
     *
     * @param fileOutputType 文件類型
     * @param fileName       文件名, 無需 ".docx" 等文件后綴
     * @return 生成的文件所在路徑
     */
    private String doExportFile(EngineFileType fileOutputType, String fileName) {
        try (HikariDataSource dataSource = buildDataSource()) {
            // 創建 screw 的配置
            Configuration config = Configuration.builder()
                    .version(DOC_VERSION)  // 版本
                    .description(DOC_DESCRIPTION) // 描述
                    .dataSource(dataSource) // 數據源
                    .engineConfig(buildEngineConfig(fileOutputType, fileName)) // 引擎配置
                    .produceConfig(buildProcessConfig()) // 處理配置
                    .build();

            // 執行 screw，生成數據庫文檔
            new DocumentationExecute(config).execute();

            return FILE_OUTPUT_DIR + File.separator + fileName + fileOutputType.getFileSuffix();
        }
    }

    private void handleDeleteFile(Boolean deleteFile, String filePath) {
        if (!deleteFile) {
            return;
        }
        FileUtil.del(filePath);
    }

    /**
     * 創建數據源
     */
    private HikariDataSource buildDataSource() {
        HikariConfig hikariConfig = new HikariConfig();
        hikariConfig.setJdbcUrl(((HikariDataSource) db).getJdbcUrl());
        hikariConfig.setUsername(((HikariDataSource) db).getUsername());
        hikariConfig.setPassword(((HikariDataSource) db).getPassword());
        hikariConfig.addDataSourceProperty("useInformationSchema", "true"); // 設置可以獲取 tables remarks 信息
        // 創建數據源
        return new HikariDataSource(hikariConfig);
    }

    /**
     * 創建 screw 的引擎配置
     */
    private static EngineConfig buildEngineConfig(EngineFileType fileOutputType, String docFileName) {
        return EngineConfig.builder()
                .fileOutputDir(FILE_OUTPUT_DIR) // 生成文件路徑
                .openOutputDir(false) // 打開目錄
                .fileType(fileOutputType) // 文件類型
                .produceType(EngineTemplateType.velocity) // 文件類型
                .fileName(docFileName) // 自定義文件名稱
                .build();
    }

    /**
     * 創建 screw 的處理配置，一般可忽略
     * 指定生成邏輯、當存在指定表、指定表前綴、指定表后綴時，將生成指定表，其余表不生成、并跳過忽略表配置
     */
    private static ProcessConfig buildProcessConfig() {
        return ProcessConfig.builder()
                .ignoreTablePrefix(Arrays.asList("QRTZ_", "ACT_")) // 忽略表前綴
                .build();
    }

}

工具類

package com.heit.road.service.util;

import cn.hutool.core.io.IoUtil;
import cn.hutool.core.util.StrUtil;
import cn.hutool.extra.servlet.ServletUtil;
import org.springframework.http.MediaType;
import org.springframework.web.context.request.RequestAttributes;
import org.springframework.web.context.request.RequestContextHolder;
import org.springframework.web.context.request.ServletRequestAttributes;

import javax.servlet.ServletRequest;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.net.URLEncoder;

/**
 * 客戶端工具類
 *
 */
public class ServletUtils {

    /**
     * 返回 JSON 字符串
     *
     * @param response 響應
     * @param object 對象，會序列化成 JSON 字符串
     */
    @SuppressWarnings("deprecation") // 必須使用 APPLICATION_JSON_UTF8_VALUE，否則會亂碼
    public static void writeJSON(HttpServletResponse response, Object object) {
        String content = JsonUtils.toJsonString(object);
        ServletUtil.write(response, content, MediaType.APPLICATION_JSON_UTF8_VALUE);
    }

    /**
     * 返回附件
     *
     * @param response 響應
     * @param filename 文件名
     * @param content 附件內容
     * @throws IOException
     */
    public static void writeAttachment(HttpServletResponse response, String filename, byte[] content) throws IOException {
        // 設置 header 和 contentType
        response.setHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(filename, "UTF-8"));
        response.setContentType(MediaType.APPLICATION_OCTET_STREAM_VALUE);
        // 輸出附件
        IoUtil.write(response.getOutputStream(), false, content);
    }

    /**
     * @param request 請求
     * @return ua
     */
    public static String getUserAgent(HttpServletRequest request) {
        String ua = request.getHeader("User-Agent");
        return ua != null ? ua : "";
    }

    /**
     * 獲得請求
     *
     * @return HttpServletRequest
     */
    public static HttpServletRequest getRequest() {
        RequestAttributes requestAttributes = RequestContextHolder.getRequestAttributes();
        if (!(requestAttributes instanceof ServletRequestAttributes)) {
            return null;
        }
        return ((ServletRequestAttributes) requestAttributes).getRequest();
    }

    public static String getUserAgent() {
        HttpServletRequest request = getRequest();
        if (request == null) {
            return null;
        }
        return getUserAgent(request);
    }

    public static String getClientIP() {
        HttpServletRequest request = getRequest();
        if (request == null) {
            return null;
        }
        return ServletUtil.getClientIP(request);
    }

    public static boolean isJsonRequest(ServletRequest request) {
        return StrUtil.startWithIgnoreCase(request.getContentType(), MediaType.APPLICATION_JSON_VALUE);
    }

}

posted on 2025-07-30 16:59 instr 閱讀(44) 評論(0) 收藏舉報

刷新頁面返回頂部

生成數據庫的表結構文檔

導航