如何更好的设计你的REST API之基于REST架构的Web Service设计及REST框架实现

关注

原创最新推荐文章于 2026-08-11 11:45:19 发布 1.3k 阅读 AI 写同款· GEO 优化 ›

Web Service架构解析：从SOAP到RESTful API的演进与实践 Web Service作为实现跨平台、跨语言系统间通信的核心技术，其本质是通过标准化协议解决异构系统间的数据交换问题。其工作原理基于客户端-服务器架构，通过定义清晰的接口契约实现松耦合集成。在技术价值层面，Web Service显著提升了系统的互操作性和可维护性，成为企业应用集成和微服务架构的基础。随着技术演进，从早期的SOAP协议到当前主流的RESTful架构，Web Service不断适应新的开发范式。SOAP以其严格的XML格式和WS-*标准体系，在金融、电信等需要高安全性和可靠性的领域仍有应用；而R 阅读详情

一、REST

含状态传输（英文：Representational State Transfer，简称REST）是Roy Fielding博士在2000年他的博士论文中提出来的一种软件架构风格。

目前在三种主流的Web服务实现方案中，因为REST模式与复杂的SOAP和XML-RPC相比更加简洁，越来越多的web服务开始采用REST风格设计和实现。例如：Amazon.com提供接近REST风格的Web服务进行图书查找；雅虎提供的Web服务也是REST风格的。

二、REST的架构设计

　　REST（Representational State Transfer）是一种轻量级的Web Service架构风格，其实现和操作明显比SOAP和XML-RPC更为简洁，可以完全通过HTTP协议实现，还可以利用缓存Cache来提高响应速度，性能、效率和易用性上都优于SOAP协议。

　　REST架构遵循了CRUD原则，CRUD原则对于资源只需要四种行为：Create（创建）、Read（读取）、Update（更新）和Delete（删除）就可以完成对其操作和处理。这四个操作是一种原子操作，即一种无法再分的操作，通过它们可以构造复杂的操作过程，正如数学上四则运算是数字的最基本的运算一样。

　　REST架构让人们真正理解我们的网络协议HTTP本来面貌，对资源的操作包括获取、创建、修改和删除资源的操作正好对应HTTP协议提供的GET、POST、PUT和DELETE方法，因此REST把HTTP对一个URL资源的操作限制在GET、POST、PUT和DELETE这四个之内。这种针对网络应用的设计和开发方式，可以降低开发的复杂性，提高系统的可伸缩性。

三、REST的设计准则

　　REST架构是针对Web应用而设计的，其目的是为了降低开发的复杂性，提高系统的可伸缩性。REST提出了如下设计准则：

l 网络上的所有事物都被抽象为资源（resource）

l 每个资源对应一个唯一的资源标识符（resource identifier）

l 通过通用的连接器接口（generic connector interface）对资源进行操作

l 对资源的各种操作不会改变资源标识符

l 所有的操作都是无状态的（stateless）

四、要点及标准

需要注意的是，REST是设计风格而不是标准。REST通常基于使用HTTP，URI，和XML以及HTML这些现有的广泛流行的协议和标准。

l 资源是由URI来指定。

l 对资源的操作包括获取、创建、修改和删除资源，这些操作正好对应HTTP协议提供的GET、POST、PUT和DELETE方法。

l 通过操作资源的表现形式来操作资源。

l 资源的表现形式则是XML或者HTML，取决于读者是机器还是人，是消费web服务的客户软件还是web浏览器。当然也可以是任何其他的格式。

五、REST的要求

l 客户端和服务器结构

l 连接协议具有无状态性

l 能够利用Cache机制增进性能

l 层次化的系统

l 随需代码 - Javascript （可选）

六、关于状态

应该注意区别应用的状态和连接协议的状态。HTTP连接是无状态的（也就是不记录每个连接的信息），而REST传输会包含应用的所有状态信息，因此可以大幅降低对HTTP连接的重复请求资源消耗。

七、含状态传输的 Web 服务

含状态传输的 Web 服务（也称为 RESTful Web API）是一个使用HTTP并遵循REST原则的Web服务。它从以下三个方面资源进行定义：

l 直观简短的资源地址：URI，比如：http://example.com/resources/。

l 传输的资源：Web服务接受与返回的互联网媒体类型，比如：JSON，XML ，YAML 等。

l 对资源的操作：Web服务在该资源上所支持的一系列请求方法（比如：POST，GET，PUT或DELETE）。

下表列出了在实现含状态传输的 Web 服务时HTTP请求方法的典型用途。

HTTP 请求方法在RESTful Web 服务中的典型应用
资源	GET	PUT	POST	DELETE
一组资源的URI，比如http://example.com/resources/	列出 URI，以及该资源组中每个资源的详细信息（后者可选）。	使用给定的一组资源替换当前整组资源。	在本组资源中创建/追加一个新的资源。该操作往往返回新资源的URL。	删除整组资源。
单个资源的URI，比如http://example.com/resources/142	获取指定的资源的详细信息，格式可以自选一个合适的网络媒体类型（比如：XML、JSON等）	替换/创建指定的资源。并将其追加到相应的资源组中。	把指定的资源当做一个资源组，并在其下创建/追加一个新的元素，使其隶属于当前资源。	删除指定的元素。