如何确保JPA实体中仅能创建一个Embeddable对象实例？

根本不需要用集合（set/list/map）来映射Embeddable类，直接把Address作为Person实体的单个字段映射即可，这完全符合你“最多仅一个嵌入实例”的要求，且完全基于Embeddable实现，不需要子类实体。

实现代码示例 #

1. 定义Embeddable的Address类

@Embeddable
public class Address {
    private String street;
    private String city;
    private String zipCode;

    // 无参构造器（JPA强制要求）
    public Address() {}

    // 带参构造器、getter/setter方法
    public Address(String street, String city, String zipCode) {
        this.street = street;
        this.city = city;
        this.zipCode = zipCode;
    }

    // 自行补充getter/setter方法
}

2. 在Person实体中直接嵌入单个Address实例

@Entity
public class Person {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String fullName;

    // 直接映射单个Address实例，默认允许为null（若要求必须存在，可添加@NotNull约束）
    @Embedded
    private Address address;

    // 自行补充构造器、getter/setter方法
}

适配遗留数据库表结构 #

如果你的遗留数据库中，Address对应的字段有特定前缀（比如addr_street、addr_city），可以通过@AttributeOverrides指定字段映射：

@Embedded
@AttributeOverrides({
    @AttributeOverride(name = "street", column = @Column(name = "addr_street")),
    @AttributeOverride(name = "city", column = @Column(name = "addr_city")),
    @AttributeOverride(name = "zipCode", column = @Column(name = "addr_zip"))
})
private Address address;

关键说明 #

• 这种方式下，JPA会把Address的字段直接嵌入到Person对应的数据库表中，完全适配遗留RDMS的表结构
• 单个字段的@Embedded映射天然保证最多只有一个Address实例，不存在多实例的可能
• 若要求Address必须存在（不能为null），只需给address字段添加@NotNull注解即可

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