SpringBoot Data mongo查询结果中带有枚举值但值不为name时如何正确反序列化

本文介绍如何在SpringBoot项目中使用MongoDB时,解决枚举类型转换问题。通过自定义Converter和MongoCustomConversions,实现从数据库的int类型到Java枚举类型的自动转换。

在使用spring boot data mongo查询mongodb的时候,因为需要维持原有db中的数据,且原有数据中存在大量的int类型枚举值,在将查询结果转化为对象时无法转换成功,查询后得出以下通过Converter达到目的的方法。

枚举类如下:

@AllArgsConstructor
public enum Week {
    MONDAY(1, "周一"),
    TUESDAY(2, "周二"),
    WEDNESDAY(3, "周二"),
    THURSDAY(4, "周四"),
    FRIDAY(5, "周五");

    private final int value;

    private final String desc;

    public int value() {
        return value;
    }

    public String desc() {
        return desc;
    }

    public static Week valueOf(int value) {
        for (Week week : Week.values()) {
            if (week.value == value) {
                return week;
            }
        }
        return null;
    }

    @Override
    public String toString() {
        return Integer.toString(value);
    }
}

若数据库中存储的值为1,需要转化为枚举MONDAY,直接通过指定Mongo查询结果的对象会自动调用枚举自带的valueOf(String name),无法自动直接转化成功,需要做如下两个步骤:

  1. 创建转化的Converter
import org.springframework.core.convert.converter.Converter;

public class Integer2WeekConverter implements Converter<Integer, Week> {
    @Override
    public Week convert(Integer integer) {
        return Week.valueOf(integer);
    }
}

其中的泛型Integer, Week指的是从Interger类型转为Week类型,convert方法就是会在转化过程自动调用的方法。
2. 创建配置类,自定义MongoCustomConversions

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.MongoDbFactory;
import org.springframework.data.mongodb.core.convert.*;

import java.util.Arrays;

@Configuration
public class MongoDBConfig {

    @Autowired
    MongoDbFactory mongoDbFactory;

    @Bean
    public MongoCustomConversions mongoCustomConversions() {
        return new MongoCustomConversions(
                Arrays.asList(new Integer2WeekConverter()));
    }
}

该步骤是自定义MongoCustomConversions,注册我们自定义的Converter

完成以上步骤,Mongo在将查询结果转换成指定对象的时候,若发现有字段需要从Interger类型转换为Week枚举时,会自动调用Converter方法,需要注意的是要确保Mongo内的数据类型和我们左边指定的类型一致,比如int32对应Integer,int64对应Long,如果对应出错,则不会触发调用。

<think>我们正在使用Spring Boot和MongoDB的BulkOperations进行批量插入,但默认情况下,Spring Data MongoDB会为每个文档添加一个`_class`属性,用于存储文档的Java类型。但在某些场景下,我们可能不希望这个字段被存储到数据库中。 解决方案: 1. 我们可以通过配置映射上下文(MongoMappingContext)来禁用`_class`字段的存储。 2. 另一种方法是在实体类上使用注解`@Document(collection = "yourCollection")`,并通过`@TypeAlias`来指定类型别名,但这并不能直接去掉`_class`字段。要去掉,我们需要在映射上下文中设置默认类型映射为null。 但是,对于批量操作,我们使用BulkOperations,我们可以通过配置MongoTemplate来禁用`_class`字段的自动添加。 具体步骤: a. 配置MongoTemplate,设置DefaultMongoTypeMapper的typeKey为null,这样就不会存储`_class`字段。 b. 在批量插入,使用这个配置好的MongoTemplate。 示例代码: 首先,配置MongoTemplate: ```java @Configuration public class MongoConfig extends AbstractMongoClientConfiguration { @Override public String getDatabaseName() { return "test"; } @Bean public MongoTemplate mongoTemplate() throws Exception { MappingMongoConverter converter = new MappingMongoConverter( new DefaultDbRefResolver(mongoDbFactory()), new MongoMappingContext()); // 这里设置_typeMapper为null,这样就不会有_class字段 converter.setTypeMapper(new DefaultMongoTypeMapper(null)); return new MongoTemplate(mongoDbFactory(), converter); } } ``` 然后,在批量插入,使用这个MongoTemplate: ```java @Autowired private MongoTemplate mongoTemplate; public void bulkInsertWithoutClassField(List<YourEntity> entities) { BulkOperations bulkOps = mongoTemplate.bulkOps(BulkOperations.BulkMode.UNORDERED, YourEntity.class); for (YourEntity entity : entities) { InsertOneOperation<YourEntity> insertOne = new InsertOneOperation<>(entity); bulkOps.insert(Collections.singletonList(insertOne)); } bulkOps.execute(); } ``` 注意:上面的代码中,我们使用了`BulkOperations`的插入操作。由于我们在MongoTemplate中配置了类型映射器将类型键设置为null,所以插入的文档中不会包含`_class`字段。 另外,需要注意的是,禁用`_class`字段后,当我们从数据库读取文档Spring Data MongoDB将无法自动将文档映射到具体的Java类型(除非我们提供其他方式,比如使用@TypeAlias并配置类型映射器)。因此,如果我们的集合中存储了多种类型的文档,并且我们依赖`_class`字段进行多态反序列化,那么禁用这个字段可能会导致问题。如果我们的集合中只存储一种类型的文档,并且我们明确知道要映射到哪个类,那么我们可以禁用`_class`字段。 另一种方法是,在实体类上使用`@Document`注解,并设置`type`属性为空字符串,例如: ```java @Document(collection = "yourCollection", type = "") public class YourEntity { // ... } ``` 但是这种方法在批量插入可能不会生效,因为Spring Data MongoDB的默认行为还是会添加`_class`字段,除非我们全局配置了类型映射器。 因此,推荐使用配置MongoTemplate的方式。 引用说明: 在Spring Data MongoDB中,我们可以通过配置`MappingMongoConverter`的`TypeMapper`来控制类型信息的存储。将`DefaultMongoTypeMapper`的类型键设置为null,即可禁用`_class`字段[^1]。 另外,关于批量操作,MongoDB提供了批量写入的能力,Spring Data MongoDB的`BulkOperations`是对此的封装[^3]。 因此,通过上述配置,我们可以在批量插入避免新增`_class`属性。 相关问题: 1. 如何在Spring Data MongoDB中配置多数据源? 2. 批量操作,如何提高性能? 3. 除了去掉`_class`字段,还有哪些常见的MongoDB文档映射配置?</think>### 避免 Spring Boot MongoDB 批量插入生成 _class 属性 在 Spring Data MongoDB 中,默认会为每个文档添加 `_class` 属性(存储 Java 类名),用于反序列化类型识别。若需在批量插入禁用此字段,可通过以下方案实现: #### 方案 1:全局配置(推荐) 在 `MongoTemplate` 中配置类型映射器,禁用 `_class` 字段: ```java @Configuration public class MongoConfig { @Bean public MongoTemplate mongoTemplate(MongoDatabaseFactory factory) { MappingMongoConverter converter = new MappingMongoConverter( new DefaultDbRefResolver(factory), new MongoMappingContext() ); // 关键配置:禁用 _class 字段 converter.setTypeMapper(new DefaultMongoTypeMapper(null)); return new MongoTemplate(factory, converter); } } ``` #### 方案 2:实体级配置 在实体类使用 `@TypeAlias` + 全局类型映射器: ```java @Document @TypeAlias("user") // 定义类型别名 public class User { @Id private String id; private String name; } // 配置类中追加 converter.setTypeMapper(new DefaultMongoTypeMapper("_alias")); // 使用自定义字段名 ``` #### 批量插入实现 使用配置好的 `MongoTemplate` 执行批量操作: ```java public void bulkInsert(List<User> users) { BulkOperations bulkOps = mongoTemplate.bulkOps( BulkOperations.BulkMode.UNORDERED, User.class ); users.forEach(user -> { bulkOps.insert(user); // 自动应用无 _class 的映射规则 }); BulkWriteResult result = bulkOps.execute(); // 执行批量操作 } ``` #### 注意事项 1. **反序列化影响** 禁用 `_class` 后,查询结果需明确指定返回类型: ```java mongoTemplate.find(new Query(), User.class); // 必须显式声明实体类型 ``` 2. **多态类型限制** 若集合存储多种实体类型,需保留 `_class` 或使用 `@TypeAlias` 维护类型信息[^1]。 3. **性能优势** 批量操作相比单条插入可提升 10-50x 性能,尤其在大数据量场景[^3]。 > **提示**:若需临保留 `_class` 字段(如特定集合),可通过 `@Document(collection = "users")` 单独配置,不影响全局设置。 --- ### 相关问题 1. 如何优化 Spring Data MongoDB 的批量写入性能? 2. 禁用 `_class` 字段后如何处理多态文档的反序列化? 3. 除了批量插入,MongoDB 还有哪些高效数据写入方式? 4. 如何为不同集合单独配置 `_class` 字段的生成规则? [^1]: Spring Data MongoDB 通过 `_class` 实现实体类型识别,禁用后需显式指定结果类型。 [^3]: MongoDB 批量操作显著减少网络开销,适合大数据写入场景。
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值