day01--MybatisPlus的使用

谷粒學院功能簡介及系統架構 https://www.cnblogs.com/coderD/p/14506161.html

day01--MybatisPlus的使用 https://www.cnblogs.com/coderD/p/14506180.html

day02--環境搭建與講師管理接口開發 https://www.cnblogs.com/coderD/p/14506295.html

day03--項目前端相關基礎知識 https://www.cnblogs.com/coderD/p/14506446.html

day04--項目前端相關基礎知識（二） https://www.cnblogs.com/coderD/p/14506481.html

day05--講師管理模塊前端開發 https://www.cnblogs.com/coderD/p/14506505.html

day06--講師管理模塊前端開發 https://www.cnblogs.com/coderD/p/14506540.html

day07--課程發布-添加課程信息 https://www.cnblogs.com/coderD/p/14506574.html

day08--課程發布-添加課程信息 https://www.cnblogs.com/coderD/p/14506609.html

day09--課程列表和整合阿里雲視頻點播 https://www.cnblogs.com/coderD/p/14506636.html

day10--微服務調用 https://www.cnblogs.com/coderD/p/14506649.html

day11--首頁數據顯示和添加Redis緩沖 https://www.cnblogs.com/coderD/p/14506655.html

day12--首頁登錄和注冊 https://www.cnblogs.com/coderD/p/14506657.html

day13--微信掃碼登陸 https://www.cnblogs.com/coderD/p/14506670.html

day14--首頁課程和名師功能 https://www.cnblogs.com/coderD/p/14506677.html

day15--統計分析 https://www.cnblogs.com/coderD/p/14506685.html

day16--權限管理 https://www.cnblogs.com/coderD/p/14506689.html

day17--權限管理和配置服務 https://www.cnblogs.com/coderD/p/14506701.html

• ActiveRecord
• Oracle 主鍵Sequence
• Mybatis-Plus 的插件
• Sql 注入器實現自定義全局操作
• 自動填充功能
• 邏輯刪除
• 通用枚舉
• 代碼生成器
• MybatisX 快速開發插件

1、ActiveRecord

ActiveRecord（簡稱AR）一直廣受動態語言（ PHP 、 Ruby 等）的喜愛，而 Java 作為准靜態語言，對於ActiveRecord 往往只能感嘆其優雅，所以我們也在 AR 道路上進行了一定的探索，喜歡大家能夠喜歡。

什么是ActiveRecord？
ActiveRecord也屬於ORM（對象關系映射）層，由Rails最早提出，遵循標准的ORM模型：表映射到記錄，記錄映射到對象，字段映射到對象屬性。配合遵循的命名和配置慣例，能夠很大程度的快速實現模型的操作，而且簡潔易懂。
ActiveRecord的主要思想是：

• 每一個數據庫表對應創建一個類，類的每一個對象實例對應於數據庫中表的一行記錄；通常表的每個字段在類中都有相應的Field；
• ActiveRecord 同時負責把自己持久化，在ActiveRecord中封裝了對數據庫的訪問，即CURD;
• ActiveRecord 是一種領域模型(Domain Model)，封裝了部分業務邏輯；

1.1、開啟AR之旅

在MP中，開啟AR非常簡單，只需要將實體對象繼承Model即可。

package cn.itcast.mp.pojo;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.extension.activerecord.Model;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
@Data
@NoArgsConstructor
@AllArgsConstructor
public class User extends Model<User> {
     private Long id;
  private String userName;
  private String password;
  private String name;
  private Integer age;
  private String email;
}

1.2、根據主鍵查詢

@RunWith (SpringRunner.class)
@SpringBootTest
public class UserMapperTest {
  @Autowired
  private UserMapper userMapper;
  @Test
  public void testAR() {
    User user = new User();
    user.setId(2L);
    User user2 = user.selectById();
    System.out.println(user2);
 }
}

1.3、新增數據

@RunWith (SpringRunner.class)
@SpringBootTest
public class UserMapperTest {
  @Autowired
  private UserMapper userMapper;
  @Test
  public void testAR() {
    User user = new User();
    user.setName("劉備");
    user.setAge(30);
    user.setPassword("123456");
    user.setUserName("liubei");
    user.setEmail("[e-mail]");
    boolean insert = user.insert();
    System.out.println(insert);
    }
}

結果：

[main] [cn.itcast.mp.mapper.UserMapper.insert]-[DEBUG]  ==> Preparing: INSERT INTO
tb_user ( user_name, password, name, age, email ) VALUES ( ?, ?, ?, ?, ? )
[main] [cn.itcast.mp.mapper.UserMapper.insert]-[DEBUG] ==> Parameters: liubei(String),
123456(String), 劉備(String), 30(Integer), [e-mail](String)
[main] [cn.itcast.mp.mapper.UserMapper.insert]-[DEBUG] <==  Updates: 1

1.4、更新操作

@RunWith (SpringRunner.class)
@SpringBootTest
public class UserMapperTest {
  @Autowired
  private UserMapper userMapper;
  @Test
  public void testAR() {
    User user = new User();
    user.setId(8L);
    user.setAge(35);
    boolean update = user.updateById();
    System.out.println(update);
 }
}

結果：

[main] [cn.itcast.mp.mapper.UserMapper.updateById]-[DEBUG]  ==> Preparing: UPDATE
tb_user SET age=? WHERE id=?
[main] [cn.itcast.mp.mapper.UserMapper.updateById]-[DEBUG] ==> Parameters: 35(Integer),
8(Long)
[main] [cn.itcast.mp.mapper.UserMapper.updateById]-[DEBUG] <==  Updates: 1

1.5、刪除操作

@RunWith (SpringRunner.class)
@SpringBootTest
public class UserMapperTest {
  @Autowired
  private UserMapper userMapper;
  @Test
  public void testAR() {
    User user = new User();
    user.setId(7L);
    boolean delete = user.deleteById();
    System.out.println(delete);
 }
}

結果：

[main] [cn.itcast.mp.mapper.UserMapper.deleteById]-[DEBUG]  ==> Preparing: DELETE FROM
tb_user WHERE id=?
[main] [cn.itcast.mp.mapper.UserMapper.deleteById]-[DEBUG] ==> Parameters: 7(Long)
[main] [cn.itcast.mp.mapper.UserMapper.deleteById]-[DEBUG] <==  Updates: 1

1.6、根據條件查詢

@RunWith (SpringRunner.class)
@SpringBootTest
public class UserMapperTest {
     @Autowired
  private UserMapper userMapper;
  @Test
  public void testAR() {
    User user = new User();
    QueryWrapper<User> userQueryWrapper = new QueryWrapper<>();
    userQueryWrapper.le("age","20");
    List<User> users = user.selectList(userQueryWrapper);
    for (User user1 : users) {
      System.out.println(user1);
   }
 }
}

結果：

[main] [cn.itcast.mp.mapper.UserMapper.selectList]-[DEBUG]  ==> Preparing: SELECT
id,user_name,password,name,age,email FROM tb_user WHERE age <= ?
[main] [cn.itcast.mp.mapper.UserMapper.selectList]-[DEBUG] ==> Parameters: 20(String)
[main] [cn.itcast.mp.mapper.UserMapper.selectList]-[DEBUG] <==   Total: 2
User(id=2, userName=lisi, password=123456, name=李四, age=20, email=[e-mail],
address=null)
User(id=6, userName=caocao, password=123456, name=曹操, age=20, email=[e-mail],
address=null)

2、Oracle主鍵Sequence

在mysql中，主鍵往往是自增長的，這樣使用起來是比較方便的，如果使用的是Oracle數據庫，那么就不能使用自增長了，就得使用Sequence 序列生成id值了。

2.1、部署Oracle環境

為了簡化環境部署，這里使用Docker環境進行部署安裝Oracle。

#拉取鏡像
docker pull sath89/oracle-12c
#創建容器
docker create --name oracle -p 1521:1521 sath89/oracle-12c
#啟動
docker start oracle && docker logs -f oracle
#下面是啟動過程
Database not initialized. Initializing database.
Starting tnslsnr

Copying database files
1% complete
3% complete
11% complete
18% complete
26% complete
37% complete
Creating and starting Oracle instance
40% complete
45% complete
50% complete
55% complete
56% complete
60% complete
62% complete
Completing Database Creation
66% complete
70% complete
73% complete
85% complete
96% complete
100% complete
Look at the log file "/u01/app/oracle/cfgtoollogs/dbca/xe/xe.log" for further details.
Configuring Apex console
Database initialized. Please visit http://#containeer:8080/em
http://#containeer:8080/apex for extra configuration if needed
Starting web management console
PL/SQL procedure successfully completed.
Starting import from '/docker-entrypoint-initdb.d':
ls: cannot access /docker-entrypoint-initdb.d/*: No such file or directory
Import finished
Database ready to use. Enjoy! ;)
#通過用戶名密碼即可登錄
用戶名和密碼為： system/oracle

下面使用navicat12進行連接並操作oracle，使用資料中提供的安裝包，可以試用14天。

需要注意的是：由於安裝的Oracle是64位版本，所以navicat也是需要使用64為版本，否則連接不成功。

連接成功：

2.2、創建表以及序列

-- 創建表，表名以及字段名都要大寫
CREATE TABLE "TB_USER" (
 "ID" NUMBER(20) VISIBLE NOT NULL ,
 "USER_NAME" VARCHAR2(255 BYTE) VISIBLE ,
 "PASSWORD" VARCHAR2(255 BYTE) VISIBLE ,
 "NAME" VARCHAR2(255 BYTE) VISIBLE ,
 "AGE" NUMBER(10) VISIBLE ,
 "EMAIL" VARCHAR2(255 BYTE) VISIBLE
)
--創建序列
CREATE SEQUENCE SEQ_USER START WITH 1 INCREMENT BY 1

2.3、jdbc驅動包

由於版權原因，我們不能直接通過maven的中央倉庫下載oracle數據庫的jdbc驅動包，所以我們需要將驅動包安裝到本地倉庫。

#ojdbc8.jar 文件在資料中可以找到
mvn install:install-file -DgroupId=com.oracle -DartifactId=ojdbc8 -Dversion=12.1.0.1 -
Dpackaging=jar -Dfile=ojdbc8.jar

安裝完成后的坐標：

< dependency>
  <groupId>com.oracle</groupId>
  <artifactId>ojdbc8</artifactId>
  <version>12.1.0.1</version>
</dependency>

2.4、修改application.properties

對於application.properties的修改，需要修改2個位置，分別是：

# 數據庫連接配置
spring.datasource.driver-class-name=oracle.jdbc.OracleDriver
spring.datasource.url=jdbc:oracle:thin:@192.168.31.81:1521:xe
spring.datasource.username=system
spring.datasource.password=oracle
#id生成策略
mybatis-plus.global-config.db-config.id-type=input

2.5、配置序列

使用Oracle的序列需要做2件事情：

第一，需要配置MP的序列生成器到Spring容器：

package cn.itcast.mp;
import com.baomidou.mybatisplus.extension.incrementer.OracleKeyGenerator;
import com.baomidou.mybatisplus.extension.plugins.PaginationInterceptor;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
@MapperScan("cn.itcast.mp.mapper") //設置mapper接口的掃描包
public class MybatisPlusConfig {
  /**
  * 分頁插件
  */
  @Bean
  public PaginationInterceptor paginationInterceptor() {
    return new PaginationInterceptor();
 }
  /**
  * 序列生成器
  */
  @Bean
  public OracleKeyGenerator oracleKeyGenerator(){
    return new OracleKeyGenerator();
    }
}

第二，在實體對象中指定序列的名稱：

@KeySequence (value = "SEQ_USER", clazz = Long.class)
public class User{
 ......
}

2.6、測試

package cn.itcast.mp;
import cn.itcast.mp.mapper.UserMapper;
import cn.itcast.mp.pojo.User;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import java.util.List;
@RunWith(SpringRunner.class)
@SpringBootTest
public class UserMapperTest {
  @Autowired
  private UserMapper userMapper;
  @Test
  public void testInsert(){
    User user = new User();
    user.setAge(20);
    user.setEmail("[e-mail]");
    user.setName("曹操");
    user.setUserName("caocao");
    user.setPassword("123456");
    int result = this.userMapper.insert(user); //返回的result是受影響的行數，並不是自增
后的id
    System.out.println("result = " + result);
    System.out.println(user.getId()); //自增后的id會回填到對象中
 }
  @Test
  public void testSelectById(){
    User user = this.userMapper.selectById(8L);
    System.out.println(user);
 }
}

3、插件

3.1、mybatis的插件機制

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

1. Executor (update, query, flushStatements, 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語法構建的處理

攔截器示例：

package cn.itcast.mp.plugins;
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) {
    //屬性設置
 }
}

注入到Spring容器：

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

或者通過xml配置，mybatis-config.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.2、執行分析插件

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

@Bean
public SqlExplainInterceptor sqlExplainInterceptor(){
  SqlExplainInterceptor sqlExplainInterceptor = new SqlExplainInterceptor();
  List<ISqlParser> sqlParserList = new ArrayList<>();
  // 攻擊 SQL 阻斷解析器、加入解析鏈
  sqlParserList.add(new BlockAttackSqlParser());
  sqlExplainInterceptor.setSqlParserList(sqlParserList);
  return sqlExplainInterceptor;
}

測試：

@Test
public void testUpdate(){
  User user = new User();
  user.setAge(20);
  int result = this.userMapper.update(user, null);
  System.out.println("result = " + result);
}

結果：

Caused by: com.baomidou.mybatisplus.core.exceptions.MybatisPlusException: Prohibition
of table update operation
at
com.baomidou.mybatisplus.core.toolkit.ExceptionUtils.mpe(ExceptionUtils.java:49)
at com.baomidou.mybatisplus.core.toolkit.Assert.isTrue(Assert.java:38)
at com.baomidou.mybatisplus.core.toolkit.Assert.notNull(Assert.java:72)
at
com.baomidou.mybatisplus.extension.parsers.BlockAttackSqlParser.processUpdate(BlockAtt
ackSqlParser.java:45)
at
com.baomidou.mybatisplus.core.parser.AbstractJsqlParser.processParser(AbstractJsqlPars
er.java:92)
at
com.baomidou.mybatisplus.core.parser.AbstractJsqlParser.parser(AbstractJsqlParser.java
:67)
at
com.baomidou.mybatisplus.extension.handlers.AbstractSqlParserHandler.sqlParser(Abstrac
tSqlParserHandler.java:76)
at
com.baomidou.mybatisplus.extension.plugins.SqlExplainInterceptor.intercept(SqlExplainI
nterceptor.java:63)
at org.apache.ibatis.plugin.Plugin.invoke(Plugin.java:61)
at com.sun.proxy.$Proxy70.update(Unknown Source)
at
org.apache.ibatis.session.defaults.DefaultSqlSession.update(DefaultSqlSession.java:197
)
... 41 more

可以看到，當執行全表更新時，會拋出異常，這樣有效防止了一些誤操作。

3.3、性能分析插件

性能分析攔截器，用於輸出每條 SQL 語句及其執行時間，可以設置最大執行時間，超過時間會拋出異常。

該插件只用於開發環境，不建議生產環境使用。

配置：

<?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>
    <!-- SQL 執行性能分析，開發環境使用，線上不推薦。 maxTime 指的是 sql 最大執行時長 -->
    <plugin
interceptor="com.baomidou.mybatisplus.extension.plugins.PerformanceInterceptor">
      <property name="maxTime" value="100" />
      <!--SQL是否格式化 默認false-->
      <property name="format" value="true" />
    </plugin>
  </plugins>
</configuration>

執行結果：

Time ：11 ms - ID：cn.itcast.mp.mapper.UserMapper.selectById
Execute SQL：
 SELECT
   id,
   user_name,
   password,
   name,
   age,
   email
 FROM
   tb_user
 WHERE
    id=7

可以看到，執行時間為11ms。如果將maxTime設置為1，那么，該操作會拋出異常

Caused  by: com.baomidou.mybatisplus.core.exceptions.MybatisPlusException: The SQL
execution time is too large, please optimize !
at com.baomidou.mybatisplus.core.toolkit.ExceptionUtils.mpe(ExceptionUtils.java:49)
at com.baomidou.mybatisplus.core.toolkit.Assert.isTrue(Assert.java:38)
................

3.4、樂觀鎖插件

3.4.1、主要適用場景

意圖：
當要更新一條記錄的時候，希望這條記錄沒有被別人更新
樂觀鎖實現方式：

• 取出記錄時，獲取當前 version
• 更新時，帶上這個 version
• 執行更新時， set version = newVersion where version = oldVersion
• 如果 version不對，就更新失敗

3.4.2、插件配置

spring xml：

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

spring boot：

@Bean
public OptimisticLockerInterceptor optimisticLockerInterceptor() {
  return new OptimisticLockerInterceptor();
}

3.4.3、注解實體字段

需要為實體字段添加@Version注解

第一步，為表添加version字段，並且設置初始值為1：

ALTER TABLE `tb_user`
ADD COLUMN `version`  int(10) NULL AFTER `email`;
UPDATE `tb_user` SET `version`='1';

第二步，為User實體對象添加version字段，並且添加@Version注解：

@Version
private Integer version;

3.4.4、測試

測試用例

@Test
public void testUpdate(){
  User user = new User();
  user.setAge(30);
  user.setId(2L);
  user.setVersion(1); //獲取到version為1
  int result = this.userMapper.updateById(user);
  System.out.println("result = " + result);
}

執行日志：

main] [com.baomidou.mybatisplus.extension.parsers.BlockAttackSqlParser]-[DEBUG]
Original SQL: UPDATE tb_user SET age=?,
version=? WHERE id=?  AND version=?
[main] [com.baomidou.mybatisplus.extension.parsers.BlockAttackSqlParser]-[DEBUG]
parser sql: UPDATE tb_user SET age = ?, version = ? WHERE id = ? AND version = ?
[main] [org.springframework.jdbc.datasource.DataSourceUtils]-[DEBUG] Fetching JDBC
Connection from DataSource
[main] [org.mybatis.spring.transaction.SpringManagedTransaction]-[DEBUG] JDBC
Connection [HikariProxyConnection@540206885 wrapping
com.mysql.jdbc.JDBC4Connection@27e0f2f5] will not be managed by Spring
[main] [cn.itcast.mp.mapper.UserMapper.updateById]-[DEBUG] ==> Preparing: UPDATE
tb_user SET age=?, version=? WHERE id=? AND version=?
[main] [cn.itcast.mp.mapper.UserMapper.updateById]-[DEBUG] ==> Parameters:
30(Integer), 2(Integer), 2(Long), 1(Integer)
[main] [cn.itcast.mp.mapper.UserMapper.updateById]-[DEBUG] <==  Updates: 1
[main] [org.mybatis.spring.SqlSessionUtils]-[DEBUG] Closing non transactional
SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@30135202]
result = 1

可以看到，更新的條件中有version條件，並且更新的version為2。
如果再次執行，更新則不成功。這樣就避免了多人同時更新時導致數據的不一致。

3.4.5、特別說明

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

4、Sql注入器

我們已經知道，在MP中，通過AbstractSqlInjector將BaseMapper中的方法注入到了Mybatis容器，這樣這些方法才可以正常執行。
那么，如果我們需要擴充BaseMapper中的方法，又該如何實現呢？
下面我們以擴展findAll方法為例進行學習。

4.1、編寫MyBaseMapper

package cn.itcast.mp.mapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import java.util.List;
public interface MyBaseMapper<T> extends BaseMapper<T> {
  List<T>  findAll();
}

其他的Mapper都可以繼承該Mapper，這樣實現了統一的擴展。
如：

package cn.itcast.mp.mapper;
import cn.itcast.mp.pojo.User;
public interface UserMapper extends MyBaseMapper<User> {
  User findById(Long id);
}

4.2、編寫MySQlInjection

如果直接繼承AbstractSqlInjector的話，原有的BaseMapper中的方法將失效，所以我們選擇繼承DefaultSqlInjector進行擴展。

package cn.itcast.mp.sqlInjector;
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() {
    List<AbstractMethod> methodList = super.getMethodList();
    methodList.add(new FindAll());
   
    // 再擴充自定義的方法
    list.add(new FindAll());
    return methodList;
 }
}

4.3、編寫FindAll

package cn.itcast.mp.sqlInjector;
import com.baomidou.mybatisplus.core.enums.SqlMethod;
import com.baomidou.mybatisplus.core.injector.AbstractMethod;
import com.baomidou.mybatisplus.core.metadata.TableInfo;
import org.apache.ibatis.mapping.MappedStatement;
import org.apache.ibatis.mapping.SqlSource;
public class FindAll extends AbstractMethod {
  @Override
  public MappedStatement injectMappedStatement(Class<?> mapperClass, Class<?>
modelClass, TableInfo tableInfo) {
    String sqlMethod = "findAll";
    String sql = "select * from " + tableInfo.getTableName();
    SqlSource sqlSource = languageDriver.createSqlSource(configuration, sql,
modelClass);
    return this.addSelectMappedStatement(mapperClass, sqlMethod, sqlSource,
modelClass, tableInfo);
 }
}

4.4、注冊到Spring容器

/**
* 自定義SQL注入器
*/
@Bean
public MySqlInjector mySqlInjector(){
  return new MySqlInjector();
}

4.5、測試

@Test
public void testFindAll(){
  List<User> users = this.userMapper.findAll();
  for (User user : users) {
    System.out.println(user);
 }
}

輸出的SQL：

[main] [cn.itcast.mp.mapper.UserMapper.findAll]-[DEBUG]  ==> Preparing: select * from
tb_user
[main] [cn.itcast.mp.mapper.UserMapper.findAll]-[DEBUG] ==> Parameters:
[main] [cn.itcast.mp.mapper.UserMapper.findAll]-[DEBUG] <==   Total: 10

至此，我們實現了全局擴展SQL注入器

5、自動填充功能

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

5.1、添加@TableField注解

@TableField (fill = FieldFill.INSERT) //插入數據時進行填充
private String password;

為password添加自動填充功能，在新增數據時有效。
FieldFill提供了多種模式選擇：

public enum FieldFill {
  /**
  * 默認不處理
  */
  DEFAULT,
  /**
  * 插入時填充字段
  */
  INSERT,
  /**
  * 更新時填充字段
  */
  UPDATE,
  /**
  * 插入和更新時填充字段
  */
  INSERT_UPDATE
}

5.2、編寫MyMetaObjectHandler

package cn.itcast.mp.handler;
import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;
@Component
public class MyMetaObjectHandler implements MetaObjectHandler {
     @Override
  public void insertFill(MetaObject metaObject) {
    Object password = getFieldValByName("password", metaObject);
    if(null == password){
      //字段為空，可以進行填充
      setFieldValByName("password", "123456", metaObject);
   }
 }
  @Override
  public void updateFill(MetaObject metaObject) {
 }
}

5.3、測試

public void testInsert(){
  User user = new User();
  user.setName("關羽");
  user.setUserName("guanyu");
  user.setAge(30);
  user.setEmail("[e-mail]");
  user.setVersion(1);
  int result = this.userMapper.insert(user);
  System.out.println("result = " + result);
}

結果：

6、邏輯刪除

開發系統時，有時候在實現功能時，刪除操作需要實現邏輯刪除，所謂邏輯刪除就是將數據標記為刪除，而並非真正的物理刪除（非DELETE操作），查詢時需要攜帶狀態條件，確保被標記的數據不被查詢到。這樣做的目的就是避免數據被真正的刪除。

MP 就提供了這樣的功能，方便我們使用，接下來我們一起學習下。

6.1、修改表結構

為tb_user表增加deleted字段，用於表示數據是否被刪除，1代表刪除，0代表未刪除

ALTER TABLE `tb_user`
ADD COLUMN `deleted`  int(1) NULL DEFAULT 0 COMMENT '1代表刪除，0代表未刪除' AFTER
`version`;

同時，也修改User實體，增加deleted屬性並且添加@TableLogic注解：

@TableLogic
private Integer deleted;

6.2、配置

application.properties

#  邏輯已刪除值(默認為 1)
mybatis-plus.global-config.db-config.logic-delete-value=1
# 邏輯未刪除值(默認為 0)
mybatis-plus.global-config.db-config.logic-not-delete-value=0

6.3、測試

@Test
public void testDeleteById(){
  this.userMapper.deleteById(2L);
}

執行的SQL：

[main] [cn.itcast.mp.mapper.UserMapper.deleteById]-[DEBUG]  ==> Preparing: UPDATE
tb_user SET deleted=1 WHERE id=? AND deleted=0
[main] [cn.itcast.mp.mapper.UserMapper.deleteById]-[DEBUG] ==> Parameters: 2(Long)
[main] [cn.itcast.mp.mapper.UserMapper.deleteById]-[DEBUG] <==  Updates: 1

測試查詢：

@Test
public void testSelectById(){
  User user = this.userMapper.selectById(2L);
  System.out.println(user);
}

執行的SQL：

[main] [cn.itcast.mp.mapper.UserMapper.selectById]-[DEBUG]  ==> Preparing: SELECT
id,user_name,password,name,age,email,version,deleted FROM tb_user WHERE id=? AND
deleted=0
[main] [cn.itcast.mp.mapper.UserMapper.selectById]-[DEBUG] ==> Parameters: 2(Long)
[main] [cn.itcast.mp.mapper.UserMapper.selectById]-[DEBUG] <==   Total: 0

7、通用枚舉

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

7.1、修改表結構

ALTER TABLE `tb_user`
ADD COLUMN `sex`  int(1) NULL DEFAULT 1 COMMENT '1-男，2-女' AFTER `deleted`;

7.2、定義枚舉

package cn.itcast.mp.enums;
import com.baomidou.mybatisplus.core.enums.IEnum;
import com.fasterxml.jackson.annotation.JsonValue;
public enum SexEnum implements IEnum<Integer> {
  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;
 }
}

7.3、配置

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

7.4、修改實體

private SexEnum sex;

7.5、測試

測試插入數據：

@Test
public void testInsert(){
  User user = new User();
  user.setName("貂蟬");
  user.setUserName("diaochan");
  user.setAge(20);
  user.setEmail("[e-mail]");
  user.setVersion(1);
  user.setSex(SexEnum.WOMAN);
  int result = this.userMapper.insert(user);
  System.out.println("result = " + result);
}

SQL：

[main] [cn.itcast.mp.mapper.UserMapper.insert]-[DEBUG]  ==> Preparing: INSERT INTO
tb_user ( user_name, password, name, age, email, version, sex ) VALUES ( ?, ?, ?, ?, ?,
?, ? )
[main] [cn.itcast.mp.mapper.UserMapper.insert]-[DEBUG] ==> Parameters:
diaochan(String), 123456(String), 貂蟬(String), 20(Integer), [e-mail](String),
1(Integer), 2(Integer)
[main] [cn.itcast.mp.mapper.UserMapper.insert]-[DEBUG] <==  Updates: 1

查詢：

 @Test
  public void testSelectById(){
    User user = this.userMapper.selectById(2L);
    System.out.println(user);
 }

結果：

[main] [cn.itcast.mp.mapper.UserMapper.selectById]-[DEBUG]  ==> Preparing: SELECT
id,user_name,password,name,age,email,version,deleted,sex FROM tb_user WHERE id=? AND
deleted=0
[main] [cn.itcast.mp.mapper.UserMapper.selectById]-[DEBUG] ==> Parameters: 2(Long)
[main] [cn.itcast.mp.mapper.UserMapper.selectById]-[DEBUG] <==   Total: 1
User(id=2, userName=lisi, password=123456, name=李四, age=30, email=[e-mail],
address=null, version=2, deleted=0, sex=女)

從測試可以看出，可以很方便的使用枚舉了。
查詢條件時也是有效的：

 @Test
  public void testSelectBySex() {
    QueryWrapper<User> wrapper = new QueryWrapper<>();
    wrapper.eq("sex", SexEnum.WOMAN);
    List<User> users = this.userMapper.selectList(wrapper);
    for (User user : users) {
      System.out.println(user);
   }
 }

SQL：

[main] [cn.itcast.mp.mapper.UserMapper.selectList]-[DEBUG]  ==> Preparing: SELECT
id,user_name,password,name,age,email,version,deleted,sex FROM tb_user WHERE deleted=0
AND sex = ?
[main] [cn.itcast.mp.mapper.UserMapper.selectList]-[DEBUG] ==> Parameters: 2(Integer)
[main] [cn.itcast.mp.mapper.UserMapper.selectList]-[DEBUG] <==   Total: 3

8、代碼生成器

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

8.1、創建工程

pom.xml：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.1.4.RELEASE</version>
  </parent>
  <groupId>cn.itcast.mp</groupId>
  <artifactId>itcast-mp-generator</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>
</project>

8.2、代碼

package cn.itcast.mp.generator;
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/mp?
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();
 }
}

8.3、測試

代碼已生成：

實體對象：

9、MybatisX快速開發插件

MybatisX 是一款基於 IDEA 的快速開發插件，為效率而生。
安裝方法：打開 IDEA，進入 File -> Settings -> Plugins -> Browse Repositories，輸入 mybatisx 搜索並安裝。
功能：

• Java 與 XML 調回跳轉
• Mapper 方法自動生成 XML