2015【精品文档】用Java 技术创建 RESTful Web 服务.doc

文档介绍：简介
JAX-RS (JSR-311) 是为 Java EE 环境下的 RESTful 服务能力提供的一种规范。它能提供对传统的基于 SOAP 的 Web 服务的一种可行替代。
在本文中,了解 JAX-RS 的主要组件。本文用一个例子展示了一个企业如何使用 JAX-RS 内的功能以一种 Restful 的方式公开员工的联系信息。
背景
多年来,开发人员使用各种工具在其 Java 应用程序内创建 RESTful 服务。由于 REST 架构的简单性,主要需求—接收 HTTP 消息和头部的能力—可以由一个简单的 Java Web 容器实现。
Java servlets 常被用来开发 RESTful 应用程序。如何使用 servlet 并没有固定的模式。通常,servlet 会接受请求并自己解析这个 HTTP 请求 URI,以将此请求与一个已知资源相匹配。对于 REST 服务开发,这个简单的 servlet 模型以更为正式的 API 得到扩展。但是,因为这些 API 是在 servlet 模型之上开发的,所以这些 API 中没有一个是作为正式的标准开发的。
随着 REST 越来越多地被采用为一种架构,munity Process (JCP) 计划在未来的 Java Enterprise Edition 6 发布版中包括对 REST 的正式支持。JSR-311 也已创建好,并已有了 JAX-RS 规范,提供了一种新的基于注释的方式来开发 RESTful 服务。与 servlet 模型相比,JAX-RS 注释让您能集中于您的资源和数据对象。并且,您不必再开发通讯层(通过 servlet)。
Java 资源
JAX-RS 建立了一种特殊的语言来描述资源,正如由其编程模型所表示的。有五种主要条目:根资源、子资源、资源方法、子资源方法以及子资源定位器。
根资源
根资源是由***@Path 注释的 Java 类。***@Path 注释提供了一个 value 属性,用来表明此资源所在的路径。value 属性可以是文本字符、变量或变量外加一个定制的正则表达式。清单 1 给出了一个例子。
清单 1. JAX-RS 根资源
子资源
子资源是作为 subresource locator 调用的结果返回的 Java 类。它们类似于根资源,只不过它们不是由***@Path 注释的,因它们的路径是由子资源定位器给出的。子资源通常包含由 HTTP 请求方法指示符(designator)注释的方法以便服务此请求。如果它们不包含如此注释的方法,那么它们将会通过指派给合适的子资源定位器来进一步解析此资源处理请求。
清单 2. JAX-RS 子资源
.;
import ;
public class Department {
***@GET
public String getDepartmentName() {
...
}
}
如上所示的清单 2 展示了由 方法返回的子资源。在这个例子中,如果一个 HTTP GET 请求被发送给/contact/{contactName}/department 路径,那么 Department 子资源内的 getDepartmentName 资源方法就会处理此请求。
资源方法
资源方法是根资源或子资源内绑定到 HTTP 方法的 Java 方法。绑定是通过诸如***@GET 这样的注释完成的。
清单 3. JAX-RS 资源方法

.;
import ;
import ;
import ;
***@Path(value="/contacts")
public class ContactsResource {
***@GET
public List<ContactInfo> getContacts() {
...
}
}
在清单 3 的例子中,发送到/contacts 路径的 HTTP GET 请求将会由 getContacts() 资源方法处理。
子资源方法
子资源方法非常类似于资源方法;惟一的区别是子资源方法也是由***@Path 注释的,此注释进一步限定了该方法的选择。
清单 4. JAX-RS 子资源方法

.;
import ;
import ;
import ;