REST 探索新項(xiàng)目

simple-service-webapp是由 Jersey 提供 Maven archetype 用來創(chuàng)建的 web 項(xiàng)目，在你的項(xiàng)目里面隨意調(diào)整 pom.xml 內(nèi)的 groupId，包號和版本號就可以成為一個新的項(xiàng)目。此時，simple-service-webapp 已經(jīng)創(chuàng)建， 符合 Maven 的項(xiàng)目結(jié)構(gòu)：

• 標(biāo)準(zhǔn)的管理配置文件 pom.xml
• 源文件路徑 src/main/java
• 資源文件路徑 src/main/resources
• web 應(yīng)用文件 src/main/webapp

該項(xiàng)目包含一個名為 MyResouce 的JAX-RS 資源類。在 src/main/webapp/WEB-INF 下，它包含了標(biāo)準(zhǔn)的JavaEE Web 應(yīng)用的 web.xml 部署描述符。項(xiàng)目中的最后一個組件是一個 index.jsp 頁面作為這次 MyResource 資源類打包和部署的應(yīng)用程序客戶端。

MyResource 類是 JAX-RS 的一個實(shí)現(xiàn)的源代碼，如下：

    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 形式響應(yīng)
         */
        @GET
        @Produces(MediaType.TEXT_PLAIN)
        public String getIt() {
            return "Got it!";
        }
    }

一個 JAX-RS 資源是一個可以處理綁定了資源的 URI 的HTTP請求的帶有注解的 POJO。在我們的例子中，單一的資源暴露了一個公開的方法，能夠處理HTTP GET請求，綁定在/myresource URI路徑下，可以產(chǎn)生媒體類型為“text/plain”的響應(yīng)消息。在這個示例中，資源返回相同的“Got it!”應(yīng)對所有客戶端的要求。