如何转换JSON布局格式？寻求适配多用户的免编码技术工具

针对你的Spring Boot REST接口场景，推荐以下几种无需新增编码（或仅需少量配置）的解决方案，适配不同用户的JSON响应格式需求：

1. JSON模板引擎（Mustache/Handlebars） #

• 核心逻辑：给每个用户的JSON格式写独立模板，接口根据用户标识加载对应模板，把业务数据填进去直接输出。
• 操作步骤：
  • 引入模板引擎依赖，比如com.github.spullara.mustache.java:compiler
  • 为每个用户创建JSON模板文件，比如layout1.mustache完全对应user1的格式：

    {
      "user2": "{{userId}}",   
      "eligibileCount":"{{eligibileCount}}",
      "business":"{{business}}",
      "metalLevel":"{{metalLevel}}",
      "productType":"{{productType}}",
      "planCode":"{{planCode}}",
      "planType":"{{planType}}",
      "nationalAccess":"{{nationalAccess}}",
      "metalTier":"{{metalTier}}",
      "licenseType":"{{licenseType}}",
      "pcpRequired":"{{pcpRequired}}",
      "packageInd":"{{packageInd}}"
    }
    

  • 接口里根据请求里的用户标识（比如请求头、参数）加载对应模板，把业务DTO的数据传入渲染，直接返回字符串形式的JSON。
• 优势：新增用户只需要加模板文件，不用改代码；模板结构和用户要求的格式完全一致，直观好维护。

2. 配置驱动的字段映射+动态JSON构建 #

• 核心逻辑：用YAML/JSON配置文件定义每个用户的字段映射规则（包括重命名、嵌套结构），代码读取配置后动态把统一的DTO转换成目标JSON。
• 操作步骤：
  • 写映射配置文件user-layouts.yaml：

    layouts:
      user1:
        fields:
          user2: "userId"
          eligibileCount: "eligibileCount"
          business: "business"
          metalLevel: "metalLevel"
          # 其他字段一一对应
      user2:
        fields:
          user2: "userId"
          eligibileCount: "eligibileCount"
          metalInfo:
            level: "metalLevel"
            tier: "metalTier"
          planInfo:
            code: "planCode"
            type: "planType"
          # 其他字段映射
    

  • 写配置类加载这个文件，再写转换工具类：根据用户标识拿映射规则，用反射或BeanUtils取DTO字段值，递归用Jackson的ObjectNode构建嵌套JSON。
  • 接口里根据用户标识调用转换工具生成JSON返回。
• 优势：配置集中管理，新增用户只加配置节点；不用写模板，适合结构规整的场景。

3. 自定义Spring HttpMessageConverter #

• 核心逻辑：扩展Spring的MappingJackson2HttpMessageConverter，根据用户标识切换不同的序列化视图或ObjectMapper配置，实现动态序列化。
• 操作步骤：
  • 为每个用户创建序列化视图类：

    public class User1Views {
        public static class Public {}
    }
    public class User2Views {
        public static class Public {}
    }
    

  • 在业务DTO上用@JsonView标记不同视图下要返回的字段，嵌套结构可以用getter生成：

    public class BusinessDTO {
        @JsonView({User1Views.Public.class, User2Views.Public.class})
        private String userId;
        @JsonView({User1Views.Public.class, User2Views.Public.class})
        private String eligibileCount;
        
        @JsonView(User1Views.Public.class)
        private String metalLevel;
        @JsonView(User1Views.Public.class)
        private String metalTier;
        
        @JsonView(User2Views.Public.class)
        public MetalInfo getMetalInfo() {
            return new MetalInfo(metalLevel, metalTier);
        }
        // 其他字段和嵌套结构处理
    }
    

  • 自定义Converter，根据请求头（比如X-User-Id）切换视图：

    public class DynamicJsonConverter extends MappingJackson2HttpMessageConverter {
        @Override
        protected void writeInternal(Object object, Type type, HttpOutputMessage outputMessage) throws IOException {
            String userId = outputMessage.getHeaders().getFirst("X-User-Id");
            ObjectMapper mapper = new ObjectMapper();
            if ("user1".equals(userId)) {
                mapper.writerWithView(User1Views.Public.class).writeValue(outputMessage.getBody(), object);
            } else if ("user2".equals(userId)) {
                mapper.writerWithView(User2Views.Public.class).writeValue(outputMessage.getBody(), object);
            } else {
                super.writeInternal(object, type, outputMessage);
            }
        }
    }
    

  • 把自定义Converter注册到Spring MVC配置里。
• 优势：用Spring原生机制，适合需要严格控制序列化逻辑的场景；新增用户只需加视图类和DTO注解。

4. JSON转换工具库（Jolt） #

• 核心逻辑：用Jolt这类专门的JSON转换工具，通过定义转换规则（Spec），把统一的源JSON转换成不同用户的目标格式。
• 操作步骤：
  • 引入Jolt依赖com.bazaarvoice.jolt:jolt-core
  • 为每个用户写转换Spec，比如user2的Spec：

    [
      {
        "operation": "shift",
        "spec": {
          "userId": "user2",
          "eligibileCount": "eligibileCount",
          "business": "business",
          "metalLevel": "metalInfo.level",
          "metalTier": "metalInfo.tier",
          "planCode": "planInfo.code",
          "planType": "planInfo.type",
          // 其他字段映射
        }
      }
    ]
    

  • 接口里先把DTO序列化成源JSON，根据用户标识加载对应Spec，用Jolt的Chainr执行转换，返回结果。
• 优势：专注JSON结构变换，规则成熟，适合复杂嵌套结构；新增用户只需写转换Spec。

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