自定义转换

以下 Spring Converter 实现示例将 String 转换为自定义 Email 值对象

@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 注解，以便在转换器实现中使用。

转换器需要显式注册，因为实例不会从类路径或容器扫描中拾取，以避免使用转换服务进行不必要的注册以及由此类注册产生的副作用。转换器通过 CustomConversions 注册，CustomConversions 是一个中心设施，允许注册和查询基于源类型和目标类型的已注册转换器。

CustomConversions 附带了一组预定义的转换器注册

JSR-310 转换器，用于在 java.time、java.util.Date 和 String 类型之间进行转换。

本地时间类型（例如，LocalDateTime 到 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> { … }