Spring Data Mongo：如何将嵌入实体直接存储为顶层属性值

这个需求很常见！要让MongoDB把你的PersonName嵌入式实体直接存成字符串而不是嵌套文档，核心是给Spring Data MongoDB加一对自定义的类型转换器，覆盖它默认的嵌入式实体处理逻辑。下面一步步来：

1. 实现对象转字符串的转换器 #

这个转换器负责把PersonName实例转换成对应的字符串（也就是它的name属性值）：

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

@Component
public class PersonNameToStringConverter implements Converter<PersonName, String> {
    @Override
    public String convert(PersonName source) {
        // 这里可以根据你的需求处理null情况，比如返回空字符串或者抛出异常
        return source != null ? source.getName() : null;
    }
}

2. 实现字符串转对象的转换器 #

这个转换器负责从数据库读取字符串时，把它还原成PersonName实例：

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

@Component
public class StringToPersonNameConverter implements Converter<String, PersonName> {
    @Override
    public PersonName convert(String source) {
        if (source == null || source.isBlank()) {
            // 这里可以根据你的验证逻辑处理，比如返回null或者抛出验证异常
            return null;
        }
        PersonName personName = new PersonName();
        personName.setName(source);
        // 如果PersonName有其他初始化逻辑或者验证，这里可以调用对应的方法
        // 比如personName.validate();
        return personName;
    }
}

3. 注册转换器到Spring Data MongoDB #

接下来需要把这两个转换器注册到Spring的Mongo配置中，让MongoDB模板使用它们。你可以通过MongoCustomConversions来完成注册：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.core.convert.MongoCustomConversions;

import java.util.List;

@Configuration
public class MongoConfig {

    @Bean
    public MongoCustomConversions mongoCustomConversions(
            PersonNameToStringConverter toStrConverter,
            StringToPersonNameConverter toObjConverter
    ) {
        return new MongoCustomConversions(
                List.of(toStrConverter, toObjConverter)
        );
    }
}

验证效果 #

现在当你保存Person实例时，MongoDB里的personName字段就会直接存储为字符串：

{ ... "personName": "John Smith", ... }

读取的时候，Spring Data MongoDB会自动把字符串转成PersonName实例，完全不影响你在业务代码里使用Person对象的逻辑。

注意事项 #

• 如果你的PersonName有其他属性或者复杂的验证逻辑，要在转换器里同步处理，确保转换后的实例符合业务规则。
• 要是你用的是Spring Boot，只要把转换器类加上@Component注解，Spring会自动扫描并注册到上下文里，上面的MongoConfig可以直接生效。

内容的提问来源于stack exchange，提问作者NRaf