《Jersey》建立第一支程式

對大部份的新手來說，很容易在學習新的技術時，在建置第一支程式時就遭到嚴重的挫折。所以在撰寫這第一支程式範例時，盡可能的以實作為根本，而不墬述太多所謂的「原理」或「為什麼」。在這裡就簡單的記錄第一支  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 進行基本測試 。