第 46 章 创建资源
摘要
在 RESTful Web 服务中，所有请求都由资源处理。JAX-RS API 将资源实施为 Java 类。资源类是用一个或多个 JAX-RS 注释标注的 Java 类。使用 JAX-RS 实施的 RESTful Web 服务的核心是根资源类。root 资源类是指向由服务公开的资源树的入口点。它可以处理所有请求本身，或者它可能会提供对处理请求的子资源的访问。
46.1. 简介
概述
使用 JAX-RS API 实施的 RESTful Web 服务将响应作为 Java 类实施的资源的表示形式提供。资源类 是使用 JAX-RS 注释来实施资源的类。对于大多数 RESTful Web 服务，需要访问的资源集合。资源类的注解提供资源 URI 以及每个操作处理的 HTTP 动词等信息。
资源类型
JAX-RS API 允许您创建两个基本类型的资源：
-
第 46.3 节 “根资源类” 是服务的资源树的入口点。它使用
@Path注释进行解码，以定义服务中资源的基本 URI。 -
第 46.5 节 “使用子资源” 通过 root 资源访问。它们通过利用
@Path注释进行解码的方法来实施。子资源的@Path注释定义了相对于根资源基本 URI 的 URI。
示例
例 46.1 “简单资源类” 显示简单的资源类。
例 46.1. 简单资源类
package demo.jaxrs.server;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
@Path("/customerservice")
public class CustomerService
{
public CustomerService()
{
}
@GET
public Customer getCustomer(@QueryParam("id") String id)
{
...
}
...
}两个项目使 例 46.1 “简单资源类” 中定义的类成为资源类：
@Path 注释指定资源的基本 URI。
@GET 注释指定方法为资源实施 HTTP GET 方法。
