Mybatis generator配置（超详细）

参考文档

MyBatis Generator Core – Introduction to MyBatis Generator

MyBatis Generator 详解_enablesubpackages_isea533的博客-CSDN博客

一文解析 MyBatis Generator 的使用及配置 - 掘金

1. Introduction

MyBatis Generator (MBG) 是 MyBatis MyBatis的代码生成器。它将生成所有版本的 MyBatis 的代码。它将内省（introspect）数据库表（或许多表）并生成可用于访问表的工件。这减少了设置对象和配置文件以与数据库表交互的初始麻烦。MBG 力求对大部分简单 CRUD（创建、检索、更新、删除）的数据库操作产生重大影响。您仍然需要为连接查询或存储过程手动编写 SQL 和对象代码。

2. Quick Start Guide

MyBatis Generator (MBG) 根据其配置方式生成不同风格的代码。

a. Sample Configuration for MyBatis3

  
    

    

    

    

    
3. XML配置详解
a. DOCTYPE
文档需要包含以下DOCTYPE
b. 根节点
generatorConfiguration节点没有任何属性，直接写节点即可，如下：

  
子元素：
 
   
 (0 or 1)
 
   
 (0..N)
 
   
 (1..N)
 
  
ⅰ. 
 元素用于指定用于解析配置的外部属性文件。引入属性文件后，可以在配置中使用 ${property}这种形式的引用，通过这种方式引用属性文件中的属性值。
必要属性
One, and only one, of the following attributes is required.
 
   
 
    
 
     
 
Attribute
 
 
     
 
Description
 
 
    
 
    
 
     
 
resource
 
 
     
 
The qualified name of the property file. When specifying the resource, the classpath will be searched for the properties file. So a file specified as com/myproject/generatorConfig.properties must exist in the com.myproject package.
 
 
    
 
    
 
     
 
url
 
 
     
 
A URL value to use for the property file. This can be used to specify a property file in a specific place on the file system when used in a form like file:///C:/myfolder/generatorConfig.properties.
 
 
    
 
   
 
  
 
  
ⅱ. 
 
  
 元素用于将类路径位置添加到 MyBatis Generator (MBG) 运行的类路径中。
 
  
MBG 在这些实例中从这些位置加载类：
 
  
 
   
加载 JDBC 驱动程序以进行数据库自省时
 
   
在 JavaModelGenerator 中加载根类以检查重写的方法时
 
  
 
  
ⅲ. 
 
  
元素用于指定生成一组对象的环境。子元素用于指定要连接的数据库、要生成的对象类型以及要内省的表。可以在元素内列出多个  元素 ，以允许在 MyBatis Generator (MBG) 的同一次运行中从不同数据库生成对象，或使用不同的生成参数生成对象。
 
  
1. 必要属性
 
  
该元素只有一个必选属性id，用来唯一确定一个元素
 
  
2. 可选属性
 
  
defaultModelType：定义了MBG如何生成实体类。This attribute is ignored if the target runtime is "MyBatis3Simple", "MyBatis3DynamicSql", or "MyBatis3Kotlin"
 
  
这个属性有以下可选值：
 
  
 
   
conditional：这是默认值，这个模型和下面的hierarchical类似，除了如果一个类只包含一个字段，将不会生成一个单独的类。 因此，如果一个表的主键只有一个字段，那么不会为该字段生成单独的实体类，会将该字段合并到基本实体类中。
 
   
flat：该模型为每一张表只生成一个实体类。这个实体类包含表中的所有字段。这种模型最简单，推荐使用。
 
   
hierarchical:如果表有主键,那么该模型会产生一个单独的主键实体类,如果表还有BLOB字段， 则会为表生成一个包含所有BLOB字段的单独的实体类,然后为所有其他的字段生成一个单独的实体类。 MBG会在所有生成的实体类之间维护一个继承关系。
 
  
 
  
 
  
targetRuntime：此属性用于指定生成的代码的运行时环境
 
  
 
   
 
    
 
     
 
目标运行时
 
 
     
 
评论
 
 
    
 
    
 
     
 
MyBatis3DynamicSql
 
 
     
 
这是默认值
 
      
 
       
生成 Java 代码
 
       
不生成XML - 专门使用MyBatis3注释
 
       
生成的模型对象是“扁平的”——没有单独的主键对象
 
       
生成的代码依赖于MyBatis动态SQL库
 
       
生成的代码量比较少
 
       
生成的代码为查询构造提供了极大的灵活性
 
      
 
    
 
    
 
     
 
MyBatis3Kotlin
 
 
     
 
      
 
       
生成 Kotlin 代码
 
       
不生成XML - 专门使用MyBatis3注释
 
       
生成的模型对象是“扁平的”——没有单独的主键对象
 
       
生成的代码依赖于MyBatis动态SQL库
 
       
生成的代码量比较少
 
       
生成的代码为查询构造提供了极大的灵活性
 
      
 
    
 
    
 
     
 
MyBatis3
 
 
     
 
这是原始的运行时。在MBG 1.3.6版本之前，MBG的大多数用法都使用这种代码风格。
 
      
 
       
生成 Java 代码
 
       
生成 MyBatis3 兼容的 XML 和 SQL 或 MyBatis3 兼容的带注释的接口，没有 XML
 
       
生成的模型对象可能具有带有单独主键对象和/或带有 BLOB 字段的单独对象的层次结构
 
       
生成的代码没有外部依赖
 
       
生成的代码量非常大
 
       
生成的代码构建查询的能力有限且难以扩展
 
      
 
    
 
    
 
     
 
MyBatis3Simple
 
 
     
 
这是 MyBatis3 运行时的简化版本。
 
      
 
       
生成 Java 代码
 
       
生成 MyBatis3 兼容的 XML 和 SQL 或 MyBatis3 兼容的带注释的接口，没有 XML
 
       
生成的模型对象是“扁平的”——没有单独的主键对象
 
       
生成的代码没有外部依赖
 
       
生成的代码量比较少
 
       
不生成“举例”或“选择性”方法
 
       
生成的代码不包含动态查询构造方法，难以扩展
 
      
 
    
 
   
 
  
 
  
sample:
 
  

  ......
 
  
 
  
3. 子元素
 
  
a.  or 
 
  
每个元素都需要一个  或  元素。
 
  
该元素需要指定jdbc连接时所需的驱动类名、URL、userId、password：
 
  
 
   
 
    
 
     
 
Property Name
 
 
     
 
Property Values
 
 
    
 
    
 
     
 
driverClass
 
 
     
 
This property is used to specify the fully qualified class name of the JDBC driver. This property is required for the default connection factory.
 
 
    
 
    
 
     
 
connectionURL
 
 
     
 
This property is used to specify the JDBC connection URL for the database. This property is required for the default connection factory.
 
 
    
 
    
 
     
 
userId
 
 
     
 
This property is used to specify the User ID for the connection.
 
 
    
 
    
 
     
 
password
 
 
     
 
This property is used to specify the password for the connection.
 
 
    
 
   
 
  
 
  
 
  
sample:
 
  

  
  
  
 
  
b. 
 
  
 元素用于定义 Java 模型生成器的属性。该元素是元素必需的子元素。
 
  
 
   
 
    
 
     
 
Attribute
 
 
     
 
Description
 
 
    
 
    
 
     
 
targetPackage
 
 
     
 
将放置生成的类的包
 
 
    
 
    
 
     
 
targetProject
 
 
     
 
为生成的对象指定指定一个已存在的目录
 
 
    
 
   
 
  
 
  
c. 
 
  
可以配置 0 或 1 个，用于配置关于 Mapper 接口的生成，如果没有配置该元素，那么默认不会生成 Mapper 接口。
 
  
元素 javaClientGenerator 有 3 个属性，其中 targetPackage 和 targetProject 属性的配置与 javaModelGenerator 元素的原理相同，只不过这里指的是 java 目录下存放 Mapper 接口的路径。关于 type 属性，有 3 个可选值：
 
  
 
   
ANNOTATEDMAPPER，按照使用 Mapper 接口 + Annotation 的方式生成文件，SQL 生成在对应的 Annotation 中，不会生成 xml 文件。
 
   
MIXEDMAPPER，使用混合配置，会生成 Mapper 接口，并适当添加合适的 Annotation，也会有 SQL 生成在 XML 文件中。
 
   
XMLMAPPER，会生成 Mapper 接口，接口完全依赖 XML 文件。
 
  
 
  
注意，如果 context 元素的 defaultModelType 属性设置为 MyBatis3Simple，那么就只支持 ANNOTATEDMAPPER 和 XMLMAPPER 的方式。一般建议将 type 设置成 XMLMAPPER。
 
  
 
  
需要注意的是，当你的项目中有多个 Module 时，在配置 javaModelGenerator、sqlMapGenerator 和 javaClientGenerator 元素的 targetProject 属性时，需要在前面加上当前的 Module 名称。
 
  
 
  

 
  
d. 
 
  
可以配置 0 或 1 个，生成 SQL Map 的 xml 文件生成器。如果 javaClientGenerator 元素中配置了需要生成 xml 的话，这个元素就必须配置。
 
  
 
  
 
  
e. 
 
  
用于给出该context的其他特性，官网列出了很多：context property，常用的如下：
 
  
 
   
 
    
 
     
 
Property Name
 
 
     
 
Property Values
 
 
    
 
    
 
     
 
beginningDelimiter
 
 
     
 
指定数据库标识符的开始定界符。数据库标识符（如表名、列名等）可能包含关键字、特殊字符或空格，这可能导致SQL语句出现语法错误。为了避免这种情况，可以使用开始定界符和结束定界符将标识符括起来，告诉数据库解析器这是一个标识符而不是关键字。举个例子，假设数据库中有一个名为 "order" 的表，但 "order" 是SQL关键字。如果你在 MBG 的配置中设置了 beginningDelimiter 为反引号`，那么生成的 SQL 就会像这样：SELECT * FROM `order`，数据库会将 order 视为标识符而不是关键字，从而避免了潜在的语法错误。
 
默认为双引号"，且不同的数据库不同，Mysql为反引号`，Oracle为双引号"
 
 
    
 
    
 
     
 
endingDelimiter
 
 
     
 
标识符的结束定界符，与beginningDelimiter对应
 
 
    
 
    
 
     
 
javaFileEncoding
 
 
     
 
如果未指定，则将使用平台默认编码
 
 
    
 
   
 
  
 
  
 
  
Sample:
 
  

  
  
  
  
  
  
 
  
 
  
f. 
 
  
 元素用于定义插件，该元素是的子元素。
 
  

  
  
  
  
  
 
  
 
  
UnmergeableXmlMappersPlugin介绍：
 
  
该插件将生成的 XML 映射器文件标记为不可合并。这将导致生成器覆盖文件，或以新名称保存文件，具体取决于覆盖设置的配置方式。
 
  
g. 
一个 table 元素对应一张数据库表，如果想同时为多张表生成代码，需要配置多个 table 元素；或者可以将 tableName 设置为 % 来为全部表生成代码。
必须属性：tableName，即指定数据库表名称
有很多可选属性，但是可能很多都不太常用，具体参见官网：标签
Sample:

4. 配置案例

以下配置文件置于maven项目的resources资源目录中：

jdbc.driverClass=com.mysql.cj.jdbc.Driver
jdbc.connectionURL=jdbc:mysql://localhost:3306/mall_tiny?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
jdbc.userId=root
jdbc.password=root

5. 运行 MyBatis-Generator

a. 使用Java

Running MyBatis Generator With Java

public class Generator {
    public static void main(String[] args) throws Exception {
        List warnings = new ArrayList<>();
        boolean overwrite = true;
        InputStream is = Generator.class.getResourceAsStream("/generatorConfig.xml");
        ConfigurationParser cp = new ConfigurationParser(warnings);
        Configuration config = cp.parseConfiguration(is);
        is.close();
        DefaultShellCallback callback = new DefaultShellCallback(overwrite);
        MyBatisGenerator myBatisGenerator = new MyBatisGenerator(config, callback, warnings);
        myBatisGenerator.generate(null);
        for(String warning:warnings){
            System.out.println(warning);
        }
    }
}

b. 使用Maven插件

Running MyBatis Generator With Maven

6. 使用生成的代码实现基本的CRUD

Java client generator为我们生成的Mapper中有以下接口方法：

• countByExample
• deleteByPrimaryKey
• deleteByExample
• insert
• insertSelective
• selectByPrimaryKey
• selectByExample
• selectByExampleWithBLOBs
• updateByPrimaryKey (with an override to specify whether or not to update BLOB columns)
• updateByPrimaryKeySelective (will only update non-null fields in the parameter class)
• updateByExample (with an override to specify whether or not to update BLOB columns)
• updateByExampleSelective (will only update non-null fields in the parameter class)

官网介绍了每个接口和对应XML含义和使用：

MyBatis Generator Core – MyBatis Generator Generated SQL Map XML Files

a. 条件查询

MyBatis Generator Core – Example Class Usage Notes

Generator为生成Example类，比如UmsAdminExample，可以把它理解为一个条件构建器，用于构建SQL语句中的各种条件。当没有条件时，可以为selectByExample传入null。

如实现查询全部：

public List selectAll() {
    return pmsBrandMapper.selectByExample(null);
}

Examples类指定如何创建动态的where子句，表中每个非BLOB字段都能被添加到where子句中，该类几乎可以添加无限的where子句。Example类中包含一个Criteria静态内部类，它包含了一系列可添加的条件语句。Criteria类对象可以通过Examples类的createCriteria()方法或者or()方法创建，通过createCriteria()方法创建的第一个Criteria实例会被自动的添加到oredCriteria列表中。

Important We recommend that you only use the or method for creating Criteria classes. We believe that this method makes for more readable code.

官网推荐使用or方法创建Criteria，这样代码可读性更好。

官方示例：

This example shows how to generate a simple WHERE clause using the generated example class:

  TestTableExample example = new TestTableExample();

  example.createCriteria().andField1EqualTo(5);

Alternatively, the following syntax also works:

  TestTableExample example = new TestTableExample();

  example.or().andField1EqualTo(5);

In either above example, the dynamically generated where clause will effectively be:

where field1 = 5

b. insert与insertSelective的区别

insert会将全部字段插入，包括为null的字段，这样如果在数据库中设置了默认值字段，会被null覆盖。而insertSelective只会插入实体类中不为null的字段，因此更为推荐。

c. 案例

@Service
public class BrandServiceImpl implements BrandService {
    @Autowired
    private PmsBrandMapper pmsBrandMapper;
    @Override
    public List selectAll() {
        return pmsBrandMapper.selectByExample(null);
    }

    @Override
    public List selectByPage(int pageNum, int pageSize) {
        PageHelper.startPage(pageNum, pageSize);
        List allBrands = pmsBrandMapper.selectByExample(null);
        PageInfo pageInfo = new PageInfo<>(allBrands);
        return pageInfo.getList();
    }

    @Override
    public PmsBrand selectByPrimaryKey(long id) {
        return pmsBrandMapper.selectByPrimaryKey(id);
    }

    @Override
    public int insert(PmsBrand brand) {
        return pmsBrandMapper.insertSelective(brand);
    }

    @Override
    public int delete(long id) {
        return pmsBrandMapper.deleteByPrimaryKey(id);
    }

    @Override
    public int update(long id, PmsBrand brand) {
        brand.setId(id);
        return pmsBrandMapper.updateByPrimaryKeySelective(brand);
    }
}