自定义转换

DeepSeek V3 中英对照 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 注解，用于转换器实现中。

为了避免转换服务中的意外注册以及由此产生的副作用，转换器需要通过显式注册的方式来进行，而不是从类路径或容器扫描中自动发现。转换器是通过 CustomConversions 进行注册的，它作为核心设施，支持基于源类型和目标类型的转换器注册与查询。

CustomConversions 提供了一个预定义的转换器注册集：

• 用于 java.time、java.util.Date 和 String 类型之间转换的 JSR-310 转换器。

备注

本地时间类型（例如 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