对于最新的稳定版本，请使用 Spring Data Commons 3.3.1！

对于最新的稳定版本，请使用 Spring Data Commons 3.3.1！

以下 Spring 实现示例从 a 转换为自定义值对象：ConverterStringEmail

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

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

如果您编写的源类型和目标类型是本机类型，我们无法确定是应将其视为读取还是写入转换器。 将转换器实例注册为两者可能会导致不需要的结果。 例如，a 是模棱两可的，尽管在编写时尝试将所有实例转换为实例可能没有意义。 为了让您强制基础架构仅以一种方式注册转换器，我们提供了在转换器实现中使用的注释。ConverterConverter<String, Long>StringLong@ReadingConverter@WritingConverter

转换器需要显式注册，因为实例不会从类路径或容器扫描中选取，以避免在转换服务中进行不必要的注册以及此类注册导致的副作用。转换器注册为中央设施，允许根据源和目标类型注册和查询已注册的转换器。CustomConversions

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

  • JSR-310 转换器，用于在 和 类型之间进行转换。java.timejava.util.DateString

本地时态类型的默认转换器（例如 to ） 依靠系统默认时区设置在这些类型之间进行转换。您可以通过注册自己的转换器来覆盖默认转换器。LocalDateTimejava.util.Date
本地时态类型的默认转换器（例如 to ） 依靠系统默认时区设置在这些类型之间进行转换。您可以通过注册自己的转换器来覆盖默认转换器。LocalDateTimejava.util.Date

转换器消歧

通常，我们会检查实现中是否包含源类型和目标类型。 根据其中一个类型是底层数据访问 API 可以本机处理的类型，我们将转换器实例注册为读取或写入转换器。 以下示例显示了写入和读取转换器（请注意，区别在于限定符的顺序）：ConverterConverter

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