为何@ColumnTransformer中的INET_NTOA函数未生效？

核心原因 #

@ColumnTransformer注解默认仅在**实体直接加载（如findById）**或JPQL查询中生效，Hibernate的Criteria API默认不会自动应用该注解中定义的读取转换逻辑。这是因为CriteriaQuery构建SQL时，会直接引用实体属性对应的数据库列，不会主动注入@ColumnTransformer里的read表达式。

具体解决方法 #

方法1：在CriteriaQuery中手动指定转换函数 #

直接在查询逻辑里对目标列应用INET_NTOA函数，示例代码如下：

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<PrinterEntity> query = cb.createQuery(PrinterEntity.class);
Root<PrinterEntity> root = query.from(PrinterEntity.class);

// 手动添加INET_NTOA转换逻辑
Expression<String> convertedIp = cb.function(
    "INET_NTOA", 
    String.class, 
    root.get("address") // 此处对应数据库中的ip列
);

// 构造查询结果，关联转换后的字段到实体属性
query.select(cb.construct(
    PrinterEntity.class,
    root.get("id"),
    convertedIp,
    root.get("name"),
    // 按需添加其他实体属性
));

List<PrinterEntity> printers = entityManager.createQuery(query).getResultList();

方法2：用@Formula替代@ColumnTransformer（适配Criteria场景） #

如果希望转换逻辑自动生效，可使用Hibernate专属的@Formula注解，它会在所有查询场景下自动生成对应SQL表达式：

@Entity
@Table(name = "printer")
public class PrinterEntity {
    // 其他属性...
    
    @Formula("INET_NTOA(ip)")
    private String address;

    // 写入时的转换逻辑通过属性设置方法处理
    @Column(name = "ip")
    private Integer ipValue;

    public void setAddress(String address) {
        this.address = address;
        // 自行实现字符串IP转整数的工具方法
        this.ipValue = IpConverter.stringToInt(address); 
    }
}

注：@Formula是Hibernate专属注解，若需保持JPA标准兼容性，优先选择方法1。

方法3：自定义Hibernate类型（长期优雅方案） #

实现自定义Hibernate类型封装IP地址的读写转换，无论哪种查询方式都能自动生效：

1. 实现UserType接口：

public class IpAddressType implements UserType {
    @Override
    public int[] sqlTypes() {
        return new int[]{Types.INTEGER};
    }

    @Override
    public Class<String> returnedClass() {
        return String.class;
    }

    // 读取时：数据库整数转IP字符串
    @Override
    public Object nullSafeGet(ResultSet rs, String[] names, SharedSessionContractImplementor session, Object owner) throws SQLException {
        Integer ipInt = rs.getInt(names[0]);
        return rs.wasNull() ? null : InetAddress.getByAddress(ByteBuffer.allocate(4).putInt(ipInt).array()).getHostAddress();
    }

    // 写入时：IP字符串转数据库整数
    @Override
    public void nullSafeSet(PreparedStatement st, Object value, int index, SharedSessionContractImplementor session) throws SQLException {
        if (value == null) {
            st.setNull(index, Types.INTEGER);
            return;
        }
        String ipStr = (String) value;
        byte[] bytes = InetAddress.getByName(ipStr).getAddress();
        int ipInt = ByteBuffer.wrap(bytes).getInt();
        st.setInt(index, ipInt);
    }

    // 其余方法（deepCopy、isMutable等）按需实现默认逻辑即可
}

2. 在实体中使用自定义类型：

@Entity
@Table(name = "printer")
public class PrinterEntity {
    // 其他属性...
    
    @Column(name = "ip")
    @Type(type = "com.yourpackage.IpAddressType")
    private String address;
}

内容的提问来源于stack exchange，提问作者Cardinal System