首页 / 软件开发 / JAVA / 使用Jersey和Apache Tomcat构建RESTful Web服务

使用Jersey和Apache Tomcat构建RESTful Web服务2011-06-12 IBM Yi Ming HuangRESTful 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 归档，包含所有必需的库