对于最新的稳定版本,请使用 Spring Data Cassandra 4.3.1! |
对于最新的稳定版本,请使用 Spring Data Cassandra 4.3.1! |
以下 Spring 实现示例从 a 转换为自定义值对象:Converter
String
Email
@ReadingConverter
public class EmailReadConverter implements Converter<String, Email> {
public Email convert(String source) {
return Email.valueOf(source);
}
}
如果您编写的源类型和目标类型是本机类型,我们无法确定是应将其视为读取还是写入转换器。
将转换器实例注册为两者可能会导致不需要的结果。
例如,a 是模棱两可的,尽管在编写时尝试将所有实例转换为实例可能没有意义。
为了让您强制基础架构仅以一种方式注册转换器,我们提供了在转换器实现中使用的注释。Converter
Converter<String, Long>
String
Long
@ReadingConverter
@WritingConverter
转换器需要显式注册,因为实例不会从类路径或容器扫描中选取,以避免在转换服务中进行不必要的注册以及此类注册导致的副作用。转换器注册为中央设施,允许根据源和目标类型注册和查询已注册的转换器。CustomConversions
CustomConversions
附带一组预定义的转换器注册:
-
JSR-310 转换器,用于在 和 类型之间进行转换。
java.time
java.util.Date
String
本地时态类型的默认转换器(例如 to ) 依靠系统默认时区设置在这些类型之间进行转换。您可以通过注册自己的转换器来覆盖默认转换器。LocalDateTime java.util.Date |
本地时态类型的默认转换器(例如 to ) 依靠系统默认时区设置在这些类型之间进行转换。您可以通过注册自己的转换器来覆盖默认转换器。LocalDateTime java.util.Date |
转换器消歧
通常,我们会检查实现中是否包含源类型和目标类型。
根据其中一个类型是底层数据访问 API 可以本机处理的类型,我们将转换器实例注册为读取或写入转换器。
以下示例显示了写入和读取转换器(请注意,区别在于限定符的顺序):Converter
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> { … }
使用自定义转换器覆盖默认映射
为了对映射过程进行更精细的控制,您可以向 Spring 注册实现,例如 .Converters
CassandraConverter
MappingCassandraConverter
MappingCassandraConverter
在尝试映射对象本身之前,首先检查是否有任何 Spring 可以处理特定类。
要“劫持”的正常映射策略(可能是为了提高性能或其他自定义映射需求),您需要创建一个 Spring 接口的实现并将其注册到 .Converters
MappingCassandraConverter
Converter
MappingCassandraConverter
使用注册的弹簧转换器进行保存
您可以在一个过程中结合转换和保存,基本上使用转换器进行保存。
以下示例使用 a 将 Jackson 2 的对象转换为 a:Converter
Person
java.lang.String
class PersonWriteConverter implements Converter<Person, String> {
public String convert(Person source) {
try {
return new ObjectMapper().writeValueAsString(source);
} catch (IOException e) {
throw new IllegalStateException(e);
}
}
}
使用弹簧转换器读取
与如何组合保存和转换类似,您也可以将读取和转换结合起来。
以下示例使用 Jackson 2 将 a 转换为对象:Converter
java.lang.String
Person
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;
}
}
注册弹簧转换器CassandraConverter
Spring Data for Apache Cassandra Java 配置提供了一种注册 Spring 实例的便捷方法:。
以下配置代码段显示了如何手动注册转换器以及配置:Converter
MappingCassandraConverter
CustomConversions
@Configuration
public class ConverterConfiguration extends AbstractCassandraConfiguration {
@Override
public CassandraCustomConversions customConversions() {
return CassandraCustomConversions.create(config -> {
config.registerConverter(new PersonReadConverter()));
config.registerConverter(new PersonWriteConverter()));
});
}
// other methods omitted...
}