文章目录
- 一、JSON结构转换是什么?
 - 二、术语解释
 - 三、案例之《JSON对象 To JSON对象》
 - 四、代码实现
 - 五、在线转换工具
 - 六、技术资料
 
一、JSON结构转换是什么?
JSON结构转换指的是将一个JSON对象或JSON数组按照一定规则进行重组、筛选、映射或转换,生成新的JSON对象或数组的过程。这种转换可以包括改变JSON数据的结构、提取特定字段、合并多个JSON数据,或者对数据进行计算和处理等操作。
在JSON结构转换中,常见的操作包括:
- 提取字段:从一个JSON对象中提取特定字段,生成新的JSON对象。
 - 过滤数据:根据条件过滤JSON数据,生成符合条件的新JSON对象或数组。
 - 映射转换:将一个JSON对象中的字段映射到另一个字段,生成新的JSON对象。
 - 合并数据:将多个JSON对象或数组合并成一个新的JSON对象或数组。
 
JSON结构转换通常在数据处理、数据清洗、数据分析等场景中广泛应用。通过结构转换,可以根据需求定制化地处理JSON数据,使其符合特定的业务逻辑或数据格式要求。
 为此我们提供了一个简单开源的JS类库,接下来我们对此类库进行详细讲解。
二、术语解释
1. 规则属性
 规则属性常用于批量属性匹配转换
 规则属性包含两种
- 对象的“ * ”,如a.*、a.*.name、a.*.*、a.*.*.age
 - 数组的“ [*] ”,a[*]、a[*].name
 
三、案例之《JSON对象 To JSON对象》
源JSON结构:
{
    "a": {
        "b": "1",
        "c": {
            "c_child": "2"
        },
        "d": {
            "d_child": "3"
        }
    }
}
 
目标JSON结构:
{
    "b1": {
        "k1": "v1",
        "k2": {
            "k2_child": "v2_child"
        },
        "k3": {
            "k3_child": "v3_child"
        }
    }
}
 
转换需求:
以下需求分别执行
- 将源结构的“a.*”值追加到目标结构的“b1”值
 - 将源结构的“a.*”值替换到目标结构的“b1”值
 - 将源结构的“a.*”值追加到目标结构的“b1”值,使用高级配置中的转换操作【复制源子元素(新Key)】
 - 将源结构的“a.*”键追加到目标结构的“b1”值,高级配置中的转换操作【复制源子元素(原Key)】失效,默认为【复制源子元素(新Key)】
 - 将源结构的“a.*.*”键替换到目标结构的“b1”值
 
四、代码实现
1.将源结构的“a.*”值追加到目标结构的“b1”值
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.ArrayList;
import java.util.List;
/**
 * 对象转换对象
 */
public class Main {
    public static void main(String[] args) {
        ObjectMapper mapper = new ObjectMapper();
        String orgJson = "{\"a\":{\"b\":\"1\",\"c\":{\"c_child\":\"2\"},\"d\":{\"d_child\":\"3\"}}}"; // JSON字符串
        String aimJson = "{\"b1\":{\"k1\":\"v1\",\"k2\":{\"k2_child\":\"v2_child\"},\"k3\":{\"k3_child\":\"v3_child\"}}}"; // JSON字符串
        List<JsonMapping> jsonMappings = new ArrayList<>();
        jsonMappings.add(new JsonMapping("root.b1", "root.a.*", 4,new JsonMappingOptions(0,1,1,1)));
        JsonTranferUtil jsonTranferUtil = null;
        String result ="";
        try {
            jsonTranferUtil = new JsonTranferUtil(orgJson, aimJson, jsonMappings);
            result = jsonTranferUtil.tranJson();
        } catch (Exception e) {
            e.printStackTrace();
        }
        System.out.println("******************结果 **********************");
        System.out.println(result);
    }
}
 
执行结果如下:
 
2.将源结构的“a.*”值替换到目标结构的“b1”值
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.ArrayList;
import java.util.List;
/**
 * 对象转换对象
 */
public class Main {
    public static void main(String[] args) {
        ObjectMapper mapper = new ObjectMapper();
        String orgJson = "{\"a\":{\"b\":\"1\",\"c\":{\"c_child\":\"2\"},\"d\":{\"d_child\":\"3\"}}}"; // JSON字符串
        String aimJson = "{\"b1\":{\"k1\":\"v1\",\"k2\":{\"k2_child\":\"v2_child\"},\"k3\":{\"k3_child\":\"v3_child\"}}}"; // JSON字符串
        List<JsonMapping> jsonMappings = new ArrayList<>();
        jsonMappings.add(new JsonMapping("root.b1", "root.a.*", 4,new JsonMappingOptions(0,2,1,1)));
        JsonTranferUtil jsonTranferUtil = null;
        String result ="";
        try {
            jsonTranferUtil = new JsonTranferUtil(orgJson, aimJson, jsonMappings);
            result = jsonTranferUtil.tranJson();
        } catch (Exception e) {
            e.printStackTrace();
        }
        System.out.println("******************结果 **********************");
        System.out.println(result);
    }
}
 
执行结果如下:
 
3.将源结构的“a.*”值追加到目标结构的“b1”值,使用高级配置中的转换操作【复制源子元素(新Key)】
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.ArrayList;
import java.util.List;
/**
 * 对象转换对象
 */
public class Main {
    public static void main(String[] args) {
        ObjectMapper mapper = new ObjectMapper();
        String orgJson = "{\"a\":{\"b\":\"1\",\"c\":{\"c_child\":\"2\"},\"d\":{\"d_child\":\"3\"}}}"; // JSON字符串
        String aimJson = "{\"b1\":{\"k1\":\"v1\",\"k2\":{\"k2_child\":\"v2_child\"},\"k3\":{\"k3_child\":\"v3_child\"}}}"; // JSON字符串
        List<JsonMapping> jsonMappings = new ArrayList<>();
        jsonMappings.add(new JsonMapping("root.b1", "root.a.*", 4,new JsonMappingOptions(0,1,2,1)));
        JsonTranferUtil jsonTranferUtil = null;
        String result ="";
        try {
            jsonTranferUtil = new JsonTranferUtil(orgJson, aimJson, jsonMappings);
            result = jsonTranferUtil.tranJson();
        } catch (Exception e) {
            e.printStackTrace();
        }
        System.out.println("******************结果 **********************");
        System.out.println(result);
    }
}
 
执行结果如下:
 
4.将源结构的“a.*”键追加到目标结构的“b1”值,高级配置中的转换操作【复制源子元素(原Key)】失效,默认为【复制源子元素(新Key)】
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.ArrayList;
import java.util.List;
/**
 * 对象转换对象
 */
public class Main {
    public static void main(String[] args) {
        ObjectMapper mapper = new ObjectMapper();
        String orgJson = "{\"a\":{\"b\":\"1\",\"c\":{\"c_child\":\"2\"},\"d\":{\"d_child\":\"3\"}}}"; // JSON字符串
        String aimJson = "{\"b1\":{\"k1\":\"v1\",\"k2\":{\"k2_child\":\"v2_child\"},\"k3\":{\"k3_child\":\"v3_child\"}}}"; // JSON字符串
        List<JsonMapping> jsonMappings = new ArrayList<>();
        jsonMappings.add(new JsonMapping("root.b1", "root.a.*", 2,new JsonMappingOptions(0,1,2,1)));
        JsonTranferUtil jsonTranferUtil = null;
        String result ="";
        try {
            jsonTranferUtil = new JsonTranferUtil(orgJson, aimJson, jsonMappings);
            result = jsonTranferUtil.tranJson();
        } catch (Exception e) {
            e.printStackTrace();
        }
        System.out.println("******************结果 **********************");
        System.out.println(result);
    }
}
 
执行结果如下:
 
5.将源结构的“a.*.*”键替换到目标结构的“b1”值
注意:为了演示,我们将源模板中的a.b属性去掉了
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.ArrayList;
import java.util.List;
/**
 * 对象转换对象
 */
public class Main {
    public static void main(String[] args) {
        ObjectMapper mapper = new ObjectMapper();
        String orgJson = "{\"a\":{\"c\":{\"c_child\":\"2\"},\"d\":{\"d_child\":\"3\"}}}"; // JSON字符串
        String aimJson = "{\"b1\":{\"k1\":\"v1\",\"k2\":{\"k2_child\":\"v2_child\"},\"k3\":{\"k3_child\":\"v3_child\"}}}"; // JSON字符串
        List<JsonMapping> jsonMappings = new ArrayList<>();
        jsonMappings.add(new JsonMapping("root.b1", "root.a.*.*", 4,new JsonMappingOptions(0,2,1,1)));
        JsonTranferUtil jsonTranferUtil = null;
        String result ="";
        try {
            jsonTranferUtil = new JsonTranferUtil(orgJson, aimJson, jsonMappings);
            result = jsonTranferUtil.tranJson();
        } catch (Exception e) {
            e.printStackTrace();
        }
        System.out.println("******************结果 **********************");
        System.out.println(result);
    }
}
 
执行结果如下:
 
五、在线转换工具
为了让使用者更加方便的配置出映射关系,为此开发了一套在线转换工具,可在工具中通过拖拽即可配置想要的结构转换关系,并可对转换关系所能实现的效果实时进行预览更改。
工具地址:数据转换工具
 
六、技术资料
- Github:edq-ebara/data-transformation-javascript: 数据转化(javascript) (github.com)
 - 技术探讨QQ群:775932762
 - 工具连接:数据转换工具
 - 御控官网:https://www.yu-con.com/
 


















