Spring MongoDB无注解配置第三方POJO持久化的实现方法问询

存在三种不需要修改第三方类加注解即可实现持久化的实现方式，可根据业务场景选择：

1. 编程式配置实体元数据 #

通过MongoMappingContext主动注册第三方类的持久化规则，无需修改原类代码即可指定集合名、ID映射字段，适配Spring Data MongoDB的Repository用法。
配置示例：

@Configuration
public class MongoConfig extends AbstractMongoClientConfiguration {
    @Override
    protected String getDatabaseName() {
        return "你的数据库名";
    }

    @Bean
    @Override
    public MongoMappingContext mongoMappingContext() throws ClassNotFoundException {
        MongoMappingContext context = new MongoMappingContext();
        BasicMongoPersistentEntity<?> entity = context.getPersistentEntity(第三方类.class);
        if (entity != null) {
            // 指定存储的集合名称
            entity.setCollection("自定义集合名");
            // 指定类中作为ID的字段（示例中假设第三方类主键字段为userId）
            Optional<MongoPersistentProperty> idProp = entity.getPersistentProperty("userId");
            idProp.ifPresent(entity::setIdProperty);
        }
        return context;
    }
}

2. 调用MongoTemplate指定集合的重载方法 #

如果仅需简单CRUD，可直接调用MongoTemplate中带集合名参数的重载方法，插入查询时主动指定目标集合，无需额外配置。
使用示例：

// 插入数据到指定集合
第三方类 obj = new 第三方类();
mongoTemplate.insert(obj, "自定义集合名");

// 按主键查询，主动指定ID对应的字段名
Query query = Query.query(Criteria.where("userId").is("12345"));
第三方类 result = mongoTemplate.findOne(query, 第三方类.class, "自定义集合名");

3. 自定义读写转换器 #

如果第三方类结构特殊，默认映射逻辑无法适配，可以注册自定义的读写转换器，完全控制类和MongoDB文档的转换逻辑。
配置示例：
首先定义转换器：

// 写转换器：将第三方类转为MongoDB文档
@WritingConverter
public class ThirdPartyWriteConverter implements Converter<第三方类, Document> {
    @Override
    public Document convert(第三方类 source) {
        Document doc = new Document();
        doc.put("_id", source.getUserId()); // 映射主键到Mongo的_id字段
        doc.put("name", source.getUserName());
        doc.put("otherField", source.getOtherField());
        return doc;
    }
}

// 读转换器：将MongoDB文档转为第三方类
@ReadingConverter
public class ThirdPartyReadConverter implements Converter<Document, 第三方类> {
    @Override
    public 第三方类 convert(Document source) {
        第三方类 obj = new 第三方类();
        obj.setUserId(source.getObjectId("_id").toString());
        obj.setUserName(source.getString("name"));
        obj.setOtherField(source.getString("otherField"));
        return obj;
    }
}

注册转换器到Mongo配置：

@Configuration
public class MongoConfig extends AbstractMongoClientConfiguration {
    @Override
    protected String getDatabaseName() {
        return "你的数据库名";
    }

    @Bean
    @Override
    public MongoCustomConversions customConversions() {
        List<Converter<?, ?>> converters = new ArrayList<>();
        converters.add(new ThirdPartyWriteConverter());
        converters.add(new ThirdPartyReadConverter());
        return new MongoCustomConversions(converters);
    }
}

选型建议 #

• 仅需简单CRUD：选择第二种方案，实现成本最低
• 需要使用Repository接口进行数据操作：选择第一种方案
• 第三方类结构复杂、默认映射不满足需求：选择第三种方案

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