本系列专题基于 springboot 整合 mybatisPlus 的各种文章早已烂大街的背景下，根据 整合过程，MP开发中的常见技巧，MP开发中遇到的各种坑 三个方面，来对这一专题做一个全面且实用的总结，基本上只要你吃透这篇文章，开发中关于mybatisplus你能遇到的问题都能迎刃而解了。

MP开发中的常见技巧

1.通用字段注入

我们的数据库表经常会有一些默认字段，比如创建人，创建时间，更新人，更新时间。我们如果每次都在代码中手动设置这些通用的属性就很麻烦，所以，MybatisPlus给我们提供了通用字段注入的方法，解决了这个问题。

1.1 加字段

我们添加三个字段：

注意： MySQL中的DATE和DATETIME数据类型在存储日期和时间信息时有一些区别。

DATE数据类型用于存储日期，它只包含日期部分，不包括时间部分。例如，它可以存储像"2023-07-19"这样的日期。

DATETIME数据类型用于存储日期和时间，它包含日期和时间两部分。例如，它可以存储像"2023-07-19 15:30:00"这样的日期和时间。DATETIME可以表示从1000年1月1日到9999年12月31日之间的任何日期和时间。

因此，DATE和DATETIME的主要区别在于是否包含时间信息。如果只需要存储日期，可以使用DATE；如果需要在日期上存储时间信息，则应使用DATETIME。

1.2 设置公共Entity

对于这些通用字段，在java中我们可以设置一个公共基类。

@Data
public class BaseEntity {
    @TableField
    private Date createDate;

    @TableField
    private Date updateDate;

    @TableField
    private String createUser;

    @TableField
    private String updateUser;
}

然后，Device类去继承它。

public class Device extends BaseEntity {
  ...
}

这样做的好处就是不用每次都写重复的字段了。

1.4 设置插入和更新规则

这些公共字段都是希望默认更新的，所以要配置更新和插入规则。

@Data
public class BaseEntity {

    @TableField(value = "create_date", fill = FieldFill.INSERT)
    private Date createDate;

    @TableField(value = "update_date", fill = FieldFill.UPDATE)
    private Date updateDate;

    @TableField(value = "create_user", fill = FieldFill.INSERT)
    private String createUser;

    @TableField(value = "update_user", fill = FieldFill.UPDATE)
    private String updateUser;

}

@TableField 注解有一个 fill 属性，我们通过 INSERT 和 UPDATE 来设配置更新或者插入的时机。

1.5 MpMetaObjectHandler

添加一个处理器，用来声明默认插入的值。

@Component
public class MpMetaObjectHandler implements MetaObjectHandler {

    /**
     * 插入时的填充策略
     * @param metaObject
     */
    @Override
    public void insertFill(MetaObject metaObject) {
        this.setFieldValByName("createDate", new Date(), metaObject);
        this.setFieldValByName("createUser", "admin", metaObject);
    }

    /**
     * 更新时的填充策略
     * @param metaObject
     */
    @Override
    public void updateFill(MetaObject metaObject) {
        this.setFieldValByName("updateDate", new Date(), metaObject);
        this.setFieldValByName("updateUser", "admin", metaObject);
    }

}

这是一个Java类，名为MpMetaObjectHandler，它实现了MetaObjectHandler接口。从代码中可以看出，这个类主要定义了插入（insert）和更新（update）时的填充策略。

具体来说，当对象被插入或更新时，这个类中的insertFill和updateFill方法会被调用。这两个方法分别用于设置创建时间（createTime）、创建用户（createUser）、更新时间（updateTime）和更新用户（updateUser）这四个字段的值。

1.6 测试

编写一个测试类：

@SpringBootTest
class DeviceTests {

    @Resource
    private DeviceService deviceService;

    @Test
    void testInsert() {
        Device device = new Device();
        device.setDeviceId(IdUtil.simpleUUID());
        device.setDeviceName("测试设备");
        device.setDeviceIdentification("设备标识码1");
        device.setStatus(0);
        deviceService.save(device);
    }
}

运行：

创建日期和创建人成功注入了。

再来测试一下更新，刚才的id是21，就更新一下21。

@Test
void testUpdate() {
    Device device = deviceService.getById(21);
    deviceService.updateById(device);
}

没问题

1.7 关于UTC时区的大坑

注意，关于时间这里有个坑。其实我在写这篇文章的时候，时间是2023-09-06 14点，而创建时间和更新时间都不对。不信你可以看上面的图。

因为在之前的配置里面，我们设置了jdbc的连接时区为：serverTimezone=UTC，UTC（世界标准时间），而北京时间比UTC时间早8小时，即UTC+08:00，所以我们java里面 new Date() 出来的时间和存进MySQL的时间会出现不一致的情况。

MySQL所在服务器的时间是

select @@global.time_zone,@@session.time_zone;

意思就是跟随系统，如果MySQL服务器的时区和Java服务器设置的JDBC连接时区不一致，就会出现这个大坑。

网上很多都是教你写的serverTimezone=UTC，一不小心就会陷入这个坑。

那么，怎么解决呢？

如果你做的项目数据库不在国外的话，我们只需要不配置时区，或者配置上海时区就行了。

  datasource:
    url: jdbc:mysql://localhost:3306/demo?useUnicode=true&characterEncoding=utf8

因为不配置时区就默认跟随系统了，倒也没问题。如果要配置时区，就写上海吧。

&serverTimezone=Asia/Shanghai

1.8 date，datetime类型对应的Java类型

在MySQL中，date类型的字段是没有时分秒的，而datetime类型有时分秒。

我们在java中都用java.util.Date即可。

java.util.Date 对象可以插入到 MySQL 中的 datetime 类型字段中。在 JDBC 中，MySQL 的驱动程序会自动将 java.util.Date 对象转换为 MySQL 的日期和时间格式。

这个转换，其实就是把Date类型，不管你是java.util.Date还是java.sql.Date，甚至是TimeStamp类型，都会转成具体的TimeStamp。

原因是mybatis内部的DateTypeHandler帮你做了处理。

public class DateTypeHandler extends BaseTypeHandler<Date> {
    public DateTypeHandler() {
    }

    public void setNonNullParameter(PreparedStatement ps, int i, Date parameter, JdbcType jdbcType) throws SQLException {
        ps.setTimestamp(i, new Timestamp(parameter.getTime()));
    }
    
}

从源码中可以看出，如果你不指定对应的jdbcType，就会调用你传进来的日期的getTime方法，然后new一个TimeStamp来。

public static void main(String[] args) {
    System.out.println(new Timestamp(new Date().getTime()));
}

Timestamp toString之后，就是一个日期的字符串：

2023-09-06 15:26:44.438

这个玩意是可以直接存到mysql的。

不信你看：

UPDATE device_info set update_date = '2023-09-06 15:26:44.438' where id = 21

真相大白，原来最终指定的sql，就是一个字符串啊。

从mybatis打印的日志也可以看出这一点：

1.9 你以为就到此结束了吗

你以为就到此结束了吗，嘿嘿，其实代码写到这里，还有一个大坑呢。

看一下数据库里面存的时间，嗯，是对的。

之前我们改时区可以保证存入数据库的是正确的，但是查询得到的也正确吗？

来个小tips，Device类因为继承了父类BaseEntity，而我们用了lombok后，@Data并不能保证toString方法也继承父类。

所以，咱还得加上@ToString(callSuper = true)

@Data
@ToString(callSuper = true)
@TableName("device_info")
public class Device extends BaseEntity {

}

这样就可以了。

ok，接下来我们改造一下list方法。

@GetMapping("/list")
public List<Device> list(){
    List<Device> list = deviceService.list();
    System.out.println(list);
    return deviceService.list();
}

访问：http://localhost:8080/v1/device/list

[Device(super=BaseEntity(createDate=Wed Sep 06 00:00:00 CST 2023, updateDate=Wed Sep 06 16:23:31 CST 2023, createUser=admin, updateUser=admin), id=21, deviceName=测试设备, deviceIdentification=设备标识码1, deviceId=77060c476f144ef39a38a335fddaf7c3, status=0)]
[Device(super=BaseEntity(createDate=Wed Sep 06 00:00:00 CST 2023, updateDate=Wed Sep 06 16:23:31 CST 2023, createUser=admin, updateUser=admin), id=21, deviceName=测试设备, deviceIdentification=设备标识码1, deviceId=77060c476f144ef39a38a335fddaf7c3, status=0)]

这是打印出来的时间：updateDate=Wed Sep 06 16:23:31 CST 2023 没问题，和数据库是一致的。

然而，返回到前台就变成了：

[{"createDate":"2023-09-05T16:00:00.000+00:00","updateDate":"2023-09-06T08:23:31.000+00:00","createUser":"admin","updateUser":"admin","id":21,"deviceName":"测试设备","deviceIdentification":"设备标识码1","deviceId":"77060c476f144ef39a38a335fddaf7c3","status":0}]

第一次看到这个结果，我是震惊的。

为什么我在controller打印出来的时间都是对的，可返回到前台就慢了8小时呢？

揭秘：springboot中对加了@RestController或者@Controller+@ResponseBody注解的方法的返回值默认是Json格式，对date类型的数据，在返回浏览器端时，会被springboot默认的Jackson框架转换，而Jackson框架默认的时区GMT（相对于中国是少了8小时）。所以最终返回到前端结果是相差8小时。

知道了原因，怎么解决呢？

一种最简单的方法就是，把Date类型转换位String类型，再返回。

可以是可以，但是总觉得不太好。

另一种办法，也是我比较推荐的，设置json的日期转换格式。

@TableField(value = "create_date", fill = FieldFill.INSERT)
@JsonFormat(pattern = "yyyy-MM-dd",timezone="GMT+8")
private Date createDate;

@TableField(value = "update_date", fill = FieldFill.UPDATE)
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone="GMT+8")
private Date updateDate;

这样就可以了，这个问题本质是因为json默认时区比北京时间慢了8小时所致，所以加上这8小时即可。

源码下载

https://gitee.com/skyblue0678/springboot-demo