一、 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": \[
\[
{
"c\_child": \["2"]
}
],
\[ { "d\_child": \["3"]
}
],
\[ { "e\_child": \["4"]
}
]
]
}
目标JSON结构：
{
"b1": \[
\[
{
"k1\_child":"v1\_child"
}
],
\[ { "k2\_child":"v2\_child" } ],
\[ { "k3\_child":"v3\_child" } ]
]
}
转换需求：
以下需求分别执行
- 将源结构的“a[*]”值追加到目标结构的“b1”值
- 将源结构的“a[*]”值替换到目标结构的“b1”值
- 将源结构的“a[*]”值追加到目标结构的“b1”值，由于是数组所以转换操作配置失效
- 将源结构的“a[*]”键追加到目标结构的“b1”值，由于是数组所以转换操作配置失效
- 将源结构的“a[][]”值追加到目标结构的“b1”值
四、 代码实现
- 将源结构的“a[*]”值追加到目标结构的“b1”值
importJsonTranferUtilfrom'./json\_transfer\_new'
constjsonOrg= {
"a": \[ \[ { "c\_child": \["2"]
}
],
\[ { "d\_child": \["3"]
}
],
\[ { "e\_child": \["4"]
}
]
]
};
constjsonAim= {
"b1": \[ \[ { "k1\_child":"v1\_child" } ],
\[ { "k2\_child":"v2\_child" } ],
\[ { "k3\_child":"v3\_child" } ]
]
};
/// 转换类型
/// 1：源Key->目标Key
/// 2：源Key->目标Value
/// 3：源Value->目标Key
/// 4：源Value->目标Value
constmappings= \[ { "AimJsonPath":"root.b1", "OrgJsonPath":"root.a\[\*]", "TranType":4, "Options": { "KeyInitIndex":0, "AddElementsOption":"1", "TranOP":"1", "TranWay":"1" } }];
/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* 测试程序\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* \*/
letjsonTranferUtil=newJsonTranferUtil(jsonOrg, jsonAim, mappings);
letresult=jsonTranferUtil.tranJson();
console.log("*************************最终转换结果*************************\*\*\*\*\*\*\*\*")
console.log(JSON.stringify(result), 88888888888)
执行结果如下：
- 将源结构的“a[*]”值替换到目标结构的“b1”值
importJsonTranferUtilfrom'./json\_transfer\_new'
constjsonOrg= {
"a": \[ \[ { "c\_child": \["2"]
}
],
\[ { "d\_child": \["3"]
}
],
\[ { "e\_child": \["4"]
}
]
]
};
constjsonAim= {
"b1": \[ \[ { "k1\_child":"v1\_child" } ],
\[ { "k2\_child":"v2\_child" } ],
\[ { "k3\_child":"v3\_child" } ]
]
};
/// 转换类型
/// 1：源Key->目标Key
/// 2：源Key->目标Value
/// 3：源Value->目标Key
/// 4：源Value->目标Value
constmappings= \[ { "AimJsonPath":"root.b1", "OrgJsonPath":"root.a\[\*]", "TranType":4, "Options": { "KeyInitIndex":0, "AddElementsOption":"2", "TranOP":"1", "TranWay":"1" } }];
/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* 测试程序\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* \*/
letjsonTranferUtil=newJsonTranferUtil(jsonOrg, jsonAim, mappings);
letresult=jsonTranferUtil.tranJson();
console.log("*************************最终转换结果*************************\*\*\*\*\*\*\*\*")
console.log(JSON.stringify(result), 88888888888)
执行结果如下：
- 将源结构的“a[*]”值追加到目标结构的“b1”值，由于是数组所以转换操作配置失效
importJsonTranferUtilfrom'./json\_transfer\_new'
constjsonOrg= {
"a": \[ \[ { "c\_child": \["2"]
}
],
\[ { "d\_child": \["3"]
}
],
\[ { "e\_child": \["4"]
}
]
]
};
constjsonAim= {
"b1": \[ \[ { "k1\_child":"v1\_child" } ],
\[ { "k2\_child":"v2\_child" } ],
\[ { "k3\_child":"v3\_child" } ]
]
};
/// 转换类型
/// 1：源Key->目标Key
/// 2：源Key->目标Value
/// 3：源Value->目标Key
/// 4：源Value->目标Value
constmappings= \[ { "AimJsonPath":"root.b1", "OrgJsonPath":"root.a\[\*]", "TranType":4, "Options": { "KeyInitIndex":0, "AddElementsOption":"1", "TranOP":"2", "TranWay":"1" } }];
/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* 测试程序\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* \*/
letjsonTranferUtil=newJsonTranferUtil(jsonOrg, jsonAim, mappings);
letresult=jsonTranferUtil.tranJson();
console.log("*************************最终转换结果*************************\*\*\*\*\*\*\*\*")
console.log(JSON.stringify(result), 88888888888)
执行结果如下：
- 将源结构的“a[*]”键追加到目标结构的“b1”值，由于是数组所以转换操作配置失效
importJsonTranferUtilfrom'./json\_transfer\_new'
constjsonOrg= {
"a": \[ \[ { "c\_child": \["2"]
}
],
\[ { "d\_child": \["3"]
}
],
\[ { "e\_child": \["4"]
}
]
]
};
constjsonAim= {
"b1": \[ \[ { "k1\_child":"v1\_child" } ],
\[ { "k2\_child":"v2\_child" } ],
\[ { "k3\_child":"v3\_child" } ]
]
};
/// 转换类型
/// 1：源Key->目标Key
/// 2：源Key->目标Value
/// 3：源Value->目标Key
/// 4：源Value->目标Value
constmappings= \[ { "AimJsonPath":"root.b1", "OrgJsonPath":"root.a\[\*]", "TranType":2, "Options": { "KeyInitIndex":0, "AddElementsOption":"1", "TranOP":"2", "TranWay":"1" } }];
/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* 测试程序\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* \*/
letjsonTranferUtil=newJsonTranferUtil(jsonOrg, jsonAim, mappings);
letresult=jsonTranferUtil.tranJson();
console.log("*************************最终转换结果*************************\*\*\*\*\*\*\*\*")
console.log(JSON.stringify(result), 88888888888)
执行结果如下：
- 将源结构的“a[][]”值追加到目标结构的“b1”值
importJsonTranferUtilfrom'./json\_transfer\_new'
constjsonOrg= {
"a": \[ \[ { "c\_child": \["2"]
}
],
\[ { "d\_child": \["3"]
}
],
\[ { "e\_child": \["4"]
}
]
]
};
constjsonAim= {
"b1": \[ \[ { "k1\_child":"v1\_child" } ],
\[ { "k2\_child":"v2\_child" } ],
\[ { "k3\_child":"v3\_child" } ]
]
};
/// 转换类型
/// 1：源Key->目标Key
/// 2：源Key->目标Value
/// 3：源Value->目标Key
/// 4：源Value->目标Value
constmappings= \[ { "AimJsonPath":"root.b1", "OrgJsonPath":"root.a\[*]\[*]", "TranType":4, "Options": { "KeyInitIndex":0, "AddElementsOption":"1", "TranOP":"1", "TranWay":"1" } }];
/\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* 测试程序\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* \*/
letjsonTranferUtil=newJsonTranferUtil(jsonOrg, jsonAim, mappings);
letresult=jsonTranferUtil.tranJson();
console.log("*************************最终转换结果*************************\*\*\*\*\*\*\*\*")
console.log(JSON.stringify(result), 88888888888)
执行结果如下：
五、 在线转换工具
为了让使用者更加方便的配置出映射关系，为此开发了一套在线转换工具，可在工具中通过拖拽即可配置想要的结构转换关系，并可对转换关系所能实现的效果实时进行预览更改。
工具地址： 数据转换工具
六、 技术资料
Ø Github: edq-ebara/data-transformation-javascript: 数据转化（javascript） (github.com)
Ø 技术探讨QQ群：775932762
Ø 工具连接： 数据转换工具
Ø 官网连接： 官网地址
