MyBatis Generator与主流数据库集成：MySQL、Oracle、PostgreSQL最佳实践

【免费下载链接】generator A code generator for MyBatis. 项目地址: https://gitcode.com/gh_mirrors/ge/generator

MyBatis Generator（简称MBG）是一款强大的代码生成工具，能够自动生成MyBatis所需的实体类、Mapper接口和XML映射文件，显著提升开发效率。本文将详细介绍MBG与MySQL、Oracle、PostgreSQL三大主流数据库的集成方案，帮助开发者快速掌握最佳实践。

📋 准备工作：环境配置

在开始集成前，请确保已完成以下准备：

• 安装Java开发环境（JDK 8+）
• 下载MyBatis Generator核心包 core/mybatis-generator-core/
• 准备对应数据库的JDBC驱动

快速安装

通过Git克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/ge/generator

🐬 MySQL集成指南

MySQL作为最流行的开源数据库，与MBG集成需要注意以下关键点：

1. 处理无符号字段

MySQL支持无符号数值类型（如UNSIGNED BIGINT），但JDBC没有对应的类型映射。解决方案是使用<columnOverride>手动指定类型：

<table tableName="ALLTYPES">
  <columnOverride column="UNSIGNED_BIGINT_FIELD" javaType="java.math.BigInteger" jdbcType="LONG" />
</table>

2. 正确配置Catalog与Schema

MySQL对Catalog和Schema的支持与标准SQL不同，建议在JDBC URL中指定数据库，不单独设置Catalog/Schema：

<jdbcConnection driverClass="com.mysql.cj.jdbc.Driver" 
    connectionURL="jdbc:mysql://localhost/my_db?nullCatalogMeansCurrent=true"
    userId="root" password="password">
</jdbcConnection>

⚠️ 注意：MySQL 8.x需添加nullCatalogMeansCurrent=true参数避免生成系统表代码

🛢️ Oracle集成要点

Oracle数据库的特殊数据类型和配置需要特别处理：

1. 处理LONG类型字段

Oracle的LONG类型会被JDBC驱动识别为LONGVARCHAR，导致MyBatis映射错误。建议使用以下配置：

<columnOverride column="LONG_FIELD" javaType="java.lang.String" jdbcType="VARCHAR" />

2. 序列与自增主键

Oracle使用序列（Sequence）实现自增，配置示例：

<table tableName="EMPLOYEE">
  <generatedKey column="ID" sqlStatement="SELECT SEQ_EMPLOYEE.NEXTVAL FROM DUAL" identity="false" type="pre" />
</table>

🐘 PostgreSQL最佳实践

PostgreSQL的大小写敏感特性和独特数据类型需要特别配置：

1. 标识符大小写处理

PostgreSQL对表名、列名等标识符区分大小写，建议使用全小写命名或用双引号包裹：

<table tableName="alltypes" schema="public">
  <!-- 全小写表名避免大小写问题 -->
</table>

2. 数组类型支持

PostgreSQL的数组类型需要自定义TypeHandler，配置示例：

<columnOverride column="TAGS" javaType="java.util.List" jdbcType="ARRAY" typeHandler="com.example.ArrayTypeHandler" />

📝 通用配置模板

以下是适用于所有数据库的基础配置模板 core/mybatis-generator-core/src/main/resources/generatorConfig.xml：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE generatorConfiguration PUBLIC
  "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
  "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
  <context id="DB2Tables" targetRuntime="MyBatis3">
    <jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
        connectionURL="jdbc:mysql://localhost/my_db"
        userId="root" password="password">
    </jdbcConnection>
    
    <javaModelGenerator targetPackage="com.example.model" targetProject="src/main/java">
      <property name="enableSubPackages" value="true" />
      <property name="trimStrings" value="true" />
    </javaModelGenerator>

    <sqlMapGenerator targetPackage="com.example.mapper" targetProject="src/main/resources">
      <property name="enableSubPackages" value="true" />
    </sqlMapGenerator>

    <javaClientGenerator type="XMLMAPPER" targetPackage="com.example.mapper" targetProject="src/main/java">
      <property name="enableSubPackages" value="true" />
    </javaClientGenerator>

    <table tableName="%">
      <!-- 全局表配置 -->
    </table>
  </context>
</generatorConfiguration>

🚀 运行与验证

配置完成后，可通过以下方式运行生成器：

使用Eclipse插件

通过Eclipse导入项目后，使用MyBatis Generator插件的导入向导：

命令行运行

cd core/mybatis-generator-core
mvn mybatis-generator:generate

💡 常见问题解决

1. Q: 生成的代码包含系统表？
   A: MySQL添加nullCatalogMeansCurrent=true参数，Oracle指定schema

2. Q: 日期类型映射错误？
   A: 使用<javaTypeResolver>配置：

   <javaTypeResolver>
     <property name="useJSR310Types" value="true" />
   </javaTypeResolver>
   

3. Q: PostgreSQL数组类型处理？
   A: 自定义TypeHandler并在<columnOverride>中指定

📚 参考资料

• 官方文档：core/mybatis-generator-core/src/site/xhtml/usage/
• 配置示例：core/mybatis-generator-core/src/main/resources/
• 数据库适配源码：core/mybatis-generator-core/src/main/java/org/mybatis/generator/internal/db/

通过本文介绍的方法，您可以轻松实现MyBatis Generator与主流数据库的无缝集成，大幅提升持久层代码开发效率。根据具体数据库特性调整配置，将帮助您避免常见陷阱，生成高质量的MyBatis代码。

【免费下载链接】generator A code generator for MyBatis. 项目地址: https://gitcode.com/gh_mirrors/ge/generator