自定义转换

Doubao 中英对照 Custom Conversions

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

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

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

java

如果您编写的 Converter 其源类型和目标类型都是原生类型，我们就无法判断应将它视为读取转换器还是写入转换器。将该转换器实例同时注册为两者可能会导致不期望的结果。例如，Converter<String, Long> 就是有歧义的，尽管在写入时试图将所有 String 实例转换为 Long 实例很可能没有意义。为了让您能够强制基础设施只按一种方式注册转换器，我们提供了 @ReadingConverter 和 @WritingConverter 注解，供在转换器实现中使用。

转换器需要显式注册，因为转换器实例不会通过 classpath 或容器扫描被自动拾取，以避免在转换服务中发生不期望的注册以及由此带来的副作用。转换器通过 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> { … }

java