《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 行：执行完成后，想要回复请求端（前端）的讯息，在这先回复简单的文字讯息。