Spring Boot 3.x 整合 MyBatis 代码生成器插件

最新推荐文章于 2025-05-03 23:08:40 发布

七禾页话

最新推荐文章于 2025-05-03 23:08:40 发布

阅读量1.2k

点赞数 45

分类专栏： spring 文章标签： spring boot mybatis 后端

本文链接：https://blog.youkuaiyun.com/2302_77276867/article/details/145116859

版权

spring 专栏收录该内容

44 篇文章

订阅专栏

Spring Boot 3.x 整合 MyBatis 代码生成器插件

1. mybatis-generator 是什么？

mybatis-generator-maven-plugin 是一个 Maven 插件，用于生成 MyBatis 的代码（如 Mapper 接口、Mapper XML 文件等），官方文档地址: https://mybatis.org/generator/ 。它可以根据数据库表自动生成相应的 Java 实体类、Mapper 接口和 XML 映射文件，大大减少了手动编写这些重复且机械化的代码的工作量。以下是它的一些优点：

自动化生成代码： 可以根据数据库表结构自动生成与之对应的 Java 实体类、Mapper 接口和 XML 映射文件，省去了手动编写这些代码的繁琐过程。
提高开发效率： 通过自动生成代码，开发人员可以更专注于业务逻辑的实现，而不必花费大量时间在重复的 CRUD 操作上。
保持数据一致性： 自动生成的代码与数据库表结构保持一致，避免了手动编写代码时可能出现的字段名拼写错误或数据类型不匹配等问题。
易于维护： 自动生成的代码结构清晰，易于阅读和理解，便于后续的维护和修改。
支持定制化配置： 可以通过配置文件或插件参数对生成的代码进行定制，满足不同项目的需求。

2. 开始整合

声明 mybatis-generator-maven-plugin 插件的版本号以及依赖，代码如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    
    <modelVersion>4.0.0</modelVersion>
    
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    
    <properties>
        <java.version>1.8</java.version>
        <mysql-connector-java.version>8.0.28</mysql-connector-java.version>
        <mybatis-generator-maven-plugin.version>1.3.5</mybatis-generator-maven-plugin.version>
    </properties>
    
    <dependencies>
        <!-- MyBatis -->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.2.2</version>
        </dependency>
        
        <!-- MySQL -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>${mysql-connector-java.version}</version>
        </dependency>
        
        <!-- Lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.24</version>
            <optional>true</optional>
        </dependency>
    </dependencies>
    
    <build>
        <plugins>
            <!-- MyBatis Generator 插件 -->
            <plugin>
                <groupId>org.mybatis.generator</groupId>
                <artifactId>mybatis-generator-maven-plugin</artifactId>
                <version>${mybatis-generator-maven-plugin.version}</version>
                <configuration>
                    <configurationFile>${basedir}/src/main/resources/generatorConfig.xml</configurationFile>
                    <verbose>true</verbose>
                    <overwrite>true</overwrite>
                </configuration>
                <dependencies>
                    <dependency>
                        <groupId>mysql</groupId>
                        <artifactId>mysql-connector-java</artifactId>
                        <version>${mysql-connector-java.version}</version>
                    </dependency>
                </dependencies>
            </plugin>
        </plugins>
    </build>
</project>

添加完成后，重新刷新一下 Maven 依赖。大概率还会爆红，暂时先不管，观察右侧栏，确认一下认证服务中 Plugins 下是否有该插件, 如下图所示：

在这里插入图片描述

3. 添加配置文件

插件添加完毕后，在 /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="mysqlTables" targetRuntime="MyBatis3" defaultModelType="flat">

        <!-- 自动检查关键字，为关键字增加反引号，如：`type` -->
        <property name="autoDelimitKeywords" value="true"/>
        <property name="beginningDelimiter" value="`"/>
        <property name="endingDelimiter" value="`"/>
        <!-- 指定生成的 Java 文件编码 -->
        <property name="javaFileEncoding" value="UTF-8"/>

        <!-- 对生成的注释进行控制 -->
        <commentGenerator>
            <!-- 由于此插件生成的注释不太美观，这里设置不生成任何注释 -->
            <property name="suppressAllComments" value="true"/>
        </commentGenerator>

        <!-- 数据库链接 -->
        <jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
                        connectionURL="jdbc:mysql://127.0.0.1:3306/xiaohashu"
                        userId="root"
                        password="123456">
            <!-- 解决多个重名的表生成表结构不一致问题 -->
            <property name="nullCatalogMeansCurrent" value="true"/>
        </jdbcConnection>

        <!-- 不强制将所有的数值类型映射为 Java 的 BigDecimal 类型 -->
        <javaTypeResolver>
            <property name="forceBigDecimals" value="false"/>
        </javaTypeResolver>

        <!-- DO 实体类存放路径 -->
        <javaModelGenerator targetPackage="com.quanxiaoha.xiaohashu.auth.domain.dataobject"
                            targetProject="src/main/java"/>

        <!-- Mapper xml 文件存放路径-->
        <sqlMapGenerator targetPackage="mapper"
                         targetProject="src/main/resources"/>

        <!-- Mapper 接口存放路径 -->
        <javaClientGenerator type="XMLMAPPER" targetPackage="com.quanxiaoha.xiaohashu.auth.domain.mapper"
                             targetProject="src/main/java"/>

        <!-- 需要生成的表-实体类 -->
        <table tableName="t_user" domainObjectName="UserDO"
               enableCountByExample="false"
               enableUpdateByExample="false"
               enableDeleteByExample="false"
               enableSelectByExample="false"
               selectByExampleQueryId="false"/>
    </context>
</generatorConfiguration>

解释一下各项配置的含义：

generatorConfiguration 标签是根标签，用于定义整个配置文件的内容。

context标签定义了一个上下文，用于指定生成代码的一些全局配置和规则。

id 属性指定了上下文的唯一标识符，这里是 mysqlTables。
targetRuntime 属性指定了生成代码的目标运行时环境，这里是 MyBatis3。
defaultModelType 属性指定了生成代码时默认的模型类型，这里是 flat，表示生成的实体类是扁平化的。

property标签用于配置一些属性。

autoDelimitKeywords 属性设置为 true 表示自动检查关键字，为关键字增加反引号。

beginningDelimiter 和 endingDelimiter 属性指定了起始和结束的引号。

javaFileEncoding 属性指定了生成的 Java 文件的编码为 UTF-8。

commentGenerator 标签用于配置注释生成器，这里设置 suppressAllComments 属性为 true 表示不生成任何注释。

jdbcConnection 标签用于配置数据库连接信息，包括驱动类、连接 URL、用户名和密码。

javaTypeResolver 标签用于配置 Java 类型解析器，这里设置 forceBigDecimals 属性为 false 表示不强制将所有的数值类型映射为 Java 的 BigDecimal 类型。

javaModelGenerator 标签用于配置生成的 DO 实体类存放路径。

sqlMapGenerator 标签用于配置生成的 Mapper XML 文件存放路径。

javaClientGenerator 标签用于配置生成的 Mapper 接口存放路径。

table标签用于指定需要生成的表和对应的实体类。

tableName 属性指定了数据库中的表名。
domainObjectName 属性指定了生成的实体类的名称。
enableCountByExample、enableUpdateByExample、enableDeleteByExample、enableSelectByExample 属性用于指定是否启用相关方法的生成。
selectByExampleQueryId 属性用于指定是否生成查询方法的 ID。