Spring Data MongoDB：如何实现无@Field的全局动态文档字段名转换器

嘿，这个需求我之前做过类似的，完全可以通过自定义全局字段命名策略来实现，不用给每个字段加@Field注解，还能适配任意实体类（也就是任意MongoDB文档），而且不需要泛型。咱们一步步来拆解：

核心思路 #

Spring Data MongoDB提供了FieldNamingStrategy接口，它可以全局控制实体类字段到MongoDB文档字段的映射规则。我们只需要实现这个接口，把字段名转成大写，再把这个策略配置到Mongo的上下文里就行，所有实体类都会自动应用这个规则。

步骤1：实现自定义字段命名策略 #

创建一个类实现FieldNamingStrategy，重写translate方法，把传入的原字段名转成大写：

import org.springframework.data.mongodb.core.mapping.FieldNamingStrategy;

public class UppercaseFieldNamingStrategy implements FieldNamingStrategy {
    @Override
    public String translate(String fieldName) {
        // 直接将字段名转为大写返回
        return fieldName.toUpperCase();
    }
}

步骤2：配置全局策略到Spring上下文 #

用Java配置类把这个策略绑定到MongoMappingContext，这样所有实体类的字段映射都会使用这个规则：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.core.MongoTemplate;
import org.springframework.data.mongodb.core.mapping.MongoMappingContext;
import com.mongodb.client.MongoClient;

@Configuration
public class MongoConfig {

    @Bean
    public MongoMappingContext mongoMappingContext() {
        MongoMappingContext mappingContext = new MongoMappingContext();
        // 设置我们自定义的大写命名策略
        mappingContext.setFieldNamingStrategy(new UppercaseFieldNamingStrategy());
        return mappingContext;
    }

    @Bean
    public MongoTemplate mongoTemplate(MongoClient mongoClient) {
        // 注意这里要把自定义的mappingContext传入MongoTemplate
        return new MongoTemplate(mongoClient, "your_database_name", mongoMappingContext());
    }
}

验证效果 #

比如我们有一个普通的实体类，完全不用加@Field注解：

public class Product {
    private String id;
    private String productName;
    private Double price;

    // 省略getter、setter和构造方法
}

当你用MongoTemplate保存这个实体时，MongoDB里的文档会变成这样：

{
    "_id": "64a1b2c3d4e5f67890abcdef",
    "PRODUCTNAME": "Wireless Headphones",
    "PRICE": 199.99
}

灵活处理例外情况 #

如果某个字段不想遵循大写规则，直接给它加@Field注解指定字段名就行——@Field的优先级比全局策略高，比如：

public class Product {
    private String id;
    @Field("product_name") // 这个字段会用指定的蛇形命名，而不是大写
    private String productName;
    private Double price;
}

这样就完美满足你的需求了：不用@Field注解、动态设置字段名为大写、适配任意文档、无泛型依赖。

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