Hibernate @ManyToOne关联实现大小写不敏感的方案咨询

问题背景 #

现有两张Oracle表：

TABLE_1
-------
CODE_TABLE_1  | LIBEL_TABLE_1
-----------------------------
code_table_1.1| libel_table_1.1
code_table_1.2| libel_table_1.2
code_table_1.3| libel_table_1.3

TABLE_2
-------
CODE_TABLE_2  | LIBEL_TABLE_2    |  CODE_TABLE_1
----------------------------------------------
code_table_2.1| libel_table_2.1  | CODE_TABLE_1.1
code_table_2.2| libel_table_2.2  | CODE_TABLE_1.2
code_table_2.3| libel_table_2.3  | CODE_TABLE_1.3

两表无外键约束，但TABLE_2.CODE_TABLE_1引用TABLE_1.CODE_TABLE_1，且TABLE_2中该字段值始终为大写，TABLE_1中为小写。

现有Hibernate实体代码如下，但因大小写差异，关联无法正常工作：

@Table(name = "TABLE_1")
@Entity
@Data
public class Table1{

    @Id
    @Column(name = "CODE_TABLE_1")
    private String codeTable1;

    @Column(name = "LIBEL_TABLE_1")
    private String libeleTable1;
}

@Table(name = "TABLE_2")
@Entity
@Data
public class Table2{

    @Id
    @Column(name = "CODE_TABLE_2")
    private String codeTable2;

    @Column(name = "LIBEL_TABLE_2")
    private String libeleTable2;

    @ManyToOne
    @JoinColumn(name = "CODE_TABLE_1", referencedColumnName = "CODE_TABLE_1")
    private Table1 table1;
}

无法修改源表数据，需要让Hibernate关联实现大小写不敏感。

解决方案 #

方法1：使用@JoinFormula定义大小写不敏感的关联 #

直接在@ManyToOne关联中通过@JoinFormula，利用Oracle的UPPER()函数将两边字段统一转换为大写后匹配：

@Table(name = "TABLE_2")
@Entity
@Data
public class Table2{
    // 其他字段不变

    @ManyToOne
    @JoinFormula(
        value = "(UPPER(CODE_TABLE_1))",
        referencedColumnName = "(UPPER(CODE_TABLE_1))"
    )
    private Table1 table1;
}

这种方式直接修改关联的匹配逻辑，Hibernate在加载关联数据时会自动执行大小写转换后的匹配，无需额外处理查询语句。

方法2：自定义字段转换器（AttributeConverter） #

给Table1的主键字段添加转换器，将数据库读取到的小写值转换为大写，让实体中的字段值与Table2的大写值一致：

1. 实现转换器类：

@Converter(autoApply = false)
public class CaseInsensitiveConverter implements AttributeConverter<String, String> {
    @Override
    public String convertToDatabaseColumn(String attribute) {
        // 不修改源数据，直接返回原属性值
        return attribute;
    }

    @Override
    public String convertToEntityAttribute(String dbData) {
        // 读取数据库值时转为大写
        return dbData != null ? dbData.toUpperCase() : null;
    }
}

2. 在Table1的主键字段上应用转换器：

@Table(name = "TABLE_1")
@Entity
@Data
public class Table1{

    @Id
    @Column(name = "CODE_TABLE_1")
    @Convert(converter = CaseInsensitiveConverter.class)
    private String codeTable1;

    // 其他字段不变
}

这种方式会统一处理Table1实体中codeTable1字段的大小写，所有读取该实体的操作都会得到大写的主键值，自然能和Table2的关联字段匹配。

方法3：查询时手动处理大小写（适合临时场景） #

如果只是特定查询需要关联，可以在HQL/JPQL中手动使用UPPER()函数实现匹配：

String hql = "SELECT t2 FROM Table2 t2 JOIN Table1 t1 ON UPPER(t2.codeTable1) = UPPER(t1.codeTable1) WHERE t2.codeTable2 = :code";
List<Table2> result = entityManager.createQuery(hql, Table2.class)
    .setParameter("code", "code_table_2.1")
    .getResultList();

这种方式无需修改实体映射，但每次需要关联查询时都要手动编写转换逻辑，适合临时或特殊查询场景。

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