ObjectLifecyclePublisher

Responsible for collecting and then passing along changes (to the EntityChangeTracker, in persistence commons) so that they can be published; and is responsible for calling the various persistence call-back facets.

this interface should really have been called ObjectLifecycleSubscriber…​

API

ObjectLifecyclePublisher.java
interface ObjectLifecyclePublisher {
  void onPostCreate(ManagedObject domainObject)     (1)
  void onPostLoad(ManagedObject entity)     (2)
  void onPrePersist(Either<ManagedObject, ManagedObject> eitherWithOrWithoutOid)     (3)
  void onPostPersist(ManagedObject entity)     (4)
  void onPreUpdate(ManagedObject entity, Function<ManagedObject, Can<PropertyChangeRecord>> propertyChangeRecordSupplier)     (5)
  void onPostUpdate(ManagedObject entity)     (6)
  void onPreRemove(ManagedObject entity)     (7)
}
1 onPostCreate(ManagedObject)

Independent of the persistence stack, called when an object has been created in-memory, for example by FactoryService and internal ObjectManager .
2 onPostLoad(ManagedObject)

Called by both JPA and JDO, just after an object is retrieved from the database.
3 onPrePersist(Either)

Called by both JPA and JDO, just before an entity is inserted into the database.
4 onPostPersist(ManagedObject)

Called by both JPA and JDO, just after an entity has been inserted into the database.
5 onPreUpdate(ManagedObject, Function)

Called by both JPA and JDO (though JDO does not provide any changeRecords).
6 onPostUpdate(ManagedObject)

Called by both JPA and JDO, after an existing entity has been updated.
7 onPreRemove(ManagedObject)

Called by both JPA and JDO, just before an entity is deleted from the database.

Members

onPostCreate(ManagedObject)

Independent of the persistence stack, called when an object has been created in-memory, for example by FactoryService and internal ObjectManager .

Default implementation fires off callback/lifecycle events.

onPostLoad(ManagedObject)

Called by both JPA and JDO, just after an object is retrieved from the database.

Default implementation calls EntityChangeTracker#recognizeLoaded(ManagedObject) and fires off callback/lifecycle events.

onPrePersist(Either)

Called by both JPA and JDO, just before an entity is inserted into the database.

Default implementation fires callbacks (including emitting the PreStoreEvent , eg as subscribed) by the TimestampService .

onPostPersist(ManagedObject)

Called by both JPA and JDO, just after an entity has been inserted into the database.

Default implementation fires callbacks and enlists the entity within EntityChangeTracker for create/persist.

onPreUpdate(ManagedObject, Function)

Called by both JPA and JDO (though JDO does not provide any changeRecords).

Default implementation fires callbacks and enlists the entity within EntityChangeTracker for update.

onPostUpdate(ManagedObject)

Called by both JPA and JDO, after an existing entity has been updated.

Default implementation fires callbacks.

onPreRemove(ManagedObject)

Called by both JPA and JDO, just before an entity is deleted from the database.

Default implementation fires callbacks and enlists the entity within EntityChangeTracker for delete/remove.