9、公共字段自動填充

上一節咱們學習了mybatis-plus 的自定義全局操做和全局sql注入,這一節咱們來學習一下mybatis-plus 的公共字段自動填充。

一、元數據處理器接口——MetaObjectHandler

要實現公共字段自動填充的填充功能，咱們實現MetaObjectHandler來定義一個自定義公共字段填充器，並實現 insertFill(MetaObject metaObject)和 updateFill(MetaObject metaObject) 方法。

metaobject: 元對象，是 Mybatis 提供的一個用於更加方便，更加優雅的訪問對象的屬性,給對象的屬性設置值 的一個對象. 還會用於包裝對象. 支持對 Object 、 Map、 Collection等對象進行包裝本質上 metaObject 獲取對象的屬性值或者是給對象的屬性設置值，最終是要經過 Reflector 獲取到屬性的對應方法的 Invoker, 最終 invoke。

二、開發步驟

首先按照快速開始——Spring集成Mybatis-Plus一節的操做，新建一個mp08 的 Module,能夠將mp02中resources的內容所有複製過來。

2.一、 註解填充字段 @TableFile(fill = FieldFill.INSERT) 查看 FieldFill

在com.mp.beans目錄下新建一個 Employee實體類，使用 @TableField 添加字段自動填充註解：

* mybatis-plus默認會使用實體類的小寫類名做爲表名
 *
 * 繼承 Model 類，開啓AR模式
 */
@Data
@ToString
@NoArgsConstructor
@AllArgsConstructor
@TableName("tbl_employee")
public class Employee extends Model<Employee> {

    private Integer id;
    private String lastName;
    private String email;

    /**
     * 添加字段自動填充註解
     */
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private Integer gender;

    private Integer age;

    @Override
    protected Serializable pkVal() {
        return this.id;
    }
}
複製代碼

在 com.mp.mapper路徑下新建一個mapper，爲了方便咱們一會測試：

public interface EmployeeMapper extends BaseMapper<Employee> {
}
複製代碼

2.二、 自定義公共字段填充處理器

在 com.mp.handler 目錄下新建一個 MyMetaObjectHandler處理器類：

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {

    private static final Logger LOGGER = LoggerFactory.getLogger(MyMetaObjectHandler.class);

    @Override
    public void insertFill(MetaObject metaObject) {
        LOGGER.info("start insert fill ....");
        Object gender = this.getFieldValByName("gender", metaObject);
        if (gender == null) {
            //避免使用metaObject.setValue()
            this.setFieldValByName("gender", 1, metaObject);
        }
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        Object gender = this.getFieldValByName("gender", metaObject);
        if (gender == null) {
            LOGGER.info("start update fill ....");
            this.setFieldValByName("gender", 0, metaObject);
        }
    }
}
複製代碼

注意:實現MetaObjectHandler來定義一個自定義公共字段填充器，並實現 insertFill(MetaObject metaObject)和 updateFill(MetaObject metaObject) 方法。getFieldValByName 和 setFieldValByName 的第一個參數是咱們須要自動填充的字段。

2.三、 MP 全局注入 自定義公共字段填充處理器

修改 applicationContext.xml 文件，添加以下配置：

<!-- mp08 公共字段填充器-->
<bean id="myMetaObjectHandler" class="com.mp.handler.MyMetaObjectHandler"></bean>
複製代碼

<!-- 定義mybatis-plus全局策略配置-->
<bean id="globalConfiguration" class="com.baomidou.mybatisplus.core.config.GlobalConfig">
    <!-- mp08 注入公共字段填充處理 -->
    <property name="metaObjectHandler" ref="myMetaObjectHandler"></property>
</bean>
複製代碼

完整 applicationContext.xml 文件配置以下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xmlns:mybatis-spring="http://mybatis.org/schema/mybatis-spring"
       xsi:schemaLocation="http://mybatis.org/schema/mybatis-spring
        http://mybatis.org/schema/mybatis-spring-1.2.xsd
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-4.0.xsd
        http://www.springframework.org/schema/tx
        http://www.springframework.org/schema/tx/spring-tx-4.0.xsd">

    <!-- 數據源 -->
    <context:property-placeholder location="classpath:db.properties"/>
    <bean id="dataSource"
          class="com.alibaba.druid.pool.DruidDataSource">
        <property name="driverClassName" value="${jdbc.driver}"></property>
        <property name="url" value="${jdbc.url}"></property>
        <property name="username" value="${jdbc.username}"></property>
        <property name="password" value="${jdbc.password}"></property>
    </bean>

    <!-- 事務管理器 -->
    <bean id="dataSourceTransactionManager"
          class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"></property>
    </bean>
    <!-- 基於註解的事務管理 -->
    <tx:annotation-driven
            transaction-manager="dataSourceTransactionManager"/>

    <!-- 配置 SqlSessionFactoryBean
        mybatis提供的：org.mybatis.spring.SqlSessionFactoryBean
        mybatis-plus提供的：3.2.0 com.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean
                2.3 com.baomidou.mybatisplus.spring.MybatisSqlSessionFactoryBean
     -->
    <bean id="sqlSessionFactoryBean"
          class="com.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean">
        <!-- 數據源 -->
        <property name="dataSource" ref="dataSource"></property>
        <property name="configLocation" value="classpath:mybatis-config.xml"></property>
        <!-- 別名處理 -->
        <property name="typeAliasesPackage" value="com.mp.beans"></property>
        <!-- 注入配置-->
        <!--<property name="configuration" ref="configuration"></property>-->
        <!-- 注入全局配置策略-->
        <property name="globalConfig" ref="globalConfiguration"></property>

        <property name="plugins">
            <!-- 分頁查詢插件 -->
            <bean id="paginationInterceptor" class="com.baomidou.mybatisplus.extension.plugins.PaginationInterceptor">
                <property name="dialectType" value="mysql" />
            </bean>
        </property>

    </bean>

    <!--這個等於Mybatis的全局配置文件，若是在MybatisSqlSessionFactoryBean裏面已經配置了configLocation屬性（外部加載Mybatis全局配置文件），就不能再配置configuration屬性-->
    <bean id="configuration" class="com.baomidou.mybatisplus.core.MybatisConfiguration">
        <!--開啓駝峯命名-->
        <property name="mapUnderscoreToCamelCase" value="true"/>
        <!--日誌打印SQL語句-->
        <property name="logImpl" value="org.apache.ibatis.logging.log4j.Log4jImpl"></property>

    </bean>

    <!-- 定義mybatis-plus全局策略配置-->
    <bean id="globalConfiguration" class="com.baomidou.mybatisplus.core.config.GlobalConfig">
        <!-- 全局主鍵策略-->
        <property name="dbConfig" ref="dbConfig"></property>

        <!-- mp08 注入公共字段填充處理 -->
        <property name="metaObjectHandler" ref="myMetaObjectHandler"></property>
    </bean>
    <!-- 這裏-->
    <bean id="dbConfig" class="com.baomidou.mybatisplus.core.config.GlobalConfig$DbConfig">
        <!-- 全局表主鍵生成策略 -->
        <property name="idType" value="AUTO"></property>
        <!-- 全局的表前綴策略配置 -->
        <property name="tablePrefix" value="tbl_"></property>
    </bean>

    <!-- mp08 公共字段填充器-->
    <bean id="myMetaObjectHandler" class="com.mp.handler.MyMetaObjectHandler"></bean>

    <!--
    配置 mybatis 掃描 mapper 接口的路徑
    -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage"
                  value="com.mp.mapper"></property>
    </bean>
</beans>
複製代碼

2.四、測試

在 com.mp.test下添加測試類 TestMp：

public class TestMp {
    private ApplicationContext ioc = new
            ClassPathXmlApplicationContext("applicationContext.xml");

    private EmployeeMapper employeeMapper = ioc.getBean("employeeMapper", EmployeeMapper.class);

    /**
     * 測試公共填充字段
     */
    @Test
    public void testFillMetaInfo(){
        Employee employee = new Employee();
        employeeMapper.insert(employee);
    }
}
複製代碼

完成上面的操做後，mp08的代碼結構以下所示：

至此，基於 mybatis-plus 的公共字段自動填充演示就完成了,下面咱們就能夠進入到z最後一節使用Idea 快速開發插件的學習了。

源代碼

相關示例完整代碼：mybatis-plus-in-action