Java中动态JSON数据的动态映射实现方案咨询

针对多API返回结构不一致，需要统一转换为jobid和clientName数组的场景，以下是可行的实现逻辑和解决方法：

核心实现逻辑 #

1. 定义映射规则：为每个API建立源字段与目标固定字段的对应关系
2. 匹配数据源：通过API标识或返回字段特征，确定当前处理的数据源类型
3. 批量转换：遍历源数据数组，根据映射规则逐个转换对象格式
4. 容错兜底：处理字段缺失、数据类型异常等情况，避免程序报错

具体解决方法 #

1. 硬编码映射（适合API数量少且固定的场景） #

直接通过条件判断匹配不同API的字段，逻辑简单直观：

function convertApiData(data, apiType) {
  // 先校验输入是否为数组，避免后续报错
  if (!Array.isArray(data)) return [];

  return data.map(item => {
    switch(apiType) {
      case 'api1':
        return {
          jobid: item.jid ?? '',
          clientName: item.clientName ?? ''
        };
      case 'api2':
        return {
          jobid: item.jobId ?? '',
          clientName: item.jClientName ?? ''
        };
      case 'api3':
        return {
          jobid: item.id ?? '',
          clientName: item.jobCName ?? ''
        };
      default:
        return { jobid: '', clientName: '' };
    }
  });
}

// 使用示例
const api3Response = [{ id: 'J003', jobCName: 'C科技' }, { id: 'J004', jobCName: 'D制造' }];
const formattedData = convertApiData(api3Response, 'api3');
console.log(formattedData);

2. 配置化映射（适合API数量多或需频繁新增的场景） #

将映射规则抽离为配置表，新增API时只需添加配置项，无需修改转换逻辑，扩展性更强：

// 全局字段映射配置表，可单独维护在配置文件中
const apiFieldMappings = {
  api1: { jobid: 'jid', clientName: 'clientName' },
  api2: { jobid: 'jobId', clientName: 'jClientName' },
  api3: { jobid: 'id', clientName: 'jobCName' }
};

function convertApiData(data, apiType) {
  if (!Array.isArray(data)) return [];
  const mapping = apiFieldMappings[apiType] || {};

  return data.map(item => ({
    jobid: item[mapping.jobid] ?? '',
    clientName: item[mapping.clientName] ?? ''
  }));
}

// 新增API示例：无需修改转换函数，直接添加配置
apiFieldMappings['api4'] = { jobid: 'jobNo', clientName: 'clientTitle' };

3. 自动字段识别（无明确API标识时的备选方案） #

如果无法通过API标识区分数据源，可通过检测字段存在性自动匹配映射规则：

function convertApiData(data) {
  if (!Array.isArray(data)) return [];

  return data.map(item => {
    // 匹配jobid字段
    const jobid = item.jid ?? item.jobId ?? item.id ?? '';
    // 匹配clientName字段
    const clientName = item.clientName ?? item.jClientName ?? item.jobCName ?? '';
    
    return { jobid, clientName };
  });
}

额外优化建议 #

• 可添加字段类型校验（如确保jobid为字符串类型）
• 对于复杂嵌套的JSON结构，可扩展映射规则支持路径解析（如item.user.info.name）
• 若使用TypeScript，可定义目标格式的接口，提升类型安全性

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