java-mybaits-015-mybatis逆向工程最佳实践【基础mybatis-generator、tk.mybatis、mubatis-plus】

1、概述

三款框架的功能对比

	Mybatis-generator	通用Mapper	Mybatis-Plus
代码生成器	支持自动生成Model,Mapper,Mapper XML文件 生成方式不够灵活； 生成代码功能较为简单	支持自动生成Entity,Mapper,Mapper XML文件； 提供通用的Mapper模板，生成方式较灵活； 生成的Model文件包含注释可以很好地与数据库表完成映射	支持自动生成Entity,Mapper,Mapper XML,Service,Controller文件； 提供BaseMapper接口
CRUD操做	代码生成后每一个Mapper有固定的CRUD方法； 在每一个Mapper上分别扩展	提供通用Mapper接口；方便构造统一service 能够扩展通用接口	提供BaseMapper接口； 能够扩展通用接口
条件构造器	每一个实体类本身的Example构造条件【对象方式】	提供通用Example【构建sql】	提供Wrapper进行复杂条件构造
乐观锁		支持	支持
主键策略		支持	支持
分页			支持
逻辑删除			支持
通用枚举			支持
攻击Sql阻断			支持
性能分析			支持

　　通用Mapper是对Mybatis-generator的升级改造，解决了使用Mybatis-generator可能须要大量重构的问题，而且在这个基础上加入了一些新的功能。

　　Mybatis-Plus能够看做是在另外一个方向上对Mybatis的升级改造，不只可以根据数据库表快速生成pojo实体类，还封装了大量CRUD方法，使用Wrapper解决了复杂条件构造等问题，更是根据开发中常见的问题给出了一系列解决方案。

　　在拥有Maven和Spring boot的开发框架下，MBG、通用Mapper和MP均可以快速地完成安装，相比于MBG和通用Mapper仅须要执行插件就能够完成基本的开发工做，MP可能须要更多的开发工做量。

　　最佳实践参看代码：https://github.com/bjlhx15/java_base_architecture.git

2、Mybatis-generator

　　MyBatis Generator（MBG）是MyBatis MyBatis 和iBATIS的代码生成器。它为全部版本的MyBatis以及版本2.2.0以后的iBATIS版本生成代码。它将根据数据库表生成可用于访问表的文件。

　　Mybatis-generator主要完成的工做是依据数据库表建立对应的model、dao、mapping文件，能够经过Maven插件或者mybatis-generator的jar包生成。

　　这里介绍Maven插件使用方法：

　　　　一、在pom.xml文件中加入mybatis-generator系列插件；

　　　　二、建立generatorConfig.xml文件，在配置文件中指定数据库链接地址、生成类的存放地址、生成对应表的类名等信息；

　　　　三、执行mybatis-generator插件，便可生成相应文件；

　　　　四、此外，mybatis-generator自动生成了example类用于构造复杂的筛选条件

　　Mybatis-generator使用较为简单，生成的DAO类及映射文件中包含基本的CRUD操做。

　　须要注意的是，在一次项目中屡次执行mybatis-generator，xml文件会追加，会覆盖本来的Model、DAO；可使用以下方式

　　　　

　　　　一、每次清理要生成的xml

　　　　二、自动生成的写入auto，

　　　　三、我的扩展的使用上图方式

　　能够参看上述github代码

3、通用Mapper【tk.mybatis】

官网：https://github.com/abel533/Mapper/wiki

　　当数据库字段变化频繁时，使用MBG（mybatis-generator）会带来大量的重构工做，对此，通用Mapper给出的解决办法是：给予开发者一个具有丰富的单表方法而且容易扩展的通用的Mapper。

　　通用Mapper是对单表的CRUD操做进行了较为详细的实现，使得开发人员能够随意的按照本身的需求选择通用的方法，同时容许开发人员便捷地对通用Mapper进行扩展。

1. 在pom.xml中添加插件配置

            <!-- 命令：mvn mybatis-generator:generate -->
            <plugin>
                <groupId>org.mybatis.generator</groupId>
                <artifactId>mybatis-generator-maven-plugin</artifactId>
                <version>1.3.6</version>
                <configuration>
                    <!-- 配置实际调用地址-->
                    <configurationFile>src/main/resources/mybatis_generatorConfig/generatorConfig-base.xml
                    </configurationFile>
                    <verbose>true</verbose>
                    <overwrite>true</overwrite>
                </configuration>
                <dependencies>
                    <dependency>
                        <groupId>mysql</groupId>
                        <artifactId>mysql-connector-java</artifactId>
                        <version>5.1.38</version>
                    </dependency>
                    <dependency>
                        <groupId>tk.mybatis</groupId>
                        <artifactId>mapper</artifactId>
                        <version>4.0.0</version>
                    </dependency>
                </dependencies>
            </plugin>

View Code

　　能够看到，通用Mapper的代码生成其实是使用了MGB，所以通用Mapper的代码生成器只是调用了MGB，而后在这个基础上加入了一些元素来方便开发。

2. 配置文件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>
    <!--导入属性配置，前面咱们写的一个配置文件，你也能够直接使用mybatis的jdbc的配置文件 -->
    <properties resource="jdbc.properties"></properties>
    <!-- 数据库驱动，注意，这里必需要修改为你的数据库的驱动地址 -->
    <!--    若是 pom配置这里能够不写-->
    <!--    <classPathEntry  location=".m2/repository/mysql/mysql-connector-java/5.1.8/mysql-connector-java-5.1.8.jar"/>-->

    <context id="Mysql" targetRuntime="MyBatis3Simple" defaultModelType="flat">
        <property name="beginningDelimiter" value="`"/>
        <property name="endingDelimiter" value="`"/>
        <plugin type="tk.mybatis.mapper.generator.MapperPlugin">
            <property name="mappers" value="tk.mybatis.mapper.common.Mapper"/>
            <property name="caseSensitive" value="true"/>
        </plugin>

        <!--数据库链接的信息：驱动类、链接地址、用户名、密码 -->
        <jdbcConnection driverClass="${jdbc.driver}"
                        connectionURL="${jdbc.url}"
                        userId="${jdbc.username}" password="${jdbc.password}">
        </jdbcConnection>

<!--        <javaTypeResolver>-->
<!--            <property name="forceBigDecimals" value="false"/>-->
<!--        </javaTypeResolver>-->
        <!-- targetProject:生成PO类的位置 -->
        <javaModelGenerator targetPackage="com.github.bjlhx15.mybatis.springboot.base.model.auto"
                            targetProject="../tk-mybatis-springboot-base1/src/main/java">
            <!-- enableSubPackages:是否让schema做为包的后缀 -->
            <property name="enableSubPackages" value="false"/>
            <!-- 从数据库返回的值被清理先后的空格 -->
            <property name="trimStrings" value="true"/>
        </javaModelGenerator>

        <!-- targetProject:mapper xml 映射文件生成的位置 -->
        <sqlMapGenerator targetPackage="autoxml"
                         targetProject="../tk-mybatis-springboot-base1/src/main/resources/mapper/">
            <!-- enableSubPackages:是否让schema做为包的后缀 -->
            <property name="enableSubPackages" value="false"/>
        </sqlMapGenerator>

        <!--targetPackage：mapper接口生成的位置 -->
        <javaClientGenerator type="XMLMAPPER"
                             targetPackage="com.github.bjlhx15.mybatis.springboot.base.repository.auto"
                             targetProject="../tk-mybatis-springboot-base1/src/main/java">
            <!-- enableSubPackages:是否让schema做为包的后缀 -->
            <property name="enableSubPackages" value="false"/>
        </javaClientGenerator>

        <!-- 指定数据库表 -->
        <table tableName="accountbalance" domainObjectName="AccountBalance">
            <generatedKey column="id" sqlStatement="JDBC"/>
        </table>


    </context>
</generatorConfiguration>

View Code

　　与MGB原有的配置文件相比，这里只是多了一个插件的配置，这个插件的做用是：配置生成的Mapper接口都会自动继承这个接口，也就是说，使用通用Mapper生成的mapper接口即便看上去空空如也，但已经具有了大量的对数据库的操做方法。此外，通用 Mapper 专用代码生成器生成的 Model 会在原有基础上增长 @Table,@Id,@Column 等注解，方便自动与数据库字段进行映射。

3. 在 pom.xml 这一级目录的命令行窗口执行 mvn mybatis-generator:generate或者直接在执行mvn插件便可。

4. 通用Mapper一样有Example的设计，与MGB不一样的是，MDB会对每个表生成对应的Example类，而通用Mapper提供了一个统一的Example类，这个类和 MBG 生成的相比，须要本身设置属性名，这个类还额外提供了更多的方法。

　　通用Mapper能够看做是MGB的改进和扩展，必定程度上解决了使用MGB重构的问题。

　　能够参看上述github代码

4、Mybatis-Plus

　　官网地址：https://mp.baomidou.com/guide/generator.html

　　（如下简称MP）是Mybatis的加强工具（MBG和通用Mapper可当作插件），在Mybatis的基础上增长了不少功能，简化开发，提升效率。

在Spring Boot中的引入：

1. 在maven中添加MP启动器

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.1.2</version>
</dependency>

2. 要使用代码生成器还须要添加模板引擎依赖

参看地址：AutoGenerator的使用参考 https://mybatis.plus/guide/generator.html 。

添加 模板引擎 依赖，MyBatis-Plus 支持 Velocity（默认）、Freemarker、Beetl，用户能够选择本身熟悉的模板引擎，若是都不知足您的要求，能够采用自定义模板引擎。

Velocity（默认）：

<dependency>
    <groupId>org.apache.velocity</groupId>
    <artifactId>velocity-engine-core</artifactId>
    <version>2.1</version>
</dependency>

Freemarker：

<dependency>
    <groupId>org.freemarker</groupId>
    <artifactId>freemarker</artifactId>
    <version>2.3.29</version>
</dependency>

Beetl：

<dependency>
    <groupId>com.ibeetl</groupId>
    <artifactId>beetl</artifactId>
    <version>3.0.11.RELEASE</version>
</dependency>

注意！若是您选择了非默认引擎，须要在 AutoGenerator 中 设置模板引擎。

AutoGenerator generator = new AutoGenerator();

// set freemarker engine
generator.setTemplateEngine(new FreemarkerTemplateEngine());

// set beetl engine
generator.setTemplateEngine(new BeetlTemplateEngine());

// set custom engine (reference class is your custom engine class)
generator.setTemplateEngine(new CustomTemplateEngine());

// other config
...

View Code

三、代码的自动生成。AutoGenerator是MP的代码生成器，经过调用AutoGenerator，进行相应的模板、策略配置能够快速生成Entity、Mapper、Mapper XML、Service、Controller各个模块的代码。

4. MP将通用的CRUD操做封装进BaseMapper接口，而自动生成的Mapper接口便自动继承了BaseMapper接口。复杂的Sql操做，则可使用QueryWrapper(LambdaQueryWrapper) 和 UpdateWrapper(LambdaUpdateWrapper)进行动态Sql拼接。

五、此外，MP还支持分页、逻辑删除、通用枚举、Sql注入等功能，在:https://mp.baomidou.com/guide/generator.html

　　还有性能分析插件：https://mp.baomidou.com/guide/performance-analysis-plugin.html

与MBG不一样，使用Mybatis-Plus自动生成代码须要编写代码，经过调用AutoAutoGenerator类实现代码生成，从这方面来讲不如使用插件方便。可是它丰富的功能以及只是相对复杂的配置仍是使它领先于MBG以及通用Mapper。

 

 

 

 

 

 

 

 

双方都