对于最新的稳定版本，请使用 Spring Data Cassandra 4.4.0！spring-doc.cn

自定义转化

以下 Spring 实现示例从 a 转换为自定义 value 对象：ConverterStringEmailspring-doc.cn

@ReadingConverter
public class EmailReadConverter implements Converter<String, Email> {

  public Email convert(String source) {
    return Email.valueOf(source);
  }
}

如果您编写的源类型和目标类型均为本机类型，则无法确定是否应将其视为读取转换器或写入转换器。将转换器实例注册为两者可能会导致不需要的结果。例如，a 是模棱两可的，尽管在写入时尝试将所有实例转换为实例可能没有意义。为了让您强制 infrastructure 仅以一种方式注册 converter，我们提供了 and annotations to be used in the converter implementation。ConverterConverter<String, Long>StringLong@ReadingConverter@WritingConverterspring-doc.cn

转换器需要进行显式注册，因为不会从 Classpath 或容器扫描中选取实例，以避免向 conversion 服务进行不必要的注册以及此类注册产生的副作用。转换器注册为中央工具，允许根据源和目标类型注册和查询已注册的转换器。CustomConversionsspring-doc.cn

CustomConversions附带一组预定义的转换器注册：spring-doc.cn

JSR-310 用于在和类型之间进行转换的转换器。java.timejava.util.DateStringspring-doc.cn

本地时间类型的默认转换器（例如更改为）依赖于系统默认时区设置在这些类型之间进行转换。您可以通过注册自己的转换器来覆盖默认转换器。LocalDateTimejava.util.Date

转换器消歧义

通常，我们会检查它们转换的源类型和目标类型的实现。根据其中之一是否是底层数据访问 API 可以本地处理的类型，我们将转换器实例注册为读取或写入转换器。以下示例显示了 writing- 和 read 转换器（请注意，区别在于限定符的顺序 on ）：ConverterConverterspring-doc.cn

// 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。ConvertersCassandraConverterMappingCassandraConverterspring-doc.cn

MappingCassandraConverter首先检查是否有任何 Spring 可以处理特定的类，然后再尝试映射对象本身。要“劫持”的法线映射策略（可能是为了提高性能或其他自定义映射需求），您需要创建 Spring 接口的实现并将其注册到 .ConvertersMappingCassandraConverterConverterMappingCassandraConverterspring-doc.cn

使用已注册的 Spring 转换器进行保存

您可以将转换和保存合并到一个过程中，基本上使用转换器进行保存。spring-doc.cn

以下示例使用 a 将对象转换为 Jackson 2 中的对象：ConverterPersonjava.lang.Stringspring-doc.cn

class PersonWriteConverter implements Converter<Person, String> {

	public String convert(Person source) {

		try {
			return new ObjectMapper().writeValueAsString(source);
		} catch (IOException e) {
			throw new IllegalStateException(e);
		}
	}
}

使用 Spring 转换器读取

与组合保存和转换的方式类似，您也可以组合读取和转换。spring-doc.cn

以下示例使用 a 将 a 转换为 Jackson 2 的对象：Converterjava.lang.StringPersonspring-doc.cn

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;
	}
}

注册 Spring Converters`CassandraConverter`

Spring Data for Apache Cassandra Java 配置提供了一种注册 Spring 实例的便捷方法：. 以下配置代码片段显示了如何手动注册转换器以及配置：ConverterMappingCassandraConverterCustomConversionsspring-doc.cn

@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...

}