RESTful Web 服务 - 环境设置

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

设置 Java 开发工具包 (JDK)

您可以从 Oracle 的 Java 站点 - Java SE 下载下载最新版本的 SDK 。您将在下载的文件中找到安装 JDK 的说明。按照给定的说明安装和配置设置。最后设置PATH和JAVA_HOME环境变量以引用包含Java和Javac的目录，通常分别为 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 值并按“确定”按钮。

在 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 主页

设置 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 内的目录结构，如图所示在下面的屏幕截图中。

贾克斯目录

您将在目录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 环境变量。

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

%CATALINA_HOME%\bin\startup.bat

或者

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

Tomcat 可以通过在 Unix（Solaris、Linux 等）机器上执行以下命令来启动 -

$CATALINA_HOME/bin/startup.sh

或者

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

成功启动后，可以通过访问http://localhost:8080/ 来使用 Tomcat 附带的默认 Web 应用程序。如果一切正常那么它应该显示以下结果 -

雄猫

有关配置和运行 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 示例。