鍍金池/ 教程/ Java/ RESTful Web 服務(wù) - 環(huán)境設(shè)置
RESTful Web 服務(wù) - 環(huán)境設(shè)置
RESTful Web 服務(wù) - 資源
RESTful Web 服務(wù) - 第一個(gè)應(yīng)用
RESTful Web 服務(wù) - 緩存
RESTful Web 服務(wù) - 方法
RESTful Web 服務(wù) - 安全性
RESTful Web 服務(wù) - 尋址
RESTful Web 服務(wù) - 無狀態(tài)
RESTful Web 服務(wù) - Java (JAX-RS)
RESTful Web 服務(wù) - 介紹
RESTful Web 服務(wù) - 消息

RESTful Web 服務(wù) - 環(huán)境設(shè)置

本教程將會(huì)指導(dǎo)我們?nèi)绾螠?zhǔn)備開發(fā)環(huán)境,使用 Jersey 框架啟動(dòng)我們的工作以創(chuàng)建一個(gè) RESTful Web 服務(wù)。Jersey 框架實(shí)現(xiàn)了 JAX-RS 2.0 API,這是創(chuàng)建 RESTful Web 服務(wù)的標(biāo)準(zhǔn)規(guī)范。在安裝 Jersey 框架之前本教程還會(huì)教授我們?nèi)绾卧谖覀兊臋C(jī)器上安裝 JDK,Tomcat 和 Eclipse:

步驟 1 - 安裝 Java 開發(fā)工具包(JDK):

我們可以從 Oracle 的 Java 站點(diǎn)的 下載 Java SE 頁面下載最新版的 SDK。在下載的文件中可以找到安裝 JDK 的說明,然后按照給定的說明安裝和配置設(shè)置即可。最后,設(shè)置 PATH 和 JAVA_HOME 環(huán)境變量指向包含 java 和 javac 的目錄,通常分別是 java_install_dir/bin 和 java_install_dir 目錄。

如果你運(yùn)行的是 Windows 并在 C:\jdk1.7.0_75 中安裝了 JDK,那么你必須把下面的代碼放到你的 C:\autoexec.bat 文件中。

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

或者,在 Windows NT/2000/XP 中,也可以右鍵我的電腦,選擇屬性,然后選擇高級(jí),最后選擇環(huán)境變量。然后,更新 PATH 的值并按下 OK 按鈕。

在 Unix(Solaris, Linux 等等)中,如果在 /usr/local/jdk1.7.0_75 中安裝了 JDK 并使用的是 C Shell,你需要把下面的代碼放到你的 .cshrc 文件中。

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

或者,如果你使用集成開發(fā)環(huán)境(IDE),比如 Borland JBuilder, Eclipse,,IntelliJ IDEA 或者 Sun ONE Studio,請(qǐng)編譯和運(yùn)行一個(gè)簡(jiǎn)單的程序確認(rèn)你的 IDE 知道你在哪里安裝了 Java,否則請(qǐng)按照給定的文檔對(duì)你的 IDE 做適當(dāng)?shù)脑O(shè)置。

步驟 2 - 安裝 Eclipse IDE

本教程中的所有示例都是使用 Eclipse IDE 編寫的。因此,我建議你在你的機(jī)器上安裝最新版的 Eclipse。

要安裝 Eclipse IDE,首先要從 http://www.eclipse.org/downloads/ 下載最新的 Eclipse 二進(jìn)制文件。下載安裝文件之后,解壓二進(jìn)制文件到某個(gè)方便的位置。比如 Windows 的 C:\eclipse 或者 Linux/Unix 的 /usr/local/exlipse 中,最后適當(dāng)?shù)脑O(shè)置 PATH 變量即可。

在 Windows 上可以通過執(zhí)行如下命令或者簡(jiǎn)單的雙擊 eclipse.exe 啟動(dòng) Eclipse。

%C:\eclipse\eclipse.exe

在 Unix(Solaris,Linux 等)機(jī)器上可以通過執(zhí)行如下命令啟動(dòng) Eclipse:

$/usr/local/eclipse/eclipse

啟動(dòng)成功之后,如果一切順利,那么它應(yīng)該顯示如下所示結(jié)果:

http://wiki.jikexueyuan.com/project/restful/images/eclipse_home_page.jpg" alt="eclipse" />

步驟 3 - 安裝 Jersey 框架庫

現(xiàn)在如果一切就緒,然后就可以安裝 Jersey 框架了。以下是在你的機(jī)器上下載和安裝這個(gè)框架的簡(jiǎn)單步驟。

  • 選擇是要在 Windows 上還是 Unix 上安裝 Jersey,然后根據(jù)下一步為 Windows 下載 .zip 文件或者為 Unix 下載 .tz 文件。
  • https://jersey.java.net/download.html 下載最新版的 Jersey 框架二進(jìn)制文件。
  • 編寫本教程時(shí),我在我的 Windows 機(jī)器上下載的 jaxrs-ri-2.17.zip,解壓下載的文件時(shí)它會(huì)在 E:\jaxrs-ri-2.17\jaxrs-ri 目錄中生成如下所示的目錄結(jié)構(gòu):

http://wiki.jikexueyuan.com/project/restful/images/jaxrs_directories.jpg" alt="jaxrs_directories" />

我們可以在 C:\jaxrs-ri-2.17\jaxrs-ri\lib 目錄找到所有的 Jersey 庫,在 C:\jaxrs-ri-2.17\jaxrs-ri\ext 中找到依賴。確保在這個(gè)目錄正確設(shè)置了 CLASSPATH 變量,否則在運(yùn)行應(yīng)用程序時(shí)將會(huì)面臨一些問題。如果你在使用 Eclipse,那么就不需要設(shè)置 CLASSPATH,因?yàn)樗械脑O(shè)置都會(huì)通過 Eclipse 完成。

步驟 4 - 安裝 Apache Tomcat

可以從 http://tomcat.apache.org/ 上下載最新版的 Tomcat。下載安裝文件之后,解壓二進(jìn)制文件到一個(gè)方便的位置。比如 Windows 的 C:\apache-tomcat-7.0.59 或者 Linux/Unix 的 /usr/local/apache-tomcat-7.0.59,然后設(shè)置 CATALINA_HOME 環(huán)境變量指向安裝位置。

Windows 上可以通過執(zhí)行如下命令或者簡(jiǎn)單的雙擊 startup.bat 文件啟動(dòng) Tomcat:

%CATALINA_HOME%\bin\startup.bat

或者

C:\apache-tomcat-7.0.59\bin\startup.bat

Unix(Solaris,Linux 等)機(jī)器上可以通過執(zhí)行如下命令啟動(dòng) Tomcat:

$CATALINA_HOME/bin/startup.sh

或者

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

成功啟動(dòng)之后,可以通過訪問 http://localhost:8080/ 查看 Tomcat 包含的默認(rèn) Web 應(yīng)用程序。如果一切就緒,那么它應(yīng)該顯示如下結(jié)果:

http://wiki.jikexueyuan.com/project/restful/images/tomcat.jpg" alt="tomcat" />

關(guān)于配置和運(yùn)行 Tomcat 的更多信息可以在包含的文章中找到,也可以在 Tomcat 的網(wǎng)頁:http://tomcat.apache.org 上找到。

Windows 機(jī)器上可以通過執(zhí)行如下命令停止 Tomcat:

%CATALINA_HOME%\bin\shutdown

或者

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

Unix(Solaris,Linux 等)機(jī)器上可以通過執(zhí)行如下命令停止 Tomcat:

$CATALINA_HOME/bin/shutdown.sh

或者

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

一旦完成最后這一步,就可以開始準(zhǔn)備下一章會(huì)看到的第一個(gè) Jersey 示例了。