• springboot整合mybatisPlus全技巧（2-常用开发技巧：通用字段插入）

    本系列专题基于 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中我们可以设置一个公共基类。

    1. @Data
    2. public class BaseEntity {
    3.     @TableField
    4.     private Date createDate;
    5.  
    6.     @TableField
    7.     private Date updateDate;
    8.  
    9.     @TableField
    10.     private String createUser;
    11.  
    12.     @TableField
    13.     private String updateUser;
    14. }
    15.

    然后，Device类去继承它。

    1. public class Device extends BaseEntity {
    2.   ...
    3. }

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

    1.4 设置插入和更新规则

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

    1. @Data
    2. public class BaseEntity {
    3.  
    4.     @TableField(value = "create_date", fill = FieldFill.INSERT)
    5.     private Date createDate;
    6.  
    7.     @TableField(value = "update_date", fill = FieldFill.UPDATE)
    8.     private Date updateDate;
    9.  
    10.     @TableField(value = "create_user", fill = FieldFill.INSERT)
    11.     private String createUser;
    12.  
    13.     @TableField(value = "update_user", fill = FieldFill.UPDATE)
    14.     private String updateUser;
    15.  
    16. }

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

    1.5 MpMetaObjectHandler

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

    1. @Component
    2. public class MpMetaObjectHandler implements MetaObjectHandler {
    3.  
    4.     /**
    5.      * 插入时的填充策略
    6.      * @param metaObject
    7.      */
    8.     @Override
    9.     public void insertFill(MetaObject metaObject) {
    10.         this.setFieldValByName("createDate", new Date(), metaObject);
    11.         this.setFieldValByName("createUser", "admin", metaObject);
    12.     }
    13.  
    14.     /**
    15.      * 更新时的填充策略
    16.      * @param metaObject
    17.      */
    18.     @Override
    19.     public void updateFill(MetaObject metaObject) {
    20.         this.setFieldValByName("updateDate", new Date(), metaObject);
    21.         this.setFieldValByName("updateUser", "admin", metaObject);
    22.     }
    23.  
    24. }
    25.

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

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

    1.6 测试

    编写一个测试类：

    1. @SpringBootTest
    2. class DeviceTests {
    3.  
    4.     @Resource
    5.     private DeviceService deviceService;
    6.  
    7.     @Test
    8.     void testInsert() {
    9.         Device device = new Device();
    10.         device.setDeviceId(IdUtil.simpleUUID());
    11.         device.setDeviceName("测试设备");
    12.         device.setDeviceIdentification("设备标识码1");
    13.         device.setStatus(0);
    14.         deviceService.save(device);
    15.     }
    16. }

    运行：

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

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

    1. @Test
    2. void testUpdate() {
    3.     Device device = deviceService.getById(21);
    4.     deviceService.updateById(device);
    5. }

    没问题

    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，一不小心就会陷入这个坑。

    那么，怎么解决呢？

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

    1.   datasource:
    2.     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帮你做了处理。

    1. public class DateTypeHandler extends BaseTypeHandler<Date> {
    2.     public DateTypeHandler() {
    3.     }
    4.  
    5.     public void setNonNullParameter(PreparedStatement ps, int i, Date parameter, JdbcType jdbcType) throws SQLException {
    6.         ps.setTimestamp(i, new Timestamp(parameter.getTime()));
    7.     }
    8.     
    9. }

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

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

    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)

    1. @Data
    2. @ToString(callSuper = true)
    3. @TableName("device_info")
    4. public class Device extends BaseEntity {
    5.  
    6. }

    这样就可以了。

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

    1. @GetMapping("/list")
    2. public List list(){
    3.     List list = deviceService.list();
    4.     System.out.println(list);
    5.     return deviceService.list();
    6. }

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

    1. [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)]
    2. [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)]
    3.

    这是打印出来的时间：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的日期转换格式。

    1. @TableField(value = "create_date", fill = FieldFill.INSERT)
    2. @JsonFormat(pattern = "yyyy-MM-dd",timezone="GMT+8")
    3. private Date createDate;
    4.  
    5. @TableField(value = "update_date", fill = FieldFill.UPDATE)
    6. @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss",timezone="GMT+8")
    7. private Date updateDate;

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

    源码下载

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

  • 相关阅读:
    基于微信小程序的奶茶在线预定点单管理系统
    Flutter基础知识
    AngularJS使用ng-class、ng-style实现动态css样式
    14 卡尔曼滤波及代码实现
    【kafka】docker + 单点kafka部署 + nodejs生产者和消费者
    2.1C#新语法
    JAVA小游戏 “拼图”
    功能解剖学复习题
    数据库系统原理 绪论
    CH1-模型训练优化
  • 原文地址：https://blog.csdn.net/weixin_39570751/article/details/132777016