Hibernate 5.1中如何基于原生SQL查询定义JPA实体？

你遇到的这种非规范化数据库的关联难题很常见，好在Hibernate提供了@Subselect这个专属注解，让你可以直接基于原生SQL查询映射JPA实体——完全不需要创建数据库视图，也不用修改现有schema。下面我一步步给你讲具体实现：

核心思路：用@Subselect定义「虚拟实体」 #

@Subselect允许你把任意原生SQL查询的结果集作为实体的数据源，相当于在应用层创建了一个虚拟视图。这个实体的行为和普通表映射的实体几乎一致，还能和其他实体正常建立关联。

第一步：定义表C的虚拟规范化实体 #

假设你已经有了表C的复合主键类（如果没有的话先创建），我们可以用@Subselect包装对表C的查询，生成一个适合关联的实体：

// 表C的复合主键类（已有可跳过）
@Embeddable
public class CId implements Serializable {
    private Long aId;
    private Integer quantity;
    private LocalDateTime validFrom;

    // 必须实现equals()、hashCode()，以及对应的getter/setter
}

// 基于SQL查询的虚拟实体CNorm
@Entity
@Subselect("SELECT A_ID, QUANTITY, VALID_FROM, /* 这里添加表C的其他需要字段 */ FROM C")
@Synchronize({"C"}) // 关键：当这个实体被修改时，同步表C的缓存，避免数据不一致
public class CNorm {
    @EmbeddedId
    private CId id;

    // 和表A的多对一关联（保留原有逻辑）
    @ManyToOne
    @JoinColumn(name = "A_ID", insertable = false, updatable = false)
    private A a;

    // 添加其他字段及对应的getter/setter
}

第二步：让表D的实体关联这个虚拟实体 #

现在你可以在D的实体里，通过复合主键的对应字段，和CNorm建立多对一关联：

// 表D的复合主键类（已有可跳过）
@Embeddable
public class DId implements Serializable {
    private Long aId;
    private Integer quantity;
    private LocalDateTime validFrom;
    private Long bId;

    // 同样要实现equals()、hashCode()和getter/setter
}

// 表D的实体
@Entity
@Table(name = "D")
public class D {
    @EmbeddedId
    private DId id;

    // 和CNorm的多对一关联，匹配三个主键字段
    @ManyToOne
    @JoinColumns({
        @JoinColumn(name = "A_ID", referencedColumnName = "A_ID", insertable = false, updatable = false),
        @JoinColumn(name = "QUANTITY", referencedColumnName = "QUANTITY", insertable = false, updatable = false),
        @JoinColumn(name = "VALID_FROM", referencedColumnName = "VALID_FROM", insertable = false, updatable = false)
    })
    private CNorm cNorm;

    // 和表B的多对一关联（保留原有逻辑）
    @ManyToOne
    @JoinColumn(name = "B_ID", insertable = false, updatable = false)
    private B b;

    // 添加其他字段及对应的getter/setter
}

进阶：如果业务不需要VALID_FROM作为关联条件 #

如果你的业务逻辑里，关联C和D时不需要考虑VALID_FROM（虽然它是主键），可以调整@Subselect的SQL，比如取每个A_ID+QUANTITY组合的最新VALID_FROM：

@Subselect("SELECT A_ID, QUANTITY, MAX(VALID_FROM) AS VALID_FROM, /* 其他字段 */ FROM C GROUP BY A_ID, QUANTITY")

这时候你可以把CNorm的主键调整为A_ID+QUANTITY，关联D时只需要匹配这两个字段即可，更贴合业务需求。

注意事项 #

1. @Subselect是Hibernate特有：它不属于JPA标准，但你用的是Hibernate 5.1，完全兼容。
2. 写操作的缓存同步：如果需要对CNorm进行写操作，一定要加上@Synchronize({"C"})，告诉Hibernate更新表C的缓存，否则会出现查询结果不一致的问题。
3. 只读场景更省心：如果这个虚拟实体只用于查询，不需要修改，那可以不用考虑写操作的缓存问题，使用起来更简单。

这种方案完全在应用层解决问题，不需要触碰数据库的任何schema，完美适配你的场景！

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