REST 探索新项目

simple-service-webapp是由 Jersey 提供 Maven archetype 用来创建的 web 项目，在你的项目里面随意调整 pom.xml 内的 groupId，包号和版本号就可以成为一个新的项目。此时，simple-service-webapp 已经创建， 符合 Maven 的项目结构：

• 标准的管理配置文件 pom.xml
• 源文件路径 src/main/java
• 资源文件路径 src/main/resources
• web 应用文件 src/main/webapp

该项目包含一个名为 MyResouce 的JAX-RS 资源类。在 src/main/webapp/WEB-INF 下，它包含了标准的JavaEE Web 应用的 web.xml 部署描述符。项目中的最后一个组件是一个 index.jsp 页面作为这次 MyResource 资源类打包和部署的应用程序客户端。

MyResource 类是 JAX-RS 的一个实现的源代码，如下：

    package com.waylau.rest;

    import javax.ws.rs.GET;
    import javax.ws.rs.Path;
    import javax.ws.rs.Produces;
    import javax.ws.rs.core.MediaType;

    /**
     * 根资源 (暴露在"myresource"路径)
     */
    @Path("myresource")
    public class MyResource {

        /**
         * 方法处理 HTTP GET 请求。返回的对象以"text/plain"媒体类型
         * 给客户端
         *
         * @return String 以 text/plain 形式响应
         */
        @GET
        @Produces(MediaType.TEXT_PLAIN)
        public String getIt() {
            return "Got it!";
        }
    }

一个 JAX-RS 资源是一个可以处理绑定了资源的 URI 的HTTP请求的带有注解的 POJO。在我们的例子中，单一的资源暴露了一个公开的方法，能够处理HTTP GET请求，绑定在/myresource URI路径下，可以产生媒体类型为“text/plain”的响应消息。在这个示例中，资源返回相同的“Got it!”应对所有客户端的要求。