使用Mybatis-Plus实现对象属性自动填充功能

案例场景:在设计一张数据库表的时候,通常会包含下列信息:createBy(创建人)、createTime(创建时间)、updateBy(修改人)、updateTime(修改时间)、otherinfo(其它属性信息)。

在一般的业务逻辑编写过程中,绝大多数的开发工程师都选择根据操作类型(insert/update)来依次调用对应的setXXX方法来设置值。使用setXXX并不是不能达到预期,只是代码实现起来不叫臃肿,而这些字段几乎是通用的字段,是否有统一的方式进行设置呢?

下面以实例的方式告诉大家,如何基于Mybatis-Plus实现固定列自动填充,让你的工作效率提升。

1、引用Mybatis-plus


    
        com.baomidou
        mybatis-plus-boot-starter
        3.0.6
    
    
        com.h2database
        h2
        runtime
    

2、自定义自己的原对象属性填充器,自定义类实现MetaObjectHandler,代码如下:

/**   
 * Copyright © 2019 DBRG. All rights reserved.
 * 
 * @Title: DbrgMetaObjectHandler.java 
 * @Prject: syswms
 * @Package: com.dbrg.project.handler 
 * @version: V1.0   
 */
package com.dbrg.project.handler;

import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;

import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import com.dbrg.common.utils.DateUtils;
import com.dbrg.common.utils.security.ShiroUtils;

/** 
 * @ClassName: DbrgMetaObjectHandler 
 * @Description:元对象自动填充处理器
 * @author: yelangking
 * @date: 2019年3月4日 上午9:14:18  
 */
@Component
public class DbrgMetaObjectHandler implements MetaObjectHandler{
  private static final String CREATE_BY_FIELD_NAME = "createBy";
  private static final String CREATE_TIME_FIELD_NAME = "createTime";
  private static final String UPDATE_BY_FIELD_NAME = "updateBy";
  private static final String UPDATE_TIME_FIELD_NAME = "updateTime";

  /* (non Javadoc) 
   * @Title: insertFill
   * @Description: {简单描述}
   * @param arg0 
   * @see com.baomidou.mybatisplus.core.handlers.MetaObjectHandler#insertFill(org.apache.ibatis.reflection.MetaObject) 
   */
  @Override
  public void insertFill(MetaObject metaObject) {
    //1、自动设置创建人信息,当外部接口调用时,用户可能为空
    if(null != ShiroUtils.getSysUser()){
      this.setFieldValByName(CREATE_BY_FIELD_NAME,ShiroUtils.getUserId(),metaObject);
    }
    //2、自动设置创建时间
    this.setFieldValByName(CREATE_TIME_FIELD_NAME, DateUtils.getNowDate(), metaObject);
    //3、自动设置更新人信息,当外部接口调用时,用户可能为空
    if(null != ShiroUtils.getSysUser()){
      this.setFieldValByName(UPDATE_BY_FIELD_NAME,ShiroUtils.getUserId(),metaObject);
    }
    //4、自动设置更新时间
    this.setFieldValByName(UPDATE_TIME_FIELD_NAME, DateUtils.getNowDate(), metaObject);
  }

  /* (non Javadoc) 
   * @Title: updateFill
   * @Description: {简单描述}
   * @param arg0 
   * @see com.baomidou.mybatisplus.core.handlers.MetaObjectHandler#updateFill(org.apache.ibatis.reflection.MetaObject) 
   */
  @Override
  public void updateFill(MetaObject metaObject) {
    //1、自动设置更新人信息,当外部接口调用时,用户可能为空
    if(null != ShiroUtils.getSysUser()){
      this.setFieldValByName(UPDATE_BY_FIELD_NAME,ShiroUtils.getUserId(),metaObject);
    }
    //2、自动设置更新时间
    this.setFieldValByName(UPDATE_TIME_FIELD_NAME, DateUtils.getNowDate(), metaObject);
  }
}

以上代码实现了自定义的设置入口,分别定义了在insert和update时设置哪些属性的值,程序实际运行时会根据不同的操作类型设置相应的值。

3、在实体类上注入设置填充规则,代码如下:


/**   
 * Copyright © 2019 DBRG. All rights reserved.
 * 
 * @Title: MpBaseEntity.java 
 * @Prject: syswms
 * @Package: com.dbrg.framework.web.domain 
 * @version: V1.0   
 */
package com.dbrg.framework.web.domain;

import java.io.Serializable;
import java.util.Date;

import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.TableField;
import com.fasterxml.jackson.annotation.JsonFormat;

import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;

/** 
 * @ClassName: MpBaseEntity 
 * @Description:mybatis plus 自动注入基类,结合FieledFill策略类一起使用,
 * 默认包含创建人、创建时间、更新人、更新时间信息,业务表单中包含此字段的集成本类即可。如无明确要求,可不做任何处理。
 * @author: yelangking
 * @date: 2019年3月4日 上午9:03:12  
 */
@Setter
@Getter
@NoArgsConstructor
@AllArgsConstructor
public class MpBaseEntity implements Serializable{
  private static final long serialVersionUID = 2234596156219712753L;
  /**
   * 创建人
   */
  @TableField(value="create_by",fill=FieldFill.INSERT)
  private Long createBy;
  /** 创建时间 */
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @TableField(value="create_time",fill=FieldFill.INSERT)
  private Date createTime;
    /**
     * 更新人
     */
    @TableField(value="update_by",fill=FieldFill.INSERT_UPDATE)
    private Long updateBy;
    /**
     * 更新时间
     */
    @TableField(value="update_time",fill=FieldFill.INSERT_UPDATE)
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date updateTime;
}

关键代码: 

@TableField(value="update_time",fill=FieldFill.INSERT_UPDATE),在对象的属性上设置填充规则即可。

4、运行效果,参考官网运行结果。

c.b.samples.metainfo.AutoFillTest : Started AutoFillTest in 9.239 seconds (JVM running for 17.064)
c.b.s.m.handler.MyMetaObjectHandler: start insert fill ....
c.b.s.metainfo.mapper.UserMapper.insert: ==> Preparing: INSERT INTO user ( ID, NAME, AGE, EMAIL, OPERATOR ) VALUES ( ?, ?, ?, ?, ? )
c.b.s.metainfo.mapper.UserMapper.insert: ==> Parameters: 1381223322590720001(Long), Tom(String), 1(Integer), [email protected](String), Jetty(String)
c.b.s.metainfo.mapper.UserMapper.insert: <== Updates: 1
c.b.s.m.mapper.UserMapper.selectById: ==>  Preparing: SELECT ID,NAME,AGE,EMAIL,OPERATOR FROM user WHERE ID=?
c.b.s.m.mapper.UserMapper.selectById: ==> Parameters: 1381223322590720001(Long)
c.b.s.m.mapper.UserMapper.selectById: <== Total: 1
c.b.samples.metainfo.AutoFillTest: query user:User(id=1381223322590720001, name=Tom, age=1, [email protected], operator=Jetty)
c.b.s.m.mapper.UserMapper.selectById: ==> Preparing: SELECT ID,NAME,AGE,EMAIL,OPERATOR FROM user WHERE ID=?
c.b.s.m.mapper.UserMapper.selectById: ==> Parameters: 1(Long)
c.b.s.m.mapper.UserMapper.selectById: <== Total: 1
c.b.samples.metainfo.AutoFillTest: before user:User(id=1, name=Jone, age=18, [email protected], operator=test)
c.b.s.m.handler.MyMetaObjectHandler : start update fill ....
c.b.s.m.mapper.UserMapper.updateById: ==> Preparing: UPDATE user SET NAME=?, AGE=?, EMAIL=?, OPERATOR=? WHERE ID=?
c.b.s.m.mapper.UserMapper.updateById: ==> Parameters: Jone(String), 12(Integer), [email protected](String), test(String), 1(Long)
c.b.s.m.mapper.UserMapper.updateById: <==   Updates: 1

5、综上所述,使用mybatis-plus可以方便快速的进行属性自动填充,最大量的减轻大家的工作量,在你的项目中大胆采用吧,提升开发效率。欢迎添加公众号交流。

你可能感兴趣的:(java,架构,java,mybatis)