【MyBatis】写了 10 年的代码，我最怕写 MyBatis 这些配置，现在有详解了

小咪咪 2021-08-26 12:57 318阅读 0赞

![format_png][]

作者 | 阿进的写字台

编辑 | 公众号（Java后端）

链接 | cnblogs.com/homejim/p/9782403.html

在使用 **mybatis** 过程中， 当手写 **JavaBean**和**XML** 写的越来越多的时候， 就越来越同意出错。这种重复性的工作， 我们当然不希望做那么多。

还好， **mybatis** 为我们提供了强大的代码生成--**MybatisGenerator**。

通过简单的配置， 我们就可以生成各种类型的实体类， Mapper接口， MapperXML文件， Example对象等。通过这些生成的文件， 我们就可以方便的进行单表进行增删改查的操作。

Tips：关注微信公众号：Java后端，获取每日推送。

以下的工具使用的都是 **IDEA**

**1.1 创建Maven项目**

**1.1.1 菜单上选择新建项目**

> **File | New | Project**

**1.1.2 选择左侧的****`Maven`**

![format_png 1][]

由于我们只是创建一个普通的项目， 此处点击 `Next`即可。

**1.1.3 输入****`GroupId`和`ArtifactId`**

*  在我的项目中，

> GroupId 填 com.homejim.mybatis
> 
> ArtifactId 填 mybatis-generator

点击 `Next`。

**1.1.4 ****`Finish`**

通过以上步骤， 一个普通的`Maven`项目就创建好了。

## **1.2 配置 generator.xml** ##

其实名字无所谓， 只要跟下面的 **pom.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="C:\Users\\Administrator\\.m2\repository\\mysql\\mysql-connector-java\\8.0.12\\mysql-connector-java-8.0.12.jar"/>
        <context id="context" targetRuntime="MyBatis3">
            <commentGenerator>
                <property name="suppressAllComments" value="false"/>
                <property name="suppressDate" value="true"/>
            </commentGenerator>
            
            <jdbcConnection
                    driverClass="com.mysql.jdbc.Driver"
                    connectionURL="jdbc:mysql://localhost:3306/mybatis"
                    userId="root"
                    password="jim777"/>
    
            <javaTypeResolver>
                <property name="forceBigDecimals" value="false"/>
            </javaTypeResolver>
            
            <javaModelGenerator
                    targetPackage="com.homejim.mybatis.entity"
                    targetProject=".\src\main\java">
                <property name="enableSubPackages" value="false"/>
                <property name="trimStrings" value="true"/>
            </javaModelGenerator>
            
            <sqlMapGenerator
                    targetPackage="mybatis/mapper"
                    targetProject=".\src\main\resources">
                <property name="enableSubPackages" value="false"/>
            </sqlMapGenerator>
            
            <javaClientGenerator type="XMLMAPPER"
                                 targetPackage="com.homejim.mybatis.mapper"
                                 targetProject=".\src\main\java">
                <property name="enableSubPackages" value="false"/>
            </javaClientGenerator>
    
            <table tableName="blog" />
        </context>
    </generatorConfiguration>

需要改一些内容：

1. 本地数据库驱动程序jar包的全路径（**必须要改**）。

2. 数据库的相关配置（**必须要改**）

3. 相关表的配置（**必须要改**）

4. 实体类生成存放的位置。

5. MapperXML 生成文件存放的位置。

6. Mapper 接口存放的位置。

如果不知道怎么改， 请看后面的**配置详解**。

## **1.3 配置 pom.xml** ##

在原基础上添加一些内容。

<?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.homejim.mybatis</groupId>
        <artifactId>mybatis-generator</artifactId>
        <version>1.0-SNAPSHOT</version>
        
        <build>
            <finalName>mybatis-generator</finalName>
            <plugins>
                <plugin>
                    <groupId>org.mybatis.generator</groupId>
                    <artifactId>mybatis-generator-maven-plugin</artifactId>
                    <version>1.3.7</version>
                    <configuration>
                       
                       <configurationFile>src/main/resources/generator.xml</configurationFile>
                        <verbose>true</verbose>
                        <overwrite>true</overwrite>
                    </configuration>
                    <executions>
                        <execution>
                            <id>Generate MyBatis Artifacts</id>
                            <goals>
                                <goal>generate</goal>
                            </goals>
                        </execution>
                    </executions>
                    <dependencies>
                        <dependency>
                            <groupId>org.mybatis.generator</groupId>
                            <artifactId>mybatis-generator-core</artifactId>
                            <version>1.3.7</version>
                        </dependency>
                    </dependencies>
                </plugin>
            </plugins>
        </build>
        
    </project>

需要注意的是 **configurationFile** 中的文件指的是 **generator.xml**。因此路径写的是该文件的相对路径， 名称也跟该文件相同。

到此， **mybatis-generator** 就可以使用啦。

## **1.4 使用及测试** ##

**1.4.1 打开 Maven Projects 视图**

在 IDEA 上， 打开：

**View | Tools | Windwos | Maven Projects**

![format_png 2][]

**1.4.2 Maven Projects 中双击 mybatis-generator**

在右侧此时可以看到 Maven Projects 了。找到 mybatis-generator 插件。

**mybatis-generator | Plugins | mybatis-generator | mybatis-generator**

![format_png 3][]

**1.4.3 双击运行**

运行正确后， 生成代码， 得到如下的结构

![format_png 4][]

仅仅是上面那么简单的使用还不够爽。那么我们就可以通过更改 generator.xml 配置文件的方式进行生成的配置。

## **2.1 文档** ##

**推荐查看官方的文档。**

英文不错的：http://www.mybatis.org/generator/configreference/xmlconfig.html

中文翻译版：http://mbg.cndocs.ml/index.html

## **2.2 官网没有的** ##

### 2.2.1 property 标签 ###

该标签在官网中只是说用来指定元素的属性， 至于怎么用没有详细的讲解。

#### 2.2.1.1 分隔符相关 ####

####     ####

#### 以上的配置对应的是 **mysql**， **当数据库中的字段和数据库的关键字一样时**， 就会使用分隔符。 ####

比如我们的数据列是 `delete`, 按以上的配置后， 在它出现的地方， 就变成 `` `delete` ``。

#### 2.2.1.2 编码 ####

默认是使用当前的系统环境的编码， 可以配置为 GBK 或 UTF-8。

我想项目为 UTF-8， 如果指定生成 GBK， 则自动生成的中文就是乱码。

#### 2.2.1.3 格式化 ####

这些显然都是可以自定义实现的的。

### 2.2.2 plugins 标签 ###

plugins 标签用来扩展或修改代码生成器生成的代码。

在生成的 XML 中， 是没有 **<cache>** 这个标签的。该标签是配置缓存的。

如果我们想生成这个标签， 那么可以 **plugins** 中进行配置。

![format_png 5][]

比如你想生成的 **JavaBean** 中自行实现 Serializable 接口。

<plugin type="org.mybatis.generator.plugins.SerializablePlugin" />

![format_png 6][]

还能自定义插件。

这些插件都蛮有用的， 感觉后续可以专门开一篇文章来讲解。

看名称， 就知道是用来生成注释用的。

默认配置：

<commentGenerator >
      <property name="suppressAllComments" value="false"/>
      <property name="suppressDate" value="false"/>
      <property name="addRemarkComments" value="false"/>
    </commentGenerator>

suppressAllComments： 阻止生成注释， 默认值是false。

suppressDate: 阻止生成的注释包含时间戳， 默认为false。

addRemarkComments: 注释中添加数据库的注释， 默认为 false。

还有一个就是我们**可以通过 type 属性指定我们自定义的注解实现类， 生成我们自己想要的注解**。自定义的实现类需要实现 `org.mybatis.generator.api.CommentGenerator`。

## **2.2.4 源码** ##

https://github.com/homejim/mybatis-cn

![format_png 7][]

本文作者：阿进的写字台，原文链接：cnblogs.com/homejim/p/9782403.html

由公众号（Java后端）编辑，转载请著名本句话及原文出处。

--------------------

\-END-

如果看到这里，说明你喜欢这篇文章，请**转发****、点赞**。微信搜索「web\_resource」，欢迎添加小编微信「focusoncode」，每日朋友圈更新一篇高质量技术博文（无广告）。

**↓扫描二维码添加小编↓**

![format_png 8][]

**推****荐****阅****读**

***1. [浅谈 Web 网站架构演变过程][Web]***

***2. [一个非常实用的特性，很多人没用过][Link 1]***

***3. [Spring Boot 2.x 操作缓存的新姿势][Spring Boot 2.x]***

***4. [MyBatis 中 SQL 写法技巧小总结][MyBatis _ SQL]***

***![format_png 9][]***

[format_png]: /images/20210730/e2fb3b4ea283439ba55dc75a03e0ffca.png
[format_png 1]: /images/20210730/9f5d97f3c23045e9b7336b746c1ac7d1.png
[format_png 2]: /images/20210730/40b24a520f324d4f93d39edd33fb475e.png
[format_png 3]: /images/20210730/ffe9a126a3b443c7b7b098a56fbeb04e.png
[format_png 4]: /images/20210730/06571739556c463d9abe5e7047e437c8.png
[format_png 5]: /images/20210730/33eb25e8f8c04f9588bbfaa55b271a9b.png
[format_png 6]: /images/20210730/c6c1e0c4a9f14c57a1236b3438868952.png
[format_png 7]: /images/20210730/b892e2bc60ac4eb79b819244facbe36e.png
[format_png 8]: /images/20210730/bd0814461543413aa634ff5bbb1f48bf.png
[Web]: https://blog.csdn.net/qq_37217713/article/details/104548904
[Link 1]: https://blog.csdn.net/qq_37217713/article/details/104548901
[Spring Boot 2.x]: https://blog.csdn.net/qq_37217713/article/details/104548905
[MyBatis _ SQL]: https://blog.csdn.net/qq_37217713/article/details/104548915
[format_png 9]: /images/20210730/a5ca7959ef5347f3a094f79c722b8234.png