mybatis-plus的插件

一.攔截器插件

MyBatis 允許你在已映射語句執行過程中的某一點進行攔截調用。默認情況下,MyBatis 允許使用插件來攔截的方法調用包括:

  1. Executor (update, query, flflushStatements, commit, rollback, getTransaction, close, isClosed)

  2. ParameterHandler (getParameterObject, setParameters)

  3. ResultSetHandler (handleResultSets, handleOutputParameters)

  4. StatementHandler (prepare, parameterize, batch, update, query)

我們看到了可以攔截Executor接口的部分方法,比如update,query,commit,rollback等方法,還有其他接口的 一些方法等。

總體概括爲:

  1. 攔截執行器的方法

  2. 攔截參數的處理

  3. 攔截結果集的處理

  4. 攔截Sql語法構建的處理

1.自定義攔截器

(1)代碼塊

import org.apache.ibatis.executor.Executor;
import org.apache.ibatis.mapping.MappedStatement;
import org.apache.ibatis.plugin.*;
import java.util.Properties;
/**
 * 自定義攔截器
 */
@Intercepts({@Signature(
        type= Executor.class,   //設置攔截的執行器
        method = "update",      //設置攔截的執行器方法
        args = {MappedStatement.class,Object.class})})
public class MyInterceptor implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        //攔截方法,具體業務邏輯編寫的位置
        return invocation.proceed();
    }
    @Override
    public Object plugin(Object target) {
        //創建target對象的代理對象,目的是將當前攔截器加入到該對象中
        return Plugin.wrap(target, this);
    }
    @Override
    public void setProperties(Properties properties) {
        //屬性設置
    }
}

(2)範例

圖片

2.spring的攔截器依賴注入

(1)bean註解注入

@Bean  //注入自定義的攔截器
public MyInterceptor myInterceptor(){
    return new MyInterceptor();
}

(2)xml注入

<?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE configuration 
PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<plugins> 
<plugin interceptor="cn.itcast.mp.plugins.MyInterceptor"></plugin> 
</plugins> 
</configuration> 

(3)範例

圖片

二.分析sql插件

在MP中提供了對SQL執行的分析的插件,可用作阻斷全表更新、刪除的操作,注意:該插件僅適用於開發環境,不適用於生產環境。

1.代碼塊

@Bean   //注入分析sql插件
public SqlExplainInterceptor sqlExplainInterceptor(){
    SqlExplainInterceptor sqlExplainInterceptor = new SqlExplainInterceptor();
    // 攻擊 SQL 阻斷解析器、加入解析鏈
    List<ISqlParser> list = new ArrayList<>();  //創建一個解析器集合
    list.add(new BlockAttackSqlParser());   //添加全表更新、刪除的解析器
    sqlExplainInterceptor.setSqlParserList(list);   //存入sqlExplainInterceptor
    return sqlExplainInterceptor;
}

2.範例

圖片

3.插件的作用

阻斷一些sql語句的誤操作。

三.性能分析插件

性能分析攔截器,用於輸出每條 SQL 語句及其執行時間,可以設置最大執行時間,超過時間會拋出異常。 該插件只用於開發環境,不建議生產環境使用。

1.代碼塊

<!-- 配置性能分析插件 -->
<plugin interceptor="com.baomidou.mybatisplus.extension.plugins.PerformanceInterceptor">
    <!-- 設置每條sql語句執行的最大時間,單位爲毫秒 -->
    <property name="maxTime" value="100"/>
    <!--SQL是否格式化 默認false-->
    <property name="format" value="true"/>
</plugin>

2.範例

圖片

圖片

3.異常解決

圖片

四.樂觀鎖插件

1.原理

樂觀鎖實現方式:

  1. 取出記錄時,獲取當前version
  2. 更新時,帶上這個version
  3. 執行更新時, set version = newVersion where version = oldVersion
  4. 如果version不對,就更新失敗

2.代碼塊

(1)xml配置【二選一】

<bean class="com.baomidou.mybatisplus.extension.plugins.OptimisticLockerInterceptor"/>

(2)springboot的bean註解配置【二選一】

@Bean   //配置樂觀鎖插件
public OptimisticLockerInterceptor optimisticLockerInterceptor() {
    return new OptimisticLockerInterceptor();
}

(3)實體類

3.範例

(1)bean註解

圖片

(2)實體類

圖片

(3)測試類

圖片

4.特別說明【重點】

  • 支持的數據類型只有**:int,Integer,long,Long,Date,Timestamp,LocalDateTime **
  • 整數類型下 newVersion = oldVersion + 1
  • newVersion 會回寫到 entity 中
  • 僅支持 updateById(id) 與 update(entity, wrapper) 方法
  • ** update(entity, wrapper) 方法下, wrapper 不能複用!!!**

五.sql自定義注入器

配置自定義sql注入器,作用是通用mapper。

1.圖解

圖片

2.代碼塊

(1)usermapper類

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import cn.pojo.User;
import org.apache.ibatis.annotations.Mapper;
import org.springframework.stereotype.Repository;
import java.util.List;
/**
 * mybatisPlus整合spring
 */
@Mapper
@Repository
public interface UserMapper extends MyBaseMapper<User> {
    User findById(Long id);
}

(2)MyBaseMapper類

import cn.pojo.User;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import java.util.List;
/**
 * 自定義sql注入器
 * @param <T>
 */
public interface MyBaseMapper<T> extends BaseMapper<T> {
    List<T> findAll();
    //設置通用方法
}

(3)MySqlInjector類

import com.baomidou.mybatisplus.core.injector.AbstractMethod;
import com.baomidou.mybatisplus.core.injector.AbstractSqlInjector;
import com.baomidou.mybatisplus.core.injector.DefaultSqlInjector;
import java.util.ArrayList;
import java.util.List;
/**
 * sql注入器配置
 */
import com.baomidou.mybatisplus.core.injector.AbstractMethod;
import com.baomidou.mybatisplus.core.injector.DefaultSqlInjector;
import java.util.List;
public class MySqlInjector extends DefaultSqlInjector {
    @Override
    public List<AbstractMethod> getMethodList() {
        ArrayList<AbstractMethod> list = new ArrayList<>();
        //獲取父類的方法【baseMapper父類的方法】
        list.addAll(super.getMethodList()); //存到集合中
        // 再擴充自定義的方法
       list.add(new FindAll());
        return list;
    }
}

(4)FindAll類

import com.baomidou.mybatisplus.core.injector.AbstractMethod;
import com.baomidou.mybatisplus.core.metadata.TableInfo;
import org.apache.ibatis.executor.keygen.NoKeyGenerator;
import org.apache.ibatis.mapping.MappedStatement;
import org.apache.ibatis.mapping.SqlCommandType;
import org.apache.ibatis.mapping.SqlSource;
/**
 * 定義sql語句實現
 */
public class FindAll extends AbstractMethod {
    @Override
    public MappedStatement injectMappedStatement(Class<?> mapperClass, Class<?> modelClass, TableInfo tableInfo) {
        //定義sql方法名
        String sqlMethod = "findAll";
        //定義sql語句
        String sql = "select * from " + tableInfo.getTableName();
        //定義sqlSource
        SqlSource sqlSource = languageDriver.createSqlSource(
                configuration,
                sql,    //添加sql語句
                modelClass
        );
        return this.addSelectMappedStatement(
                mapperClass,
                sqlMethod,      //方法名
                sqlSource,          //方法配置
                modelClass,
                tableInfo
        );
    }
}

3.範例

(1)usermapper類

圖片

(2)MyBaseMapper類

圖片

(3)MySqlInjector類

圖片

(4)FindAll類

圖片

六.自動填充功能【重點】

我們可能會有這樣的需求,插入或者更新數據時,希望有些字段可以自動填充數據,比如密碼、version 等。在MP中提供了這樣的功能,可以實現自動填充。

1.代碼塊

(1)對象類

import com.baomidou.mybatisplus.annotation.*;
import com.baomidou.mybatisplus.extension.activerecord.Model;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
import static com.baomidou.mybatisplus.annotation.IdType.AUTO;
@Data
@NoArgsConstructor  //空參構造方法
@AllArgsConstructor //全參構造方法
@TableName("tb_user") //測試全局表名前綴
//@KeySequence(value = "SEQ_USER",clazz = Long.class)  //配置oracle序列的註解
////value是聲明序列表的表名,clazz是聲明主鍵的數據類型
public class User extends Model<User> implements Serializable {
    @TableId(type=IdType.AUTO)  //聲明主鍵自增長
    private Long id;
    private String userName;
    @TableField(fill = FieldFill.INSERT)    //插入數據時自動填充字段
    private String password;
    @TableField(select = false)    //查詢時,則不返回該字段的值
    private String name;
    private Integer age;
    @TableField(value = "email")    //通過tableField進行字段不一致的映射
    //數據庫字段是email,而實體類對應的是mail
    private String mail;
    @TableField(exist = false)  //設置該字段在數據庫表中不存在
    private String msg; //數據庫中不存在該字段
    @Version    //配置樂觀鎖
    private Integer version;
}

(2)配置類

import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;
@Component  //聲明配置類
public class MyMetaObjectHandle implements MetaObjectHandler {
    @Override
    //插入數據時填充數據
    public void insertFill(MetaObject metaObject) {
        //先獲取password的值,
        //判斷是否爲空,如果爲空,則進行填充
        //如果不爲空,則不做處理
        Object password = getFieldValByName("password",metaObject);//通過字段名獲取字段值
        if(null == password){
            //參數一:字段名,參數二:字段值,參數三:metaObject
            setFieldValByName("password","123456",metaObject);
        }
    }
    @Override
    //更新數據時填充數據
    public void updateFill(MetaObject metaObject) {
    }
}

2.範例

(1)對象類

圖片

(2)配置類

圖片

(3)測試類

圖片

七.邏輯刪除

1.代碼塊

(1)對象類

import com.baomidou.mybatisplus.annotation.*;
import com.baomidou.mybatisplus.extension.activerecord.Model;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
import static com.baomidou.mybatisplus.annotation.IdType.AUTO;
@Data
@NoArgsConstructor  //空參構造方法
@AllArgsConstructor //全參構造方法
@TableName("tb_user") //測試全局表名前綴
//@KeySequence(value = "SEQ_USER",clazz = Long.class)  //配置oracle序列的註解
////value是聲明序列表的表名,clazz是聲明主鍵的數據類型
public class User extends Model<User> implements Serializable {
    @TableId(type=IdType.AUTO)  //聲明主鍵自增長
    private Long id;
    private String userName;
    @TableField(fill = FieldFill.INSERT)    //插入數據時自動填充字段
    private String password;
    @TableField(select = false)    //查詢時,則不返回該字段的值
    private String name;
    private Integer age;
    @TableField(value = "email")    //通過tableField進行字段不一致的映射
    //數據庫字段是email,而實體類對應的是mail
    private String mail;
    @TableField(exist = false)  //設置該字段在數據庫表中不存在
    private String msg; //數據庫中不存在該字段
    @Version    //配置樂觀鎖
    private Integer version;
    @TableLogic //邏輯刪除的註解,0是未刪除,1是刪除
    private Integer deleted; //判斷是否被刪除【不會將真實數據刪除,而是標記刪除】
}

(2)yml配置文件

spring:
  #數據庫連接配置
  datasource:
    #配置oracle
#    driver-class-name: oracle.jdbc.driver.OracleDriver
#    url: jdbc:oracle:thin:@192.168.223.129:1521:orcl
#    username: root
#    password: root
      # mysql配置
    driver-class-name: com.mysql.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/db2?serverTimezone=GMT%2B8&useUnicode=true&characterEncoding=utf-8
    username: root
    password: root

#mybatis的相關配置
#mybatis:
#  #mapper配置文件
#  mapper-locations: classpath*:mapper/*.xml
#  type-aliases-package: cn.pojo
#  #開啓駝峯命名
#  configuration:
#    map-underscore-to-camel-case: true
#mybatisplus的相關配置
mybatis-plus:
  #指定全局配置文件【二選一】
  config-location: classpath:mybatis-config.xml
  #mapper配置文件
  mapper-locations: classpath*:mapper/*.xml
  #開啓實體類包路徑掃描
  type-aliases-package: cn.pojo
#  configuration: #【二選一】
#    #開啓駝峯命名:默認開啓,
#    map-underscore-to-camel-case: true
#    #開啓二級緩存,默認開啓
#    cache-enabled: true
  global-config:
    db-config:
#      id-type: input
    # 全局主鍵自增長模式
      id-type: auto
#      # 全局的數據庫表名的前綴配置【不推薦】
#      table-prefix: tb_
      #邏輯刪除時,刪除的狀態值爲1
      logic-delete-value: 1
      #邏輯刪除時,未刪除的狀態值爲0
      logic-not-delete-value: 0

2.範例

(1)對象類

圖片

(2)yml配置文件

圖片

(3)測試類【重點細節】

圖片

圖片

八.通用枚舉

解決了繁瑣的配置,讓 mybatis 優雅的使用枚舉屬性!

1.代碼塊

(1)枚舉類

import com.baomidou.mybatisplus.core.enums.IEnum;
/**
 * 定義一個枚舉類
 */
public enum  SexEnum implements IEnum<Integer> {
    //參數1是value,參數2是desc
    MAN(1,"男"),
    WOMAN(2,"女");
    private int value;
    private String desc;
    SexEnum(int value, String desc) {
        this.value = value;
        this.desc = desc;
    }
    @Override
    public Integer getValue() {
        return this.value;
    }
    @Override
    public String toString() {
        return this.desc;
    }
}

(2)yml配置文件

# 枚舉包掃描 
mybatis-plus.type-enums-package=cn.itcast.mp.enums 

(3)對象類

import cn.enums.SexEnum;
import com.baomidou.mybatisplus.annotation.*;
import com.baomidou.mybatisplus.extension.activerecord.Model;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
import static com.baomidou.mybatisplus.annotation.IdType.AUTO;
@Data
@NoArgsConstructor  //空參構造方法
@AllArgsConstructor //全參構造方法
@TableName("tb_user") //測試全局表名前綴
//@KeySequence(value = "SEQ_USER",clazz = Long.class)  //配置oracle序列的註解
////value是聲明序列表的表名,clazz是聲明主鍵的數據類型
public class User extends Model<User> implements Serializable {
    @TableId(type=IdType.AUTO)  //聲明主鍵自增長
    private Long id;
    private String userName;
    @TableField(fill = FieldFill.INSERT)    //插入數據時自動填充字段
    private String password;
    @TableField(select = false)    //查詢時,則不返回該字段的值
    private String name;
    private Integer age;
    @TableField(value = "email")    //通過tableField進行字段不一致的映射
    //數據庫字段是email,而實體類對應的是mail
    private String mail;
    @TableField(exist = false)  //設置該字段在數據庫表中不存在
    private String msg; //數據庫中不存在該字段
    @Version    //配置樂觀鎖
    private Integer version;
    @TableLogic //邏輯刪除的註解,0是未刪除,1是刪除
    private Integer deleted; //判斷是否被刪除【不會將真實數據刪除,而是標記刪除】
    private SexEnum sex;    //數據類型爲通用枚舉
}

2.範例

(1)對象類

圖片

(2)yml配置文件

圖片

(3)枚舉類

圖片

九.代碼生成器

AutoGenerator 是 MyBatis-Plus 的代碼生成器,通過 AutoGenerator 可以快速生成 Entity、Mapper、Mapper XML、Service、Controller 等各個模塊的代碼,極大的提升了開發效率。

1.代碼塊

(1)pom.xml

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.1.4.RELEASE</version>
</parent>
<groupId>org.example</groupId>
<artifactId>demo05</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency> <!--mybatis-plus的springboot支持-->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>3.1.1</version>
    </dependency>
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-generator</artifactId>
        <version>3.1.1</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-freemarker</artifactId>
    </dependency>
    <!--mysql驅動-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.47</version>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-log4j12</artifactId>
    </dependency>
</dependencies>
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

(2)代碼生成類

import java.util.ArrayList;
import java.util.ArrayList;
import java.util.List;
import java.util.Scanner;
import com.baomidou.mybatisplus.core.exceptions.MybatisPlusException;
import com.baomidou.mybatisplus.core.toolkit.StringPool;
import com.baomidou.mybatisplus.core.toolkit.StringUtils;
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.po.TableInfo;
import com.baomidou.mybatisplus.generator.config.rules.NamingStrategy;
import com.baomidou.mybatisplus.generator.engine.FreemarkerTemplateEngine;
/***
 * <p>
 *      mysql 代碼生成器演示例子 *
 * </p>
 */
public class MysqlGenerator {
    /*** <p> * 讀取控制檯內容 * </p> */
    public static String scanner(String tip) {
        Scanner scanner = new Scanner(System.in);
        StringBuilder help = new StringBuilder();
        help.append("請輸入" + tip + ":");
        System.out.println(help.toString());
        if (scanner.hasNext()) {
            String ipt = scanner.next();
            if (StringUtils.isNotEmpty(ipt)) {
                return ipt;
            }
        }
        throw new MybatisPlusException("請輸入正確的" + tip + "!");
    }
    /*** RUN THIS */
    public static void main(String[] args) {
        // 代碼生成器
        AutoGenerator mpg = new AutoGenerator();
        // 全局配置
        GlobalConfig gc = new GlobalConfig();
        String projectPath = System.getProperty("user.dir");
        gc.setOutputDir(projectPath + "/src/main/java");
        gc.setAuthor("itcast");
        gc.setOpen(false);
        mpg.setGlobalConfig(gc);
        // 數據源配置
        DataSourceConfig dsc = new DataSourceConfig();
        dsc.setUrl("jdbc:mysql://127.0.0.1:3306/db2? useUnicode=true&useSSL=false&characterEncoding=utf8");
        dsc.setSchemaName("public");
        dsc.setDriverName("com.mysql.jdbc.Driver");
        dsc.setUsername("root"); dsc.setPassword("root");
        mpg.setDataSource(dsc);
        // 包配置
        PackageConfig pc = new PackageConfig();
        pc.setModuleName(scanner("模塊名"));
        pc.setParent("cn.itcast.mp.generator");
        mpg.setPackageInfo(pc);
        // 自定義配置
        InjectionConfig cfg = new InjectionConfig() {
            @Override
            public void initMap() {
                // to do nothing
            }
        };
        List<FileOutConfig> focList = new ArrayList<>();
        focList.add(new FileOutConfig("/templates/mapper.xml.ftl") {
            @Override
            public String outputFile(TableInfo tableInfo) {
                // 自定義輸入文件名稱
                return projectPath + "/itcast-mp- generator/src/main/resources/mapper/" + pc.getModuleName() + "/" + tableInfo.getEntityName() + "Mapper" + StringPool.DOT_XML;
            }
        });
        cfg.setFileOutConfigList(focList);
        mpg.setCfg(cfg);
        mpg.setTemplate(new TemplateConfig().setXml(null));
        // 策略配置
        StrategyConfig strategy = new StrategyConfig();
        strategy.setNaming(NamingStrategy.underline_to_camel);
        strategy.setColumnNaming(NamingStrategy.underline_to_camel);
        //strategy.setSuperEntityClass("com.baomidou.mybatisplus.samples.generator.common.BaseE ntity");
        strategy.setEntityLombokModel(true);
        //strategy.setSuperControllerClass("com.baomidou.mybatisplus.samples.generator.common.B aseController");
        strategy.setInclude(scanner("表名"));
        strategy.setSuperEntityColumns("id");
        strategy.setControllerMappingHyphenStyle(true);
        strategy.setTablePrefix(pc.getModuleName() + "_");
        mpg.setStrategy(strategy);
        // 選擇 freemarker 引擎需要指定如下加,注意 pom 依賴必須有!
        mpg.setTemplateEngine(new FreemarkerTemplateEngine());
        mpg.execute();
    }
}

2.演示

圖片

圖片

圖片

圖片

十.mybatisX插件【idea專有】

(1)作用

Java 與 XML 調回跳轉

Mapper 方法自動生成 XML

(2)演示

圖片

十一.源碼

鏈接:https://pan.baidu.com/s/1gzJ2WEUm2pF-_Y9PFCiCwQ

提取碼:q8tr

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章