SpringBoot 使用Mybatis-Plus

简介

Mybatis-Plus（简称MP）是一个 Mybatis 的增强工具，在 Mybatis 的基础上只做增强不做改变，为简化开发、提高效率而生。

特性

无侵入：Mybatis-Plus 在 Mybatis 的基础上进行扩展，只做增强不做改变，引入 Mybatis-Plus 不会对您现有的 Mybatis 构架产生任何影响，而且 MP 支持所有 Mybatis 原生的特性

依赖少：仅仅依赖 Mybatis 以及 Mybatis-Spring

损耗小：启动即会自动注入基本CURD，性能基本无损耗，直接面向对象操作

预防Sql注入：内置Sql注入剥离器，有效预防Sql注入攻击

通用CRUD操作：内置通用 Mapper、通用 Service，仅仅通过少量配置即可实现单表大部分 CRUD 操作，更有强大的条件构造器，满足各类使用需求

多种主键策略：支持多达4种主键策略（内含分布式唯一ID生成器），可自由配置，完美解决主键问题

支持ActiveRecord：支持 ActiveRecord 形式调用，实体类只需继承 Model 类即可实现基本 CRUD 操作

支持代码生成：采用代码或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller 层代码，支持模板引擎，更有超多自定义配置等您来使用（P.S. 比 Mybatis 官方的 Generator 更加强大！）

支持自定义全局通用操作：支持全局通用方法注入（ Write once, use anywhere ）

支持关键词自动转义：支持数据库关键词（order、key……）自动转义，还可自定义关键词

内置分页插件：基于Mybatis物理分页，开发者无需关心具体操作，配置好插件之后，写分页等同于普通List查询

内置性能分析插件：可输出Sql语句以及其执行时间，建议开发测试时启用该功能，能有效解决慢查询

内置全局拦截插件：提供全表 delete 、 update 操作智能分析阻断，预防误操作

集成

Mybatis-Plus 的集成非常简单，对于 Spring，我们仅仅需要把 Mybatis 自带的MybatisSqlSessionFactoryBean替换为 MP 自带的即可。

使用：

1.pom.xml依赖：

   <!--Mybatis-plus-->

        <dependency>

            <groupId>com.baomidou</groupId>

            <artifactId>mybatisplus-spring-boot-starter</artifactId>

            <version>1.0.</version>

        </dependency>

        <dependency>

            <groupId>com.baomidou</groupId>

            <artifactId>mybatis-plus</artifactId>

            <version>2.3</version>

        </dependency>

如果要自动生成代码，那么还要加入模板引擎：

Velocity引擎：

 <!-- Code generator test sample-->

        <dependency>

            <groupId>org.apache.velocity</groupId>

            <artifactId>velocity</artifactId>

            <version>1.7</version>

        </dependency>

或者Freemarker引擎：

  <!-- https://mvnrepository.com/artifact/org.freemarker/freemarker -->

        <dependency>

            <groupId>org.freemarker</groupId>

            <artifactId>freemarker</artifactId>

            <version>2.3.</version>

        </dependency>

这两个引擎随便选择一个就可以，在自动生成代码的时候选择配置即可。

Mybatis及Mybatis-Spring依赖请勿加入项目配置，以免引起版本冲突！！！Mybatis-Plus会自动帮你维护！

2.自动生成代码：

import com.baomidou.mybatisplus.enums.FieldFill;

import com.baomidou.mybatisplus.generator.AutoGenerator;

import com.baomidou.mybatisplus.generator.InjectionConfig;

import com.baomidou.mybatisplus.generator.config.DataSourceConfig;

import com.baomidou.mybatisplus.generator.config.FileOutConfig;

import com.baomidou.mybatisplus.generator.config.GlobalConfig;

import com.baomidou.mybatisplus.generator.config.PackageConfig;

import com.baomidou.mybatisplus.generator.config.StrategyConfig;

import com.baomidou.mybatisplus.generator.config.TemplateConfig;

import com.baomidou.mybatisplus.generator.config.converts.MySqlTypeConvert;

import com.baomidou.mybatisplus.generator.config.po.TableFill;

import com.baomidou.mybatisplus.generator.config.po.TableInfo;

import com.baomidou.mybatisplus.generator.config.rules.DbColumnType;

import com.baomidou.mybatisplus.generator.config.rules.DbType;

import com.baomidou.mybatisplus.generator.config.rules.NamingStrategy;

import com.baomidou.mybatisplus.generator.engine.FreemarkerTemplateEngine;

import java.util.ArrayList;

import java.util.Collections;

import java.util.HashMap;

import java.util.List;

import java.util.Map;

import org.junit.Test;

/**

 * Created by qhong on 2018/7/25 17:40

 **/

public class MysqlGenerator extends GeneratorTest {

    @Test

    public void generateCode() {

        //0 Velocity引擎 1 Freemarker引擎

        int result=;

        // 自定义需要填充的字段

        List<TableFill> tableFillList = new ArrayList<>();

        tableFillList.add(new TableFill("ASDD_SS", FieldFill.INSERT_UPDATE));

        // 代码生成器

        AutoGenerator mpg = new AutoGenerator().setGlobalConfig(

                // 全局配置

                new GlobalConfig()

                        .setOutputDir("src\\main\\java")//输出目录

                        .setFileOverride(true)// 是否覆盖文件

                        .setActiveRecord(true)// 开启 activeRecord 模式

                        .setEnableCache(false)// XML 二级缓存

                        .setBaseResultMap(true)// XML ResultMap

                        .setBaseColumnList(true)// XML columList

                        //.setKotlin(true) 是否生成 kotlin 代码

                        .setAuthor("qhong")

                // 自定义文件命名，注意 %s 会自动填充表实体属性！

                // .setMapperName("%sDao")

                // .setXmlName("%sDao")

                // .setServiceName("MP%sService")

                // .setServiceImplName("%sServiceDiy")

                // .setControllerName("%sAction")

        ).setDataSource(

                // 数据源配置

                new DataSourceConfig()

                        .setDbType(DbType.MYSQL)// 数据库类型

                        .setTypeConvert(new MySqlTypeConvert() {

                            // 自定义数据库表字段类型转换【可选】

                            @Override

                            public DbColumnType processTypeConvert(String fieldType) {

                                System.out.println("转换类型：" + fieldType);

                                // if ( fieldType.toLowerCase().contains( "tinyint" ) ) {

                                //    return DbColumnType.BOOLEAN;

                                // }

                                return super.processTypeConvert(fieldType);

                            }

                        })

                        .setDriverName("com.mysql.jdbc.Driver")

                        .setUsername("root")

                        .setPassword("hongda$123456")

                        .setUrl("jdbc:mysql://127.0.0.1:3306/test1?characterEncoding=utf8")

        ).setStrategy(

                // 策略配置

                new StrategyConfig()

                        // .setCapitalMode(true)// 全局大写命名

                        // .setDbColumnUnderline(true)//全局下划线命名

                        .setTablePrefix(new String[]{"bmd_", "mp_"})// 此处可以修改为您的表前缀

                        .setNaming(NamingStrategy.underline_to_camel)// 表名生成策略

                        // .setInclude(new String[] { "user" }) // 需要生成的表

                        // .setExclude(new String[]{"test"}) // 排除生成的表

                        .setExclude(new String[]{"sc"})

                        // 自定义实体父类

                        // .setSuperEntityClass("com.baomidou.demo.TestEntity")

                        // 自定义实体，公共字段

                        .setSuperEntityColumns(new String[]{"test_id"})

                        .setTableFillList(tableFillList)

                // 自定义 mapper 父类

                // .setSuperMapperClass("com.baomidou.demo.TestMapper")

                // 自定义 service 父类

                // .setSuperServiceClass("com.baomidou.demo.TestService")

                // 自定义 service 实现类父类

                // .setSuperServiceImplClass("com.baomidou.demo.TestServiceImpl")

                // 自定义 controller 父类

                // .setSuperControllerClass("com.baomidou.demo.TestController")

                // 【实体】是否生成字段常量（默认 false）

                // public static final String ID = "test_id";

                // .setEntityColumnConstant(true)

                // 【实体】是否为构建者模型（默认 false）

                // public User setName(String name) {this.name = name; return this;}

                // .setEntityBuilderModel(true)

                // 【实体】是否为lombok模型（默认 false）<a href="https://projectlombok.org/">document</a>

                // .setEntityLombokModel(true)

                // Boolean类型字段是否移除is前缀处理

                // .setEntityBooleanColumnRemoveIsPrefix(true)

                // .setRestControllerStyle(true)

                // .setControllerMappingHyphenStyle(true)

        ).setPackageInfo(

                // 包配置

                new PackageConfig()

                        .setModuleName(null)

                        .setParent("com.qhong.modules")// 自定义包路径

                        .setController("controller")// 这里是控制器包名，默认 web

        ).setCfg(

                // 注入自定义配置，可以在 VM 中使用 cfg.abc 设置的值

                new InjectionConfig() {

                    @Override

                    public void initMap() {

                        Map<String, Object> map = new HashMap<>();

                        map.put("abc", this.getConfig().getGlobalConfig().getAuthor() + "-mp");

                        this.setMap(map);

                    }

                }.setFileOutConfigList(Collections.<FileOutConfig>singletonList(new FileOutConfig(

                        "/templates/mapper.xml" + (( == result) ? ".ftl" : ".vm")) {

                    // 自定义输出文件目录

                    @Override

                    public String outputFile(TableInfo tableInfo) {

                        return "src/main/resources/mapper/" + tableInfo.getEntityName() + ".xml";

                    }

                }))

        ).setTemplate(

                // 关闭默认 xml 生成，调整生成 至 根目录

                new TemplateConfig().setXml(null)

                // 自定义模板配置，模板可以参考源码 /mybatis-plus/src/main/resources/template 使用 copy

                // 至您项目 src/main/resources/template 目录下，模板名称也可自定义如下配置：

                // .setController("...");

                // .setEntity("...");

                // .setMapper("...");

                // .setXml("...");

                // .setService("...");

                // .setServiceImpl("...");

        );

        // 执行生成

        if ( == result) {

            mpg.setTemplateEngine(new FreemarkerTemplateEngine());

        }

        mpg.execute();

        // 打印注入设置，这里演示模板里面怎么获取注入内容【可无】

        System.err.println(mpg.getCfg().getMap().get("abc"));

    }

}

3.配置：

MybatisPlusConfig：

import com.baomidou.mybatisplus.incrementer.H2KeyGenerator;

import com.baomidou.mybatisplus.incrementer.IKeyGenerator;

import com.baomidou.mybatisplus.mapper.ISqlInjector;

import com.baomidou.mybatisplus.mapper.LogicSqlInjector;

import com.baomidou.mybatisplus.mapper.MetaObjectHandler;

import com.baomidou.mybatisplus.plugins.PaginationInterceptor;

import com.baomidou.mybatisplus.plugins.PerformanceInterceptor;

import com.qhong.filter.MyMetaObjectHandler;

import org.mybatis.spring.annotation.MapperScan;

import org.springframework.context.annotation.Bean;

import org.springframework.context.annotation.Configuration;

import org.springframework.context.annotation.Profile;

import org.springframework.transaction.annotation.EnableTransactionManagement;

/**

 * Created by qhong on 2018/7/25 16:43

 **/

@EnableTransactionManagement

@Configuration

@MapperScan("com.qhong.modules.mapper*")

public class MybatisPlusConfig {

    /**

     * mybatis-plus SQL执行效率插件【生产环境可以关闭】

     */

    @Bean

    @Profile({"dev","test"})// 设置 dev test 环境开启

    public PerformanceInterceptor performanceInterceptor() {

        return new PerformanceInterceptor();

    }

    /**

     * mybatis-plus分页插件<br>

     * 文档：http://mp.baomidou.com<br>

     */

    @Bean

    public PaginationInterceptor paginationInterceptor() {

        return new PaginationInterceptor();

    }

    @Bean

    public MetaObjectHandler metaObjectHandler(){

        return new MyMetaObjectHandler();

    }

    /**

     * 注入主键生成器

     */

    @Bean

    public IKeyGenerator keyGenerator(){

        return new H2KeyGenerator();

    }

    /**

     * 注入sql注入器

     */

    @Bean

    public ISqlInjector sqlInjector(){

        return new LogicSqlInjector();

    }

}

application.properties:

#mybatis-plus

# 如果是放在src/main/java目录下 classpath:/com/yourpackage/*/mapper/*.xml

# 如果是放在resource目录 classpath:/mapper/*.xml

mybatis-plus.mapper-locations=classpath:/mapper/*.xml

#实体扫描，多个package用逗号或者分号分隔

mybatis-plus.typeAliasesPackage=com.qhong.modules.entity

#主键类型  0:"数据库ID自增", 1:"用户输入ID",2:"全局唯一ID (数字类型唯一ID)", 3:"全局唯一ID UUID";

mybatis-plus.global-config.id-type=2

#字段策略 0:"忽略判断",1:"非 NULL 判断"),2:"非空判断"

mybatis-plus.global-config.field-strategy=2

#驼峰下划线转换

mybatis-plus.global-config.db-column-underline=true

#mp2.3+ 全局表前缀 mp_

#mybatis-plus.global-config.table-prefix=mp_

# Sequence序列接口实现类配置,如果不配置，自动获取数据库类型

mybatis-plus.global-config.key-generator=com.baomidou.mybatisplus.incrementer.OracleKeyGenerator

#逻辑删除配置（下面3个配置）

mybatis-plus.global-config.logic-delete-value=1

mybatis-plus.global-config.logic-not-delete-value=0

mybatis-plus.global-config.sql-injector=com.baomidou.mybatisplus.mapper.LogicSqlInjector

#自定义填充策略接口实现

mybatis-plus.global-config.meta-object-handler=com.qhong.filter.MyMetaObjectHandler

#配置返回数据库(column下划线命名&&返回java实体是驼峰命名)，自动匹配无需as（没开启这个，SQL需要写as： select user_id as userId）

mybatis-plus.configuration.map-underscore-to-camel-case=true

mybatis-plus.configuration.cache-enabled=false

#配置JdbcTypeForNull, oracle数据库必须配置

mybatis-plus.configuration.jdbc-type-for-null=null

4.代码：

基本就使用第一步自动生成代码即可，注意数据库表和字段如果不是很规范，要自己手动设置TableField

   @TableField(value="userSex")

    private String userSex;

    @TableField(value="nickName")

    private String nickName;

如果我自己不配置，那么抓取sql会发现，字段变成user_Sex,nick_Name,当然这是因为我大部分都是由下划线的，所以设置成驼峰下划线转换的，但是有个别不规范的要注意。

参考：

http://baomidou.oschina.io/mybatis-plus-doc/#/spring-boot

https://blog.csdn.net/helloPurple/article/details/78715508

https://blog.csdn.net/xusheng_Mr/article/details/78740887

https://cloud.tencent.com/developer/article/1057101

巴特西

SpringBoot 使用Mybatis-Plus

最新文章

热门文章