Jersey Tomcat

JSR 311 (JAX-RS) 和 Jersey

Jersey 是 JAX-RS 的参考实现,它包含三个主要部分:

  • 核心服务器(Core Server):通过提供 JSR 311 中标准化的注释和 API 标准化,您可以用直观的方式开发 RESTful Web 服务。
  • 核心客户端(Core Client):Jersey 客户端 API 帮助您与 REST 服务轻松通信。
  • 集成(Integration):Jersey 还提供可以轻松集成 Spring、Guice、Apache Abdera 的库。

构建 RESTful Web 服务

@Path("/hello")
public class HelloResource {
    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String sayHello() {
        return "Hello Jersey";
    }
}
  • 资源类(Resource Class):注意,资源类是一个简单的 Java 对象 (POJO),可以实现任何接口。这增加了许多好处,比如可重用性和简单
  • 注释(Annotation):在 javax.ws.rs.* 中定义,是 JAX-RS (JSR 311) 规范的一部分
  • @Path:定义资源基 URI。由上下文根和主机名组成,资源标识符类似于 http://localhost:8080/rest/jersey/hello
  • @GET:这意味着以下方法可以响应 HTTP GET 方法
  • @Produces:以纯文本方式定义响应内容 MIME 类型

资源

@Path("/contacts")
public class ContactsResource {
    @Context
    UriInfo uriInfo;
    @Context
    Request request;

    @GET
    @Produces({MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON})
    public List<Contact> getContacts() {
        List<Contact> contacts = new ArrayList<Contact>();
        contacts.addAll( ContactStore.getStore().values());
        return contacts;
    }

    @Path("{contact}")
    public ContactResource getContact(
            @PathParam("contact") String contact) {
        return new ContactResource(uriInfo, request, contact);
    }
}
  • @Context:使用该注释注入上下文对象,比如 RequestResponseUriInfoServletContext
  • @Path("{contact}"):这是 @Path 注释,与根路径 /contacts 结合形成子资源的 URI
  • @PathParam("contact"):该注释将参数注入方法参数的路径。其他可用的注释有 @FormParam@QueryParam
  • @Produces:响应支持多个 MIME 类型

与 REST 服务通讯的客户端

使用 curl 与 REST 服务通讯

curl http://localhost:8080/rest/jersey/contacts
curl –HAccept:application/json http://localhost:8080/rest/jersey/contacts
curl -X PUT -HContent-type:application/xml --data "<contact><id>foo</id><name>bar</name></contact>" http://localhost:8080/rest/jersey/contacts/foo