14.5.使用自定义转换器覆盖默认映射
要对映射过程进行更细粒度的控制，您可以Converters使用 CassandraConverter实现注册 Spring ，例如 MappingCassandraConverter.
MappingCassandraConverterConverters在尝试映射对象本身之前，首先检查是否有任何 Spring可以处理特定的类。要“劫持” MappingCassandraConverter（可能是为了提高性能或其他自定义映射需求）的正常映射策略，您需要创建 SpringConverter接口的实现并将其注册到MappingCassandraConverter.
14.5.1.使用注册的 Spring 转换器进行保存
您可以在一个过程中将转换和保存结合起来，基本上是使用转换器来进行保存。
以下示例使用 aConverter将Person对象转换为java.lang.String 带有 Jackson 2 的 a：
代码语言：javascript复制class PersonWriteConverter implements Converter<Person, String> {
public String convert(Person source) {
try {
return new ObjectMapper().writeValueAsString(source);
} catch (IOException e) {
throw new IllegalStateException(e);
}
}
}14.5.2.使用 Spring 转换器读取
与结合保存和转换的方式类似，您也可以结合阅读和转换。
以下示例使用 aConverter将 ajava.lang.String转换为PersonJackson 2的对象：
代码语言：javascript复制class PersonReadConverter implements Converter<String, Person> {
public Person convert(String source) {
if (StringUtils.hasText(source)) {
try {
return new ObjectMapper().readValue(source, Person.class);
} catch (IOException e) {
throw new IllegalStateException(e);
}
}
return null;
}
}14.5.3.注册 Spring 转换器CassandraConverter
Spring Data for Apache Cassandra Java 配置提供了一种注册 SpringConverter实例的便捷方法： MappingCassandraConverter. 以下配置片段显示了如何手动注册转换器以及配置CustomConversions：
代码语言：javascript复制@Configuration
public class ConverterConfiguration extends AbstractCassandraConfiguration {
@Override
public CassandraCustomConversions customConversions() {
List<Converter<?, ?>> converters = new ArrayList<>();
converters.add(new PersonReadConverter());
converters.add(new PersonWriteConverter());
return new CassandraCustomConversions(converters);
}
// other methods omitted...
}以下 SpringConverter实现示例从 aString转换为自定义Email值对象：
代码语言：javascript复制@ReadingConverter
public class EmailReadConverter implements Converter<String, Email> {
public Email convert(String source) {
return Email.valueOf(source);
}
}
如果您编写Converter的源类型和目标类型均为本机类型，我们无法确定是否应将其视为读取转换器或写入转换器。将转换器实例注册为两者可能会导致不需要的结果。例如， aConverter<String, Long>是不明确的，尽管在编写时尝试将所有String实例转换为Long实例可能没有意义。为了让你强制基础设施注册一个转换器，只有一个办法，我们提供@ReadingConverter并@WritingConverter在转换器实现使用注解。
转换器需要进行显式注册，因为不会从类路径或容器扫描中提取实例，以避免不必要的转换服务注册以及此类注册产生的副作用。转换器注册CustomConversions为中央工具，允许根据源和目标类型注册和查询已注册的转换器。
CustomConversions 附带一组预定义的转换器注册：
- JSR-310 转换器，用于在java.time,java.util.Date和String类型之间进行转换。
- 不推荐使用：Joda 时间转换器，用于在org.joda.time、JSR-310 和java.util.Date.
- 已弃用：ThreeTenBackport 转换器，用于在org.joda.time、JSR-310 和java.util.Date.
本地时间类型（例如LocalDateTimeto java.util.Date）的默认转换器依赖于系统默认时区设置在这些类型之间进行转换。您可以通过注册您自己的转换器来覆盖默认转换器。
转换器消歧
通常，我们会检查Converter它们相互转换的源和目标类型的实现。根据其中一个是否是底层数据访问 API 可以本地处理的类型，我们将转换器实例注册为读取或写入转换器。以下示例显示了一个写入和读取转换器（注意区别在于 上的限定符的顺序Converter）：
代码语言：javascript复制// Write converter as only the target type is one that can be handled natively
class MyConverter implements Converter<Person, String> { … }
// Read converter as only the source type is one that can be handled natively
class MyConverter implements Converter<String, Person> { … }14.6.实体状态检测策略
下表描述了 Spring Data 提供的用于检测实体是否为新实体的策略：
14.7.生命周期事件
Cassandra 映射框架有几个内置 org.springframework.context.ApplicationEvent事件，您的应用程序可以通过在ApplicationContext. 由于基于 Spring 的应用程序上下文事件基础结构，其他产品（例如 Spring Integration）可以轻松接收这些事件，因为它们是基于 Spring 的应用程序中众所周知的事件机制。
要在对象进入数据库之前对其进行拦截，您可以注册一个 org.springframework.data.cassandra.core.mapping.event.AbstractCassandraEventListener覆盖该onBeforeSave(…)方法的子类。当事件被调度时，你的监听器被调用并传递域对象（它是一个 Java 实体）。以下示例使用该onBeforeSave方法：
代码语言：javascript复制class BeforeSaveListener extends AbstractCassandraEventListener<Person> {
@Override
public void onBeforeSave(BeforeSaveEvent<Person> event) {
// … change values, delete them, whatever …
}
}在 Spring 中声明这些 beanApplicationContext将导致在调度事件时调用它们。
将 AbstractCassandraEventListener具有以下回调方法：
- onBeforeSave:在插入或更新数据库中的行之前调用CassandraTemplate.insert(…)和.update(…)操作。
- onAfterSave: 在数据库中插入或更新行后调用CassandraTemplate…insert(…)和.update(…)操作。
- onBeforeDelete: 在CassandraTemplate.delete(…)从数据库中删除行之前的操作中调用。
- onAfterDelete:CassandraTemplate.delete(…)从数据库中删除行后在操作中调用。
- onAfterLoad：从数据库中检索每一行后CassandraTemplate.select(…)，在.slice(…)、 和.stream(…)方法中调用。
- onAfterConvert：将从数据库中检索到的行转换为 POJO 后CassandraTemplate.select(…)，在.slice(…)、 和.stream(…)方法中调用。
仅针对根级别类型发出生命周期事件。在聚合根中用作属性的复杂类型不受事件发布的影响。
14.8.实体回调
Spring Data 基础设施提供了在调用某些方法之前和之后修改实体的钩子。那些所谓的EntityCallback实例提供了一种方便的方法来检查和潜在地以回调风格修改实体。 AnEntityCallback看起来很像一个专门的ApplicationListener. 一些 Spring Data 模块发布BeforeSaveEvent允许修改给定实体的存储特定事件（例如）。在某些情况下，例如使用不可变类型时，这些事件可能会导致麻烦。此外，事件发布依赖于 ApplicationEventMulticaster. 如果使用异步配置TaskExecutor它可能会导致不可预测的结果，因为事件处理可以分叉到线程上。
实体回调为同步 API 和反应式 API 提供集成点，以保证在处理链中定义明确的检查点按顺序执行，返回潜在修改的实体或反应式包装器类型。
实体回调通常按 API 类型分隔。这种分离意味着同步 API 仅考虑同步实体回调，而反应式实现仅考虑反应式实体回调。
Spring Data Commons 2.2 引入了实体回调 API。这是应用实体修改的推荐方式。在调用可能已注册的实例之前，ApplicationEvents仍会发布特定于现有商店的信息。EntityCallback
