此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Data Commons 3.4.0spring-doc.cn

自定义转化

以下 Spring 实现示例从 a 转换为自定义 value 对象:ConverterStringEmailspring-doc.cn

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

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

如果您编写的源类型和目标类型均为本机类型,则无法确定是否应将其视为读取转换器或写入转换器。 将转换器实例注册为两者可能会导致不需要的结果。 例如,a 是模棱两可的,尽管在写入时尝试将所有实例转换为实例可能没有意义。 为了让您强制 infrastructure 仅以一种方式注册 converter,我们提供了 and annotations to be used in the converter implementation。ConverterConverter<String, Long>StringLong@ReadingConverter@WritingConverterspring-doc.cn

转换器需要进行显式注册,因为不会从 Classpath 或容器扫描中选取实例,以避免向 conversion 服务进行不必要的注册以及此类注册产生的副作用。转换器 注册为中央工具,允许根据源和目标类型注册和查询已注册的转换器。CustomConversionsspring-doc.cn

CustomConversions附带一组预定义的转换器注册:spring-doc.cn

  • JSR-310 用于在 和 类型之间进行转换的转换器。java.timejava.util.DateStringspring-doc.cn

本地时间类型的默认转换器(例如 更改为 ) 依赖于系统默认时区设置在这些类型之间进行转换。您可以通过注册自己的转换器来覆盖默认转换器。LocalDateTimejava.util.Date

转换器消歧义

通常,我们会检查它们转换的源类型和目标类型的实现。 根据其中之一是否是底层数据访问 API 可以本地处理的类型,我们将转换器实例注册为读取或写入转换器。 以下示例显示了 writing- 和 read 转换器(请注意,区别在于限定符的顺序 on ):ConverterConverterspring-doc.cn

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