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
成功啓動後,如果一切都很好,然後它應該顯示以下結果:
第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庫的目錄在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的更多信息,可以這裏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例子,將在下一章中看到。