0

0

如何将REST API的JSON响应映射为SOAP XML请求

畫卷琴夢

畫卷琴夢

发布时间:2026-01-15 09:01:58

|

380人浏览过

|

来源于php中文网

原创

REST JSON响应结构决定XML层级,硬编码转换必错;需依data字段嵌套、数组、null等动态生成SOAP,配合WSDL命名空间与XSD格式严格校验。

如何将rest api的json响应映射为soap xml请求

REST JSON 响应结构决定 XML 元素层级

直接硬编码转换必然出错,关键看 REST 接口返回的 data 字段是否嵌套、是否有数组、是否存在空值或 null。比如响应里是 {"user": {"id": 123, "profile": {"name": "Alice"}}},那 SOAP 的 下就得有 子元素,不能 flatten 成平级字段。

  • 遇到 Array 类型(如 "orders": [{"id": "A1"}, {"id": "A2"}]),SOAP 中需用重复元素(如多个 )或包装容器(如 ...
  • null 或缺失字段在 SOAP 中通常省略,除非 WSDL 明确要求 nillable="true" 并需带上 xsi:nil="true"
  • 注意字段命名冲突:JSON 键名 user_id 在 XML 中建议转为 userId(驼峰)或保持下划线,但必须与 WSDL 定义一致

用 Python 的 dicttoxmlxmltodict 反向生成时的陷阱

这两个库不处理命名空间、SOAP Envelope 包装、必需的 xmlnsxsi 前缀——它们只生成裸 XML。强行用 dicttoxml.dicttoxml(response_data) 得到的是无效 SOAP 请求。

  • 必须手动添加 SOAP 外层:...
  • 目标命名空间(如 xmlns:ns="http://example.com/ws")要从 WSDL 的 提取,并用于包裹操作元素(如
  • xmltodict 适合解析已有 SOAP 响应,不适合构造请求;它把 XML 转成 dict 后再转回,会丢失属性顺序和命名空间声明

真实项目中推荐的三步构造法

跳过通用序列化库,用模板 + 显式映射更可控。尤其当 REST 和 SOAP 字段语义不完全对齐时(比如 JSON 用 created_at,WSDL 要求 creationTimestamp)。

造好物
造好物

一站式AI造物设计平台

下载
  • 第一步:解析 WSDL,提取目标操作的输入结构,用工具zeep client.wsdl.dump() 或在线 WSDL 查看器确认 GetUserRequest 的 exact 元素名、类型、是否可选
  • 第二步:写一个轻量映射函数,例如:
    def json_to_soap_request(json_resp):
        return {
            "userId": json_resp["user"]["id"],
            "userName": json_resp["user"].get("profile", {}).get("name", ""),
            "timestamp": datetime.now().isoformat()  # 补充 SOAP 要求但 JSON 没有的字段
        }
  • 第三步:用 lxml.etree 或字符串模板填充命名空间和 Envelope,避免拼接错误。例如用 etree.Element("{http://schemas.xmlsoap.org/soap/envelope/}Envelope") 确保前缀绑定正确

调试时必查的三个 XML 错误点

SOAP 请求失败 80% 是 XML 结构问题,不是逻辑错误。抓包看实际发出的请求体,对照 WSDL 验证以下三点:

  • 根元素名是否匹配 WSDL 中 对应的 所引用的消息名(通常是 GetUserRequest,不是 GetUser
  • 所有元素是否在正确的命名空间下——比如 中的 ns 必须与 WSDL 的 targetNamespace 一致,且该 namespace 已在 Envelope 中声明
  • 日期/数字格式是否符合 XSD 类型:JSON 的 "2024-05-20" 传给 XSD xs:dateTime 字段时,必须补全时间部分变成 "2024-05-20T00:00:00Z",否则服务器校验失败

最易被忽略的是 WSDL 中定义的 elementFormDefault="qualified" —— 这意味着所有局部元素(非顶层)也必须带命名空间前缀,哪怕你没写,生成器也得强制加上。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

753

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

636

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

758

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

618

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1262

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

577

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

707

2023.08.11

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 0.7万人学习

Django 教程
Django 教程

共28课时 | 3.1万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号