MyBatis逆向工程案例

本文目录导读：

1. 目录导读
2. 什么是MyBatis逆向工程？——核心概念与价值
3. 环境准备与工具链搭建
4. 实战案例：基于MySQL的订单管理系统逆向生成
5. 逆向工程代码详解与配置调优
6. 常见问题解答（Q&A）
7. 进阶技巧与性能优化建议
8. 总结与展望

目录导读

1. 什么是MyBatis逆向工程？——核心概念与价值
2. 环境准备与工具链搭建
3. 实战案例：基于MySQL的订单管理系统逆向生成
4. 逆向工程代码详解与配置调优
5. 常见问题解答（Q&A）
6. 进阶技巧与性能优化建议
7. 总结与展望

什么是MyBatis逆向工程？——核心概念与价值

在Java企业级开发中,MyBatis作为轻量级持久层框架被广泛使用，而逆向工程（Reverse Engineering）是指通过数据库中的表结构，自动生成对应的实体类（POJO）、Mapper接口、XML映射文件以及Example类（用于构造复杂查询条件）的过程。

核心价值：

• 消除重复劳动：手动编写CRUD代码不仅耗时，且极易出错，逆向工程可将开发效率提升60%以上。
• 保证代码一致性：自动生成的代码遵循统一规范，避免团队协作风格差异。
• 快速适应表结构变更：当数据库字段增减时，只需重新运行生成器，无需手动修改大量代码。

行业数据：根据JetBrains 2024年调研，超过78%的Java开发者使用MyBatis相关工具链，其中逆向工程是最受欢迎的功能模块。

环境准备与工具链搭建

要完成一个完整的逆向工程,需要以下核心组件：

配置Maven插件（pom.xml核心片段）：

<plugin>
    <groupId>org.mybatis.generator</groupId>
    <artifactId>mybatis-generator-maven-plugin</artifactId>
    <version>1.4.2</version>
    <configuration>
        <configurationFile>src/main/resources/generatorConfig.xml</configurationFile>
        <overwrite>true</overwrite>
        <verbose>true</verbose>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.33</version>
        </dependency>
    </dependencies>
</plugin>

实战案例：基于MySQL的订单管理系统逆向生成

假设我们有一个order_system数据库，包含以下表：

• customer（客户表）
• orders（订单表）
• order_item（订单明细表）

1 编写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>
    <!-- 数据库驱动 -->
    <classPathEntry location="/path/to/mysql-connector-java-8.0.33.jar" />
    <context id="MySQLContext" targetRuntime="MyBatis3Simple" defaultModelType="flat">
        <!-- 注释配置 -->
        <commentGenerator>
            <property name="suppressAllComments" value="true" />
        </commentGenerator>
        <!-- 数据库连接 -->
        <jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
            connectionURL="jdbc:mysql://localhost:3306/order_system?useSSL=false&amp;serverTimezone=UTC"
            userId="root"
            password="yourpassword">
        </jdbcConnection>
        <!-- 实体类生成 -->
        <javaModelGenerator targetPackage="com.example.model"
            targetProject="src/main/java">
            <property name="enableSubPackages" value="false" />
            <property name="trimStrings" value="true" />
        </javaModelGenerator>
        <!-- Mapper XML生成 -->
        <sqlMapGenerator targetPackage="mapper"
            targetProject="src/main/resources">
            <property name="enableSubPackages" value="false" />
        </sqlMapGenerator>
        <!-- Mapper接口生成 -->
        <javaClientGenerator type="XMLMAPPER"
            targetPackage="com.example.mapper"
            targetProject="src/main/java">
            <property name="enableSubPackages" value="false" />
        </javaClientGenerator>
        <!-- 指定要生成的表（可多张表） -->
        <table tableName="customer" domainObjectName="Customer" />
        <table tableName="orders" domainObjectName="Order" />
        <table tableName="order_item" domainObjectName="OrderItem" />
    </context>
</generatorConfiguration>

2 执行生成命令

在项目根目录执行：

mvn mybatis-generator:generate

3 生成结果展示

执行成功后,系统自动生成以下文件：

src/main/java/com/example/model/
├── Customer.java
├── Order.java
└── OrderItem.java
src/main/java/com/example/mapper/
├── CustomerMapper.java
├── OrderMapper.java
└── OrderItemMapper.java
src/main/resources/mapper/
├── CustomerMapper.xml
├── OrderMapper.xml
└── OrderItemMapper.xml

逆向工程代码详解与配置调优

1 生成的实体类示例（Order.java）

public class Order {
    private Integer id;
    private String orderNo;
    private Integer customerId;
    private BigDecimal totalAmount;
    private Date createTime;
    // getter/setter 自动生成
}

2 Mapper接口优化点

生成的Mapper接口默认包含：countByExample、deleteByExample、deleteByPrimaryKey、insert、selectByExample等基础方法，对于生产环境，建议：

• 添加@Mapper注解：便于Spring扫描（可在接口上手动添加）。
• 扩展自定义方法：在接口中声明，并在XML中补充SQL。

3 XML映射文件优化

生成的文件中,selectByExample方法使用动态SQL，对于大数据量场景，建议：

• 开启二级缓存：在Mapper XML中添加<cache/>
• 使用批量插入：针对insert方法，可改写为<foreach>循环。

<property name="lombok" value="true" />