Mybatis详解系列(五)--Mybatis Generator和全注解风格的MyBatis3DynamicSql
简介
Mybatis Generator (MBG) 是 Mybatis 官方提供的代码生成器，通过它可以在项目中自动生成简单的 CRUD 方法，甚至**“无所不能”的高级条件查询（MyBatis3DynamicSql**，有了它根本不需要 Mybatis Plus），让我们避免了进行数据库交互时需要手动创建对象和配置 Mybatis 映射等基础工作。
另外，MBG 有很好地扩展性，它提供了大量的接口和插件用来给我们自定义生成的代码应该是什么样子，例如我们可以自定义注释、代码格式化、添加 toString 方法等。本文将讲解如何使用这些接口。
本文内容大致如下，由于篇幅较长，可选择阅读：
- 如何使用 MBG 生成代码；
- 详解 MBG 的配置，将配置使用自定义注释生成器、实体类中添加 toString/equals/hashCode方法等。
- MyBatis3DynamicSql 风格(无 XML) API 的使用。
通过本文的学习，你将能够通过简单改造 MBG 来生成自己想要的代码，另外，我们也将认识强大的 MyBatis3DynamicSql 风格（它提供的条件类使用 Lambda 解耦，全注解，支持单表查询、多表查询、分页、排序、分组等等）。
关于 MBG 生成代码的风格
MBG 支持生成不同风格、不同语言的代码，例如，MBG 能够生成 Java 或 Kotlin 代码。另外，MBG 支持生成旧版的 MyBatis3 风格（我们常用的 xml 配置属于 MyBatis3 风格，官方认为这种风格已经过时），也支持新版的 MyBatis3DynamicSql 的风格（MyBatis3DynamicSql 风格为官方推荐）。几种风格的对比如下：
| 代码风格 | 描述 |
|---|---|
| MyBatis3DynamicSql | 默认风格，官方推荐 Java代码 全注解，不生成 XML 文件 生成的高级条件查询灵活性较大，使用 lambda 表达式避免条件对象渗透到上一层 一个表生成一个实体类  |
| MyBatis3Kotlin | Kotlin 代码，本文不涉及 |
| MyBatis3 | 早期风格 Java代码 能够生成 MyBatis3 兼容的 xml 或 全注解 生成的高级条件查询灵活性较小，条件类渗透到上一层，而且 sql 和代码耦合度较高 一个表除了生成基本类，可能还会生成主键类和BLOB类（如果指定的话）  |
| MyBatis3Simple | MyBatis3 的简易版 Java代码 能够生成 MyBatis3 兼容的 xml 或 全注解 不生成 “by example” 或 “selective” 的方法 一个表生成一个实体类  |
由于 MyBatis3 风格生成的 Example 类存在的问题，实际项目中建议使用 MyBatis3Simple 风格或官方推荐的 MyBatis3DynamicSql 风格。
关于 MBG 文件覆盖的问题
当我们在迭代开发环境中使用 MBG，需要注意文件覆盖的问题，默认情况下，文件覆盖规则如下：
-
如果 XML 已经存在，MBG 会采用文件合并的方式。
它不会修改你自定义的节点，但是会更新原来生成的 CRUD 节点（如果表发生变化）。文件合并有个前提，就是原来生成的 CRUD 节点必须包含 @mbg.generated 的默认注释。否则，当再次运行 MBG 时，它将无法识别哪些是它生成过的节点，于是会出现下图的情况，即 CRUD 节点被重复插入。
Java程序的运行方式
通常情况下，我们都是使用 maven 插件的方式，但是，当我们在 MBG 中指定了自定义的实现，使用 maven 插件可能会报错，这个时候就需要通过 Java 程序的方式运行 MBG，具体方法如下：
public static void main(String[] args) throws Exception {
// LogFactory.forceSlf4jLogging();
// System.setProperty("user.name", "zzs");
// 这个集合记录着生成、合并、覆盖文件的信息
List<String> warnings = new ArrayList<String>();
InputStream in = MybatisGenerator.class.getClassLoader().getResourceAsStream("generatorConfig.xml");
ConfigurationParser cp = new ConfigurationParser(warnings);
Configuration config = cp.parseConfiguration(in);
// 不覆盖 Java 文件
boolean overwrite = false;
DefaultShellCallback callback = new DefaultShellCallback(overwrite);
MyBatisGenerator myBatisGenerator = new MyBatisGenerator(config, callback, warnings);
// 生成文件
myBatisGenerator.generate(null);
// 打印信息
warnings.forEach(System.err::println);
}
生成规则详解
generatorConfig.xml 的顶层结构如下：
- generatorConfiguration（配置）
- classPathEntry（JDBC驱动路径）
- properties（properties文件路径）
- context（生成对象的环境）
- property（Context作用域参数）
- jdbcConnection（JDBC连接）
- connectionFactory（JDBC连接工厂）
- commentGenerator（注释生成器）
- javaModelGenerator（实体对象生成器）
- javaClientGenerator（Mapper 接口或实现类生成器）
- sqlMapGenerator（xml 生成器）
- table（用于生成对象的表）
- javaTypeResolver（Java 类型处理器）
- plugin（插件）
下面选择部分节点展开分析：
context*
属性
这里最重要的属性是targetRuntime，它直接决定该环境下生成的代码风格，常用的风格为 MyBatis3DynamicSql 和 MyBatis3Simple。
| 属性 | 描述 |
|---|---|
| id | 用于唯一标识指定环境。必选属性 |
| defaultModelType | 指定实体对象的类型。包括三种： flat：一个表生成一个实体类； conditional：和 hierarchical 差不多，区别在于如果表只有一个主键，不会单独去生成一个主键类； hierarchical：除了生成基本类，如果表中包含主键或 BLOB 列，都会单独再生成一个主键类或BLOB类 默认为 conditional，如果 targetRuntime 为 “MyBatis3Simple”、“MyBatis3DynamicSql"或"MyBatis3Kotlin”，则该属性忽略 |
| targetRuntime | 用于指定生成代码的风格。默认为 MyBatis3DynamicSql |
| introspectedColumnImpl | 指定org.mybatis.generator.api.IntrospectedColumn实现类。该类可以看成是某一列的所有信息 |
子节点
/ (1…N)
其中，
参数名 Property Values autoDelimitKeywords 如果数据库关键字被作为列名使用，MBG 是否需要对其进行定界。
默认为falsebeginningDelimiter 指定定界符的开头，默认为" endingDelimiter 指定定界符的结尾，默认为" javaFileEncoding 指定处理 Java 文件使用的编码 javaFormatter 指定生成 Java 代码使用的格式化器。
如果自定义的话需要实现org.mybatis.generator.api.JavaFormatter接口并提供无参构造，默认为org.mybatis.generator.api.dom.DefaultJavaFormattertargetJava8 指定生成 Java 代码使用的 JDK 版本 kotlinFileEncoding 不涉及 kotlinFormatter 不涉及 xmlFormatter 指定生成 XML 文件使用的格式化器。如果自定义的话需要实现 org.mybatis.generator.api.XmlFormatter接口并提供无参构造，默认为org.mybatis.generator.api.dom.DefaultXmlFormatterjdbcConnection
属性
属性 描述 driverClass JDBC 驱动。必选属性 connectionURL JDBC URL。必选属性 userId 用户名 password 密码 子节点
connectionFactory
属性
属性 描述 type 用于指定 连接工厂的类。必选属性
如果自定义的话需要实现org.mybatis.generator.api.ConnectionFactory接口并提供无参构造，默认为org.mybatis.generator.internal.JDBCConnectionFactory子节点
参数 描述 driverClass JDBC 驱动 connectionURL JDBC URL userId 用户名 password 密码 如何使用HikariCP作为 MBG 的连接工厂
这里我简单的实现了一个连接工厂：
public class HikariConnectionFactory implements ConnectionFactory { private DataSource dataSource; public HikariConnectionFactory() { super(); HikariConfig config = new HikariConfig("/hikari.properties"); dataSource = new HikariDataSource(config); } @Override public Connection getConnection() throws SQLException { return dataSource.getConnection(); } @Override public void addConfigurationProperties(Properties properties) { // do nothing } }将它配置到 XML 文件中，这时我们不需要添加任何的
<connectionFactory type="cn.zzs.mybatis.factory.HikariConnectionFactory"/>使用 Java 程序运行 MBG，可以看到代码可以正常生成。
commentGenerator*
属性
属性 描述 type 用于指定注释生成器的类。
如果自定义的话需要实现org.mybatis.generator.api.CommentGenerator接口并提供无参构造，默认为org.mybatis.generator.internal.DefaultCommentGenerator子节点
Property Name Property Values suppressAllComments 是否不生成任何注解。
默认为false。注意，前面提到过，MBG 通过注释中的@mbg.generated来判断某个元素是不是通过 MBG 生成，如果不生成注解的话，XML 的文件覆盖功能会受到影响。suppressDate 是否在注释中不包含时间。
默认为false。addRemarkComments 是否在注释中包含列的注释
默认为falsedateFormat 指定时间格式
例如：yyyy-MM-dd HH:mm:ss自定义注释生成器
想要自定义注释生成器需要实现
org.mybatis.generator.api.CommentGenerator接口并提供无参构造，在本项目中，我在DefaultCommentGenerator的基础上改造了一个注释生成器，感兴趣的可以移步到项目源码。注意，编写自定义注解生成器时应该考虑在xml节点的注释中加入@mbg.generated来维持 MBG 文件合并的功能。
下面简单举个例子，MBG 生成的实体类属性的注解是这样的：
/** * Database Column Remarks: * 员工id * * This field was generated by MyBatis Generator. * This field corresponds to the database column demo_employee.id * * @mbg.generated Sat May 02 12:52:28 CST 2020 */ private String id;但是，我不想要这种注释，这时，我们可以改造以下方法：
@Override public void addFieldComment(Field field, IntrospectedTable introspectedTable, IntrospectedColumn introspectedColumn) { if (suppressAllComments) { return; } field.addJavaDocLine("/**"); // 获取列注释并加入到注解中 String remarks = introspectedColumn.getRemarks(); if (addRemarkComments && StringUtility.stringHasValue(remarks)) { String[] remarkLines = remarks.split(System.getProperty("line.separator")); for (String remarkLine : remarkLines) { field.addJavaDocLine(" *"
+ remarkLine + ""); } } field.addJavaDocLine(" */"); }并且在 XML 中进行如下配置：
<commentGenerator type="cn.zzs.mybatis.generator.MyCommentGenerator"> <property name="addRemarkComments" value="true"/> commentGenerator>使用 Java 程序运行 MBG，可以看到实体类属性的注释变成我们想要的样子。
/** *员工id
*/ private String id;javaTypeResolver
Short、Integer、Long等 Java 类型，如果我们不希望这样解析，就需要使用到这个节点。Java 类型解析器使用默认的就行，一般不会去重写它。
属性
Attribute Description type 用于指定Java 类型解析器的类。
如果自定义的话需要实现org.mybatis.generator.api.JavaTypeResolver并提供无参构造，默认为org.mybatis.generator.internal.types.JavaTypeResolverDefaultImpl，它会将数据库类型 decimal 或 numberic 解析为 Integer 的 Java 类型子节点
Property Name Property Values forceBigDecimals 是否强制将数据库类型 decimal 或 numberic 解析为 BigDecimal 类型。
默认为false，会根据数据的小数点位数和长度来决定使用 Short、Integer、Long 或 BigDecimal。useJSR310Types 是否不强制将数据库类型 date, time 和 timestamp 解析为 Date
默认为false，如果为true，解析规则将变成：date -> LocalDate，time -> LocalTime，timestamp -> LocalDateTimejavaModelGenerator
属性
Attribute Description targetPackage 指定存放生成类的包路径。必选属性 targetProject 指定 targetPackage 的源文件夹。必选属性
注意，如果该文件夹不存在，将会报错子节点
Property Name Property Values constructorBased 是否生成包含全部参数的构造方法。
默认为false。当为true时，除了生成指定构造，还会生成对应的 resultMap。enableSubPackages 是否在targetPackage基础上生成子包。
默认为false。当为true时，会将表所在 schema 名作为子包名exampleTargetPackage 指定 Example 条件类的生成路径
默认和 targetPackage 相同exampleTargetProject 指定 exampleTargetPackage 的源文件夹
默认和 targetProject 相同immutable 如果为 true，生成的实体类将不包含 setter 方法，但会提供包含所有参数的构造。
默认为 falserootClass 指定实体类需要继承的父类。 trimStrings 在setter方法中是否对传入字符串进行 trim 操作
默认为 false。javaClientGenerator
SqlProvider。属性
下面的 type 属性仅针对 MyBatis3Simple 和 MyBatis3 风格生效，而且 MyBatis3Simple 风格不支持 MIXEDMAPPER。
属性 描述 type 用于指定使用客户端类生成器的类。
如果自定义的话需要实现org.mybatis.generator.codegen.AbstractJavaClientGenerator并提供无参构造，MBG 为我们提供了以下几种：
1. ANNOTATEDMAPPER：包含 Mapper 接口和 SqlProvider 辅助类，全注解，不包含 XML 文件；
2. XMLMAPPER：包含 Mapper 接口和 XML 文件，不包含注解；
3. MIXEDMAPPER：包含 Mapper 接口和 XML 文件，简单的 CRUD 使用注解，高级条件查询使用 XML 文件。targetPackage 指定存放生成类的包路径。必选属性 targetProject 指定存放生成类的包路径。必选属性 子节点
Property Name Property Values enableSubPackages 是否在 targetPackage 基础上生成子包。
默认为 false。当为 true 时，会将表所在 schema 名作为子包名rootInterface 指定 Mapper 接口需要实现的父接口。 useLegacyBuilder 是否使用过时的 SqlBuilder来构造动态语句。
默认为 falsesqlMapGenerator
属性
Attribute Description targetPackage 指定存放生成 XML 的包路径。必选属性 targetProject 指定存放生成 XML 的包路径。必选属性 子节点
Property Name Property Values enableSubPackages 是否在targetPackage基础上生成子包。
默认为false。当为true时，会将表所在 schema 名作为子包名table*
节点用于指定需要用于生成对象的表以及配置某些生成规则。这个节点相比前面提到的，要更加复杂一些。
属性
节点支持的属性很多，一般保持默认就可以了。
Attribute Description tableName 需要用于生成对象的表名。必选属性
允许使用 SQL 通配符，例如：demo_%schema 指定数据库 schema
允许使用 SQL 通配符catalog 指定数据库 catalog alias 指定查询时字段别名前缀。
如果指定，生成的 select 语句将使用alias_actualColumnName的别名domainObjectName 指定实体类的类名。
默认情况下使用驼峰命名规则mapperName 指定 Mapper 接口名
默认为实体类名+MappersqlProviderName 指定 SqlProvider 接口名
默认为实体类名+SqlProviderenableInsert
enableSelectByPrimaryKey
enableSelectByExample
enableUpdateByPrimaryKey
enableDeleteByPrimaryKey
enableDeleteByExample
enableCountByExample
enableUpdateByExample是否生成指定语句
默认为trueselectByPrimaryKeyQueryId
selectByExampleQueryId如果指定，在select 语句中将添加 ‘value’ as QUERYID modelType 指定实体对象的类型。context节点中已介绍过了 escapeWildcards 当 schema 或 tableName 包含 SQL 通配符时，在搜素列时是否对其进行转义 delimitIdentifiers 是否在 SQL 中对表名使用定界符并且使用确定的表名大小写
默认为falsedelimitAllColumns 是否在 SQL 中对所有列名都添加定界符
默认为false子节点
的子节点如下：
这几个子节点中，常用到的是
property
Property Name Property Values constructorBased 是否生成包含全部参数的构造方法。
默认为false。当为true时，除了生成指定构造，还会生成对应的 resultMap。ignoreQualifiersAtRuntime 在生成的 SQL 中，表名前是否不添加 schema 或 catalog
默认为 falseimmutable 如果为 true，生成的实体类将不包含 setter 方法，但会提供包含所有参数的构造。
默认为 falsemodelOnly 是否只生成实体类
默认为 falserootClass 指定实体类需要继承的父类。 rootInterface 指定 Mapper 接口需要实现的父接口。 runtimeCatalog 指定 SQL 中使用的 catalog runtimeSchema 指定 SQL 中使用的 schema runtimeTableName 指定 SQL 中使用的 tableName selectAllOrderByClause 指定 selectAll方法中加入order by ‘value’trimStrings 在实体类的 setter 方法中是否对传入字符串进行 trim 操作
默认为 false。useActualColumnNames 是否直接使用表名作为实体类类名。
默认为falseuseColumnIndexes 是否在 resultMap 中使用索引而不使用列名进行映射 useCompoundPropertyNames 是否将“列名+列注释”作为实体类的属性名 domainObjectRenamingRule/columnRenamingRule
例如，在没有指定 domainObjectName 的情况下，demo_employee 的表将生成实体类 DemoEmloyee，但我希望去掉前面的 Demo 前缀，则可以这样处理：
<table tableName="demo_%" > <domainObjectRenamingRule searchString="^Demo" replaceString=""/> table>另一个子节点
<table tableName="demo_%" > <columnRenamingRule searchString="^Employee_" replaceString="" /> table>ignoreColumnsByRegex/ignoreColumn
<table tableName="Foo"> <ignoreColumnsByRegex pattern="(?i)col.*"> <except column="col01"/> <except column="col13"/> ignoreColumnsByRegex> table>plugin*
如果自定义的话需要实现
org.mybatis.generator.api.Plugin接口，并提供无参构造。MBG 为我们提供了许多好用的插件，如下：插件 描述 org.mybatis.generator.plugins.SerializablePlugin 用于在实体类中实现 java.io.Serializable接口org.mybatis.generator.plugins.ToStringPlugin 用于在实体类中添加 toString 方法 org.mybatis.generator.plugins.EqualsHashCodePlugin 用于在实体类中添加 equals 和 hashCode 方法。 org.mybatis.generator.plugins.UnmergeableXmlMappersPlugin 用于指定不合并 XML 文件，这时 MBG 将 采用处理 Java 文件的方式来处理 XML 文件 org.mybatis.generator.plugins.CachePlugin 用于在 xml 文件中加入cache节点 org.mybatis.generator.plugins.CaseInsensitiveLikePlugin 用于在 Example 类中生成不区分大小写的Like org.mybatis.generator.plugins.dsql.DisableDeletePlugin 禁用 MyBatisDynamicSQLV2 风格的所有删除方法 org.mybatis.generator.plugins.dsql.DisableInsertPlugin 禁用 MyBatisDynamicSQLV2 风格的所有插入方法 org.mybatis.generator.plugins.dsql.DisableUpdatePlugin 禁用 MyBatisDynamicSQLV2 风格的所有更新方法 org.mybatis.generator.plugins.FluentBuilderMethodsPlugin 用于在实体类中添加 MyDomainClass withValue(Object v)方法。通过它可以实现如下赋值方式：new Employee().withAddress("北京").withDeleted(false).withName("zzs001");org.mybatis.generator.plugins.MapperAnnotationPlugin 用于在 Mapper 接口中添加 @Mapper接口org.mybatis.generator.plugins.MapperConfigPlugin 用于生成 Mybatis 的主配置文件 MapperConfig org.mybatis.generator.plugins.RenameExampleClassPlugin 用于重命名 Example 类 org.mybatis.generator.plugins.RowBoundsPlugin 用于在 Mapper 接口的 selectByExample 方法参数中加入 RowBounds 参数，用于支持分页 org.mybatis.generator.plugins.VirtualPrimaryKeyPlugin 用于指定表的主键 插件的配置方式非常简单，如下：
<plugin type="org.mybatis.generator.plugins.EqualsHashCodePlugin"> <property name="useEqualsHashCodeFromRoot" value="true"/> plugin> <plugin type="org.mybatis.generator.plugins.ToStringPlugin"> <property name="useToStringFromRoot" value="true"/> plugin>运行 Java 程序，可以看到实体类中生成类 toString 、hashCode 和 equals 方法。
以上，基本讲完 MBG 的使用方法，涉及到的内容可以满足实际使用需求。
MyBatis3DynamicSql 风格 API 的使用
在研究 MBG 之前，其实我并没有听说过 MyBatis3DynamicSql 风格，因为项目里一直使用的是 Mybatis3Simple，网上也很少人提起。
Mybatis3Simple 可以生成简单的 CRUD，但是针对高级条件查询就无能为力了，实际项目中，我们有时必须手动地去编写高级查询的代码，通常情况下，我们用不同的方案来处理：
- 自定义代码生成器来生成高级条件查询的代码。针对复杂场景时，我们还是得手动改造。
- 使用 Mybatis Plus 的条件构造器。在 MP 3.0 之前，条件构造器会造成 sql 和代码的严重耦合。
现在，Mybatis 官方为我们提供了新的方案，那就是 MyBatis3DynamicSql。MyBatis3DynamicSql 风格丢弃了 XML 文件，使用全注解形式并搭配几个条件辅助类，刚接触时，我还是比较抗拒，因为前面MyBatis3 中也尝试过全注解和条件类，当遇到某些复杂场景时，还是需要 XML，而且生成器提供的条件类会渗透到服务层。
直到开始使用 MyBatis3DynamicSql，我才发现它的强大。它可以做到：
- 单表高级查询。包括 Equal/NotEqual、Like/NotLike、In/NotIn、Between/NotBetween、IsNull/IsNotNull 等等，而且还可以判空设置条件。
- 联表查询。你可以像给单表一样给关联表设置条件。
- 分组、排序、分页。
- 只返回你要的字段。
下面这个例子，涉及到了关联查询、排序、分页，而 MyBatis3DynamicSql 都能帮我们处理，并且它利用 Lambda表达式来解耦条件类。
@Test public void testSelect() { // 注意，当查询结果多于1时会报错 List<Employee> lsit = baseMapper.select(c -> c.leftJoin(DepartmentDynamicSqlSupport.department) .on(departmentId, new EqualTo(DepartmentDynamicSqlSupport.id)) .where(name, isLikeWhenPresent("zzs%"), or(name, isLikeWhenPresent("zzf%"))) .and(status, isEqualTo((byte)1)) .and(address, isIn("北京", "广东")) .and(DepartmentDynamicSqlSupport.name, isEqualToWhenPresent("质控部")) .orderBy(gmtCreate.descending()) .limit(3) .offset(1) ); lsit.forEach(System.err::println); }我相信，MyBatis3DynamicSql 风格会被更多开发者使用，这里就不长篇大论的讲解如何使用它，因为它的 API 并不难操作。感兴趣的朋友可以移步到项目源码阅读：测试例子
参考资料
MyBatis Generator官方文档
相关源码请移步：mybatis–generator
本文为原创文章，转载请附上原文出处链接：https://www.cnblogs.com/ZhangZiSheng001/p/12820344.html
你可能感兴趣的:(Mybatis)