Mybatis --- 自定义类型转换

最新推荐文章于 2025-06-04 14:58:35 发布

原创

最新推荐文章于 2025-06-04 14:58:35 发布 · 2.8k 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#Mybatis #自动类型转换

本文介绍了在Mybatis中自定义类型转换的必要性，详细讲解了如何创建自定义转换器，包括接口实现、代码示例以及配置方法。通过在Mapper XML文件中配置或使用注解两种方式来应用自定义转换，同时强调了在使用过程中应注意的配置和声明类型，以避免查询结果为null或类型不匹配的问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Mybatis — 自定义类型转换

前言

在进行数据库增删改查的时候，因为实体类类型和数据库类型不兼容，或者说Mybatis自带的类型转换不够用了，这时候就要自己手动操作了，最常见的就是素组的的操作,根据原有的进行扩展，这样就不用定义一个数组属性，就写一次转换方法。

接口

原生接口org.apache.ibatis.type.TypeHandler<T>

public interface TypeHandler<T> {
   
   
  /**
  用来设置查询参数
  */
  void setParameter(PreparedStatement ps, int i, T parameter, JdbcType jdbcType) throws SQLException;
  /**
  用来将查询结果转换成指定实体类,依旧是返回结果的列名
  */
  T getResult(ResultSet rs, String columnName) throws SQLException;
  /**
  用来将查询结果转换成指定实体类,依旧是返回结果列的顺序号
  */
  T getResult(ResultSet rs, int columnIndex) throws SQLException;
  /**
  用来将查询结果转换成指定实体类,依旧是返回结果列的顺序号,
  只是使用了不同的返回接收接口,写过原生jdbc的应该有印象
  */
  T getResult(CallableStatement cs, int columnIndex) throws SQLException;

}

也可以使用继承的方式扩展，我这里是直接继承 org.apache.ibatis.type.TypeReference<T>,这个可以省很多事情

public abstract class BaseTypeHandler<T> extends TypeReference<T> implements TypeHandler<T> {
   
   

  protected Configuration configuration;

  public void setConfiguration(Configuration c) {
   
   
    this.configuration = c;
  }

  public void setParameter(PreparedStatement ps, int i, T parameter, JdbcType jdbcType) throws SQLException {
   
   
    if (parameter == null) {
   
   
      if (jdbcType == null) {
   
   
        throw new TypeException("JDBC requires that the JdbcType must be specified for all nullable parameters.");
      }
      try {
   
   
        ps.setNull(i, jdbcType.TYPE_CODE);
      } catch (SQLException e) {
   
   
        throw new TypeException("Error setting null for parameter #" + i + " with JdbcType " + jdbcType + " . " +
        		"Try setting a different JdbcType for this parameter or a different jdbcTypeForNull configuration property. " +
        		"Cause: " + e, e);
      }
    } else {
   
   
      setNonNullParameter(ps, i, parameter, jdbcType);
    }