RESTful Web 服务简介
REST 在 2000 年由 Roy Fielding 在博士论 文中提出,他是 HTTP 规范 1.0 和 1.1 版的首席作者之一。
REST 中最 重要的概念是资源(resources),使用全球 ID(通常使用 URI)标识。客户端 应用程序使用 HTTP 方法(GET/ POST/ PUT/ DELETE)操作资源或资源集。 RESTful Web 服务是使用 HTTP 和 REST 原理实现的 Web 服务。通常,RESTful Web 服务应该定义以下方面:
Web 服务的基/根 URI,比如 http://host/<appcontext>/resources。
支持 MIME 类型的响应 数据,包括 JSON/XML/ATOM 等等。
服务支持的操作集合(例如 POST、 GET、PUT 或 DELETE)。
表 1 演示了典型 RESTful Web 服务中使用的 资源 URI 和 HTTP 方法。
表 1. RESTful Web 服务示例
方法/资源 | 资源集合, URI 如: http://host/<appctx>/resources |
成员资源,URI 如: http://host/<appctx>/resources/1234 |
GET | 列出资源集合的所有成员。 | 检索标识为 1234 的资源的表示 形式。 |
PUT | 使用一个集合更新(替换)另一个集 合。 | 更新标记为 1234 的数字资源。 |
POST | 在集合中创建数字资源,其 ID 是自动分配的。 | 在下面创建 一个子资源。 |
DELETE | 删除整个资源集合。 | 删除标记为 1234 的数字资源。 |
JSR 311 (JAX-RS) 和 Jersey
JSR 311 或 JAX-RS(用于 RESTful Web Services 的 Java API)的提议开始于 2007 年,1.0 版本到 2008 年 10 月定 稿。目前,JSR 311 版本 1.1 还处于草案阶段。该 JSR 的目的是提供一组 API 以简化 REST 样式的 Web 服务的开发。
在 JAX-RS 规范之前,已经有 Restlet 和 RestEasy 之类的框架,可以帮助 您实现 RESTful Web 服务,但是它们不够直观。Jersey 是 JAX-RS 的参考实现 ,它包含三个主要部分。
核心服务器(Core Server):通过提供 JSR 311 中标准化的注释和 API 标准化,您可以用直观的方式开发 RESTful Web 服 务。
核心客户端(Core Client):Jersey 客户端 API 帮助您与 REST 服务轻松 通信。
集成(Integration):Jersey 还提供可以轻松集成 Spring、Guice、 Apache Abdera 的库。
在本文的以下部分,我介绍了所有这些组件,但是更关注核心服务器。
构建 RESTful Web 服务
我将从可以集成到 Tomcat 的 “hello world” 应用程序开始。该应用程序将带领您完成设置环境 的过程,并涉及 Jersey 和 JAX-RS 的基础知识。
然后,我将介绍更加 复杂的应用程序,深入探讨 JAX-RS 的本质和特性,比如多个 MIME 类型表示形 式支持、JAXB 支持等。我将从样例中摘取一些代码片段来介绍重要的概念。
Hello World:第一个 Jersey Web 项目
要设置开发环境,您需 要以下内容:
IDE:Eclipse IDE for JEE (v3.4+) 或 IBM Rational Application Developer 7.5
Java SE5 或更高版本
Web 容器: Apache Tomcat 6.0(Jetty 和其他也可以)
Jersey 库:Jersey 1.0.3 归档,包含所有必需的库