MyBatis-Plus中Kotlin自动填充字段的类型匹配注意事项

在使用MyBatis-Plus的自动填充功能时，Kotlin开发者可能会遇到一个常见的陷阱——原始类型与包装类型的匹配问题。本文将深入分析这个问题及其解决方案。

问题现象

当开发者按照常规方式配置自动填充时，例如：

@TableField(fill = FieldFill.INSERT, updateStrategy = FieldStrategy.NEVER)
var createdAt: Long? = null

@TableField(fill = FieldFill.INSERT_UPDATE)
var updatedAt: Long? = null

并实现MetaObjectHandler：

override fun insertFill(metaObject: MetaObject?) {
    strictInsertFill(metaObject, "createdAt", Long::class.java, System.currentTimeMillis() / 1000)
    strictInsertFill(metaObject, "updatedAt", Long::class.java, System.currentTimeMillis() / 1000)
}

会发现自动填充功能并未按预期工作，字段值没有被填充。

根本原因

这个问题源于Kotlin与Java类型系统的差异以及MyBatis-Plus的严格类型检查机制：

1. Kotlin中的Long::class.java对应的是Java的原始类型long.class
2. 实体类中声明的是可空类型Long?，对应Java的包装类型java.lang.Long
3. MyBatis-Plus的strictFill方法会严格检查类型匹配，原始类型与包装类型被视为不同类型

解决方案

正确的做法是使用Long::class.javaObjectType来获取包装类型：

override fun insertFill(metaObject: MetaObject?) {
    strictInsertFill(metaObject, "createdAt", Long::class.javaObjectType, System.currentTimeMillis() / 1000)
    strictInsertFill(metaObject, "updatedAt", Long::class.javaObjectType, System.currentTimeMillis() / 1000)
}

类型匹配原则

在Kotlin中使用MyBatis-Plus自动填充时，需要遵循以下类型匹配原则：

1. 对于基本类型（如Int、Long等）的可空版本：

   • 使用Xxx::class.javaObjectType获取包装类型
   • 例如：Int::class.javaObjectType对应java.lang.Integer

2. 对于非基本类型或明确使用Java类的场景：

   • 直接使用对应的Java类引用
   • 例如：String::class.java或LocalDateTime::class.java

最佳实践

1. 在Kotlin中定义实体类时，建议使用可空类型（如Long?）以获得更好的空安全支持
2. 实现MetaObjectHandler时，注意匹配实体字段的实际Java类型
3. 对于所有基本类型的包装版本，统一使用javaObjectType获取类型引用
4. 在团队开发中，可以将这些注意事项纳入编码规范

总结

Kotlin与Java的类型系统差异可能导致MyBatis-Plus自动填充功能失效。理解Kotlin中原始类型与包装类型的区别，并正确使用javaObjectType获取类型引用，是解决这类问题的关键。通过遵循本文提出的解决方案和最佳实践，开发者可以避免这类陷阱，确保自动填充功能正常工作。