好用！一键生成数据库文档，这个开源的文档生成工具值得了解

 简介

创新互联建站是一家专注于做网站、网站建设与策划设计,晋中网站建设哪家好?创新互联建站做网站,专注于网站建设十年,网设计领域的专业建站公司;建站业务涵盖:晋中等地区。晋中做网站价格咨询:13518219792

在企业级开发中、我们经常会有编写数据库表结构文档的时间付出，从业以来，待过几家企业，关于数据库表结构文档状态：要么没有、要么有、但都是手写、后期运维开发，需要手动进行维护到文档中，很是繁琐、如果忘记一次维护、就会给以后工作造成很多困扰、无形中制造了很多坑留给自己和后人。

于是萌生了要自己写一个插件工具的想法，但由于自己前期在程序设计上没有很多造诣，且能力偏低，有想法并不能很好实现，随着工作阅历的增加，和知识的不断储备，终于在2020年的3月中旬开始进行编写。

4月上旬完成初版，想完善差不多在开源，但由于工作太忙，业余时间不足，没有在进行完善，到了6月份由于工作原因、频繁设计和更改数据库、经常使用自己写的此插件、节省了很多时间，解决了很多问题 ，在仅有且不多的业余时间中、进行开源准备，于2020年6月22日，开源，欢迎大家使用、建议、并贡献。

关于名字，想一个太难了，好在我这个聪明的小脑瓜灵感一现，怎么突出它的小，但重要呢？从小就学过雷锋的螺丝钉精神，摘自雷锋日记：虽然是细小的螺丝钉，是个细微的小齿轮，然而如果缺了它，那整个的机器就无法运转了，慢说是缺了它，即使是一枚小螺丝钉没拧紧，一个小齿轮略有破损，也要使机器的运转发生故障的...，感觉自己写的这个工具，很有这意味，虽然很小、但是开发中缺了它还不行，于是便起名为screw（螺丝钉）。

特点

  •  简洁、轻量、设计良好
  •  多数据库支持
  •  多种格式文档
  •  灵活扩展
  •  支持自定义模板

数据库支持

  •  MySQL
  •  MariaDB
  •  TIDB
  •  Oracle
  •  SqlServer
  •  PostgreSQL
  •  Cache DB（2016）
  •  H2 （开发中）
  •  DB2  （开发中）
  •  HSQL  （开发中）
  •  SQLite（开发中）
  •  瀚高（开发中）
  •  达梦 （开发中）
  •  虚谷  （开发中）
  •  人大金仓（开发中）

文档生成支持

  •  html
  •  word
  •  markdown

文档截图

  •  html

  •  word

  •  markdwon

  

使用方式

普通方式

  •  引入依赖 
 
 
 
 
    
  
  
  
  
  1.   
    2. 
  
  
  
  
  2.     cn.smallbun.screw  
    3. 
  
  
  
  
  3.     screw-core  
    4. 
  
  
  
  
  4.     ${lastVersion}  
    5. 
  
  
  
  
  5.   
    6.
  •  编写代码 
 
 
 
 
    
  
  
  
  
  1. /**  
    2. 
  
  
  
  
  2.  * 文档生成  
    3. 
  
  
  
  
  3.  */  
    4. 
  
  
  
  
  4. void documentGeneration() {  
    5. 
  
  
  
  
  5.    //数据源  
    6. 
  
  
  
  
  6.    HikariConfig hikariConfig = new HikariConfig();  
    7. 
  
  
  
  
  7.    hikariConfig.setDriverClassName("com.mysql.cj.jdbc.Driver");  
    8. 
  
  
  
  
  8.    hikariConfig.setJdbcUrl("jdbc:mysql://127.0.0.1:3306/database");  
    9. 
  
  
  
  
  9.    hikariConfig.setUsername("root");  
    10. 
  
  
  
  
  10.    hikariConfig.setPassword("password");  
    11. 
  
  
  
  
  11.    //设置可以获取tables remarks信息  
    12. 
  
  
  
  
  12.    hikariConfig.addDataSourceProperty("useInformationSchema", "true");  
    13. 
  
  
  
  
  13.    hikariConfig.setMinimumIdle(2);  
    14. 
  
  
  
  
  14.    hikariConfig.setMaximumPoolSize(5);  
    15. 
  
  
  
  
  15.    DataSource dataSource = new HikariDataSource(hikariConfig);  
    16. 
  
  
  
  
  16.    //生成配置  
    17. 
  
  
  
  
  17.    EngineConfig engineConfig = EngineConfig.builder()  
    18. 
  
  
  
  
  18.          //生成文件路径  
    19. 
  
  
  
  
  19.          .fileOutputDir(fileOutputDir)  
    20. 
  
  
  
  
  20.          //打开目录  
    21. 
  
  
  
  
  21.          .openOutputDir(true)  
    22. 
  
  
  
  
  22.          //文件类型  
    23. 
  
  
  
  
  23.          .fileType(EngineFileType.HTML)  
    24. 
  
  
  
  
  24.          //生成模板实现  
    25. 
  
  
  
  
  25.          .produceType(EngineTemplateType.freemarker)  
    26. 
  
  
  
  
  26.          //自定义文件名称  
    27. 
  
  
  
  
  27.          .fileName("自定义文件名称").build();  
    28. 
  
  
  
  
  28.    //忽略表  
    29. 
  
  
  
  
  29.    ArrayList ignoreTableName = new ArrayList<>();  
    30. 
  
  
  
  
  30.    ignoreTableName.add("test_user");  
    31. 
  
  
  
  
  31.    ignoreTableName.add("test_group");  
    32. 
  
  
  
  
  32.    //忽略表前缀  
    33. 
  
  
  
  
  33.    ArrayList ignorePrefix = new ArrayList<>();  
    34. 
  
  
  
  
  34.    ignorePrefix.add("test_");  
    35. 
  
  
  
  
  35.    //忽略表后缀      
    36. 
  
  
  
  
  36.    ArrayList ignoreSuffix = new ArrayList<>();  
    37. 
  
  
  
  
  37.    ignoreSuffix.add("_test"); 
    38. 
  
  
  
  
  38.     ProcessConfig processConfig = ProcessConfig.builder()  
    39. 
  
  
  
  
  39.          //指定生成逻辑、当存在指定表、指定表前缀、指定表后缀时，将生成指定表，其余表不生成、并跳过忽略表配置   
    40. 
  
  
  
  
  40.    //根据名称指定表生成  
    41. 
  
  
  
  
  41.    .designatedTableName(new ArrayList<>())  
    42. 
  
  
  
  
  42.    //根据表前缀生成  
    43. 
  
  
  
  
  43.    .designatedTablePrefix(new ArrayList<>())  
    44. 
  
  
  
  
  44.    //根据表后缀生成   
    45. 
  
  
  
  
  45.    .designatedTableSuffix(new ArrayList<>())  
    46. 
  
  
  
  
  46.          //忽略表名  
    47. 
  
  
  
  
  47.          .ignoreTableName(ignoreTableName)  
    48. 
  
  
  
  
  48.          //忽略表前缀 
    49. 
  
  
  
  
  49.           .ignoreTablePrefix(ignorePrefix)  
    50. 
  
  
  
  
  50.          //忽略表后缀 
    51. 
  
  
  
  
  51.           .ignoreTableSuffix(ignoreSuffix).build();  
    52. 
  
  
  
  
  52.    //配置  
    53. 
  
  
  
  
  53.    Configuration config = Configuration.builder()  
    54. 
  
  
  
  
  54.          //版本  
    55. 
  
  
  
  
  55.          .version("1.0.0")  
    56. 
  
  
  
  
  56.          //描述  
    57. 
  
  
  
  
  57.          .description("数据库设计文档生成")  
    58. 
  
  
  
  
  58.          //数据源  
    59. 
  
  
  
  
  59.          .dataSource(dataSource)  
    60. 
  
  
  
  
  60.          //生成配置  
    61. 
  
  
  
  
  61.          .engineConfig(engineConfig) 
    62. 
  
  
  
  
  62.           //生成配置  
    63. 
  
  
  
  
  63.          .produceConfig(processConfig) 
    64. 
  
  
  
  
  64.           .build();  
    65. 
  
  
  
  
  65.    //执行生成  
    66. 
  
  
  
  
  66.    new DocumentationExecute(config).execute();  
    67. 
  
  
  
  
  67. } 
    68.

Maven 插件 

 
 
 
 
    
  
  
  
  
  1.   
    2. 
  
  
  
  
  2.       
    3. 
  
  
  
  
  3.           
    4. 
  
  
  
  
  4.             cn.smallbun.screw  
    5. 
  
  
  
  
  5.             screw-maven-plugin  
    6. 
  
  
  
  
  6.             ${lastVersion}  
    7. 
  
  
  
  
  7.               
    8. 
  
  
  
  
  8.                   
    9. 
  
  
  
  
  9.                   
    10. 
  
  
  
  
  10.                     com.zaxxer  
    11. 
  
  
  
  
  11.                     HikariCP  
    12. 
  
  
  
  
  12.                     3.4.5  
    13. 
  
  
  
  
  13.                   
    14. 
  
  
  
  
  14.                   
    15. 
  
  
  
  
  15.                   
    16. 
  
  
  
  
  16.                     mysql  
    17. 
  
  
  
  
  17.                     mysql-connector-java  
    18. 
  
  
  
  
  18.                     8.0.20  
    19. 
  
  
  
  
  19.                   
    20. 
  
  
  
  
  20.               
    21. 
  
  
  
  
  21.               
    22. 
  
  
  
  
  22.                   
    23. 
  
  
  
  
  23.                 root  
    24. 
  
  
  
  
  24.                   
    25. 
  
  
  
  
  25.                 password  
    26. 
  
  
  
  
  26.                   
    27. 
  
  
  
  
  27.                 com.mysql.cj.jdbc.Driver  
    28. 
  
  
  
  
  28.                   
    29. 
  
  
  
  
  29.                 jdbc:mysql://127.0.0.1:3306/xxxx  
    30. 
  
  
  
  
  30.                   
    31. 
  
  
  
  
  31.                 HTML  
    32. 
  
  
  
  
  32.                   
    33. 
  
  
  
  
  33.                 false  
    34. 
  
  
  
  
  34.                   
    35. 
  
  
  
  
  35.                 freemarker  
    36. 
  
  
  
  
  36.                   
    37. 
  
  
  
  
  37.                 测试文档名称  
    38. 
  
  
  
  
  38.                   
    39. 
  
  
  
  
  39.                 数据库文档生成  
    40. 
  
  
  
  
  40.                   
    41. 
  
  
  
  
  41.                 ${project.version}  
    42. 
  
  
  
  
  42.                   
    43. 
  
  
  
  
  43.                 数据库文档  
    44. 
  
  
  
  
  44.              
    45. 
  
  
  
  
  45.                
    46. 
  
  
  
  
  46.                   
    47. 
  
  
  
  
  47.                     compile  
    48. 
  
  
  
  
  48.                       
    49. 
  
  
  
  
  49.                         run  
    50. 
  
  
  
  
  50.                       
    51. 
  
  
  
  
  51.                   
    52. 
  
  
  
  
  52.               
    53. 
  
  
  
  
  53.           
    54. 
  
  
  
  
  54.       
    55. 
  
  
  
  
  55.  
    56.

扩展模块

pojo生成功能

功能简介

pojo生成功能是基于screw延伸出的扩展模块,目前处于初步开发的状态。在日常的开发中,经过需求分析、建模之后,往往会先在数据库中建表,其次在进行代码的开发。那么pojo生成功能在这个阶段就可以帮助大家节省一些重复劳动了。

使用pojo生成功能可以直接根据数据库生成对应的java pojo对象。这样后续的修改，开发都会很方便。

数据库支持

  •  MySQL

使用方式

  •  引入依赖 
 
 
 
 
    
  
  
  
  
  1.   
    2. 
  
  
  
  
  2.     cn.smallbun.screw  
    3. 
  
  
  
  
  3.     screw-extension  
    4. 
  
  
  
  
  4.     ${lastVersion}  
    5. 
  
  
  
  
  5.   
    6.
  •  编写代码 
 
 
 
 
    
  
  
  
  
  1. /**  
    2. 
  
  
  
  
  2.  * pojo生成  
    3. 
  
  
  
  
  3.  */  
    4. 
  
  
  
  
  4. void pojoGeneration() {  
    5. 
  
  
  
  
  5.     //数据源  
    6. 
  
  
  
  
  6.     HikariConfig hikariConfig = new HikariConfig();  
    7. 
  
  
  
  
  7.     hikariConfig.setDriverClassName("com.mysql.cj.jdbc.Driver");  
    8. 
  
  
  
  
  8.     hikariConfig.setJdbcUrl("jdbc:mysql://127.0.0.1:3306/screw");  
    9. 
  
  
  
  
  9.     hikariConfig.setUsername("screw");  
    10. 
  
  
  
  
  10.     hikariConfig.setPassword("screw");  
    11. 
  
  
  
  
  11.     //设置可以获取tables remarks信息 
    12. 
  
  
  
  
  12.      hikariConfig.addDataSourceProperty("useInformationSchema", "true");  
    13. 
  
  
  
  
  13.     hikariConfig.setMinimumIdle(2);  
    14. 
  
  
  
  
  14.     hikariConfig.setMaximumPoolSize(5);  
    15. 
  
  
  
  
  15.     DataSource dataSource = new HikariDataSource(hikariConfig);  
    16. 
  
  
  
  
  16.     ProcessConfig processConfig = ProcessConfig.builder()  
    17. 
  
  
  
  
  17.         //指定生成逻辑、当存在指定表、指定表前缀、指定表后缀时，将生成指定表，其余表不生成、并跳过忽略表配置  
    18. 
  
  
  
  
  18.         //根据名称指定表生成  
    19. 
  
  
  
  
  19.         .designatedTableName(new ArrayList<>())  
    20. 
  
  
  
  
  20.         //根据表前缀生成  
    21. 
  
  
  
  
  21.         .designatedTablePrefix(new ArrayList<>())  
    22. 
  
  
  
  
  22.         //根据表后缀生成  
    23. 
  
  
  
  
  23.         .designatedTableSuffix(new ArrayList<>()).build();  
    24. 
  
  
  
  
  24.     //设置生成pojo相关配置  
    25. 
  
  
  
  
  25.     PojoConfiguration config = new PojoConfiguration();  
    26. 
  
  
  
  
  26.     //设置文件存放路径  
    27. 
  
  
  
  
  27.     config.setPath("/cn/smallbun/screw/");  
    28. 
  
  
  
  
  28.     //设置包名  
    29. 
  
  
  
  
  29.     config.setPackageName("cn.smallbun.screw");  
    30. 
  
  
  
  
  30.     //设置是否使用lombok  
    31. 
  
  
  
  
  31.     config.setUseLombok(false);  
    32. 
  
  
  
  
  32.     //设置数据源  
    33. 
  
  
  
  
  33.     config.setDataSource(dataSource);  
    34. 
  
  
  
  
  34.     //设置命名策略  
    35. 
  
  
  
  
  35.     config.setNameStrategy(new HumpNameStrategy());  
    36. 
  
  
  
  
  36.     //设置表过滤逻辑  
    37. 
  
  
  
  
  37.     config.setProcessConfig(processConfig);  
    38. 
  
  
  
  
  38.     //执行生成  
    39. 
  
  
  
  
  39.     new PojoExecute(config).execute();  
    40. 
  
  
  
  
  40. } 
    41.

常见问题

  •  生成后文档乱码？

          MySQL：URL加入?characterEncoding=UTF-8。

  •  Caused by: java.lang.NoSuchFieldError: VERSION_2_3_30？

           检查项目freemarker依赖，这是由于版本过低造成的，升级版本为2.3.30即可。

  •  java.lang.AbstractMethodError: oracle.jdbc.driver.T4CConnection.getSchema()Ljava/lang/String;

          这是因为oracle驱动版本过低造成的，删除或屏蔽目前驱动版本，驱动添加升级为以下版本：   

 
 
 
 
    
  
  
  
  
  1.   
    2. 
  
  
  
  
  2.        com.oracle.ojdbc  
    3. 
  
  
  
  
  3.        ojdbc8  
    4. 
  
  
  
  
  4.        19.3.0.0  
    5. 
  
  
  
  
  5.       
    6. 
  
  
  
  
  6.       
    7. 
  
  
  
  
  7.        cn.easyproject  
    8. 
  
  
  
  
  8.        orai18n  
    9. 
  
  
  
  
  9.        12.1.0.2.0  
    10. 
  
  
  
  
  10.      
    11.
  •  MySQL数据库表和列字段有说明、生成文档没有说明？

    URL链接加入useInformationSchema=true即可。

  •  java.lang.AbstractMethodError: com.mysql.jdbc.JDBC4Connection.getSchema()Ljava/lang/String;

    这是因为mysql驱动版本过低造成的，升级mysql驱动版本为最新即可。 

本文名称：好用！一键生成数据库文档，这个开源的文档生成工具值得了解
分享路径：http://www.shufengxianlan.com/qtweb/news35/202635.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 创新互联

猜你还喜欢下面的内容

软件开发知识

分类信息网站

华川商务　　 　成都口碑营销公司　　 　绵竹网站建设　　 　软文营销　　 　成都网站建设　　 　APP定制开发　　 　四川艾名斯　　 　成都商城网站制作　　 　谷歌推广　　 　升施印刷　　 　高端网站设计　　 　西部信息机房　　 　蜜朵婚庆　　 　温江电信机房　　 　香港四川國際商會　　 　成都模板网站　　 　网络推广公司　　 　软文推广　　 　成都网站改版　　 　顺泽窗帘