编写rest服务教程.pdf

页码，1/ 13 2007 11 月 15 日 本教程讨论了 REST 和 Atom 发布协议（Atom Publishing Protocol，APP ）的概念，展示了其在服务中 的应用。本教程还介绍了如何使用 Java 技术实现基于 REST/APP 的服务。 开始之前 了解本文介绍的内容以及如何充分利用这些知识。 关于本教程 本教程讨论了 Representation State Transfer （REST）和 Atom 发布协议的概念，并展示了它们在服务中的应用。 此外，您还将了解到如何使用 Java 技术实现基于 REST/APP 的服务。 目标 在本教程中，您将学习以下内容： l 了解 REST 的基本知识以及 APP 的基本概念。 l 在企业系统内部应用这些技术，以通过一个基于 Java servlet 的系统发送和接受 HTTP 请求和响应。 l 能够访问和修改 podcast、博客条目、图像存储、日历条目等资源数据。 先决条件 本教程面向的读者是具有初到中级技能和经验的 Java 编程人员。您应当基本了解 Java servlet 的用法以及 Java 编 程语言的实践知识。要下载本教程中的所有源代码，请参阅 下载。 系统需求 要运行本教程中的示例，您需要使用一个 Java servlet 容器。 Representational State Transfer REST 由各种架构原理和一种软件架构样式组成，它根据诸如 World Wide Web 这样的资源定义和访问机制在网 络中构建分布式系统。REST 这一术语源于 Roy Fielding 的论文（参阅 参考资料），经常用于宽泛地描述一种通 过 HTTP 这样的协议传输数据的框架，这种框架不需要使用额外的语义层或会话管理。 REST 严格区分构成客户机-服务器系统的组件之间的关系，可以更轻松地实现涉及的参 组件。REST 还设法简 化分步式系统中的通信语义，以提供可伸缩性并改善性能。REST 依赖于请求之间的无状态对话，这表示请求消 息必须包括客户机或服务器理解消息上下文所需的全部信息。在基于 REST 的系统中，使用最少量的消息动词便 可交换标准媒体类型。 REST 原理使用统一资源标识符 （URI ）定位并提交资源的具象状态。给定资源的具象状态可以被创建、检索、修 改和删除。例如，可以将 REST 应用于文档发布，使读者可以使用文档。在任何特定时间，发布者可以给出 Web URL 以便读者访问所发布的文档的信息 （具象状态）。文档读者只需要知道 URL 就可读取文档信息，如果 经过授权，则可以修改信息。 正如 Roy Fielding 所说，REST 的定义原则之一是它可以利用现有的技术、标准和 网络有关的协议（如 HTTP ）。 其他大多数基于 Web 的消息传递标准相比，这种对现有技术和协议的依赖性使得 REST 更加容易掌 握和使用，因为只需很少量的额外开销就能够有效地交换信息。 页码，2/ 13 根据 Fielding 的描述，基于 REST 的会话是在无状态的会话中进行的，因此它成为推动基于订阅技术的首选，例 如 RSS、RDF 、OWL 和 Atom ，这些技术中的内容都是被传递给预先订阅的客户机。 REST 的基本实体 REST 定义了以下基本实体： l 数据元素：数据、标识符 （URI 和 URL ）和数据表示形式，如 HTML 文档、XML 文档和图像 l 组件：原始服务器 （如Apache httpd 和 Microsoft®Internet Information Services (IIS)）、网关（如 Squid 和 CGI ）、代理 （如Gauntlet 和 Netscape 代理）以及用户代理 （如Web 浏览器或移动设备） l 连接器：客户连接器 （例如 libwww ）、服务器连接器 （如NSAPI ）、缓存 （如浏览器缓存）等等 图 1 示了其中一些基本的 REST 实体以及在典型企业系统中的交互方式。 图 1. REST 实体间的交互 可以看到，连接器是被作为能够支持组件间通信的协议端口包含到系统中的。注意：REST 系统中的任何组件都 可以使用多个客户机和/或服务器连接