基于类型的转换器 (Type based Converter) _ Spring Data MongoDB 4.3.1 中文文档(官方文档中文翻译) —

以下 Spring 实现示例从 a 转换为自定义值对象：ConverterStringEmailSpring中文文档

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

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

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

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

CustomConversions附带一组预定义的转换器注册：Spring中文文档

JSR-310 转换器，用于在和类型之间进行转换。java.timejava.util.DateStringSpring中文文档

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

转换器消歧

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

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

基于类型的转换器

影响映射结果的最简单方法是通过注释指定所需的原生 MongoDB 目标类型。这允许使用非MongoDB类型，如在域模型中，同时以本机格式保存值。@FieldBigDecimalorg.bson.types.Decimal128Spring中文文档

例 1.显式目标类型映射

public class Payment {

  @Id String id; (1)

  @Field(targetType = FieldType.DECIMAL128) (2)
  BigDecimal value;

  Date date; (3)

}

{
  "_id"   : ObjectId("5ca4a34fa264a01503b36af8"), (1)
  "value" : NumberDecimal(2.099), (2)
  "date"   : ISODate("2019-04-03T12:11:01.870Z") (3)
}

1	表示有效值的字符串 ID 值将自动转换。有关详细信息，请参阅如何在映射图层中处理 `_id` 字段。`ObjectId`
2	所需的目标类型被显式定义为。否则，该值将被截断为 .`Decimal128NumberDecimalBigDecimalString`
3	`Date`值由 MongoDB 驱动程序本身处理，并存储为 .`ISODate`

上面的代码片段对于提供简单的类型提示非常方便。为了获得对映射过程的更精细的控制，您可以将 Spring 转换器注册到实现中，例如 .MongoConverterMappingMongoConverterSpring中文文档

在尝试映射对象本身之前，检查是否有任何 Spring 转换器可以处理特定类。要“劫持”的正常映射策略，也许是为了提高性能或其他自定义映射需求，您首先需要创建 Spring 接口的实现，然后将其注册到 .MappingMongoConverterMappingMongoConverterConverterMappingConverterSpring中文文档

有关 Spring 类型转换服务的更多信息，请参阅此处的参考文档。

写作转换器

下面的示例演示了从对象转换为的实现：ConverterPersonorg.bson.DocumentSpring中文文档

import org.springframework.core.convert.converter.Converter;

import org.bson.Document;

public class PersonWriteConverter implements Converter<Person, Document> {

  public Document convert(Person source) {
    Document document = new Document();
    document.put("_id", source.getId());
    document.put("name", source.getFirstName());
    document.put("age", source.getAge());
    return document;
  }
}

阅读转换器

下面的示例演示从 a 转换为对象的 a 的实现：ConverterDocumentPersonSpring中文文档

public class PersonReadConverter implements Converter<Document, Person> {

  public Person convert(Document source) {
    Person p = new Person((ObjectId) source.get("_id"), (String) source.get("name"));
    p.setAge((Integer) source.get("age"));
    return p;
  }
}

注册转换器

class MyMongoConfiguration extends AbstractMongoClientConfiguration {

	@Override
	public String getDatabaseName() {
		return "database";
	}

	@Override
	protected void configureConverters(MongoConverterConfigurationAdapter adapter) {
		adapter.registerConverter(new com.example.PersonReadConverter());
		adapter.registerConverter(new com.example.PersonWriteConverter());
	}
}

1	表示有效值的字符串 ID 值将自动转换。有关详细信息，请参阅如何在映射图层中处理 `_id` 字段。`ObjectId`
2	所需的目标类型被显式定义为。否则，该值将被截断为 .`Decimal128NumberDecimalBigDecimalString`
3	`Date`值由 MongoDB 驱动程序本身处理，并存储为 .`ISODate`

有关 Spring 类型转换服务的更多信息，请参阅此处的参考文档。