web 服务最经典的两种接口方式是 SOAP 和 REST,二者都是跨系统远程调用的标准方案,核心目标是让不同语言不同平台的程序通过网络互相请求数据,但是设计思路报文格式协议约束差别很大。SOAP 属于基于 XML 的重型协议,自带完整规范,支持 WS 安全事务等高级能力,多用于企业内部异构系统对接金融政务这类对可靠性要求很高的场景。REST 属于轻量级架构风格,依托 HTTP 协议,一般使用 JSON 作为数据格式,没有强制复杂规范,现在互联网项目前后端分离开放 API 绝大多数都选用 REST 这种接口方式。很多初学者容易混淆,SOAP 是严格协议,REST 本身不是协议,是一套设计规范,底层仍然跑在 HTTP 之上,这也是两种接口方式最本质的区别,理解这个点之后,再去学习报文结构请求特点适用场景就会清晰很多。
SOAP 接口方式详解
SOAP 全称简单对象访问协议,报文固定使用 XML 格式,请求和响应都封装在 SOAP 信封里面,结构固定,包含信封头信封体,还可以附加错误信息。它依赖 WSDL 文件描述接口,客户端可以读取 WSDL 自动生成调用代码,接口定义非常明确。
特点清单
1 数据格式固定 XML,可读性一般,报文体积偏大
2 协议标准化程度高,原生支持 WS Security WS Transaction 安全加密事务回滚
3 跨平台跨语言兼容性强,老企业系统集成大量使用
4 学习和开发成本偏高,调试相对麻烦
REST 接口方式详解
REST 全称表述性状态转移,它是架构风格,不是强制协议,复用 HTTP 本身的方法语义,GET 查询 POST 新增 PUT 更新 DELETE 删除,数据大多使用 JSON,也可以使用 XML。接口一般通过 URL 标识资源,围绕资源做操作,没有强制 WSDL,接口文档一般使用 Swagger OpenAPI 维护。
特点清单
1 轻量,JSON 报文体积小,传输效率更高
2 直接使用 HTTP 状态码表达结果,200 成功 404 不存在 500 服务器错误
3 开发调试简单,浏览器 Postman 都可以直接测试
4 灵活度高,但是没有强制标准,团队需要自行约定规范
两种接口方式对照表
| 对比项目 | SOAP | REST |
|---|---|---|
| 本质 | 正式协议 | 架构风格 |
| 数据格式 | XML 为主 | JSON 为主 |
| 接口描述 | WSDL | OpenAPI Swagger |
| HTTP 方法 | 不依赖 HTTP 语义 | 充分使用 GET POST PUT DELETE |
| 高级能力 | 原生支持安全事务 | 需要额外自行实现 |
| 报文体积 | 大 | 小 |
| 性能 | 相对偏低 | 相对更高 |
| 主流场景 | 企业老系统金融政务 | 互联网前后端分离开放 API |
选型思路
如果项目是新开发互联网产品,优先选择 REST 接口方式,开发快调试方便生态成熟。如果对接已经存在的 legacy 老系统,业务需要事务保证数字签名强安全规范,那就继续沿用 SOAP 接口方式。现在还有 GraphQL 这类新方案,但传统教材里面 web 服务两种接口方式考点,固定就是 SOAP 和 REST,课程考试一般不会把 GraphQL 算作这两种里面。
【常见问题】
问题 1 web 服务的两种接口方式里面 SOAP 是不是只能用 HTTP 传输
回答 1 不是,SOAP 接口方式除了 HTTP,还可以跑在其他传输协议之上,REST 接口方式则是建立在 HTTP 协议之上。
问题 2 web 服务的两种接口方式哪个现在互联网项目用得更多
回答 1 当前互联网新项目里面 REST 接口方式使用更多,SOAP 接口方式主要保留在传统企业遗留系统对接场景。
问题 3 web 服务的两种接口方式都可以跨编程语言调用吗
回答 1 是的,SOAP 和 REST 这两种 web 服务接口方式都支持跨语言跨平台调用,只是实现机制和报文格式不一样。
问题 4 web 服务的两种接口方式报文都可以用 JSON 吗
回答 1 REST 接口方式默认常用 JSON,SOAP 接口方式标准是 XML,一般不会默认使用 JSON 作为报文格式。
【免责申明】
本文内容仅作为计算机课程学习参考,不同教材对 web 服务的两种接口方式表述略有差异,考试答题请以任课老师和指定教材为准。


