Entity State Detection Strategies

  • @Id-Property 检查(默认):如果实体的 ID 属性为 null 或 0(对于基本类型),则实体被认为是新的。

  • @Version-Property 检查:如果带有 @Version 注释的属性存在且为 null,或者对于基本类型的版本属性为 0,则实体被认为是新的。

  • 实现 Persistable:如果实体实现了 Persistable,Spring Data 将委托新检测到实体的 isNew(…​) 方法。

  • 提供自定义 EntityInformation 实现:通过创建模块特定存储库工厂的子类并覆盖 getEntityInformation(…​) 方法,可以自定义存储库基本实现中使用的 EntityInformation 抽象。

下表描述了 Spring Data 提供的策略,用于检测实体是否新创建:

Table 1. Options for detection whether an entity is new in Spring Data

@Id-Property inspection (the default)

默认情况下,Spring Data 将检查给定实体的标识符属性。如果标识符属性对于基本类型为 null0,那么该实体将被视为新的。否则,它将被视为不是新的。

@Version-Property inspection

如果存在带 @Version 注释的属性,并且为 null,或者在版本属性为基本类型 0 的情况下,该实体将被视为新的。如果版本属性存在但具有不同的值,则将该实体视为不是新的。如果不存在版本属性,则 Spring Data 将回退到检查标识符属性。

Implementing Persistable

如果实体实现了 Persistable,Spring Data 会将新检测委托给实体的 isNew(…)`方法。有关详细信息,请参阅 JavadocNote: Properties of `Persistable will get detected and persisted if you use AccessType.PROPERTY. To avoid that, use @Transient.

提供自定义 EntityInformation 实现

您可以通过创建模块特定存储库工厂的一个子类并覆盖 getEntityInformation(…) 方法来自定义存储库基本实现中使用的 EntityInformation 抽象。然后您必须将模块特定存储库工厂的自定义实现注册为 Spring bean。请注意,这种情况很少是必需的。