对于最新的稳定版本，请使用 Spring Data Relational 4.0.4！spring-doc.cadn.net.cn

实体回调

Spring Data 基础设施提供了在调用某些方法之前和之后修改实体的钩子。这些所谓的EntityCallback实例提供了一种便捷的方式，以回调风格检查并可能修改实体。
An EntityCallback看起来非常像一个专门的ApplicationListener. 一些 Spring Data 模块会发布特定存储的事件（例如BeforeSaveEvent) 允许修改给定的实体。在某些情况下，例如处理不可变类型时，这些事件可能会引发问题。此外，事件发布依赖于ApplicationEventMulticaster. 如果使用异步方式配置该功能TaskExecutor它可能导致不可预测的结果，因为事件处理可以分叉到线程上。spring-doc.cadn.net.cn

实体回调提供了与同步和响应式 API 的集成点，以确保在处理链中定义明确的检查点按顺序执行，并返回一个可能已被修改的实体或响应式包装类型。spring-doc.cadn.net.cn

实体回调通常按 API 类型进行区分。这种区分意味着同步 API 仅考虑同步实体回调，而响应式实现仅考虑响应式实体回调。spring-doc.cadn.net.cn

实体回调（Entity Callback）API 自 Spring Data Commons 2.2 起引入，是应用实体修改的推荐方式。现有的特定于存储的 ApplicationEvents 仍会在调用已注册的 EntityCallback 实例之前发布。spring-doc.cadn.net.cn

实现实体回调

EntityCallback 通过其泛型类型参数直接与其领域类型相关联。每个 Spring Data 模块通常都提供一组预定义的 EntityCallback 接口，用于覆盖实体的生命周期。spring-doc.cadn.net.cn

EntityCallback 的结构

@FunctionalInterface
public interface BeforeSaveCallback<T> extends EntityCallback<T> {

	/**
	 * Entity callback method invoked before a domain object is saved.
	 * Can return either the same or a modified instance.
	 *
	 * @return the domain object to be persisted.
	 */
	(1)
	T onBeforeSave(T entity, (2)
		String collection); (3)
}

1	`BeforeSaveCallback` 在保存实体之前调用的特定方法。返回一个可能已被修改的实例。
2	持久化之前的实体。
3	一些特定于存储的参数，例如实体所持久化的集合。

响应式 EntityCallback 的结构

@FunctionalInterface
public interface ReactiveBeforeSaveCallback<T> extends EntityCallback<T> {

	/**
	 * Entity callback method invoked on subscription, before a domain object is saved.
	 * The returned Publisher can emit either the same or a modified instance.
	 *
	 * @return Publisher emitting the domain object to be persisted.
	 */
	(1)
	Publisher<T> onBeforeSave(T entity, (2)
		String collection); (3)
}

1	`BeforeSaveCallback` 在订阅时调用的特定方法，在实体保存之前执行。会发出一个可能已被修改的实例。
2	持久化之前的实体。
3	一些特定于存储的参数，例如实体所持久化的集合。

可选的实体回调参数由具体的 Spring Data 模块定义，并从 EntityCallback.callback() 的调用点推断得出。

实现符合您应用程序需求的接口，如下例所示：spring-doc.cadn.net.cn

示例 BeforeSaveCallback

class DefaultingEntityCallback implements BeforeSaveCallback<Person>, Ordered {      (2)

	@Override
	public Object onBeforeSave(Person entity, String collection) {                   (1)

		if(collection == "user") {
		    return // ...
		}

		return // ...
	}

	@Override
	public int getOrder() {
		return 100;                                                                  (2)
	}
}

1	根据您的需求实现的回调。
2	如果存在多个针对同一领域类型的实体回调，则可能对其进行排序。排序遵循最低优先级原则。

注册实体回调

EntityCallback Bean 会被特定于存储的实现类自动发现，前提是它们已在 ApplicationContext 中注册。大多数模板 API 已经实现了 ApplicationContextAware，因此能够访问 ApplicationContext。spring-doc.cadn.net.cn

以下示例说明了一组有效的实体回调注册：spring-doc.cadn.net.cn

示例 EntityCallback Bean 注册

@Order(1)                                                           (1)
@Component
class First implements BeforeSaveCallback<Person> {

	@Override
	public Person onBeforeSave(Person person) {
		return // ...
	}
}

@Component
class DefaultingEntityCallback implements BeforeSaveCallback<Person>,
                                                           Ordered { (2)

	@Override
	public Object onBeforeSave(Person entity, String collection) {
		// ...
	}

	@Override
	public int getOrder() {
		return 100;                                                  (2)
	}
}

@Configuration
public class EntityCallbackConfiguration {

    @Bean
    BeforeSaveCallback<Person> unorderedLambdaReceiverCallback() {   (3)
        return (BeforeSaveCallback<Person>) it -> // ...
    }
}

@Component
class UserCallbacks implements BeforeConvertCallback<User>,
                                        BeforeSaveCallback<User> {   (4)

	@Override
	public Person onBeforeConvert(User user) {
		return // ...
	}

	@Override
	public Person onBeforeSave(User user) {
		return // ...
	}
}

1	`BeforeSaveCallback` 从 `@Order` 注解接收其顺序。
2	`BeforeSaveCallback` 通过实现 `Ordered` 接口来接收其执行顺序。
3	使用 lambda 表达式实现的 `BeforeSaveCallback`。默认情况下无序，并在最后被调用。请注意，通过 lambda 表达式实现的回调不会暴露类型信息，因此使用不可赋值的实体调用这些回调会影响回调的吞吐量。请使用 `class` 或 `enum` 来为回调 bean 启用类型过滤。
4	在单个实现类中组合多个实体回调接口。