RESTful Web 服务 - 环境设置

本教程将指导您如何准备开发环境,以便开始使用 Jersey 框架 创建 RESTful Web 服务。Jersey 框架实现了 JAX-RS 2.0 API,这是创建 RESTful Web 服务的标准规范。本教程还将教您如何在设置 Jersey 框架之前在您的机器上设置 JDK、TomcatEclipse

设置 Java 开发工具包 (JDK)

您可以从 Oracle 的 Java 站点 − Java SE 下载 下载最新版本的 SDK。您将在下载的文件中找到安装 JDK 的说明。按照给出的说明安装和配置设置。最后,设置 PATHJAVA_HOME 环境变量,以引用包含 JavaJavac 的目录,通常分别为 java_install_dir/bin 和 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,则应将以下内容放入 .cshrc 文件中。

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 的给定文档进行正确的设置。

设置 Eclipse IDE

本教程中的所有示例都是使用 Eclipse IDE 编写的。因此,我建议您在计算机上安装最新版本的 Eclipse。

要安装 Eclipse IDE,请从 https://www.eclipse.org/downloads/ 下载最新的 Eclipse 二进制文件。下载安装程序后,将二进制分发包解压到方便的位置。例如,在 Windows 上位于 C:\eclipse,或在 Linux/Unix 上位于 /usr/local/eclipse,最后适当地设置 PATH 变量。

在 Windows 机器上,可以通过执行以下命令来启动 Eclipse,或者只需双击 eclipse.exe 即可。

%C:\eclipse\eclipse.exe

在 Unix(Solaris、Linux 等)机器上,可以通过执行以下命令来启动 Eclipse −

$/usr/local/eclipse/eclipse 

启动成功后,如果一切正常,您的屏幕应显示以下结果 −

Eclipse Home Page

设置 Jersey 框架库

现在,如果一切正常,您可以继续设置 Jersey 框架。以下是在您的机器上下载和安装框架的几个简单步骤。

  • 选择是否要在 Windows 或 Unix 上安装 Jersey,然后继续下一步,下载适用于 Windows 的 .zip 文件,然后下载适用于 Unix 的 .tz 文件。

  • 从以下链接下载最新版本的 Jersey 框架二进制文件 - https://jersey.java.net/download.html

  • 在撰写本教程时,我在 Windows 机器上下载了 jaxrs-ri-2.17.zip,当您解压下载的文件时,它将为您提供 E:\jaxrs-ri-2.17\jaxrs-ri 内的目录结构,如下所示屏幕截图。

Jaxrs Directory

您将在目录 C:\jaxrs-ri-2.17\jaxrs-ri\lib 中找到所有 Jersey 库,并在 C:\jaxrs-ri-2.17\jaxrs-ri\ext 中找到依赖项。请确保在此目录上正确设置 CLASSPATH 变量,否则在运行应用程序时会遇到问题。如果您使用的是 Eclipse,则无需设置 CLASSPATH,因为所有设置都将通过 Eclipse 完成。

设置 Apache Tomcat

您可以从 https://tomcat.apache.org/ 下载最新版本的 Tomcat。下载安装后,将二进制分发包解压到方便的位置。例如,Windows 上的 C:\apache-tomcat-7.0.59 或 Linux/Unix 上的 /usr/local/apache-tomcat-7.0.59,并将 CATALINA_HOME 环境变量设置为指向安装位置。

可以在 Windows 机器上执行以下命令来启动 Tomcat,或者只需双击 startup.bat 即可。

%CATALINA_HOME%\bin\startup.bat

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

可以在 Unix(Solaris、Linux 等)机器上执行以下命令来启动 Tomcat −

$CATALINA_HOME/bin/startup.sh

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

成功启动后,访问 http://localhost:8080/ 即可使用 Tomcat 附带的默认 Web 应用程序。如果一切正常,则应显示以下结果 −

Tomcat

有关配置和运行 Tomcat 的更多信息,请参阅本页附带的文档。此信息也可在 Tomcat 网站上找到 − https://tomcat.apache.org.

可以在 Windows 机器上执行以下命令来停止 Tomcat −

%CATALINA_HOME%\bin\shutdown 

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

可以通过在 Unix(Solaris、Linux 等)机器上执行以下命令来停止 Tomcat −

$CATALINA_HOME/bin/shutdown.sh

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

完成最后一步后,您就可以继续执行第一个 Jersey 示例了,您将在下一章中看到该示例。