如何在Spring Data JDBC中获取对象属性与表字段名的映射？

你完全没必要自己写反射逻辑，Spring Data JDBC本身就提供了对应的元数据工具类来处理这种映射，以下是具体实现步骤：

1. 核心依赖与类 #

Spring Data JDBC的MappingContext、RelationalPersistentEntity和RelationalPersistentProperty是处理实体映射的核心组件，直接注入这些类就能获取映射信息。

2. 具体代码实现 #

确保项目已引入Spring Data JDBC依赖，然后编写工具类或直接在需要的地方注入JdbcMappingContext：

import org.springframework.data.jdbc.core.mapping.JdbcMappingContext;
import org.springframework.data.relational.core.mapping.RelationalPersistentEntity;
import org.springframework.data.relational.core.mapping.RelationalPersistentProperty;
import org.springframework.stereotype.Component;

import java.util.HashMap;
import java.util.Map;

@Component
public class EntityFieldMappingUtil {

    private final JdbcMappingContext mappingContext;

    // 构造注入JdbcMappingContext
    public EntityFieldMappingUtil(JdbcMappingContext mappingContext) {
        this.mappingContext = mappingContext;
    }

    public <T> Map<String, String> getPropertyColumnMapping(Class<T> entityClass) {
        Map<String, String> mapping = new HashMap<>();
        RelationalPersistentEntity<T> persistentEntity = mappingContext.getRequiredPersistentEntity(entityClass);

        for (RelationalPersistentProperty property : persistentEntity) {
            String propertyName = property.getName();
            // 自动处理@Column注解：有注解取注解值，无注解用默认规则生成字段名
            String columnName = property.getColumnName();
            mapping.put(propertyName, columnName);
        }

        return mapping;
    }
}

3. 使用示例 #

在需要获取映射的地方注入工具类，调用方法即可：

@Autowired
private EntityFieldMappingUtil mappingUtil;

public void getRecordMapping() {
    Map<String, String> recordMapping = mappingUtil.getPropertyColumnMapping(Record.class);
    // 输出结果：{"id":"id_field","name":"name","shortName":"name_short"}
    System.out.println(recordMapping);
}

4. 原理说明 #

• JdbcMappingContext是Spring Data JDBC的核心映射上下文，启动时会扫描所有标注了相关注解的实体类，提前构建好实体与数据库的元数据映射。
• RelationalPersistentEntity对应实体的元数据，包含实体的所有属性信息。
• RelationalPersistentProperty对应单个属性，getColumnName()方法会直接返回属性对应的数据库字段名：如果有@Column注解就取注解指定值，没有则按Spring Data JDBC默认命名规则（比如驼峰转下划线，或原样保留，取决于配置）生成。

这种方式完全复用Spring Data JDBC自身的映射逻辑，不会出现手写反射时可能遗漏的注解处理、命名规则适配等问题，非常适合用于构建关联查询时的字段映射。

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