当前位置:首页 » 技术资料 » 产品知识库 » 正文

产品功能详解-JSON报文(一):JSON编码器算子详解

产品功能详解 · 算子功能 · 编解码

把结构化对象序列化成 JSON,报文轻一步到位

EasyLink JSON编码器 算子详解

JSON编码器 用于将结构化对象序列化为标准 JSON 字符串:自定义节点别名,开启高级参数后配置输入数据源、输出存储变量,配置字符集与序列化过滤、格式化开关,保存后即完成实体对象转 JSON 报文。JSON 报文体量轻、解析快,是 Web/API 接口场景的主流格式。

📌 来源:聚信万通 · 易连EDI🗓 发布:2026-11-16⏱ 阅读时长:约 5 分钟

一、JSON编码器 是什么

JSON编码器 是“编解码”分组中把结构化对象序列化为 JSON 字符串的算子:从输入参数绑定的变量读取业务实体数据,按配置的字符集完成序列化,结果写入输出参数指定的变量。它还提供三个实用的序列化开关——忽略Null、忽略空值、格式化输出,可以在“报文体量”与“可读性”之间自由取舍。与 XML编码器 相比,JSON 报文更轻、解析更快,是对接 REST 接口与新一代伙伴系统的首选;与 JSON解码器 配对完成 JSON 数据的双向转换。

二、典型使用场景

JSON编码器 适合在流程中把业务数据序列化成 JSON 报文再输出的场景。常见场景如下。

场景解决什么问题预期效果
接口响应输出业务数据需要以 JSON 形式返回调用方输出写入 %{messages.response.content} 即可返回
对接 REST/API 伙伴伙伴系统要求 JSON 格式报文序列化即发送,轻量报文传输快
精简报文体量数据里大量 null 字段、空字符串拖累传输开启忽略Null/忽略空值,报文瘦身
调试与生产取舍调试要看结构,生产要省带宽调试开格式化输出,生产关闭压缩单行
💡 JSON 和 XML 怎么选 两者都是“结构化数据 → 报文”的封装算子,差别在报文形态:JSON 体量轻、解析快,是 Web/API 接口的主流;XML 结构约束强、行业报文标准(如 EDIFACT 延伸体系)多用 XML。对接 REST 接口选 JSON,对接传统 EDI 报文伙伴选 XML,按伙伴要求来即可。

三、参数设置

进入流程设计器界面,打开左边栏的执行单元(编解码),拖拽“JSON编码器”算子。基础配置页面中可设置别名;开启“高级参数”开关后,可配置输入、输出与“配置”分组下的字符集和三个序列化开关,共 6 项参数(默认值中的变量引用表达式可按你的实际流程变量调整)。

图 1  JSON编码器的基础配置页面(高级参数已开启)

参数

类别名称类型高级参数说明默认值
输入输入格式化字符串否从临时变量读取待序列化的结构化数据%{messages.temporary.variables.data}
输出输出格式化字符串否将生成的JSON字符串存入响应内容变量%{messages.response.content}
配置字符集属性下拉是指定JSON序列化使用的编码格式UTF-8
配置忽略Null开关选项是开启后序列化时剔除值为null的字段关闭
配置忽略空值开关选项是开启后序列化时剔除空字符串、空集合字段关闭
配置格式化输出开关选项是开启后生成带换行缩进的美化JSON,关闭为压缩单行JSON开启

参数说明

•  别名:设置流程内算子展示名称,用于区分多个JSON编码节点。

•  输入:绑定上游业务实体变量,作为JSON序列化原始数据,配置示例:%{messages.temporary.variables.data}。

•  输出:接收序列化完成的JSON字符串,向下游接口返回报文,配置示例:%{messages.response.content}。

•  字符集:控制JSON字符编码,避免中文、特殊符号乱码,配置示例:UTF-8。

•  忽略Null:按需过滤null字段,精简输出JSON结构。

•  忽略空值:过滤各类空数据字段,缩减报文体积。

•  格式化输出:调试场景开启美化格式,生产环境可关闭节省传输带宽。

编辑对话框中的示例配置与默认值一致:字符集 UTF-8,忽略Null 与忽略空值保持关闭,格式化输出保持开启。

四、输入与输出端口

算子在流程中以端口衔接上下游,各端口职责如下。

输出

端口类型名称说明
输入输入接收待序列化的结构化数据对象
输出成功序列化成功,按指定字符集输出 JSON 字符串

五、生成的报文长什么样

编码器把输入数据对象序列化为 JSON 字符串。开启“格式化输出”时报文带换行缩进(如下示意),关闭则为压缩单行;开启“忽略Null/忽略空值”后,值为 null 或空的字段不会出现在报文中:

{
  “orderNo”: “PO1”,
  “orderDate”: “2020-05-11”,
  “buyer”: “BYNAME”,
  “shipTo”: “STNAME”,
  “lines”: [
    {
      “lineNo”: 1,
      “item”: “CPN1”,
      “qty”: 6200,
      “price”: “30.0000”
    }
  ]
}

图 2  生成的 JSON 报文结构示意(格式化输出开启状态)

序列化完成后,输出变量(如 %{messages.response.content})中即为 JSON 报文全文,可直接作为接口响应返回,或交给 AS2、文件传输等算子投递给合作伙伴。

六、容易被忽略的配置要点

•  配置项都藏在“高级参数”开关后面

输入、输出与“配置”分组(字符集、三个开关)都在高级参数开关开启后才会显示。只填别名就保存,序列化行为将按默认值执行——伙伴要求 GBK 而你按 UTF-8 发出,轻则乱码、重则对方解析失败。

•  三个开关各管一件事,别混着开

忽略Null 只剔 null 字段,忽略空值管空字符串、空集合等“看着有实际没有”的字段,两者可叠加;格式化输出决定报文形态——调试开美化格式方便看,生产环境关闭省带宽。

•  输入是数据对象,不是报文文本

编码器的输入是“待序列化”的结构化数据(如 %{messages.temporary.variables.data})。若把 JSON 文本喂给编码器,方向就反了——那是 JSON解码器 的活。

⚠ 对方读不了或乱码?先查“字符集”再查“开关” 生成的 JSON 出现乱码或对方解析失败时,按顺序排查:一看“字符集”与伙伴要求是否一致——GBK/UTF-8 选错是最常见错因;二看忽略Null/忽略空值是否误开了——对方必需的字段被剔掉也会解析缺数据;三看输入的数据对象结构是否完整。数据侧问题修上游,配置侧问题改本算子。

七、小结

JSON编码器 是编解码分组中把结构化对象序列化为 JSON 字符串的算子。6 项参数中“字符集”保证编码一致、避免乱码,“忽略Null/忽略空值”负责报文瘦身,“格式化输出”在调试可读与生产带宽之间取舍。它与 JSON解码器 配对完成双向转换,与 XML编码器 按“伙伴要什么格式”分工,与 AS2、文件传输等算子组合即可实现“数据加工—序列化—发送”的完整链路。使用时重点保证字符集与伙伴约定一致、按需配置过滤开关、输入是数据对象而非报文文本。

📌 想进一步了解 EasyLink 的产品能力,欢迎访问 www.sinowintop.com 与我们联系。

易连EDI—EasyLink是由北京聚信万通科技有限公司(以下简称“聚信万通”)经过多年潜心研究成功打造出的新一代国产化EDI产品方案,100%自主研发,拥有完全知识产权的EDI软件,是目前国内唯一通过了Drummond Group AS2 & Odette OFTP2 双国际认证的EDI产品。

🏆以创世界纪录的速度通过AS2国际认证预测试

🏆Drummond Group首次提前完成AS2正式测试

🏆中国唯一通过AS2国际认证的国产EDI软件产品

🏆中国唯一受邀参加新版AS2国际标准制定的公司

🏆中国唯一通过Drummond&Odette双国际认证的公司

🏆EasyLink AS2、OFTP2技术标准支持能力处于世界领先水平

🏆中国唯一同时受邀加入AS2、OFTP2两大国际技术专家组的公司

🏆全球首款原生适配华为自研麒麟PC芯片、鸿蒙PC操作系统的EDI产品

🏆Odette CA官方授权的中国区Odette ID及数字证书的注册审批管理机构

🏆全球首款获得华为鲲鹏技术、openEuler、麒麟、统信、天翼云适配认证的EDI产品

🏆首款实现AI驱动自动化WebEDI开发、数据映射、流程编排、平台迁移的国产EDI软件

易连EDI—EasyLink以其先进的设计理念、强大的功能特性与极致的用户体验,成为企业实现高效、安全数据交换的理想之选。

未经允许不得转载:北京聚信万通科技有限公司 » 产品功能详解-JSON报文(一):JSON编码器算子详解
分享到
0 赞

相关推荐

联系我们

sinowintop

复制已复制
contact@sinowintop.com复制已复制
13810521470复制已复制
微信公众号
sinowintop复制已复制
关注官方微信,了解最新资讯
contact-img
客服邮箱