简介

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 表达式避免条件对象渗透到上一层一个表生成一个实体类

MyBatis3KotlinKotlin 代码,本文不涉及MyBatis3早期风格Java代码能够生成 MyBatis3 兼容的 xml 或 全注解生成的高级条件查询灵活性较小,条件类渗透到上一层,而且 sql 和代码耦合度较高一个表除了生成基本类,可能还会生成主键类和BLOB类(如果指定的话)

MyBatis3SimpleMyBatis3 的简易版Java代码能够生成 MyBatis3 兼容的 xml 或 全注解不生成 “by example” 或 “selective” 的方法一个表生成一个实体类

由于 MyBatis3 风格生成的 Example 类存在的问题,实际项目中建议使用 MyBatis3Simple 风格或官方推荐的 MyBatis3DynamicSql 风格。

关于 MBG 文件覆盖的问题

当我们在迭代开发环境中使用 MBG,需要注意文件覆盖的问题,默认情况下,文件覆盖规则如下:

如果 XML 已经存在,MBG 会采用文件合并的方式。 它不会修改你自定义的节点,但是会更新原来生成的 CRUD 节点(如果表发生变化)。文件合并有个前提,就是原来生成的 CRUD 节点必须包含 @mbg.generated 的默认注释。否则,当再次运行 MBG 时,它将无法识别哪些是它生成过的节点,于是会出现下图的情况,即 CRUD 节点被重复插入。

![https://img2020.cnblogs.com/blog/1731892/202005/1731892-20200502235440091-1666766703.png)

如果 Java 或 Kotlin 文件已经存在,MBG 可以覆盖现有文件或使用其他唯一名称保存新生成的文件,这取决于你如何配置false

那么,下面开始详细介绍如何使用 MBG。

项目环境的说明

工程环境

JDK:1.8.0_231(要求 JDK8 及以上)

maven:3.6.1

IDE:Spring Tool Suites4 for Eclipse 4.12

mysql:5.7.28

数据库脚本

具体的 sql 脚本也提供好了(脚本路径)。

maven配置

pom.xml配置

MBG 支持使用Java 代码、maven 插件、Eclipse 插件等方式运行,本文使用 maven 插件方式,所以需要在 build/plugins 节点引入 MBG 插件,并加入其它依赖项,例如 mybatis、mysql 驱动等。另外,因为本文也需要用到 Java 程序来运行 MBG(当使用自定义类时),所以把插件的依赖项从 build/plugins/plugin 节点中单独取出来。

org.mybatis.generator

mybatis-generator-core

1.4.0

org.mybatis

mybatis

3.5.4

org.mybatis.dynamic-sql

mybatis-dynamic-sql

1.1.4

mysql

mysql-connector-java

8.0.15

ch.qos.logback

logback-core

1.2.3

jar

ch.qos.logback

logback-classic

1.2.3

jar

org.mybatis.generator

mybatis-generator-maven-plugin

1.4.0

Generate MyBatis Artifacts

package

generate

true

default

false

${basedir}/src/main/resources/generatorConfig.xml

true

插件参数详解

plugin/configuration 节点可以配置影响 MBG 行为的参数,如下:

参数表达式类型描述configurationFile${mybatis.generator.configurationFile}java.io.File配置文件路径。默认为${basedir}/src/main/resources/generatorConfig.xmlcontexts${mybatis.generator.contexts}java.lang.String指定使用配置文件中的哪个context多个用逗号隔开jdbcDriver${mybatis.generator.jdbcDriver}java.lang.StringJDBC 驱动jdbcPassword${mybatis.generator.jdbcPassword}java.lang.StringJDBC 密码jdbcURL${mybatis.generator.jdbcURL}java.lang.StringJDBC URLjdbcUserId${mybatis.generator.jdbcUserId}java.lang.StringJDBC 用户名outputDirectory${mybatis.generator.outputDirectory}java.io.FileMBG 文件输出路径。只有在配置文件中配置targetProject=”MAVEN”(区分大小写),才会使用这个路径。默认为${project.build.directory}/generated-sources/mybatis-generatoroverwrite${mybatis.generator.overwrite}boolean是否覆盖已经存在的同名Java文件。如果为true,Java文件将被覆盖。 如果为false,MBG会将新生成唯一名称的Java文件(例如MyClass.java.1,MyClass.java.2)默认为falsesqlScript${mybatis.generator.sqlScript}java.lang.String生成代码之前需要运行的SQL脚本路径。如果指定,则必须提供jdbcDriver,jdbcURL、jdbcUserId、jdbcPassword。tableNames${mybatis.generator.tableNames}java.lang.String需要生成代码的表多个用逗号隔开verbose${mybatis.generator.verbose}boolean是否打印日志默认为falseincludeCompileDependencies${mybatis.generator.includeCompileDependencies}boolean如果为true,则作用域为“ compile”,“ provided”和“ system”的依赖将添加到生成器的类路径中。默认为falseincludeAllDependencies${mybatis.generator.includeAllDependencies}boolean如果为true,则所有作用域的依赖将添加到生成器的类路径中。默认为falseskip${mybatis.generator.skip}boolean项目启动时跳过 MBG。默认false

代码生成规则配置

使用 maven 插件的方式不需要编写代码,只要将规则配置到 generatorConfig.xml 文件就行,配置内容主要为:

如何连接到数据库生成什么对象,以及如何生成它们哪些表将用于对象生成

下面先给一个简单版的,后面再具体讲解这些参数的意义:

PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"

"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">

driverClass="${jdbc.driver}"

connectionURL="${jdbc.url}"

userId="${jdbc.username}"

password="${jdbc.password}">

targetPackage="cn.zzs.mybatis.entity"

targetProject=".\src\main\java">

targetPackage="cn.zzs.mybatis.mapper"

targetProject=".\src\main\resources">

targetPackage="cn.zzs.mybatis.mapper"

targetProject=".\src\main\java">

命令执行

maven 插件的运行方式

maven build,输入mybatis-generator:generate,生成成功。

Java程序的运行方式

通常情况下,我们都是使用 maven 插件的方式,但是,当我们在 MBG 中指定了自定义的实现,使用 maven 插件可能会报错,这个时候就需要通过 Java 程序的方式运行 MBG,具体方法如下:

public static void main(String[] args) throws Exception {

// LogFactory.forceSlf4jLogging();

// System.setProperty("user.name", "zzs");

// 这个集合记录着生成、合并、覆盖文件的信息

List warnings = new ArrayList();

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用于指定生成代码的风格。默认为 MyBatis3DynamicSqlintrospectedColumnImpl指定org.mybatis.generator.api.IntrospectedColumn实现类。该类可以看成是某一列的所有信息

子节点

包含以下子节点:

(0..N) (0..N) (0 or 1)/ (1 Required) (0 or 1) (1 Required) (0 or 1) (0 or 1)

(1..N)

其中,支持以下参数。其中,针对 mysql 数据库,可以将定界符修改为反单引号。如果想要使用自定义的代码格式或 XML 格式,可以配置自定义实现。

参数名Property ValuesautoDelimitKeywords如果数据库关键字被作为列名使用,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.DefaultXmlFormatter

jdbcConnection

节点用于指定 MBG 进行数据库交互所用的 JDBC 连接。注意,节点只要一个就行了。

属性

属性描述driverClassJDBC 驱动。必选属性connectionURLJDBC URL。必选属性userId用户名password密码

子节点

(0..N):用于定义 JDBC 驱动所需的一些参数,较少用到。

connectionFactory

节点用于指定和配置 MBG 进行数据库交互时获取 JDBC 连接的工厂。注意,节点只要一个就行了。

属性

属性描述type用于指定 连接工厂的类。必选属性如果自定义的话需要实现org.mybatis.generator.api.ConnectionFactory 接口并提供无参构造,默认为org.mybatis.generator.internal.JDBCConnectionFactory

子节点

的子节点为 (0..N),参数如下表。如果是使用默认的连接工厂,这几个参数必须按照下表的提供,但是,如果是自定义的连接工厂,需要提供什么参数由你自己决定。

参数描述driverClassJDBC 驱动connectionURLJDBC URLuserId用户名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 文件中,这时我们不需要添加任何的子节点。

使用 Java 程序运行 MBG,可以看到代码可以正常生成。

commentGenerator*

节点用于指定和配置 Java 代码或 XML 文件中使用的注释生成器。默认的注释生成器比较鸡肋,一般我们都会考虑自己实现。

属性

属性描述type用于指定注释生成器的类。如果自定义的话需要实现org.mybatis.generator.api.CommentGenerator接口并提供无参构造,默认为org.mybatis.generator.internal.DefaultCommentGenerator

子节点

的子节点为 (0..N),参数如下表。注意,这些参数是针对默认注释生成器的,如果是自定义的,需要提供什么参数由你自己决定。

Property NameProperty ValuessuppressAllComments是否不生成任何注解。默认为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 中进行如下配置:

使用 Java 程序运行 MBG,可以看到实体类属性的注释变成我们想要的样子。

/**

*

员工id

*/

private String id;

javaTypeResolver

节点用于指定和配置 Java 类型解析器。默认的解析器可能会将数据库类型 decimal 或 numberic 解析为Short、Integer、Long等 Java 类型,如果我们不希望这样解析,就需要使用到这个节点。

Java 类型解析器使用默认的就行,一般不会去重写它。

属性

AttributeDescriptiontype用于指定Java 类型解析器的类。 如果自定义的话需要实现org.mybatis.generator.api.JavaTypeResolver并提供无参构造,默认为org.mybatis.generator.internal.types.JavaTypeResolverDefaultImpl,它会将数据库类型 decimal 或 numberic 解析为 Integer 的 Java 类型

子节点

的子节点为 (0..N),参数如下表。注意,这些参数是针对默认注释生成器的,如果是自定义的,需要提供什么参数由你自己决定。

Property NameProperty ValuesforceBigDecimals是否强制将数据库类型 decimal 或 numberic 解析为 BigDecimal 类型。默认为false,会根据数据的小数点位数和长度来决定使用 Short、Integer、Long 或 BigDecimal。useJSR310Types是否不强制将数据库类型 date, time 和 timestamp 解析为 Date默认为false,如果为true,解析规则将变成:date -> LocalDate,time -> LocalTime,timestamp -> LocalDateTime

javaModelGenerator

节点用于配置实体类生成器。实体类生成器不支持自定义。

属性

AttributeDescriptiontargetPackage指定存放生成类的包路径。必选属性targetProject指定 targetPackage 的源文件夹。必选属性注意,如果该文件夹不存在,将会报错

子节点

的子节点为 (0..N),参数如下表。用的比较多的是 rootClass 和 trimStrings。

Property NameProperty ValuesconstructorBased是否生成包含全部参数的构造方法。默认为false。当为true时,除了生成指定构造,还会生成对应的 resultMap。enableSubPackages是否在targetPackage基础上生成子包。默认为false。当为true时,会将表所在 schema 名作为子包名exampleTargetPackage指定 Example 条件类的生成路径默认和 targetPackage 相同exampleTargetProject指定 exampleTargetPackage 的源文件夹默认和 targetProject 相同immutable如果为 true,生成的实体类将不包含 setter 方法,但会提供包含所有参数的构造。默认为 falserootClass指定实体类需要继承的父类。trimStrings在setter方法中是否对传入字符串进行 trim 操作默认为 false。

javaClientGenerator

节点用于指定和配置客户端类生成器。这个节点是可选的,如果不指定,则不会生成客户端类。客户端类一般指的是 Mapper 接口及 Mapper 接口的一些辅助类,例如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指定存放生成类的包路径。必选属性

子节点

的子节点为 (0..N),参数如下表。注意,这些参数是针对默认注释生成器的,如果是自定义的,需要提供什么参数由你自己决定。

Property NameProperty ValuesenableSubPackages是否在 targetPackage 基础上生成子包。默认为 false。当为 true 时,会将表所在 schema 名作为子包名rootInterface指定 Mapper 接口需要实现的父接口。useLegacyBuilder是否使用过时的SqlBuilder来构造动态语句。默认为 false

sqlMapGenerator

节点用于配置 XML 生成器,不支持自定义。

属性

AttributeDescriptiontargetPackage指定存放生成 XML 的包路径。必选属性targetProject指定存放生成 XML 的包路径。必选属性

子节点

的子节点为 (0..N),参数如下表。

Property NameProperty ValuesenableSubPackages是否在targetPackage基础上生成子包。默认为false。当为true时,会将表所在 schema 名作为子包名

table*

节点用于指定需要用于生成对象的表以及配置某些生成规则。这个节点相比前面提到的,要更加复杂一些。

属性

节点支持的属性很多,一般保持默认就可以了。

AttributeDescriptiontableName需要用于生成对象的表名。必选属性允许使用 SQL 通配符,例如:demo_%schema指定数据库 schema允许使用 SQL 通配符catalog指定数据库 catalogalias指定查询时字段别名前缀。如果指定,生成的 select 语句将使用alias_actualColumnName的别名domainObjectName指定实体类的类名。默认情况下使用驼峰命名规则mapperName指定 Mapper 接口名默认为实体类名+MappersqlProviderName指定 SqlProvider 接口名默认为实体类名+SqlProviderenableInsertenableSelectByPrimaryKeyenableSelectByExampleenableUpdateByPrimaryKeyenableDeleteByPrimaryKeyenableDeleteByExampleenableCountByExampleenableUpdateByExample是否生成指定语句默认为trueselectByPrimaryKeyQueryIdselectByExampleQueryId如果指定,在select 语句中将添加 ‘value’ as QUERYIDmodelType指定实体对象的类型。context节点中已介绍过了escapeWildcards当 schema 或 tableName 包含 SQL 通配符时,在搜素列时是否对其进行转义delimitIdentifiers是否在 SQL 中对表名使用定界符并且使用确定的表名大小写默认为falsedelimitAllColumns是否在 SQL 中对所有列名都添加定界符默认为false

子节点

的子节点如下:

(0..N) (0 or 1) (0 or 1) (0 or 1) (0..N) (0..N) (0..N)

这几个子节点中,常用到的是,其他的用的比较少。下面挑几个来分析下:

property

配置的大部分参数都是为了覆盖全局的配置,并不常用。

Property NameProperty ValuesconstructorBased是否生成包含全部参数的构造方法。默认为false。当为true时,除了生成指定构造,还会生成对应的 resultMap。ignoreQualifiersAtRuntime在生成的 SQL 中,表名前是否不添加 schema 或 catalog默认为 falseimmutable如果为 true,生成的实体类将不包含 setter 方法,但会提供包含所有参数的构造。默认为 falsemodelOnly是否只生成实体类默认为 falserootClass指定实体类需要继承的父类。rootInterface指定 Mapper 接口需要实现的父接口。runtimeCatalog指定 SQL 中使用的 catalogruntimeSchema指定 SQL 中使用的 schemaruntimeTableName指定 SQL 中使用的 tableNameselectAllOrderByClause指定selectAll方法中加入order by ‘value’trimStrings在实体类的 setter 方法中是否对传入字符串进行 trim 操作默认为 false。useActualColumnNames是否直接使用表名作为实体类类名。默认为falseuseColumnIndexes是否在 resultMap 中使用索引而不使用列名进行映射useCompoundPropertyNames是否将“列名+列注释”作为实体类的属性名

domainObjectRenamingRule/columnRenamingRule

节点一般用于重命名实体类类名。

例如,在没有指定 domainObjectName 的情况下,demo_employee 的表将生成实体类 DemoEmloyee,但我希望去掉前面的 Demo 前缀,则可以这样处理:

另一个子节点也是相同的用法。

ignoreColumnsByRegex/ignoreColumn

节点用于告诉 MBG 生成代码时忽略某些列。使用方法如下。

plugin*

节点用于定义和配置插件。这个节点只有一个 type 属性,用于指定使用哪个插件,并通过子节点 property 来为这个插件设置参数。

如果自定义的话需要实现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 类中生成不区分大小写的Likeorg.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 的主配置文件 MapperConfigorg.mybatis.generator.plugins.RenameExampleClassPlugin用于重命名 Example 类org.mybatis.generator.plugins.RowBoundsPlugin用于在 Mapper 接口的 selectByExample 方法参数中加入 RowBounds 参数,用于支持分页org.mybatis.generator.plugins.VirtualPrimaryKeyPlugin用于指定表的主键

插件的配置方式非常简单,如下:

运行 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 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

作者:子月生

原文地址:https://www.cnblogs.com/ZhangZiSheng001/p/12820344.html

喜欢 0

好文链接

评论可见,请评论后查看内容,谢谢!!!评论后请刷新页面。