RESTful API 与 Web 服务的比较-JavaScript中文网-JavaScript教程资源分享门户

随着业务的发展，越来越多的企业需要开发并提供各种 Web 服务来满足客户需求。RESTful API 和 Web 服务作为常见的两种技术方案，都能够实现数据传输和服务调用。然而，它们之间存在一些区别。本文将会对这两个技术方案进行深入比较，并提供一些指导意义。

RESTful API 和 Web 服务的概念

RESTful API 是一种基于 HTTP 协议的 Web 系统架构风格。其核心设计理念是“资源”的定义和访问，通过 HTTP 中的一个 URI 来表示一个资源，通过 HTTP 中的一个方法来定义对该资源进行的操作。一般使用 JSON 或 XML 格式的数据传输。

Web 服务是一种基于 Web 的接口技术。它提供了基于统一协议的分布式方法，使得应用程序之间可以进行数据交换和通信。Web 服务使用 SOAP (Simple Object Access Protocol) 或 REST (Representational State Transfer) 协议进行通信，可以在不同技术和平台之间互相通信，以实现功能的共享。

RESTful API 和 Web 服务的比较

架构模式

RESTful API 和 Web 服务的最大区别在于架构模式。RESTful API 是基于资源的架构模式，而 Web 服务是基于服务的架构模式。

RESTful API 架构模式

RESTful API 是一种基于资源的架构模式。它建议使用 HTTP 协议中所提供的 GET、POST、PUT、DELETE 等 HTTP 动词来进行资源的访问和操作。RESTful API 常常被用于构建分布式系统，以提供系统之间的数据交换和调用。

Web 服务架构模式

Web 服务是一种基于服务的架构模式。就像其名称中的“服务”一样，它主要关注的是应用程序提供的服务，而不是资源。Web 服务常常使用 SOAP 协议进行通信，并使用 WSDL (Web Services Description Language) 描述服务接口。

数据格式

RESTful API 和 Web 服务除了在架构模式上不同，还有在数据格式上的差异。RESTful API 使用 JSON 或 XML 格式对数据进行传输，而 Web 服务通常使用 SOAP 格式。

RESTful API 数据格式

RESTful API 基于 HTTP 协议进行传输和交互，一般使用 JSON 或 XML 格式的数据来交换。这种方式有着良好的可读性和可扩展性。

Web 服务数据格式

Web 服务使用 SOAP (Simple Object Access Protocol) 格式进行传输，SOAP 格式是一种 XML 格式，具有更加明确的语义和严格的规范。但是，它的数据传输量相比于 JSON 或 XML 更加庞大，可能存在传输效率较低的问题。

执行效率

由于 RESTful API 采用 JSON 或 XML 格式进行数据的传输与交互，相比于 Web 服务的 SOAP 格式，数据传输量更小，效率更高。而且 RESTful API 架构模式是基于资源而不是服务的，从而更加灵活可扩展。

安全性

在安全方面，RESTful API 和 Web 服务都采用基于 HTTPS 的 SSL/TLS 加密传输协议，对于数据传输过程中的安全可以保证。但是 RESTful API 对于访问控制和数据加密，需要应用自行决定处理方案，而 Web 服务可以采用 WS-Security 进行访问控制和数据加密，对于安全性更加的细致和完善。

RESTful API 和 Web 服务的适用场景

RESTful API 适用场景

RESTful API 更适用于轻量级、简单的 Web 系统，尤其是面向 Web 移动端的应用。它可以为一些无状态的 API 提供数据传输和服务调用，具有良好的可读性和可扩展性。例如，一些前端框架会使用 RESTful API，作为客户端与服务器之间数据交互的接口。同时，业内已形成很成熟商业化服务的 RESTful API 平台，开发者也可以使用这些平台快速部署应用程序。

Web 服务适用场景

Web 服务适用于复杂、高耦合度和安全性要求高的系统。例如，金融银行领域中，Web 服务可以被用于处理大量的实时交易数据，确保数据的安全性和完整性。同时，Web 服务支持集成第三方服务，例如以谷歌地图为数据源的应用。

示例代码

RESTful API 示例

// javascriptcn.com 代码示例
// 查询用户列表
// GET /users
fetch('/users')
  .then(res => res.json())
  .then(data => {
    // data 为后端返回的用户列表，进行页面数据展示
  });

// 查询单个用户详情
// GET /users/{userID}
fetch(`/users/${userID}`)
  .then(res => res.json())
  .then(data => {
    // data 为后端返回的单个用户详情，进行页面数据展示
  });

// 新增用户
// POST /users
const userData = {
  name: 'zhangsan',
  age: 26,
  gender: 'male'
};
fetch('/users', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(userData)
}).then(res => {
  // 如果新增成功，则返回用户新建成功的 ID
});

// 更新用户信息
// PUT /users/{userID}
const updateData = {
  age: 28
};
fetch(`/users/${userID}`, {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(updateData)
}).then(res => {
  // 如果更新成功，则返回更新后该用户的信息
});

// 删除用户
// DELETE /users/{userID}
fetch(`/users/${userID}`, {
  method: 'DELETE',
}).then(res => {
  // 如果删除成功，则返回 true，否则返回 false
});

Web 服务示例

// javascriptcn.com 代码示例
// 查询交易记录
// WebService Endpoint： http://192.168.0.1/TransactionService
// WebService 方法名称：GetTransactionHistory
var xmlhttp = new XMLHttpRequest();
xmlhttp.onreadystatechange = function() {
    if (this.readyState == 4 && this.status == 200) {
        const data = JSON.parse(this.responseText);
        // data 为后端返回的交易记录数据，进行页面数据展示
    }
};
xmlhttp.open("POST", "http://192.168.0.1/TransactionService.asmx?op=GetTransactionHistory", true);
xmlhttp.setRequestHeader("Content-Type", "text/xml;charset=UTF-8");
xmlhttp.send(`<?xml version="1.0" encoding="UTF-8"?>
  <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://192.168.0.1">
  <soapenv:Header/>
  <soapenv:Body>
    <ser:GetTransactionHistory>
      <ser:username>${username}</ser:username>
      <ser:password>${password}</ser:password>
    </ser:GetTransactionHistory>
  </soapenv:Body>
  </soapenv:Envelope>`);

总结

本文对 RESTful API 和 Web 服务进行了比较和分析，总结如下：

RESTful API 是基于资源的架构模式，Web 服务是基于服务的架构模式。
RESTful API 使用 JSON 或 XML 格式进行数据传输，Web 服务使用 SOAP 格式。
RESTful API 与 Web 服务的执行效率、安全性和适用场景有所不同。

对于前端开发者来说，熟练掌握 RESTful API 和 Web 服务的使用，可以帮助我们更好地理解服务端的架构，更有效地与服务端进行交互，提高工作效率。

来源：JavaScript中文网，转载请注明来源本文地址：https://www.javascriptcn.com/post/6548c76f7d4982a6eb309a17