對大部份的新手來說,很容易在學習新的技術時,在建置第一支程式時就遭到嚴重的挫折。所以在撰寫這第一支程式範例時,盡可能的以實作為根本,而不墬述太多所謂的「原理」或「為什麼」。在這裡就簡單的記錄第一支 Jersey 的程式。
1. 首先設定 web.xml ( 基本配置檔,可說是 Java Web Project 的指揮中心 )
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd" > <web-app> <display-name>Archetype Created Web Application</display-name> <servlet> <servlet-name>JerseySerlvet</servlet-name> <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class> <init-param> <param-name>jersey.config.server.provider.packages</param-name> <param-value>com.edittw</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>JerseySerlvet</servlet-name> <url-pattern>/rest/*</url-pattern> </servlet-mapping> </web-app>
- 第 8 行:org.glassfish.jersey.servlet.ServletContainer 指的是 Jersey 監控的處理程式。
- 第 11 行:com.edittw 指的是步驟 2 中第一支程式的 Package 名稱。
- 第 17 行:/rest/* 指的是符合 Jersey 監控的 URL 規則(Servlet 基本觀念)。
- 第 7 行及第 16 行的 JerseySerlvet 可以自行命名,但二行的名字必須一致(Servlet 基本觀念)。
2. 接著建立第一支 Jersey 程式,用來接受 HTTP 服務請求。
package com.edittw; import javax.ws.rs.GET; import javax.ws.rs.Path; @Path("/order") //提供服務的 URL public class Order { @GET // 對應的要求方法:可以是 GET, POST, PUT, DELETE public String get() { return "Hello, Jersey"; } }
- 第 6 行:程式提供服務的 URL 為 /JerseySample/rest/order,其中 JerseySample 為專案名稱,rest 為 servlet 監聽規則的設定。
- 第 9 行:宣告監聽的 要求方式( Requset Method) 為 GET:在 REST 的規範中,GET 所對應的方法拿來處理「查詢資源」。
- 第 11 行:執行完成後,想要回覆請求端(前端)的訊息,在這先回覆簡單的文字訊息。
3. 完成上述步驟,起動 Tomcat 後,可以簡單的利用 Chrome 的外掛 Postman 進行基本測試 。
![]() |
下一篇:《Jersey》如何使用 JSON 介接格式 ![]() |
文章標籤
全站熱搜