自定义转换

下面的 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 附带一组预定义的转换器注册。

  • 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> { … }