MyBatis中的JdbcType映射使用详解

1. 什么是JdbcType映射

在MyBatis中，默认情况下，MyBatis会自动根据JavaBean属性的类型来映射到对应的JdbcType数据类型。但是在某些情况下，根据JavaBean属性的类型无法满足实际需求，这个时候你可以通过手动进行JdbcType映射。

2. 如何进行JdbcType映射

在MyBatis中可以通过两种方式进行JdbcType映射：全局配置和局部配置。

2.1 全局配置

在mybatis-config.xml文件中配置typeHandlers标签，指定需要进行JdbcType映射的Java类型和对应的JdbcType数据类型。

举个例子，假设需要将Java中的java.time.LocalDateTime类型映射到数据库中的DATE类型，可以在typeHandlers标签中添加以下配置：

<typeHandlers>
  <typeHandler javaType="java.time.LocalDateTime" jdbcType="DATE" />
</typeHandlers>

2.2 局部配置

在Mapper.xml中，可以使用<resultMap>或者<parameterMap>标签，来进行JdbcType映射的局部配置。

举个例子，假设需要将Mapper.xml中的<parameterMap>标签中的java.time.LocalDateTime类型映射到数据库中的DATE类型，可以在<parameterMap>标签中添加以下配置：

<parameterMap id="param" type="com.example.Param">
  <parameter property="startTime" jdbcType="DATE"/>
</parameterMap>

3. JdbcType映射的示例

示例1: LocalDateTime -> Timestamp

假设需要将Java中的java.time.LocalDateTime类型映射到数据库中的Timestamp类型，可以在全局配置文件mybatis-config.xml中添加以下配置：

<typeHandlers>
  <typeHandler javaType="java.time.LocalDateTime" jdbcType="TIMESTAMP" handler="org.apache.ibatis.type.LocalDateTimeTypeHandler" />
</typeHandlers>

或者在Mapper.xml中使用<resultMap>标签进行局部映射，示例如下：

<resultMap id="exampleResultMap" type="com.example.Example">
  <result column="start_time" property="startTime" jdbcType="TIMESTAMP" />
</resultMap>

示例2: String -> Enum

假设需要使用String类型的值来表示以下枚举类型：

public enum Gender {
  MALE,
  FEMALE
}

可以在全局配置文件mybatis-config.xml中添加以下配置：

<typeHandlers>
  <typeHandler handler="org.apache.ibatis.type.EnumTypeHandler" javaType="com.example.Gender" jdbcType="VARCHAR" />
</typeHandlers>