RESTful Web 服务 - 环境设置
本教程将指导您如何准备开发环境,以便开始使用 Jersey 框架 创建 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 值并按下 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
启动成功后,如果一切正常,您的屏幕应显示以下结果 −
设置 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 环境变量设置为指向安装位置。
可以在 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 网站上找到 − 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 示例了,您将在下一章中看到该示例。