RESTful教學 » RESTful環境安裝設定

RESTful環境安裝設定

本教學將指導你如何準備一個開發環境，開始使用Jersey框架工作，以建立基於REST的Web服務。Jersey 框架實現JAX-RS2.0 API，這是建立標準規範REST Web服務。本教學也將教你如何設定JDK，Tomcat和Eclipse在安裝JerseyFramework之前：

第1步 - 安裝Java開發工具包(JDK)：

您可以從甲骨文的Java網站上的最新版本的JDK：Java SE 下載. 會找到安裝說明在下載的檔案中，請按照說明安裝JDK和組態設定。最後，設定PATH和JAVA_HOME環境變數指向包含java和javac的目錄，通常java的安裝目錄分別為java_install_dir和java_install_dir。

如果使用的是Windows，並安裝了JDK在C:\jdk1.7.0_75, 必須把下面的行放在 C:\autoexec.bat 檔案中.

set PATH=C:\jdk1.7.0_75\bin;%PATH%
set JAVA_HOME=C:\jdk1.7.0_75

另外，如果使用 Windows NT/2000/XP, 你也可以在"我的電腦"，選擇"屬性"，然後右鍵單擊"高階"，然後"環境變數"。 然後更新PATH值，然後按OK按鈕。

在Unix（Solaris和Linux等），如果SDK安裝在 /usr/local/jdk1.7.0_75 而你使用的是C shell，乾脆把以下內容加入到.bashrc檔案。

setenv PATH /usr/local/jdk1.7.0_75/bin:$PATH
setenv JAVA_HOME /usr/local/jdk1.7.0_75

另外，如果您使用的整合開發環境（IDE），如 Borland JBuilder, Eclipse, IntelliJ IDEA, 或Sun ONE Studio, 編譯和執行一個簡單的程式，以確認IDE知道你在哪裡安裝了Java，否則按說明文件為IDE做適當設定。

第2步 - 設定Eclipse IDE

在本教學中的所有範例是使用Eclipse IDE編寫。所以建議你應該在計算機上安裝最新版本的Eclipse。

要安裝Eclipse IDE，請下載最新的Eclipse二進位制檔案：http://www.eclipse.org/downloads/ 當下載安裝，解壓二進位制分發到一個方便的位置。例如：在window 上為C:\eclipse, 或/usr/local/eclipse 在Linux/Unix，最後適當設定PATH變數。

Eclipse可以通過在Windows計算機上執行下面的命令來啟動，或者可以簡單地雙擊eclipse.exe

 %C:\eclipse\eclipse.exe

在Unix（Solaris和Linux等）機器下面Eclipse可以通過執行下面命令來啟動：

$/usr/local/eclipse/eclipse

成功啟動後，如果一切都很好，然後它應該顯示以下結果：

Eclipse Home page

第4步 - 設定Jersey框架庫

現在，如果一切正常，那麼你可以繼續設定Jersey框架。以下是簡單的步驟，下載並在計算機上安裝框架。

  • 做出選擇是否要在Windows或Unix上安裝Jersey，然後進行下一步的下載.zip檔案在windows，或.tz檔案在Unix。

  • 下載Jersey框架二進位制檔案的最新版本：https://jersey.java.net/download.html.

  • 在寫這篇教學的時候，下載是jaxrs-ri-2.17.zip 在Windows機器上，當解壓縮下載的檔案時，它會給出以下目錄結構 E:\jaxrs-ri-2.17\jaxrs-ri 在window中。

Jersey Directories

你會發現所有的Jersey庫的目錄在C:\jaxrs-ri-2.17\jaxrs-ri\lib並依賴於C:\jaxrs-ri-2.17\jaxrs-ri\ext。確保這個目錄上設定CLASSPATH變數正確，否則在執行應用程式面臨的問題。如果使用的是Eclipse，則不需要設定CLASSPATH，因為所有的設定將通過Eclipse來完成。

第5步：安裝Apache Tomcat：

可以下載Tomcat的最新版本：http://tomcat.apache.org/。一旦下載安裝，解壓二進位制分發到一個方便的位置。如在windows上為 C:\apache-tomcat-7.0.59, 或在 Linux/Unix上為 /usr/local/apache-tomcat-7.0.59 並設定CATALINA_HOME環境變數指向安裝位置。

Tomcat既可以通過在Windows機器上執行以下命令來啟動，或者可以簡單地雙擊執行startup.bat

 %CATALINA_HOME%\bin\startup.bat
 
 or
 
 C:\apache-tomcat-7.0.59\bin\startup.bat

Tomcat也可以通過在Unix（Solaris和Linux等）的機器執行下面的命令來啟動：

$CATALINA_HOME/bin/startup.sh
 
or
 
/usr/local/apache-tomcat-7.0.59/bin/startup.sh

成功啟動後，包含在Tomcat預設的Web應用程式將可以通過存取 http://localhost:8080/. 如果一切順利，然後它應該顯示以下結果：

Tomcat Home page

有關組態和執行Tomcat的更多資訊，可以這裡include文件裡找到，以及關於Tomcat網站： http://tomcat.apache.org

Tomcat可以執行在Windows機器下面的命令停止：

%CATALINA_HOME%\bin\shutdown

or

C:\apache-tomcat-7.0.59\bin\shutdown

Tomcat可以在Unix（Solaris和Linux等）的機器執行下面的命令停止：

$CATALINA_HOME/bin/shutdown.sh

or

/usr/local/apache-tomcat-7.0.59/bin/shutdown.sh

到這最後一步完成後，就可以開始你的第一個Jersey例子，將在下一章中看到。