JPA实体类如何使用复合对象映射同表多个@Column字段

你要的同表字段映射到复合对象的需求，不需要创建独立数据表、也不需要关联查询，直接用JPA标准的@Embeddable+@Embedded注解即可实现，映射后查询性能和字段直接写在User类中完全一致，没有额外开销。

具体修改步骤 #

• 第一步：给Statistics类添加@Embeddable注解，标记该类是可嵌入的值类型，不需要对应独立数据表。
  改完的代码结构如下：

  // 注意导入对应包，旧版本JPA用javax.persistence下的注解即可
  import jakarta.persistence.Embeddable;
  import lombok.NoArgsConstructor;
  
  @Embeddable
  @NoArgsConstructor // Hibernate实例化对象需要无参构造
  public class Statistics {
  
      @Column // 列名映射规则和写在实体类中完全一致，对应user表的实际列名
      private int x;
  
      @Column
      private int y;
  
      // 其余统计相关字段按相同规则写即可
      // ...
  }
  

• 第二步：在User类的stats字段上添加@Embedded注解，标记该字段为嵌入的复合对象，Hibernate会自动把同表对应列的值映射到该对象的字段中。
  改完的代码结构如下：

  import jakarta.persistence.Embedded;
  import jakarta.persistence.Entity;
  import jakarta.persistence.Id;
  import lombok.NoArgsConstructor;
  
  @Entity
  @NoArgsConstructor
  public class User {
  
      @Id
      private long id;
  
      @Column
      private String name;
  
      // 其余User自身的业务字段
      // ...
  
      @Embedded
      private Statistics stats;
  }
  

常见适配说明 #

• 如果Statistics中定义的列名和user表实际列名不一致，或者和User类中其他字段的列名冲突，不需要修改Statistics类的代码，直接在User类的stats字段上通过@AttributeOverrides重写列映射即可，示例：

  @Embedded
  @AttributeOverrides({
      @AttributeOverride(name = "x", column = @Column(name = "stat_x")),
      @AttributeOverride(name = "y", column = @Column(name = "stat_y"))
  })
  private Statistics stats;
  

• 该映射属于值类型映射，不是实体关联，Hibernate生成的查询SQL会直接把stats对应的列和User其他字段一起查询，不会产生join查询，完全满足性能要求。
• 注意不要给Statistics类加@Entity、@Id这类实体专属注解，它不是独立的持久化实体，加了之后会被Hibernate识别为独立实体，要求配置关联关系和对应数据表。

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