本文旨在解决Spring Boot JPA项目中，当多个实体类继承自同一个基类时，如何实现每个实体类拥有独立的自增长ID序列。文章将深入探讨GenerationType.AUTO策略的默认行为，并提供使用SEQUENCE和IDENTITY策略的解决方案，以及选择合适的ID生成策略时需要考虑的关键因素。
在Spring Boot JPA项目中，使用@MappedSuperclass定义基类实体，并让其他实体类继承，是一种常见的代码复用方式。然而，当基类包含@Id和@GeneratedValue注解的ID字段时，可能会遇到所有实体类共享同一个ID生成序列的问题。例如，User实体和Contact实体都继承自BaseEntity，它们的ID值会递增，而不是各自独立递增。本文将探讨如何解决这个问题，确保每个实体类拥有独立的ID生成序列。
理解 GenerationType.AUTO 的默认行为
当使用@GeneratedValue(strategy = GenerationType.AUTO)时，JPA实现（通常是Hibernate）会根据底层数据库的特性选择合适的ID生成策略。Hibernate默认使用SEQUENCE策略，这意味着它会使用一个共享的数据库序列来生成所有实体类的ID。这就是导致不同实体类ID递增的原因。
解决方案一：为每个实体指定独立的 SEQUENCE
如果希望继续使用序列生成ID，可以为每个实体类指定独立的序列名称。这可以通过@SequenceGenerator注解来实现。
import javax.persistence.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.hibernate.annotations.CreationTimestamp;
import org.hibernate.annotations.UpdateTimestamp;
import java.util.Date;
@MappedSuperclass
@AllArgsConstructor
@NoArgsConstructor
@Data
public abstract class BaseEntity {
@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "entity_sequence")
@Column(name = "objectId", insertable = false, updatable = false)
private long objectId;
@Column(name = "createdDate", updatable = false)
@CreationTimestamp
private Date createdDate;
@Column(name = "updatedDate")
@UpdateTimestamp
private Date updatedDate;
@Column(name = "active", columnDefinition = "boolean default false")
private boolean active;
}
@Entity
@SequenceGenerator(name = "user_sequence", sequenceName = "user_seq", allocationSize = 1)
@Data
@NoArgsConstructor
@AllArgsConstructor
public class User extends BaseEntity {
private String username;
}
@Entity
@SequenceGenerator(name = "contact_sequence", sequenceName = "contact_seq", allocationSize = 1)
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Contact extends BaseEntity {
private String phoneNumber;
}在这个例子中，User实体使用名为user_seq的序列，Contact实体使用名为contact_seq的序列。 @SequenceGenerator 注解定义了序列的名称和序列在数据库中的实际名称（sequenceName）。allocationSize 定义了序列每次增加的步长。
注意： 需要确保数据库中存在相应的序列。例如，对于user_seq和contact_seq，可以使用以下SQL语句创建：
CREATE SEQUENCE user_seq START WITH 1 INCREMENT BY 1; CREATE SEQUENCE contact_seq START WITH 1 INCREMENT BY 1;
解决方案二：使用 GenerationType.IDENTITY
另一种简单的方法是将GenerationType改为IDENTITY。IDENTITY策略依赖于数据库的自增长特性。
import javax.persistence.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.hibernate.annotations.CreationTimestamp;
import org.hibernate.annotations.UpdateTimestamp;
import java.util.Date;
@MappedSuperclass
@AllArgsConstructor
@NoArgsConstructor
@Data
public abstract class BaseEntity {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
@Column(name = "objectId", insertable = false, updatable = false)
private long objectId;
@Column(name = "createdDate", updatable = false)
@CreationTimestamp
private Date createdDate;
@Column(name = "updatedDate")
@UpdateTimestamp
private Date updatedDate;
@Column(name = "active", columnDefinition = "boolean default false")
private boolean active;
}
@Entity
@Data
@NoArgsConstructor
@AllArgsConstructor
public class User extends BaseEntity {
private String username;
}
@Entity
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Contact extends BaseEntity {
private String phoneNumber;
}使用IDENTITY策略，数据库会负责生成唯一的ID，每个实体类都会有自己独立的ID序列。
注意： IDENTITY策略可能不适用于所有数据库，并且在某些情况下可能会影响性能，特别是批量插入操作。
选择合适的 ID 生成策略
选择合适的ID生成策略需要考虑多个因素，包括：
- 数据库支持： 不同的数据库对ID生成策略的支持程度不同。例如，MySQL原生不支持序列，因此Hibernate会回退到使用TABLE策略。
- 性能： 不同的策略在性能上有所差异。IDENTITY策略可能会影响批量插入的性能。
- 可移植性： 如果需要将应用程序移植到不同的数据库，需要选择一个所有数据库都支持的策略。
- 批量插入： 如果需要执行大量的批量插入操作，需要选择一个支持批量插入的策略。
建议仔细阅读Hibernate文档，了解各种ID生成策略的优缺点，并根据具体情况做出选择。可以参考Hibernate User Guide。
总结
本文介绍了在Spring Boot JPA项目中，如何为继承自同一个基类的实体类生成独立的ID序列。通过为每个实体指定独立的SEQUENCE或使用IDENTITY策略，可以解决ID共享的问题。选择合适的ID生成策略需要综合考虑数据库支持、性能、可移植性和批量插入等因素。理解这些概念并根据实际情况做出选择，可以帮助你构建更健壮、更高效的JPA应用程序。
