此版本仍在开发中，尚不被认为是稳定的。对于最新的稳定版本，请使用 Spring Data Commons 3.5.3！spring-doc.cadn.net.cn

自定义转换

以下弹簧示例Converter实现从String到自定义Emailvalue 对象：spring-doc.cadn.net.cn

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

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

如果您编写一个Converter其源类型和目标类型是原生类型，我们无法确定是否应该将其视为读取或写入转换器。 将转换器实例注册为两者可能会导致不良结果。 例如，一个Converter<String, Long>是模棱两可的，尽管尝试将所有String实例转换为Long写作时的实例。 为了让您强制基础设施仅注册单向转换器，我们提供了@ReadingConverter和@WritingConverter要在转换器实现中使用的注释。spring-doc.cadn.net.cn

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

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

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

转换器消歧义

通常，我们检查Converter它们从中转换到的源和目标类型的实现。 根据其中一个是否是底层数据访问 API 可以本地处理的类型，我们将转换器实例注册为读取或写入转换器。 以下示例显示了写入转换器和读取转换器（请注意，区别在于Converter):spring-doc.cadn.net.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> { … }