本书是《RESTful Web Services Cookbook》的中文翻译版。 本书从实践出发，涉及设计RESTful Web服务的各个方面，通过问题描述、解决方案、问题讨论的形式在14个章节中详细讨论了统一接口、资源、表述、URI、链接、请求、缓存、安全等诸多内容。无论读者是否设计过RESTf……

O'Reilly Media通过图书、杂志、在线服务、调查研究和会议等方式传播创新知识。自1978年开始，O'Reilly一直都是前沿发展的见证者和推动者。超级极客们正在开创着未来，而我们关注真正重要的技术趋势——通过放大那些“细微的信号”来刺激社会对新科技的应用。作为技术社区中活跃的参与者，O'R……

推荐序 从3万英尺到3英尺 REST（表述性状态转移）是一种与DO（分布式对象）、RPC（远程过程调用）齐名的分布式应用架构风格（architectural style）。REST诞生于Roy Fielding（HTTP 1.1协议的主要设计者）在2000年所著的博士论文“Architectural……

有人说计算机搞的是科学，也有人说计算机搞的是工程，于是大学里的计算机系通常叫“计算机科学与工程系”。两种说法究竟孰对孰错，我们不去深究，但请允许我做一个也许不怎么恰当的对比： 1905年，Albert Einstein提出了具有划时代意义的相对论，100年过去了，绝大多数人只是知道世上有这么一个伟大……

2000年，HTTP和URI的关键贡献者Roy Fielding在题为“Architectural Styles and the Design of Network-Based Software Architectures”的博士论文中精确地阐述了Web的架构。在这篇论文中，他引入了一种名为表述性状……

HTTP是一种应用层协议，它定义了客户端与服务器之间的转移在此协议中，诸如GET，POST，PUT和DELETE之类的方法是对资源的操作。有了它，您就无须创造createOrder，getStatus，updateStatus等应用程序特定的操作了。能从HTTP基础设施中获得多少收益，主要取决于您把……

开发RESTful Web服务的首要步骤之一就是设计资源模型。资源模型对所有客户端用来与服务器交互的资源加以识别和分类。在设计RESTful Web服务的所有工作，如资源的识别、媒体类型和格式的选择以及统一接口的应用中，资源的识别是最灵活的部分。 由于HTTP的可见性（详见1.1节），您可以使用诸如……

客户端所关心的资源是一个抽象的实体，它是用URI来标识的。另一方面，表述是具体而真实的，您在客户端和服务器上针对它编写代码，进行操作。 回想一下1.1节，HTTP在请求和响应中为表述提供了一种包装格式。设计表述涉及（a）使用HTTP提供的格式包含正确的标头，（b）当表述有正文时，为正文选择合适的媒体……

URI是跨越Web的资源描述符，一个URI由以下内容组成——协议（例如http和https）、主机（例如www.example.org）、端口号，后面紧跟一段或多段路径（例如/user/1234），还有查询字符串。在本章中，我们将关注于为RESTful Web服务设计URI。 4.1节，“如何设计U……

链接提供了一种方式，可以从一个资源导航到另一个资源。日常生活中有很多链接的例子。旅行者使用路牌和地图来决定走哪条路。书籍和文章使用脚注和参考文献把读者引向相关的资料。在软件方面，我们使用变量和指针在应用程序的不同环节之间建立链接。 万维网基于同样的原则。HTML文档使用锚（anchor）和表单让用户……

Atom Syndication Format（RFC4287）和Atom Publishing Protocol（也称为AtomPub,RFC5023）中定义了一些资源（比如Entry与Feed，还有它们的表述）以及操作这些资源的协议。Atom的设计中使用了易于阅读的内容，比如HTML和纯文本。它……

内容协商（Content Negotiation），有时也简写为conneg，该过程用于当存在多个可用的资源表述形式时，为客户端选择一个最好的出来。内容协商常用于标明媒介类型的偏好，但它也可以用于标明本地化语言、字符编码以及压缩方面的偏好。 HTTP指定了两种类型的内容协商。分别是服务器驱动（ser……

查询信息是HTTP GET方法的一种常见应用。查询通常涉及三个组成部分，即过滤（filtering）、排序（sorting）和投影（projection）。过滤是基于一些过滤条件选择实体的一个子集的过程。排序会影响服务器是如何排列响应中结果的。投影是选择实体中的哪些字段将被包含到结果中的过程。例如，……

缓存是构建于HTTP统一接口之上的最有用的功能之一。可以利用缓存减少终端用户感知到的延时，增加可靠性，减少带宽使用和成本，降低服务器负载。缓存无处不在，可以在服务器网络里、内容分发网络（content delivery network，简称CDN）或是客户端网络里（通常被称为转发代理）。 通常所说的……

HTTP中的条件请求（conditional request）着眼于两个问题。对于GET请求，条件请求帮助客户端和缓存校验被缓存的表述是否仍然是最新的。对于非安全请求，比如PUT，POST和DELETE，条件请求则可以提供并发控制。 不支持条件GET请求会降低性能，面临并发时，如果不使POST，PU……

本章所着眼的这些问题通常被视为极具挑战性，或者是超越了REST统一接口约束的领域。本章的内容涉及到创建副本、建立快照（snapshots）、移动及合并、批量处理请求，以及对事务的支持。尽管它们不会出现在每个RESTful Web服务中，本章仍将向您展示怎样将HTTP的统一接口与资源和链接结合起来，解……

安全这个术语是用来描述系统不同层面和部分中的不同事物的。举例来说，一个基于Web的应用程序会涉及用户访问资源。要保护这样一个系统需要做到以下几点： ·保证只有通过身份验证的用户才能访问资源。 ·从信息被收集那刻起，一直到它被存储起来，后续展现给经授权的组织和用户，都要保证它的机密性和完整性。 ·防止……

在任何分布式的客户端/服务器环境中管理变更都是很困难的。在这样的环境中，客户端依赖于服务器能履行自己的承诺。RESTful Web服务也不例外，对它们而言，这包括URI、资源、结构体和表述的内容、它们的格式，以及每个资源的HTTP方法。 直到您开始考虑向后兼容性（backward compatibi……

构建RESTful Web服务时，需要处理两类可发现性（discoverability），即设计时可发现性和运行时可发现性。设计时可发现性帮助他人设计并构建客户端，它描述了客户端开发团队和管理员需要知道的所有关于构建和运行客户端所需的知识。另一方面，运行时可发现性帮助保持客户端与服务器之间的松耦合，……

附录A 辅助读物 图书 Ross J. Anderson, Security Engineering: A Guide to Building Dependable Distributed Systems, 2nd Edition. Indianapolis, IN: Wiley, 2008. Ri……

附录B REST概述 REST是表述性状态转移（Representational State Transfer）的简称。要明白它的含义，可以设想一个简单的基于Web的社交应用程序。 1. 用户在浏览器中键入地址，访问应用程序的主页。 2. 浏览器向服务器提交了一个HTTP请求。 3. 服务器返回一个……

附录C HTTP方法 HTTP的统一接口包括OPTIONS，GET，HEAD，POST，PUT，DELETE和TRACE方法。本附录提供了一个入门，说明这些HTTP方法的使用方式，下文按照RFC 2616进行排序。 OPTIONS 使用该方法来获取资源支持的HTTP方法列表，或者ping服务器。 请……

附录D Atom Syndication Format 本附录提供了一个概述，介绍如何针对资源使用Atom的Entry和Feed文档。图D-1和图D-2是atom:entry和atom:feed的一个高层视图。如果需要这些元素的完整描述，详见RFC 4287。 图D-1:atom:entry Fee……

附录E 链接关系类型 该附录列举了在http://www.iana.org/assignments/link-relations/link-relations.xhtml中注册过的所有链接关系类型，以及何时使用这些链接关系类型。在Web Linking Internet-Draft定稿后，这个列表会……

Symbols & (ampersand), URIs, 76 ，(comma), URIs, 76 -(hyphen), URIs, 76 .(dot)character, URI extensions, 134 .(full stop), URIs, 78 /(forward-slash sep……

Subbu Allamaraju是Yahoo！的架构师，曾负责开发设计RESTful Web服务的标准及实践，目前负责为某些面向开发者的平台做架构设计。在此之前，他在BEA Systems,Inc.开发Web服务及基于Java的软件，并参与制定JCP和OASIS标准。Subbu参与了4本J2EE书籍……

本书的封面动物是一只刺背鳄蜥或楔齿蜥，通常也被称为喙头蜥（tuatara），分布于新西兰；“tuatara”是新西兰毛利语，意思是“背上的山峰”（指它们那尖锐带刺的脊骨）。“刺背鳄蜥”其实是一个误称；虽然喙头蜥和普通的蜥蜴很像，但它们在解剖学上却很不一样，而且多在夜间活动，喜欢凉爽的天气。喙头蜥曾在……