14.5.使用自定义转换器覆盖默认映射
要对映射过程进行更细粒度的控制,您可以Converters使用 CassandraConverter实现注册 Spring ,例如
MappingCassandraConverter.
MappingCassandraConverterConverters在尝试映射对象本身之前,首先检查是否有任何 Spring可以处理特定的类。要“劫持” MappingCassandraConverter(可能是为了提高性能或其他自定义映射需求)的正常映射策略,您需要创建 SpringConverter接口的实现并将其注册到MappingCassandraConverter.
14.5.1.使用注册的 Spring 转换器进行保存
您可以在一个过程中将转换和保存结合起来,基本上是使用转换器来进行保存。
以下示例使用 aConverter将Person对象转换为java.lang.String 带有 Jackson 2 的 a:
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的对象:
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:
@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值对象:
@ReadingConverter
public class EmailReadConverter implements Converter<String, Email> {
public Email convert(String source) {
return Email.valueOf(source);
}
}
Spring中国教育管理中心-Apache Cassandra 的 Spring 数据教程十三
如果您编写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):
// 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 提供的用于检测实体是否为新实体的策略:
Spring中国教育管理中心-Apache Cassandra 的 Spring 数据教程十三
14.7.生命周期事件
Cassandra 映射框架有几个内置
org.springframework.context.ApplicationEvent事件,您的应用程序可以通过在ApplicationContext. 由于基于 Spring 的应用程序上下文事件基础结构,其他产品(例如 Spring Integration)可以轻松接收这些事件,因为它们是基于 Spring 的应用程序中众所周知的事件机制。
要在对象进入数据库之前对其进行拦截,您可以注册一个
org.springframework.data.cassandra.core.mapping.event.AbstractCassandraEventListener覆盖该onBeforeSave(…)方法的子类。当事件被调度时,你的监听器被调用并传递域对象(它是一个 Java 实体)。以下示例使用该onBeforeSave方法:
class BeforeSaveListener extends AbstractCassandraEventListener {
@Override
public void onBeforeSave(BeforeSaveEvent 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